DisplayMetrics.java revision f6d4045d6c386fe09eafb894aa1ff79ca6f04178
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.util; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackbornimport android.os.SystemProperties; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A structure describing general information about a display, such as its 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size, density, and font scaling. 2571d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main * <p>To access the DisplayMetrics members, initialize an object like this:</p> 2671d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main * <pre> DisplayMetrics metrics = new DisplayMetrics(); 2771d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main * getWindowManager().getDefaultDisplay().getMetrics(metrics);</pre> 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class DisplayMetrics { 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 31a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * Standard quantized DPI for low-density screens. 32a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn */ 33a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn public static final int DENSITY_LOW = 120; 34a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn 35a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn /** 36a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * Standard quantized DPI for medium-density screens. 37a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn */ 38a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn public static final int DENSITY_MEDIUM = 160; 39a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn 40a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn /** 41493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * This is a secondary density, added for some common screen configurations. 42493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * It is recommended that applications not generally target this as a first 43493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * class density -- that is, don't supply specific graphics for this 44493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * density, instead allow the platform to scale from other densities 45493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * (typically {@link #DENSITY_HIGH}) as 46493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * appropriate. In most cases (such as using bitmaps in 47493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * {@link android.graphics.drawable.Drawable}) the platform 48493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * can perform this scaling at load time, so the only cost is some slight 49493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * startup runtime overhead. 50493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * 51493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * <p>This density was original introduced to correspond with a 52493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * 720p TV screen: the density for 1080p televisions is 53493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * {@link #DENSITY_XHIGH}, and the value here provides the same UI 54493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * size for a TV running at 720p. It has also found use in 7" tablets, 55493861dfa011f482987c7a49d147d6e50a90c692Dianne Hackborn * when these devices have 1280x720 displays. 56b96cbbd11c4590bec846212c33361e02293f18b5Dianne Hackborn */ 57b96cbbd11c4590bec846212c33361e02293f18b5Dianne Hackborn public static final int DENSITY_TV = 213; 58b96cbbd11c4590bec846212c33361e02293f18b5Dianne Hackborn 59b96cbbd11c4590bec846212c33361e02293f18b5Dianne Hackborn /** 60a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * Standard quantized DPI for high-density screens. 61a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn */ 62a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn public static final int DENSITY_HIGH = 240; 63a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn 64a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn /** 65f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell * Intermediate density for screens that sit between {@link #DENSITY_HIGH} (240dpi) and 66f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell * {@link #DENSITY_XHIGH} (320dpi). This is not a density that applications should target, 67f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell * instead relying on the system to scale their {@link #DENSITY_XHIGH} assets for them. 68f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell */ 69f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell public static final int DENSITY_280 = 280; 70f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell 71f6d4045d6c386fe09eafb894aa1ff79ca6f04178Adam Powell /** 72a0b46c9c441f017a2008ca8ee2c864987465996bDianne Hackborn * Standard quantized DPI for extra-high-density screens. 73a0b46c9c441f017a2008ca8ee2c864987465996bDianne Hackborn */ 74a0b46c9c441f017a2008ca8ee2c864987465996bDianne Hackborn public static final int DENSITY_XHIGH = 320; 75a0b46c9c441f017a2008ca8ee2c864987465996bDianne Hackborn 76a0b46c9c441f017a2008ca8ee2c864987465996bDianne Hackborn /** 7709acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn * Intermediate density for screens that sit somewhere between 78a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * {@link #DENSITY_XHIGH} (320 dpi) and {@link #DENSITY_XXHIGH} (480 dpi). 7909acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn * This is not a density that applications should target, instead relying 8009acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn * on the system to scale their {@link #DENSITY_XXHIGH} assets for them. 8109acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn */ 8209acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn public static final int DENSITY_400 = 400; 8309acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn 8409acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn /** 8561a5a3f2c38ca908b7a607e7bc19b8553f59780eJeff Davidson * Standard quantized DPI for extra-extra-high-density screens. 86d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn */ 87d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn public static final int DENSITY_XXHIGH = 480; 88d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn 89d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn /** 90a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * Intermediate density for screens that sit somewhere between 91d561913798c6ee3c987f39fa19f70e53eeb93ce6Philip Nowell * {@link #DENSITY_XXHIGH} (480 dpi) and {@link #DENSITY_XXXHIGH} (640 dpi). 92a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * This is not a density that applications should target, instead relying 93a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * on the system to scale their {@link #DENSITY_XXXHIGH} assets for them. 94a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn */ 95a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn public static final int DENSITY_560 = 560; 96a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn 97a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn /** 9856a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * Standard quantized DPI for extra-extra-extra-high-density screens. Applications 9956a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * should not generally worry about this density; relying on XHIGH graphics 10056a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * being scaled up to it should be sufficient for almost all cases. A typical 10156a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * use of this density would be 4K television screens -- 3840x2160, which 10256a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * is 2x a traditional HD 1920x1080 screen which runs at DENSITY_XHIGH. 10356a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn */ 10456a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn public static final int DENSITY_XXXHIGH = 640; 10556a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn 10656a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn /** 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The reference density used throughout the system. 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 109a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn public static final int DENSITY_DEFAULT = DENSITY_MEDIUM; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1112e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima /** 112908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * Scaling factor to convert a density in DPI units to the density scale. 113908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide 114908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn */ 115908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn public static final float DENSITY_DEFAULT_SCALE = 1.0f / DENSITY_DEFAULT; 116908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn 117908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn /** 1182e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima * The device's density. 119908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide because eventually this should be able to change while 120a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * running, so shouldn't be a constant. 121908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @deprecated There is no longer a static density; you can find the 122908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * density for a display in {@link #densityDpi}. 1232e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima */ 124908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn @Deprecated 125dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static int DENSITY_DEVICE = getDeviceDensity(); 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The absolute width of the display in pixels. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int widthPixels; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The absolute height of the display in pixels. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int heightPixels; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The logical density of the display. This is a scaling factor for the 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Density Independent Pixel unit, where one DIP is one pixel on an 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * approximately 160 dpi screen (for example a 240x320, 1.5"x2" screen), 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * providing the baseline of the system's display. Thus on a 160dpi screen 1406b13bc043e715b5415b701e93141daa0d49fa364Dirk Dougherty * this density value will be 1; on a 120 dpi screen it would be .75; etc. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This value does not exactly follow the real screen size (as given by 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #xdpi} and {@link #ydpi}, but rather is used to scale the size of 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall UI in steps based on gross changes in the display dpi. For 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, a 240x320 screen will have a density of 1 even if its width is 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1.8", 1.3", etc. However, if the screen resolution is increased to 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 320x480 but the screen size remained 1.5"x2" then the density would be 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * increased (probably to 1.5). 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 150a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see #DENSITY_DEFAULT 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float density; 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * The screen density expressed as dots-per-inch. May be either 15511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * {@link #DENSITY_LOW}, {@link #DENSITY_MEDIUM}, or {@link #DENSITY_HIGH}. 15611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 15711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int densityDpi; 15811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A scaling factor for fonts displayed on the display. This is the same 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as {@link #density}, except that it may be adjusted in smaller 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * increments at runtime based on a user preference for the font size. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float scaledDensity; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The exact physical pixels per inch of the screen in the X dimension. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float xdpi; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The exact physical pixels per inch of the screen in the Y dimension. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float ydpi; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17381e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 17481e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * The reported display width prior to any compatibility mode scaling 17581e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * being applied. 17681e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * @hide 17781e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 1782b31d53161789358de57fd396716a6503855c5daDianne Hackborn public int noncompatWidthPixels; 17981e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 18081e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * The reported display height prior to any compatibility mode scaling 18181e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * being applied. 18281e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * @hide 18381e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 1842b31d53161789358de57fd396716a6503855c5daDianne Hackborn public int noncompatHeightPixels; 1852b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 1862b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display density prior to any compatibility mode scaling 1872b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 1882b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 1892b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 1902b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatDensity; 1912b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 192908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * The reported display density prior to any compatibility mode scaling 193908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * being applied. 194908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide 195908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn */ 196908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn public int noncompatDensityDpi; 197908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn /** 1982b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported scaled density prior to any compatibility mode scaling 1992b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2002b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2012b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2022b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatScaledDensity; 2032b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2042b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display xdpi prior to any compatibility mode scaling 2052b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2062b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2072b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2082b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatXdpi; 2092b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2102b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display ydpi prior to any compatibility mode scaling 2112b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2122b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2132b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2142b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatYdpi; 215e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DisplayMetrics() { 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTo(DisplayMetrics o) { 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project widthPixels = o.widthPixels; 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project heightPixels = o.heightPixels; 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project density = o.density; 22311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn densityDpi = o.densityDpi; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scaledDensity = o.scaledDensity; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project xdpi = o.xdpi; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ydpi = o.ydpi; 2272b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatWidthPixels = o.noncompatWidthPixels; 2282b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatHeightPixels = o.noncompatHeightPixels; 2292b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatDensity = o.noncompatDensity; 230908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn noncompatDensityDpi = o.noncompatDensityDpi; 2312b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatScaledDensity = o.noncompatScaledDensity; 2322b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatXdpi = o.noncompatXdpi; 2332b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatYdpi = o.noncompatYdpi; 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setToDefaults() { 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project widthPixels = 0; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project heightPixels = 0; 239a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown density = DENSITY_DEVICE / (float) DENSITY_DEFAULT; 240a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown densityDpi = DENSITY_DEVICE; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scaledDensity = density; 242a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown xdpi = DENSITY_DEVICE; 243a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown ydpi = DENSITY_DEVICE; 244a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatWidthPixels = widthPixels; 245a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatHeightPixels = heightPixels; 246a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatDensity = density; 247a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatDensityDpi = densityDpi; 248a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatScaledDensity = scaledDensity; 249a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatXdpi = xdpi; 250a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatYdpi = ydpi; 251a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 252a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 253a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown @Override 254a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public boolean equals(Object o) { 255a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return o instanceof DisplayMetrics && equals((DisplayMetrics)o); 256a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 257a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 258a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown /** 259a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * Returns true if these display metrics equal the other display metrics. 260a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * 261a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * @param other The display metrics with which to compare. 262a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * @return True if the display metrics are equal. 263a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown */ 264a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public boolean equals(DisplayMetrics other) { 2657ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn return equalsPhysical(other) 2667ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn && scaledDensity == other.scaledDensity 2677ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn && noncompatScaledDensity == other.noncompatScaledDensity; 2687ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn } 2697ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn 2707ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn /** 2717ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * Returns true if the physical aspects of the two display metrics 2727ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * are equal. This ignores the scaled density, which is a logical 2737ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * attribute based on the current desired font size. 2747ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * 2757ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @param other The display metrics with which to compare. 2767ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @return True if the display metrics are equal. 2777ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @hide 2787ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn */ 2797ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn public boolean equalsPhysical(DisplayMetrics other) { 280a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return other != null 281a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && widthPixels == other.widthPixels 282a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && heightPixels == other.heightPixels 283a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && density == other.density 284a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && densityDpi == other.densityDpi 285a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && xdpi == other.xdpi 286a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && ydpi == other.ydpi 287a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatWidthPixels == other.noncompatWidthPixels 288a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatHeightPixels == other.noncompatHeightPixels 289a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatDensity == other.noncompatDensity 290a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatDensityDpi == other.noncompatDensityDpi 291a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatXdpi == other.noncompatXdpi 292a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatYdpi == other.noncompatYdpi; 293a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 294a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 295a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown @Override 296a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public int hashCode() { 297a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return widthPixels * heightPixels * densityDpi; 29858feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima } 29958feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima 30064f59342d41849bd365cb43fad7505d5e3daa417Mitsuru Oshima @Override 30158feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima public String toString() { 30258feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima return "DisplayMetrics{density=" + density + ", width=" + widthPixels + 30358feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima ", height=" + heightPixels + ", scaledDensity=" + scaledDensity + 30458feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima ", xdpi=" + xdpi + ", ydpi=" + ydpi + "}"; 30558feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima } 3062a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner 3072a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner private static int getDeviceDensity() { 3082a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // qemu.sf.lcd_density can be used to override ro.sf.lcd_density 3092a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // when running in the emulator, allowing for dynamic configurations. 3102a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // The reason for this is that ro.sf.lcd_density is write-once and is 3112a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // set by the init process when it parses build.prop before anything else. 3122a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner return SystemProperties.getInt("qemu.sf.lcd_density", 313a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn SystemProperties.getInt("ro.sf.lcd_density", DENSITY_DEFAULT)); 3142a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner } 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 316