VideoComposeConfiguration.StructuralUpdateMode
How a STRUCTURAL composition update — a layer added or removed, or a part’s sourceRect appearing/disappearing — is applied on the COMPOSE_SPECTRUM_* arms, which rebuild their compiled pipeline for such changes. Non-structural updates (geometry, opacity, transitions) always apply in place regardless of this setting. Ignored by COMPOSE_NONE / _QUADRA / _NVIDIA arms.
Name |
Number |
Description |
STRUCTURAL_UPDATE_GLITCH_FREE |
0 |
Make-before-break (the default): the previous composition keeps rendering while the new pipeline is prepared, then output cuts over. Output never pauses and no frames are dropped, but the change lands a few frames late — or seconds late the first time a never-before-seen structure is compiled on a box (compiled pipelines are cached in memory and on disk, so this is a first-time-only cost per structure). |
STRUCTURAL_UPDATE_FRAME_ACCURATE |
1 |
Frame-accurate: output pauses at the update point, input frames queue while the new pipeline is prepared, and every queued frame is then rendered with the new composition. Choose when the exact frame the update applies at matters more than continuous output — and accept that a not-yet-cached structure pauses output for the pipeline build time. |