HDR Post-Processing

Initializes the HDR post-processing chain (bright pass, downscale, luminance, combine) on first update. Creates engine-level PostEffect objects if they don't already exist.

Public API

Internals

Post-Effect Chain (created in order)

How It Works

1. onFirstUpdate checks for null graphics device - skips if running headless
2. Looks up each post-effect object in the scene tree via scenetree.findObject
3. Creates missing objects with createObject() and registers them
4. DownScale, Luminance, and CombinePass are added as children of BrightPass
5. The initialized flag prevents re-creation across hot-reloads

Usage Examples

-- Normally loaded automatically by the engine render pipeline
-- The extension creates objects once and they persist in the scene tree

-- Check if bright pass exists
local bp = scenetree.findObject("PostEffectBrightPassObject")
if bp then
  -- HDR chain is initialized
end

Key Notes

• Idempotent: safe to call multiple times - only creates objects that don't exist
• Skips initialization if a null graphics adapter is detected (headless/server mode)
• All four post-effect objects form the bloom/HDR pipeline
• Target scale of 0.5 0.5 means half-resolution render targets for performance

See Also

• Render OpenXR - VR/XR Runtime Management - Related reference
• Render Views - Offscreen Camera Screenshots - Related reference
• Render View Demo - Render View Usage Example - Related reference
• Game Engine Overview - Guide