Forward playback-rate range the engine accepts. Reverse playback needs a
backwards decode strategy the runtime does not have, so zero and negative
rates are refused rather than approximated.
MAX is an API bound, not a promise that every source plays every frame
there. Sustaining rate r frame by frame means decoding r x nativeFps frames a
second, so past what a source's frame size and encode allow, playback moves
to the keyframe walk (see PLAYBACK) and keeps the rate by showing sync
samples only. What the walk cannot cure is a GOP so long that one decode per
sync sample is still too many, and the engine measures that rather than
guessing: DiagnosticsSnapshot carries the commanded rate beside the presented
one, and PLAYBACK_RATE_NOT_SUSTAINED fires when they diverge.
SUSTAINED_SHORTFALL is the share of the commanded rate the presented one has
to hold to count as sustained.
Sixty-four is the keyframe walk's reach on ordinary footage: a sync sample a
second asks for 64 decodes a second, well inside what a hardware decoder
sustains, and a 70s clip passes in about a second.
Forward playback-rate range the engine accepts. Reverse playback needs a backwards decode strategy the runtime does not have, so zero and negative rates are refused rather than approximated.
MAX is an API bound, not a promise that every source plays every frame there. Sustaining rate r frame by frame means decoding r x nativeFps frames a second, so past what a source's frame size and encode allow, playback moves to the keyframe walk (see PLAYBACK) and keeps the rate by showing sync samples only. What the walk cannot cure is a GOP so long that one decode per sync sample is still too many, and the engine measures that rather than guessing: DiagnosticsSnapshot carries the commanded rate beside the presented one, and PLAYBACK_RATE_NOT_SUSTAINED fires when they diverge. SUSTAINED_SHORTFALL is the share of the commanded rate the presented one has to hold to count as sustained.
Sixty-four is the keyframe walk's reach on ordinary footage: a sync sample a second asks for 64 decodes a second, well inside what a hardware decoder sustains, and a 70s clip passes in about a second.