Screen & Display Subsystem
Display inspection reveals the true optical and geometric properties of an Android device: physical hardware panel pixels, logical usable viewport bounds, pixel density (DPI), refresh rate modes, and High Dynamic Range (HDR) standards.
Physical Panel Resolution vs. Logical Usable Resolution
Standard Android apps querying DisplayMetrics often receive smaller numbers (e.g. 1080x2130 instead of 1080x2280) because the OS subtracts system window insets, navigation bars, and display cutouts. Under modern Android (API 17+), Voodoo queries Display.getRealMetrics() to reveal the full physical pixel grid of the glass panel.
Software diagnostic tools can measure pixel count, refresh rate, and color gamut support, but cannot evaluate physical optical quality: subpixel matrix layout (e.g. Diamond Pentile vs RGB stripe), panel technology (IPS LCD vs Super AMOLED vs LTPO), color calibration accuracy (Delta E), contrast ratio, or Pulse-Width Modulation (PWM) dimming flicker.
How Voodoo Inspects Display Characteristics
1. Primary Call & API-Level Fallback Chain
Extracted from ScreenCollector.kt. Uses Display.getRealMetrics() (API 17+), falling back to standard getMetrics() on legacy Android, with reflection-based helpers for API 23+ display modes and API 24+ HDR capabilities:
// Excerpt from com.tool3.hardwareinfo.categories.screen.ScreenCollector.kt
val windowManager = context.getSystemService(Context.WINDOW_SERVICE) as WindowManager
val display = windowManager.defaultDisplay
// Real physical panel pixels (API 17+) vs legacy logical
val realMetrics = DisplayMetrics()
if (Build.VERSION.SDK_INT >= 17) {
ModernScreenHelper.getRealMetrics(display, realMetrics)
} else {
display.getMetrics(realMetrics)
}
// Supported Display Modes (Resolution & Refresh Rates on API 23+)
val supportedModes = if (Build.VERSION.SDK_INT >= 23) {
ModernScreenHelper.getSupportedModes(display)
} else {
emptyList()
}
// HDR Capabilities (HDR10, HLG, Dolby Vision on API 24+)
val hdrTypes = if (Build.VERSION.SDK_INT >= 24) {
ModernScreenHelper.getHdrCapabilities(display)
} else {
emptyList()
}
2. Permission & Privilege Gate
Display querying requires zero permissions. All properties are exposed safely through Android's WindowManager and Display services.
3. Interpretation & Normalization Logic
- Physical Diagonal Calculation: Uses exact horizontal (
xdpi) and vertical (ydpi) pixel density to compute physical screen width and height in inches:sqrt((width/xdpi)² + (height/ydpi)²). Note: OEM calibration errors inxdpican yield slight geometric variance. - Aspect Ratio Resolver: Divides dimensions by greatest common divisor (GCD) or matches standard ratios (16:9, 18:9, 19.5:9, 20:9, 4:3).
- Density Bucket Classification: Maps
densityDpiinto standard Android buckets (mdpi160,hdpi240,xhdpi320,xxhdpi480,xxxhdpi640).
4. Availability-State Triggers
Display.getSupportedModes()on Android < 6.0 triggersAvailabilityState.UNSUPPORTED.- HDR capabilities on Android < 7.0 trigger
AvailabilityState.UNSUPPORTED; on supported OS without HDR hardware, reports empty list cleanly.
Subsystem Field Inventory
| Field ID | Display Name | Type | Primary Source / API | Min API |
|---|---|---|---|---|
| screen.physical_resolution | Physical Panel Resolution | STRING | Display.getRealMetrics() (API 17+) | API 17 |
| screen.usable_resolution | Logical Usable Resolution | STRING | Display.getMetrics() | API 1 |
| screen.density_dpi | Screen Density (DPI) | INTEGER | DisplayMetrics.densityDpi | API 4 |
| screen.density_bucket | Density Bucket | STRING | DPI Bucket Classification (xxhdpi, etc.) | API 4 |
| screen.refresh_rate | Refresh Rate (Hz) | FLOAT | Display.getRefreshRate() | API 1 |
| screen.physical_size_inches | Physical Diagonal Size | STRING | Calculated via xdpi / ydpi geometric formula | API 1 |
| screen.hdr_capabilities | HDR Capabilities | LIST | Display.getHdrCapabilities() (API 24+) | API 24 |
| screen.supported_modes | Supported Display Modes | LIST | Display.getSupportedModes() (API 23+) | API 23 |