Skip to content

EffectCraft: An open-source motion graphics and compositing tool written by scratch in pure Rust

Merge pull request #1106 from eliasx45/upstream/relink-moved-footage

Brandon Thomas7a9213611e41
diff --cc crates/engine/src/commands/mod.rs
index 471a79eed,f1d270662..685d4dad8
--- a/crates/engine/src/commands/mod.rs
+++ b/crates/engine/src/commands/mod.rs
@@@ -51,8 -49,8 +51,9 @@@ mod prop_groups
mod proxy;
pub mod puppet;
mod query;
+mod quick_offset;
mod relink;
+ pub(crate) mod relink_moved;
mod render_queue;
pub(crate) mod rig3d;
pub mod roto_cmds;
@@@ -194,11 -191,10 +195,12 @@@ pub fn command_specs() -> &'static [Com
v.extend(focus::specs());
v.extend(key_labels::specs());
v.extend(key_transform::specs());
+ v.extend(quick_offset::specs());
v.extend(file_more::specs());
v.extend(relink::specs());
+ v.extend(relink_moved::specs());
v.extend(lottie::specs());
+ v.extend(import_project::specs());
v.extend(timeline::specs());
v.extend(comp_more::specs());
v.extend(frame_export::specs());
diff --cc docs/footage.md
index 9cfa022aa,20ca89265..4a5a498c7
--- a/docs/footage.md
+++ b/docs/footage.md
@@@ -110,13 -98,14 +110,21 @@@ vectors, positions and IDs are never th
- **File ▸ Replace Footage ▸ File…** (Ctrl+H) points the item at another file. Pick a numbered
file to replace it with that file's whole sequence (`file.replaceFootage {"path": …,
"sequence": false}` for one frame).
+- **Replace with Precomposition (used N times)**, right-clicking a footage item or solid in the
+ Project panel, puts the item in a new composition of its size,
+ pixel aspect and frame rate, in the same folder, and switches every layer in every composition
+ that used the item to that composition. Layers keep their timing, transforms, effects and
+ masks, and the item stays in the project. The composition lasts as long as the footage, or as
+ the longest layer that showed a still or solid. One undo step (`file.replaceWithPrecomp
+ {"item"?}`).
+ - **Relinking moved files.** `footage.relink {"item": id, "path": …}` points a missing item at
+ its file's new location, keeping its interpretation, and relinks every other missing item that
+ was in the same place relative to it (the whole folder moved, a drive was renamed, a project
+ made on Windows opened on macOS); File ▸ Replace Footage on a missing item does the same. One
+ undo step; `footage.missing` lists what is still missing.
+ - **A project moved with its footage** finds it again on open: the footage check that runs after
+ File ▸ Open tries each missing file at the same place under the project's new folder, without
+ marking the project modified.
- **File ▸ Reload Footage** (Ctrl+Alt+L) reads the files again. A sequence picks up frames
added to its folder (a render still in progress) and keeps its interpretation.