Tone Mapping
Tone mapping is the process of converting the wide range of brightness in HDR images to a range that can be expressed on standard monitors. It acts as the Entry Point of the post-processing pipeline and determines the overall atmosphere of the scene.
1. ToneMappingManager
All settings are made through view.toneMappingManager. It is automatically included when View3D is created, so no separate instance creation is necessary.
Default Settings
RedGPU adopts Khronos PBR Neutral, optimized for physically based rendering, as its default algorithm.
| Property | Default Value | Description |
|---|---|---|
mode | KHRONOS_PBR_NEUTRAL | Tone mapping algorithm (RedGPU.ToneMapping.TONE_MAPPING_MODE) |
exposure | 1.0 | Exposure value (brightness intensity) |
contrast | 1.0 | Brightness contrast (0.0 ~ 2.0) |
brightness | 0.0 | Brightness correction (-1.0 ~ 1.0) |
2. Changing Settings
2.1 Tone Mapping Mode (mode)
Select the algorithm according to the desired visual style. All constant values are defined in the RedGPU.ToneMapping.TONE_MAPPING_MODE object.
javascript
// Apply strong contrast and cinematic color like a movie
view.toneMappingManager.mode = RedGPU.ToneMapping.TONE_MAPPING_MODE.ACES_FILMIC_HILL;Available Mode Constants and Visual Differences:
| Mode (Constant) | Description | Comparison Image |
|---|---|---|
| LINEAR | Linear transformation without correction |  |
| KHRONOS_PBR_NEUTRAL | Physically based standard (Default) |  |
| ACES_FILMIC_HILL | Cinematic contrast (Hill version) |  |
| ACES_FILMIC_NARKOWICZ | Cinematic contrast (Narkowicz version) |  |
2.2 Adjusting Detailed Properties
javascript
const tm = view.toneMappingManager;
tm.exposure = 1.2; // Increase overall exposure
tm.contrast = 1.05; // Fine-tune brightness contrast
tm.brightness = 0.02; // Correct shadow brightnessKey Summary
- Tone mapping is managed with separate configuration (
ToneMappingManager) and execution (PostEffectManager). - Executed at the very first stage of the post-processing pipeline.
- A core window for controlling exposure and contrast that determines the first impression of the scene.