1 /* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.server.display; 18 19 import android.graphics.Rect; 20 21 /** 22 * Describes how the pixels of physical display device reflects the content of 23 * a logical display. 24 * <p> 25 * This information is used by the input system to translate touch input from 26 * physical display coordinates into logical display coordinates. 27 * </p> 28 */ 29 public final class DisplayViewport { 30 // True if this viewport is valid. 31 public boolean valid; 32 33 // The logical display id. 34 public int displayId; 35 36 // The rotation applied to the physical coordinate system. 37 public int orientation; 38 39 // The portion of the logical display that are presented on this physical display. 40 public final Rect logicalFrame = new Rect(); 41 42 // The portion of the (rotated) physical display that shows the logical display contents. 43 // The relation between logical and physical frame defines how the coordinate system 44 // should be scaled or translated after rotation. 45 public final Rect physicalFrame = new Rect(); 46 47 // The full width and height of the display device, rotated in the same 48 // manner as physicalFrame. This expresses the full native size of the display device. 49 // The physical frame should usually fit within this area. 50 public int deviceWidth; 51 public int deviceHeight; 52 copyFrom(DisplayViewport viewport)53 public void copyFrom(DisplayViewport viewport) { 54 valid = viewport.valid; 55 displayId = viewport.displayId; 56 orientation = viewport.orientation; 57 logicalFrame.set(viewport.logicalFrame); 58 physicalFrame.set(viewport.physicalFrame); 59 deviceWidth = viewport.deviceWidth; 60 deviceHeight = viewport.deviceHeight; 61 } 62 63 // For debugging purposes. 64 @Override toString()65 public String toString() { 66 return "DisplayViewport{valid=" + valid 67 + ", displayId=" + displayId 68 + ", orientation=" + orientation 69 + ", logicalFrame=" + logicalFrame 70 + ", physicalFrame=" + physicalFrame 71 + ", deviceWidth=" + deviceWidth 72 + ", deviceHeight=" + deviceHeight 73 + "}"; 74 } 75 } 76