Footage cache (#3271): channel selection is static, and only the channels picked are read

The parameters that pick which channels or Cryptomatte layer an effect reads (EXtractoR's Red/Green/Blue/Alpha, Cryptomatte's Layer and Layer Name, 3D Channel Extract's 3D Channel, ID Matte's Aux. Channel and Use Coverage, IDentifier's Channel Type) are static, as in After Effects where they have no stopwatch: no keyframes, no expression (prop.addKey, prop.toggleKey, prop.toggleAnimation and prop.setExpression refuse; prop.set changes the value). A document or an import that animated one keeps its first value and says so (a toast on open, a loss on .aep import). With that, what a frame reads is known from the values alone: the 'all channels' fallbacks for moving parameters and for effects that don't declare are gone (every channel effect declares; a test holds them to it), and a layer whose effects read no channels asks for none. Tests: the parameters refuse keys and expressions and the need is exactly the channel picked; a keyed channel selection opens static with its first value and is reported (both fail on the old code); the migration keeps the first key's value.
This commit is contained in:
vangel76 committed 2026-11-08 13:24:22 +01:00
1 parent f21b7d2a8f
commit c3464f640f
12 files changed
+231 -29

No files matched your search

+2
View File
@@ -13,6 +13,8 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands
## 3D Channel
The parameters that pick which channels or Cryptomatte layer an effect reads are not animatable, as in After Effects (see [footage](footage.md)).
| Effect | Id | Params | GPU | 32 | Status |
|---|---|---:|:-:|:-:|---|
| 3D Channel Extract | `ec.3d.channelextract` | 6 | GPU | 32 | Implemented |
+15 -5
View File
@@ -123,11 +123,21 @@ vectors, positions and IDs are never the picture. EXtractoR reads every other la
Footage on its own keeps only the channels of its picture (a single-part file still
decompresses all of its pixels to read them). Once an effect reads an item's channels
(EXtractoR, Cryptomatte, the 3D Channel effects), each frame, the first included, is decoded
once for the picture and the effects together, and kept for a while: about 1 GB of decoded
channels (512 MB in the browser), a soft bound, as the newest file and files still in use
stay whatever their size. Several frames asking for the same file at once wait for one
decode. Once no enabled effect reads the item any more, its frames go back to the picture's
channels alone.
once for the picture and the effects together, and only the channels the effects pick are
read (EXtractoR's channel names, Cryptomatte's layer, the 3D Channel effects' channel popups).
The decoded channels are kept for a while, in the Footage Frame Cache together with the
decoded frames (the least recently used frame or channel set goes first; in the browser the
channels take at most 512 MB), a soft bound, as the newest file and files still in use stay
whatever their size. The picture is kept once, converted: its own R, G, B and A planes are
not kept beside it, unless an effect names one of them. Several frames asking for the same
file at once wait for one decode. Once no enabled effect reads the item any more, its frames
go back to the picture's channels alone.
The parameters that pick channels (EXtractoR's Red, Green, Blue and Alpha, Cryptomatte's Layer
and Layer Name, 3D Channel Extract's 3D Channel, ID Matte's Aux. Channel and Use Coverage,
IDentifier's Channel Type) can't be animated, as in After Effects, where they have no
stopwatch either: they take no keyframes and no expression. A document that animated one
opens with its first value.
The Cryptomatte effect keys objects by their Cryptomatte ID passes, with the names from the
file's manifest. Pick them with the eyedropper next to its Selection, then click in the