The camera dead-zone look-ahead layer filters small movement input before it can move the camera, then blends a look-ahead offset in the resolved movement direction. It preserves the base camera mode pose metadata while exporting the offset location through the camera manager contract.
Runtime Surface#
FV2CameraDeadZoneLookAheadConfigconfigures input dead zone, look-ahead distance, maximum offset distance, blend speeds, feature toggles, planar movement projection, and blend duration.FV2CameraDeadZoneLookAheadStatecarries the base camera mode and current look-ahead offset.FV2CameraDeadZoneLookAheadInputcarries movement input and delta seconds.FV2CameraDeadZoneLookAheadEvaluationreturns raw and resolved input magnitude, movement direction, target and blended offsets, resolved location, mode specs, and validation issues.
Dead Zone and Look-Ahead Rules#
- Invalid config, state, or input timing is blocking.
- Input inside
InputDeadZonereportsDeadZoneHoldingand resolves to zero. - Input outside the dead zone is remapped to a zero-to-one analog magnitude.
- Movement can be projected to the horizontal plane before direction solving.
- Look-ahead offsets follow movement direction and scale by resolved magnitude.
- Offsets are clamped to
MaxLookAheadDistanceand reportLookAheadClamped. - Disabled look-ahead reports
LookAheadDisabledand blends back to center. - Releasing input uses
RecenterBlendSpeedand reportsRecenterCompletewhen the offset reaches zero.
Camera Manager Export#
EvaluateCameraDeadZoneLookAhead fills ModeSpec from the base camera mode
with the resolved location and configured blend duration.
BuildCameraDeadZoneLookAheadMode can export a custom id, priority, and active
flag while preserving base camera rotation, FOV, blend function, input, and
cinematic metadata.
Validation Commands#
Run these targeted checks when touching camera dead-zone look-ahead:
python3 V2/ue/Tools/check-v2-camera-dead-zone-look-ahead.py
python3 V2/ue/Tools/check-v2-camera-manager.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/Camera/CameraDeadZoneLookAhead_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-camera-dead-zone-look-ahead.py