OptionalskyOptionalshadowCascaded directional shadow map. false skips the feature; a config object
is forwarded to ShadowFeature. Default: enabled.
OptionaliblBaked IBL textures, forwarded to the deferred lighting pass.
OptionalaoAO method; false skips the AO feature entirely. Default: 'ssao'.
OptionalocclusionOpt-in GPU occlusion culling for the deferred geometry pass (default
off). Builds a Hi-Z pyramid each frame and uses it the next frame to skip
opaque draws hidden behind earlier geometry (via drawIndexedIndirect).
Previous-frame Hi-Z → one frame of latency; conservative (never over-culls).
Helps heavy-occlusion scenes (terrain, cities, streamed geo tiles); a no-op
cost for small/open scenes. See GeometryFeatureOptions.occlusionCull.
OptionalssgiEnable screen-space global illumination. Pass true for defaults or a
partial settings object. Inserted between AO and deferred lighting so
the SSGI result feeds the indirect-diffuse term. Default: disabled.
OptionaltransparentRegister the ForwardOverlayFeature for transparent meshes. Default: true.
OptionaloverlayWhich forward pass shades the transparency overlay:
'forward' (default) — plain ForwardPass; cheap with a small
point-light count.'forward+' — ForwardPlusPass sharing the deferred gbuffer
depth for tile culling. Worth it once transparents need to see many
point lights.
Ignored when transparent is false.OptionalpointRegister point + spot light shadowing & lighting. Default: false (cheap forward pipelines don't need it; deferred_full and crafty enable it).
Pass true for the defaults ('auto' culling — brute-force for a few
lights, tiled once the count grows), or { culling } to force a specific
mode ('none' / 'tiled' / 'clustered'). { autoCulled: 'clustered' }
makes 'auto' escalate to clustered instead of tiled (better for large
depth ranges). Culling lifts the per-pixel cost cap so the scene can use the
full MAX_POINT_LIGHTS/MAX_SPOT_LIGHTS.
OptionaltaaTemporal anti-aliasing. Default: true. Ignored when aa is set.
OptionalaaAnti-aliasing method, a superset of taa that also selects SMAA:
'taa' — temporal AA (TAAFeature); resolves sub-pixel detail
but needs camera jitter and can ghost under motion.'smaa' — spatial SMAA 1x (SMAAFeature); no jitter, no history,
no temporal ghosting.false — no anti-aliasing.
When omitted, falls back to taa (default 'taa').OptionalsmaaTuning forwarded to SMAAFeature when aa: 'smaa'.
OptionalmotionMotion blur. Camera-only by default; pass
{ useVelocityBuffer: true } to add per-object motion blur via an
extra velocity-buffer pass. Slotted after TAA and before DoF / bloom so
those passes respond to the blurred image. Default: disabled.
OptionaldofOptionalbloomOptionalexposureOptionalacesOptionalcameraDrive the tonemap exposure from a physical camera (aperture/shutter/ISO → EV100) instead of exposure. Mutate the object's fields for live camera sliders. See TonemapFeature.
OptionalphysicalCalibration for camera on a still-normalized scene (default 1).
OptionalhdrOptionalgradeFilm color-grading stack applied in the tonemap pass (white balance, lift/gamma/gain, split toning, …). Mutate fields on the live TonemapFeature.grade object for runtime grading.
OptionallutOptional .cube 3D LUT (URL or parsed) applied after the tonemap operator.
OptionallutLUT blend amount, 0..1 (default 1).
OptionalpostLens & film post-FX applied in the tonemap pass (chromatic aberration, vignette, lens distortion, Panini projection, film grain). Mutate fields on the live TonemapFeature.postFx object for runtime sliders.
OptionallightingForwarded to DeferredLightingFeature for extra knobs (shadow bias, etc.).
OptionalcontactScreen-space contact shadows for the sun (convenience for
lighting.contactShadows). Omit to disable.
OptionalcookieDirectional light cookie / gobo projected along the sun (convenience for
lighting.cookie). Omit to disable.
OptionalshadowDirectional shadow filtering — 'pcss' (default) or 'vsm' (EVSM2)
(convenience for lighting.shadowFilter).
OptionalreflectionRegister a ReflectionProbeFeature. The feature discovers ReflectionProbe components in the scene each frame and bakes their cubemaps + IBL into a shared cube-array; the deferred lighting pass blends those over the global sky IBL per-pixel.
Pass true for the defaults (max 8 probes, 256-cube capture) or an
options object to tune sizes / lighting overrides. Default: disabled.
OptionalprojectorsRegister a ProjectorFeature that composites unlit projection
textures (Projector components) onto the HDR target after lighting.
Pass true for the defaults or an options object. Default: disabled.
Sky source — see SkyOption for the union. Default: no sky (deferred lighting clears HDR itself).