HDR Diagnostics
Debugging and data-export tools for the HDR tone-mapping pipeline.
Available Tools
Log Metering Values
| Property | Value |
|---|---|
| Type | Toggle (On / Off) |
| Default | Off |
When enabled, the following metering values are printed to the console every frame:
- EV — exposure value
- max_i — maximum scene intensity
- min_i — minimum scene intensity
- content_peak — detected content peak luminance
Useful for verifying that peak detection and exposure tracking behave as expected during live playback.
Export EV History to CSV
| Property | Value |
|---|---|
| Type | Action |
Exports the accumulated exposure-value metering history to a CSV file. Use this to analyse metering behaviour over time in a spreadsheet or plotting tool.
Not Yet Implemented
This action is planned but not yet functional.
Export Histogram to CSV
| Property | Value |
|---|---|
| Type | Action |
Exports the current frame histogram data to a CSV file. Helpful for offline analysis of luminance distribution.
Not Yet Implemented
This action is planned but not yet functional.
Debug Visualization Modes
These toggles are available via the diagnostic server REST API and dashboard. They are not exposed in the on-screen menu.
| Setting | Config Key | Default | Description |
|---|---|---|---|
| X-Ray Heatmap | void_xray_enabled | Off | Renders a luminance heatmap overlay showing tone curve compression regions |
| Specular Debug | void_specular_debug | Off | Highlights specular pixels (above tone curve knee) in magenta |
| Mipmap Debug | void_mipmap_debug | Off | Displays the blurred mipmap luminance texture fullscreen |
| Metering Debug | void_debug_metering | Off | Logs metering values to console every frame |
| Visualize LUT | visualize_lut | Off | Show 3D LUT visualization |
| Visualize Gamut | visualize_gamut | Off | Show gamut boundary visualization |
| Gamut Viz Mode | visualize_gamut_mode | rgb | Visualization color space: rgb, oklch, ictcp |
Recommended Settings
For day-to-day use, leave all debug toggles off — they add overhead and alter the image. Enable them temporarily when diagnosing tone-mapping issues such as unexpected brightness shifts, clipping, or gamut mapping artifacts.
Menu Path
Main Menu > HDR Settings > Diagnostics