DisplayMetrics.java revision d7bbc8a92f101575d92dee1bbc47519c36666bd1
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 /** 134d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * The device's current density. 135d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * <p> 136d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * This value reflects any changes made to the device density. To obtain 137d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * the device's stable density, use {@link #DENSITY_DEVICE_STABLE}. 138d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * 139d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * @hide This value should not be used. 140d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * @deprecated Use {@link #DENSITY_DEVICE_STABLE} to obtain the stable 141d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * device density or {@link #densityDpi} to obtain the current 142d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * density for a specific display. 1432e3d3b9ce74cb9c906e5cc0e9898d757d45c4237Mitsuru Oshima */ 144908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn @Deprecated 145dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static int DENSITY_DEVICE = getDeviceDensity(); 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 148d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * The device's stable density. 149d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * <p> 150d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * This value is constant at run time and may not reflect the current 151d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * display density. To obtain the current density for a specific display, 152d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette * use {@link #densityDpi}. 153d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette */ 154d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette public static final int DENSITY_DEVICE_STABLE = getDeviceDensity(); 155d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette 156d7bbc8a92f101575d92dee1bbc47519c36666bd1Alan Viverette /** 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The absolute width of the display in pixels. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int widthPixels; 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The absolute height of the display in pixels. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int heightPixels; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The logical density of the display. This is a scaling factor for the 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Density Independent Pixel unit, where one DIP is one pixel on an 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * approximately 160 dpi screen (for example a 240x320, 1.5"x2" screen), 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * providing the baseline of the system's display. Thus on a 160dpi screen 1696b13bc043e715b5415b701e93141daa0d49fa364Dirk Dougherty * this density value will be 1; on a 120 dpi screen it would be .75; etc. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This value does not exactly follow the real screen size (as given by 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #xdpi} and {@link #ydpi}, but rather is used to scale the size of 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall UI in steps based on gross changes in the display dpi. For 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * example, a 240x320 screen will have a density of 1 even if its width is 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1.8", 1.3", etc. However, if the screen resolution is increased to 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 320x480 but the screen size remained 1.5"x2" then the density would be 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * increased (probably to 1.5). 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 179a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see #DENSITY_DEFAULT 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float density; 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * The screen density expressed as dots-per-inch. May be either 18411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * {@link #DENSITY_LOW}, {@link #DENSITY_MEDIUM}, or {@link #DENSITY_HIGH}. 18511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 18611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int densityDpi; 18711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A scaling factor for fonts displayed on the display. This is the same 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as {@link #density}, except that it may be adjusted in smaller 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * increments at runtime based on a user preference for the font size. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float scaledDensity; 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The exact physical pixels per inch of the screen in the X dimension. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float xdpi; 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The exact physical pixels per inch of the screen in the Y dimension. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float ydpi; 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20281e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 20381e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * The reported display width prior to any compatibility mode scaling 20481e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * being applied. 20581e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * @hide 20681e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 2072b31d53161789358de57fd396716a6503855c5daDianne Hackborn public int noncompatWidthPixels; 20881e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 20981e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * The reported display height prior to any compatibility mode scaling 21081e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * being applied. 21181e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * @hide 21281e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 2132b31d53161789358de57fd396716a6503855c5daDianne Hackborn public int noncompatHeightPixels; 2142b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2152b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display density prior to any compatibility mode scaling 2162b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2172b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2182b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2192b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatDensity; 2202b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 221908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * The reported display density prior to any compatibility mode scaling 222908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * being applied. 223908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn * @hide 224908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn */ 225908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn public int noncompatDensityDpi; 226908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn /** 2272b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported scaled density prior to any compatibility mode scaling 2282b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2292b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2302b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2312b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatScaledDensity; 2322b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2332b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display xdpi prior to any compatibility mode scaling 2342b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2352b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2362b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2372b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatXdpi; 2382b31d53161789358de57fd396716a6503855c5daDianne Hackborn /** 2392b31d53161789358de57fd396716a6503855c5daDianne Hackborn * The reported display ydpi prior to any compatibility mode scaling 2402b31d53161789358de57fd396716a6503855c5daDianne Hackborn * being applied. 2412b31d53161789358de57fd396716a6503855c5daDianne Hackborn * @hide 2422b31d53161789358de57fd396716a6503855c5daDianne Hackborn */ 2432b31d53161789358de57fd396716a6503855c5daDianne Hackborn public float noncompatYdpi; 244e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DisplayMetrics() { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTo(DisplayMetrics o) { 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project widthPixels = o.widthPixels; 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project heightPixels = o.heightPixels; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project density = o.density; 25211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn densityDpi = o.densityDpi; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scaledDensity = o.scaledDensity; 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project xdpi = o.xdpi; 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ydpi = o.ydpi; 2562b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatWidthPixels = o.noncompatWidthPixels; 2572b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatHeightPixels = o.noncompatHeightPixels; 2582b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatDensity = o.noncompatDensity; 259908aecc3a63c5520d5b11da14a9383f885b7d126Dianne Hackborn noncompatDensityDpi = o.noncompatDensityDpi; 2602b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatScaledDensity = o.noncompatScaledDensity; 2612b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatXdpi = o.noncompatXdpi; 2622b31d53161789358de57fd396716a6503855c5daDianne Hackborn noncompatYdpi = o.noncompatYdpi; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setToDefaults() { 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project widthPixels = 0; 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project heightPixels = 0; 268a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown density = DENSITY_DEVICE / (float) DENSITY_DEFAULT; 269a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown densityDpi = DENSITY_DEVICE; 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scaledDensity = density; 271a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown xdpi = DENSITY_DEVICE; 272a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown ydpi = DENSITY_DEVICE; 273a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatWidthPixels = widthPixels; 274a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatHeightPixels = heightPixels; 275a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatDensity = density; 276a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatDensityDpi = densityDpi; 277a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatScaledDensity = scaledDensity; 278a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatXdpi = xdpi; 279a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown noncompatYdpi = ydpi; 280a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 281a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 282a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown @Override 283a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public boolean equals(Object o) { 284a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return o instanceof DisplayMetrics && equals((DisplayMetrics)o); 285a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 286a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 287a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown /** 288a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * Returns true if these display metrics equal the other display metrics. 289a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * 290a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * @param other The display metrics with which to compare. 291a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown * @return True if the display metrics are equal. 292a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown */ 293a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public boolean equals(DisplayMetrics other) { 2947ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn return equalsPhysical(other) 2957ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn && scaledDensity == other.scaledDensity 2967ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn && noncompatScaledDensity == other.noncompatScaledDensity; 2977ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn } 2987ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn 2997ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn /** 3007ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * Returns true if the physical aspects of the two display metrics 3017ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * are equal. This ignores the scaled density, which is a logical 3027ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * attribute based on the current desired font size. 3037ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * 3047ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @param other The display metrics with which to compare. 3057ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @return True if the display metrics are equal. 3067ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn * @hide 3077ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn */ 3087ac8bbddfcaa2539f6311be54323d22f2dcc4a35Dianne Hackborn public boolean equalsPhysical(DisplayMetrics other) { 309a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return other != null 310a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && widthPixels == other.widthPixels 311a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && heightPixels == other.heightPixels 312a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && density == other.density 313a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && densityDpi == other.densityDpi 314a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && xdpi == other.xdpi 315a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && ydpi == other.ydpi 316a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatWidthPixels == other.noncompatWidthPixels 317a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatHeightPixels == other.noncompatHeightPixels 318a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatDensity == other.noncompatDensity 319a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatDensityDpi == other.noncompatDensityDpi 320a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatXdpi == other.noncompatXdpi 321a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown && noncompatYdpi == other.noncompatYdpi; 322a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown } 323a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown 324a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown @Override 325a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown public int hashCode() { 326a492c3a7b2c18426fd0cb4d017eacbc368195dc5Jeff Brown return widthPixels * heightPixels * densityDpi; 32758feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima } 32858feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima 32964f59342d41849bd365cb43fad7505d5e3daa417Mitsuru Oshima @Override 33058feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima public String toString() { 33158feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima return "DisplayMetrics{density=" + density + ", width=" + widthPixels + 33258feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima ", height=" + heightPixels + ", scaledDensity=" + scaledDensity + 33358feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima ", xdpi=" + xdpi + ", ydpi=" + ydpi + "}"; 33458feea74b42bbaaa0552d76af23873bdd0b5dca2Mitsuru Oshima } 3352a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner 3362a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner private static int getDeviceDensity() { 3372a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // qemu.sf.lcd_density can be used to override ro.sf.lcd_density 3382a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // when running in the emulator, allowing for dynamic configurations. 3392a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // The reason for this is that ro.sf.lcd_density is write-once and is 3402a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner // set by the init process when it parses build.prop before anything else. 3412a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner return SystemProperties.getInt("qemu.sf.lcd_density", 342a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn SystemProperties.getInt("ro.sf.lcd_density", DENSITY_DEFAULT)); 3432a578ae518ff3d8a2d4768b3d190e4702509e82cDavid 'Digit' Turner } 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 345