From c5bb5f439764bb091826d21ecebdac7822e80cfa Mon Sep 17 00:00:00 2001 From: Brandon Thomas Date: Tue, 13 Oct 2026 02:36:43 -0400 Subject: [PATCH] docs: move #1104's project import notes from a stray parity-log.md into footage.md Co-Authored-By: Claude Opus 5.5 --- docs/footage.md | 12 ++++++++++++ docs/parity-log.md | 13 ------------- 2 files changed, 12 insertions(+), 13 deletions(-) delete mode 100644 docs/parity-log.md diff --git a/docs/footage.md b/docs/footage.md index e626eee0..9cfa022a 100644 --- a/docs/footage.md +++ b/docs/footage.md @@ -58,6 +58,18 @@ sequences, except dropped files (`"drag": true`), which import as stills as in A imports stills and a folder's files one by one, and `"alphabetical": true` is Force Alphabetical Order. +## Importing another project + +File ▸ Import ▸ EffectCraft Project… (or an `.ecproj` / `.ecprojx` file given to File ▸ Import) +merges that project into the open one, inside a folder named after the file, as After Effects +imports an `.aep`. Every item, layer and property id moves past the open project's, so precomps, +parents, track mattes, Layer Control values, Essential Graphics and tracker targets keep pointing +at the right things. It is one undo step. Footage paths relative to the imported project resolve +next to it. + +Agents: `file.importProject {"path": "/projects/titles.ecproj"}` returns the comps, the root comps, +`primaryComp` (the only root comp, if there is one) and any missing media. + ## Interpret Footage Select a footage item in the Project panel and choose **File ▸ Interpret Footage ▸ Main…** diff --git a/docs/parity-log.md b/docs/parity-log.md deleted file mode 100644 index 22319e6e..00000000 --- a/docs/parity-log.md +++ /dev/null @@ -1,13 +0,0 @@ - -## Update: File ▸ Import ▸ EffectCraft Project - -- **Import a project into a project**, as After Effects imports an `.aep`: - `file.importProject {path}` (File ▸ Import ▸ EffectCraft Project..., and `.ecproj` / - `.ecprojx` files given to File ▸ Import) merges the project into a folder named after the - file. Every item, layer and property id moves past the open project's, so references - (precomps, parents, track mattes, Layer Control values, Essential Graphics, tracker - targets) stay intact. It's one undo step. Footage paths relative to the imported project - resolve next to it. The result lists the comps, the root comps, `primaryComp` (the only - root comp) and missing media. -- Id shifting saturates instead of overflowing on damaged files, for both templates and - projects.