Footage cache (#3271): stage B review fixes

- A region of interest reads rows only at the top level (no collapsed precomps, no nested
  comps, no adjustment layers); input and footprint keys never keep a rows-only buffer; a rows
  request takes the whole frame from the frame cache when it is there and keeps nothing itself.
- Sequence layers are keyed by their frame (without frame blending or fields), so times within
  a frame share the entry.
- A decode taken over by a decode thread runs under the asker's cancel flag and hints.
- Disk planes: one entry per channel, read back whatever was asked for before; queued planes
  are moved in (counted exactly), written by channel with checked math; the write refused when
  a plane is of another size. Segmentations are compressed on the writer thread.
- Memory accountant: the plane budget is in the sum; the disk queue counts only bytes it alone
  holds and never drops frame writes; one balance at a time, inserts balance at most every
  100 ms, a refilling holder stays protected for 10 s.
- Reload Footage gives thumbnails new keys; thumbnail keys are worked out at most every 0.25 s.
- Localizer: network footage locations (Settings > Disk, e.g. P:\) besides UNC paths; copies
  recorded beside them and adopted after a restart, stale temporaries deleted; the disk cache's
  reserve kept free; by default beside the disk cache's folder, 20 GB; a copy gone meanwhile
  reads the share; status shown translated, with the network locations.
- Tests: hooks hold the queued decode for the claim test; the disk test uses its own paths.
This commit is contained in:
vangel76 committed 2026-11-08 03:59:09 +01:00
1 parent 1e47afcf9a
commit d91f5d28fd
26 files changed
+829 -322

No files matched your search

+9
View File
@@ -153,6 +153,15 @@ Commands (CLI, MCP, control channel):
- `disk.mediaCacheFolder`: audio waveform summaries kept between sessions (`Peaks/`)
- `disk.conformedMediaFolder`: decoded (conformed) footage audio, written once per file and
sample rate and read back instead of decoding again
- `disk.localizeFootage` (off by default), `disk.localizeMaxGb` (20), `disk.localizeFolder`,
`disk.networkFootageLocations`: OpenEXR footage on network shares is copied, one file at a
time on a background thread, to a local folder (by default beside the disk cache's folder),
and read from the copy once it is complete and the source still has the size and modification
time it had when copied. Network footage is UNC paths (`\server\share\…`) and the locations
listed in `disk.networkFootageLocations` (`;`-separated path prefixes, such as a drive letter
mapped to a share: `P:\`). The copies take at most `disk.localizeMaxGb` and leave the disk
cache's reserve free on their disk; earlier sessions' copies are adopted. The Disk page shows
the local copies, what is queued and being copied, and the network locations
- `memory.ramReservedGb`: the cache budgets together leave this much physical memory free
- `memory.reduceCacheWhenLow`: cache budgets halve while the system is low on memory (checked
every 30 s by the desktop app, on a background thread)