This HDR Calibration Sample project shows how an HDR calibration menu with Neutral Tonemapping can be implemented.
Requirement:
Function | Mouse / Touch | Keyboard | Game Controller |
---|---|---|---|
Menu Item Select | Click on-screen buttons | Arrow keys | D-Pad Up/Down |
Confirm | Click on-screen buttons | Enter | South Button |
Back | Click on-screen buttons | Esc / Backspace | East Button |
Show/Hide UI | Click on-screen buttons | Tab | North Button |
Display Info | Click on-screen buttons | Shift | West Button |
Switch Sample Images | Click on-screen buttonsSwipe left/right | PageUp / PageDown | Left/Right TriggerLeft/Right Shoulder |
HDROutputSettings
API paperWhiteNits
, minToneMapLuminance
and maxToneMapLuminance
values.HDROutputSettings
API couldnt detect the luminance values, the default will be a set of hard-coded values.The HDR Calibration Sample comes with a few .EXR images captured from the HDRP template project. The images showcase some outdoor (bright) and indoor (dark) environments. When you are implementing your own calibration scenes, you should use the brightest and darkest environments in your project. These images are useful for users to adjust the brightness values to make the bright part not overexposed, dark part not completely invisible, and the UI is still clear to read.
The popup prints the important information using the HDROutputSettings
API.
Note that the luminance values might change according to screen brightness, and is only effective on player start (i.e. if you change screen brightness while player is running, you will have to restart the player to refresh the value).
For more information about HDROutputSettings API, visit documentation.
If GameView or player is not running in HDR, the popup will appear and indicate possible reasons of why HDR is not available.
The full-screen calibration allows users to calibrate the tonemapping values with max/min brightness. It has 3 pages:
The HDRCalibrationSample" also showcases the setup for camera stacking. In order for HDR rendering to work, all cameras need to be in the same color space. Therefore, make sure Tonemapping is only applied on the last camera on the camera stack. In the HDRCalibrationSample scene, there is:
Open the SpectrumTestScene scene and this scene is useful for testing the colors on the display.