Status: Implemented and tested

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.

Critical Caveat: Panel Resolution != Panel Quality

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 in xdpi can 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 densityDpi into standard Android buckets (mdpi 160, hdpi 240, xhdpi 320, xxhdpi 480, xxxhdpi 640).

4. Availability-State Triggers

  • Display.getSupportedModes() on Android < 6.0 triggers AvailabilityState.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