# Sequencer LOD

This document records the `TODOS.phase-72.72.15.1.13` cinematic sequencer LOD
contract. Sequence LOD can skip cinematic playback during active gameplay when
configured and play an abbreviated version on repeat viewing.

The default profile exists to skip cinematic in gameplay when configured and
select an abbreviated version on repeat viewing.

## Runtime Ownership

- Runtime module: `V2Cinematics`
- Decision enum: `EV2SequencerLODDecision`
- Profile spec: `FV2SequencerLODProfileSpec`
- Request spec: `FV2SequencerLODRequest`
- Evaluation: `FV2SequencerLODEvaluation`
- Issue enum: `EV2SequencerLODIssueType`
- Automation: `V2.Cinematics.Sequencer.LOD`
- CI checker: `V2/ue/Tools/check-v2-sequencer-lod.py`

## LOD Model

`FV2SequencerLODProfileSpec` owns the policy for one sequence: gameplay skip,
active-gameplay skip, repeat-view abbreviation, repeat threshold, abbreviated
sequence id, abbreviated duration, minimum full playback seconds, and critical
story protection.

`EvaluateSequencerLOD` combines a profile with `FV2SequencerLODRequest` state to
choose `FullSequence`, `SkipSequence`, or `AbbreviatedSequence`.

## Default Fixture

`BuildDefaultSequencerLODProfile` creates `LOD.CouncilIntro.GameplayAware` for
`Seq.DataModel.CouncilIntro`. The profile skips during active gameplay, uses
`Seq.DataModel.CouncilIntro.Abbreviated` after one prior viewing, and plays that
abbreviated sequence for `60` frames. Critical story requests always keep the
full sequence.

## Verification

Run:

```bash
python3 V2/ue/Tools/check-v2-sequencer-lod.py
```

Adjacent verification should include
`python3 V2/ue/Tools/check-v2-sequencer-serialization.py`,
`python3 V2/ue/Tools/check-v2-sequencer-gameplay-blend.py`,
`python3 V2/ue/Tools/check-v2-sequencer-sub-sequence-composition.py`,
`python3 V2/ue/Tools/check-v2-sequencer-actor-bindings.py`,
`python3 V2/ue/Tools/check-v2-sequencer-camera-tracks.py`,
`python3 V2/ue/Tools/check-v2-sequencer-event-tracks.py`,
`python3 V2/ue/Tools/check-v2-sequencer-audio-tracks.py`,
`python3 V2/ue/Tools/check-v2-sequencer-animation-clip-tracks.py`,
`python3 V2/ue/Tools/check-v2-sequencer-property-tracks.py`,
`python3 V2/ue/Tools/check-v2-sequencer-keyframe-interpolation.py`,
`python3 V2/ue/Tools/check-v2-sequencer-timeline-playback.py`,
`python3 V2/ue/Tools/check-v2-sequencer-data-model.py`, and
`python3 V2/ue/Tools/check-v2-cinematics-module.py`.