DisplayMetrics.java revision 1e9c51a00aeb8c0bc6be170a4615cf2959c4f032
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 */ 82f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell public static final int DENSITY_360 = 360; 83f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell 84f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell /** 85f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell * Intermediate density for screens that sit somewhere between 86f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell * {@link #DENSITY_XHIGH} (320 dpi) and {@link #DENSITY_XXHIGH} (480 dpi). 87f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell * This is not a density that applications should target, instead relying 88f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell * on the system to scale their {@link #DENSITY_XXHIGH} assets for them. 89f6d9cd19e28d78fe3f46914959932ea1244b04edAdam Powell */ 9009acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn public static final int DENSITY_400 = 400; 9109acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn 9209acb7ca897c9f49dd65b7173688e4ca63ca5dd3Dianne Hackborn /** 931e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn * Intermediate density for screens that sit somewhere between 941e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn * {@link #DENSITY_XHIGH} (320 dpi) and {@link #DENSITY_XXHIGH} (480 dpi). 951e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn * This is not a density that applications should target, instead relying 961e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn * on the system to scale their {@link #DENSITY_XXHIGH} assets for them. 971e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn */ 981e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn public static final int DENSITY_420 = 420; 991e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn 1001e9c51a00aeb8c0bc6be170a4615cf2959c4f032Dianne Hackborn /** 10161a5a3f2c38ca908b7a607e7bc19b8553f59780eJeff Davidson * Standard quantized DPI for extra-extra-high-density screens. 102d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn */ 103d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn public static final int DENSITY_XXHIGH = 480; 104d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn 105d96e3dfa02b203b1fc826e80d6f9aa074ba9c250Dianne Hackborn /** 106a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * Intermediate density for screens that sit somewhere between 107d561913798c6ee3c987f39fa19f70e53eeb93ce6Philip Nowell * {@link #DENSITY_XXHIGH} (480 dpi) and {@link #DENSITY_XXXHIGH} (640 dpi). 108a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * This is not a density that applications should target, instead relying 109a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn * on the system to scale their {@link #DENSITY_XXXHIGH} assets for them. 110a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn */ 111a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn public static final int DENSITY_560 = 560; 112a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn 113a3fb40d5f492825bb86769f541620baca5616e05Dianne Hackborn /** 11456a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * Standard quantized DPI for extra-extra-extra-high-density screens. Applications 11556a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * should not generally worry about this density; relying on XHIGH graphics 11656a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * being scaled up to it should be sufficient for almost all cases. A typical 11756a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * use of this density would be 4K television screens -- 3840x2160, which 11856a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn * is 2x a traditional HD 1920x1080 screen which runs at DENSITY_XHIGH. 11956a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn */ 12056a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn public static final int DENSITY_XXXHIGH = 640; 12156a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn 12256a2301c7a1169a0692cadaeb48b9a6385d700f5Dianne Hackborn /** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The reference density used throughout the system. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 125a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn public static final int DENSITY_DEFAULT = DENSITY_MEDIUM; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1272e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima /** 128908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * Scaling factor to convert a density in DPI units to the density scale. 129908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide 130908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn */ 131908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn public static final float DENSITY_DEFAULT_SCALE = 1.0f / DENSITY_DEFAULT; 132908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn 133908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn /** 1342e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima * The device's density. 135908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide because eventually this should be able to change while 136a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * running, so shouldn't be a constant. 137908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @deprecated There is no longer a static density; you can find the 138908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * density for a display in {@link #densityDpi}. 1392e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima */ 140908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn @Deprecated 141dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static int DENSITY_DEVICE = getDeviceDensity(); 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The absolute width of the display in pixels. 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int widthPixels; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The absolute height of the display in pixels. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int heightPixels; 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The logical density of the display. This is a scaling factor for the 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Density Independent Pixel unit, where one DIP is one pixel on an 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * approximately 160 dpi screen (for example a 240x320, 1.5"x2" screen), 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * providing the baseline of the system's display. Thus on a 160dpi screen 1566b13bc043e715b5415b701e93141daa0d49fa364Dirk Dougherty * this density value will be 1; on a 120 dpi screen it would be .75; etc. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This value does not exactly follow the real screen size (as given by 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #xdpi} and {@link #ydpi}, but rather is used to scale the size of 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall UI in steps based on gross changes in the display dpi. For 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, a 240x320 screen will have a density of 1 even if its width is 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1.8", 1.3", etc. However, if the screen resolution is increased to 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 320x480 but the screen size remained 1.5"x2" then the density would be 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * increased (probably to 1.5). 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 166a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see #DENSITY_DEFAULT 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float density; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * The screen density expressed as dots-per-inch. May be either 17111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * {@link #DENSITY_LOW}, {@link #DENSITY_MEDIUM}, or {@link #DENSITY_HIGH}. 17211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 17311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int densityDpi; 17411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A scaling factor for fonts displayed on the display. This is the same 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as {@link #density}, except that it may be adjusted in smaller 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * increments at runtime based on a user preference for the font size. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float scaledDensity; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The exact physical pixels per inch of the screen in the X dimension. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float xdpi; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The exact physical pixels per inch of the screen in the Y dimension. 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float ydpi; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18981e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 19081e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * The reported display width prior to any compatibility mode scaling 19181e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * being applied. 19281e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * @hide 19381e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 1942b31d53161789358de57fd396716a6503855c5daDianne Hackborn public int noncompatWidthPixels; 19581e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 19681e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * The reported display height prior to any compatibility mode scaling 19781e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * being applied. 19881e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * @hide 19981e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 2002b31d53161789358de57fd396716a6503855c5daDianne Hackborn public int noncompatHeightPixels; 2012b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2022b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display density prior to any compatibility mode scaling 2032b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2042b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2052b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2062b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatDensity; 2072b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 208908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * The reported display density prior to any compatibility mode scaling 209908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * being applied. 210908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide 211908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn */ 212908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn public int noncompatDensityDpi; 213908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn /** 2142b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported scaled density prior to any compatibility mode scaling 2152b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2162b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2172b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2182b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatScaledDensity; 2192b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2202b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display xdpi prior to any compatibility mode scaling 2212b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2222b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2232b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2242b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatXdpi; 2252b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2262b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display ydpi prior to any compatibility mode scaling 2272b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2282b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2292b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2302b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatYdpi; 231e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DisplayMetrics() { 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTo(DisplayMetrics o) { 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project widthPixels = o.widthPixels; 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project heightPixels = o.heightPixels; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project density = o.density; 23911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn densityDpi = o.densityDpi; 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scaledDensity = o.scaledDensity; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project xdpi = o.xdpi; 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ydpi = o.ydpi; 2432b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatWidthPixels = o.noncompatWidthPixels; 2442b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatHeightPixels = o.noncompatHeightPixels; 2452b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatDensity = o.noncompatDensity; 246908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn noncompatDensityDpi = o.noncompatDensityDpi; 2472b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatScaledDensity = o.noncompatScaledDensity; 2482b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatXdpi = o.noncompatXdpi; 2492b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatYdpi = o.noncompatYdpi; 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setToDefaults() { 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project widthPixels = 0; 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project heightPixels = 0; 255a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown density = DENSITY_DEVICE / (float) DENSITY_DEFAULT; 256a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown densityDpi = DENSITY_DEVICE; 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scaledDensity = density; 258a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown xdpi = DENSITY_DEVICE; 259a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown ydpi = DENSITY_DEVICE; 260a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatWidthPixels = widthPixels; 261a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatHeightPixels = heightPixels; 262a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatDensity = density; 263a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatDensityDpi = densityDpi; 264a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatScaledDensity = scaledDensity; 265a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatXdpi = xdpi; 266a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatYdpi = ydpi; 267a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 268a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 269a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown @Override 270a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public boolean equals(Object o) { 271a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return o instanceof DisplayMetrics && equals((DisplayMetrics)o); 272a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 273a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 274a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown /** 275a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * Returns true if these display metrics equal the other display metrics. 276a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * 277a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * @param other The display metrics with which to compare. 278a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * @return True if the display metrics are equal. 279a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown */ 280a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public boolean equals(DisplayMetrics other) { 2817ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn return equalsPhysical(other) 2827ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn && scaledDensity == other.scaledDensity 2837ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn && noncompatScaledDensity == other.noncompatScaledDensity; 2847ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn } 2857ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn 2867ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn /** 2877ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * Returns true if the physical aspects of the two display metrics 2887ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * are equal. This ignores the scaled density, which is a logical 2897ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * attribute based on the current desired font size. 2907ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * 2917ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @param other The display metrics with which to compare. 2927ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @return True if the display metrics are equal. 2937ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @hide 2947ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn */ 2957ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn public boolean equalsPhysical(DisplayMetrics other) { 296a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return other != null 297a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && widthPixels == other.widthPixels 298a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && heightPixels == other.heightPixels 299a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && density == other.density 300a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && densityDpi == other.densityDpi 301a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && xdpi == other.xdpi 302a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && ydpi == other.ydpi 303a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatWidthPixels == other.noncompatWidthPixels 304a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatHeightPixels == other.noncompatHeightPixels 305a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatDensity == other.noncompatDensity 306a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatDensityDpi == other.noncompatDensityDpi 307a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatXdpi == other.noncompatXdpi 308a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatYdpi == other.noncompatYdpi; 309a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 310a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 311a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown @Override 312a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public int hashCode() { 313a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return widthPixels * heightPixels * densityDpi; 31458feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima } 31558feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima 31664f59342d41849bd365cb43fad7505d5e3daa417Mitsuru Oshima @Override 31758feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima public String toString() { 31858feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima return "DisplayMetrics{density=" + density + ", width=" + widthPixels + 31958feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima ", height=" + heightPixels + ", scaledDensity=" + scaledDensity + 32058feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima ", xdpi=" + xdpi + ", ydpi=" + ydpi + "}"; 32158feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima } 3222a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner 3232a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner private static int getDeviceDensity() { 3242a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // qemu.sf.lcd_density can be used to override ro.sf.lcd_density 3252a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // when running in the emulator, allowing for dynamic configurations. 3262a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // The reason for this is that ro.sf.lcd_density is write-once and is 3272a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // set by the init process when it parses build.prop before anything else. 3282a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner return SystemProperties.getInt("qemu.sf.lcd_density", 329a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn SystemProperties.getInt("ro.sf.lcd_density", DENSITY_DEFAULT)); 3302a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner } 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 332