Preview: playback steps down a resolution when it can't keep up

Settings > Previews > Lower Resolution When Playback Can't Keep Up (on by
default): a preview at Resolution Auto that stalls on uncached frames and
shows under 80 % of its frame rate for two seconds plays on at half the
scale, and two seconds later at a quarter if still slow, no lower than the
Adaptive Resolution Limit. Stopping goes back to the viewer's resolution
and Cache Frames When Idle fills it in. An explicit Resolution, the comp's
or the Preview panel's, is kept as set.

First playback of a 1080p comp with a blur (cache_bench --play): 9.0 to
22.1 frames/s on the CPU (about 27 once at Half), 4.1 to 16.1 with Mercury
Auto on an integrated GPU; plain clips that keep up stay at Full.
This commit is contained in:
nazar-gavrylyk
2026-11-10 15:03:10 +01:00
parent cc4f834a94
commit 893d9a0b04
8 changed files with 100 additions and 1 deletions
+7 -1
View File
@@ -52,7 +52,13 @@ Commands (CLI, MCP, control channel):
- `autoSave.saveOnRenderStart`: Save When Starting Render Queue
- `composition.showRenderingProgress`: Show Rendering Progress in Info Panel and Flowchart
- `previews.adaptiveResolutionLimit`: Adaptive Resolution Limit (the lowest resolution Fast Previews ▸
Adaptive Resolution drops to while you drag; a playing preview keeps the viewer's resolution)
Adaptive Resolution drops to while you drag, and the lowest a playing preview steps down to)
- `previews.adaptivePlayback`: Lower Resolution When Playback Can't Keep Up. On by default. A
preview at Resolution Auto that stalls on frames and shows under 80 % of its frame rate steps
down a resolution (half the scale after two seconds, a quarter two seconds later if still slow,
no lower than the Adaptive Resolution Limit) for the rest of that play; stopping goes back to the viewer's resolution, and Cache
Frames When Idle fills it in. An explicit Resolution (the comp's or the Preview panel's) is
kept as set
- `previews.cacheFramesWhenIdle`: Cache Frames When Idle (Composition ▸ Preview): after a second
without input or edits, the viewer renders the work area into the RAM preview in the
background, from the current time on, until it is cached or the budget is full. On by default,