The camera post-process zone layer resolves sphere and box trigger volumes into blended post-process settings. It covers fog, color grading, and depth-of-field settings while reporting deterministic enter, exit, priority, and validation issues.
Runtime Surface#
FV2CameraPostProcessSettingscarries fog density and color, color-grade intensity and tint, and depth-of-field focal distance and aperture.FV2CameraPostProcessZoneConfigcarries default settings and fallback blend durations.FV2CameraPostProcessZoneStatecarries the camera location, previous active zone id, current blend alpha, and current settings.FV2CameraPostProcessZoneInputcarries delta seconds.FV2CameraPostProcessZonedefines a sphere or box trigger with priority, settings, blend durations, and active state.FV2CameraPostProcessZoneEvaluationreturns the resolved active zone, enter/exit flags, blend alpha, blended settings, and validation issues.
Zone Rules#
- Invalid config, state, input, or zone data is blocking.
- Inactive zones do not trigger.
- Sphere zones use distance from center to radius.
- Box zones use absolute local offset within extents.
- Overlapping zones choose the highest priority zone.
- Equal-priority overlaps keep the earlier zone and report
PriorityTie. - Entering a zone reports
ZoneEnteredand blends toward that zone settings. - Exiting all zones reports
ZoneExitedand blends back to default settings. BlendCompleteis reported when the blend reaches zero or one.
Post-Process Settings#
The resolved settings blend fog density and fog color, color-grade intensity and tint, depth-of-field focal distance, and aperture. Callers can bind the resolved data to runtime post-process volumes or camera post-process overrides.
Validation Commands#
Run these targeted checks when touching camera post-process zones:
bash
python3 V2/ue/Tools/check-v2-camera-post-process-zone.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/Camera/CameraPostProcessZone_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-camera-post-process-zone.py