Ethanfel/Comfyui-VACE-Tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Move SVG diagrams to separate files for GitHub rendering

Browse Source 
Inline SVGs are stripped by GitHub's markdown sanitizer. Moved all 11
diagrams to docs/diagrams/*.svg and referenced them with <img> tags.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Ethanfel
2026-02-22 13:25:14 +01:00
parent f71afeeae9
commit 7c584bd0d7
12 changed files with 258 additions and 247 deletions
Download Patch File Download Diff File Expand all files Collapse all files

258
README.md
View File

@@ -96,18 +96,7 @@ Generate new frames **after** the source clip.
- **`split_index`** — optional trim: `0` keeps the full clip; a negative value (e.g. `-16`) drops that many frames from the end before extending.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="360" height="28" rx="4" fill="#222"/>
<text x="180" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × source</text>
<rect x="360" y="18" width="240" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="480" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × generated</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="360" height="28" rx="4" fill="#4a9ebb"/>
<text x="180" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">source clip</text>
<rect x="360" y="68" width="240" height="28" rx="4" fill="#999"/>
<text x="480" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × generated</text>
</svg>
<img src="docs/diagrams/end-extend.svg" alt="End Extend layout">
---
@@ -117,18 +106,7 @@ Generate new frames **before** a reference portion of the source clip.
- **`split_index`** — how many frames from the start to keep as the reference tail (e.g. `24`).
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="240" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="120" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × generated</text>
<rect x="240" y="18" width="360" height="28" rx="4" fill="#222"/>
<text x="420" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × reference</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="240" height="28" rx="4" fill="#999"/>
<text x="120" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × generated</text>
<rect x="240" y="68" width="360" height="28" rx="4" fill="#4a9ebb"/>
<text x="420" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">reference frames</text>
</svg>
<img src="docs/diagrams/pre-extend.svg" alt="Pre Extend layout">
---
@@ -138,22 +116,7 @@ Generate new frames **between** two halves of the source clip, split at `split_i
- **`split_index`** — frame index where the source is split (`0` = auto-middle). Raises an error if out of range.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="180" height="28" rx="4" fill="#222"/>
<text x="90" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × part_a</text>
<rect x="180" y="18" width="240" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="300" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × generated</text>
<rect x="420" y="18" width="180" height="28" rx="4" fill="#222"/>
<text x="510" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × part_b</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="180" height="28" rx="4" fill="#4a9ebb"/>
<text x="90" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">part_a</text>
<rect x="180" y="68" width="240" height="28" rx="4" fill="#999"/>
<text x="300" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × generated</text>
<rect x="420" y="68" width="180" height="28" rx="4" fill="#4a9ebb"/>
<text x="510" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">part_b</text>
</svg>
<img src="docs/diagrams/middle-extend.svg" alt="Middle Extend layout">
---
@@ -166,22 +129,7 @@ Generate a transition **between the end and start** of a clip (useful for loopin
The end segment is placed first, then the generated gap, then the start segment — so the model learns to connect the clip's end back to its beginning.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="150" height="28" rx="4" fill="#222"/>
<text x="75" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × end_seg</text>
<rect x="150" y="18" width="300" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="300" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × generated</text>
<rect x="450" y="18" width="150" height="28" rx="4" fill="#222"/>
<text x="525" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × start_seg</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="150" height="28" rx="4" fill="#4a9ebb"/>
<text x="75" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">end_seg</text>
<rect x="150" y="68" width="300" height="28" rx="4" fill="#999"/>
<text x="300" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × generated</text>
<rect x="450" y="68" width="150" height="28" rx="4" fill="#4a9ebb"/>
<text x="525" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">start_seg</text>
</svg>
<img src="docs/diagrams/edge-extend.svg" alt="Edge Extend layout">
---
@@ -192,36 +140,7 @@ Heal/blend **two halves** of a clip (or two separate clips) together. By default
- **`edge_frames`** — context frames taken from each side of the join point.
- **`split_index`** — unused.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 170" style="max-width:600px">
<!-- Single clip source layout -->
<text y="12" font-size="11" font-family="sans-serif" fill="#888">single clip source</text>
<rect x="0" y="18" width="120" height="24" rx="4" fill="#4a9ebb" opacity="0.4"/>
<text x="60" y="34" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">part_1</text>
<rect x="120" y="18" width="120" height="24" rx="4" fill="#4a9ebb"/>
<text x="180" y="34" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">part_2</text>
<rect x="240" y="18" width="120" height="24" rx="4" fill="#4a9ebb"/>
<text x="300" y="34" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">part_3</text>
<rect x="360" y="18" width="120" height="24" rx="4" fill="#4a9ebb" opacity="0.4"/>
<text x="420" y="34" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">part_4</text>
<line x1="120" y1="44" x2="240" y2="44" stroke="#666" stroke-dasharray="4"/>
<text x="180" y="54" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#666">← edge → ← edge →</text>
<!-- Mask bar -->
<text y="72" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="78" width="150" height="28" rx="4" fill="#222"/>
<text x="75" y="96" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × part_2</text>
<rect x="150" y="78" width="300" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="300" y="96" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × generated</text>
<rect x="450" y="78" width="150" height="28" rx="4" fill="#222"/>
<text x="525" y="96" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × part_3</text>
<!-- Control bar -->
<text y="122" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="128" width="150" height="28" rx="4" fill="#4a9ebb"/>
<text x="75" y="146" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">part_2</text>
<rect x="150" y="128" width="300" height="28" rx="4" fill="#999"/>
<text x="300" y="146" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × generated</text>
<rect x="450" y="128" width="150" height="28" rx="4" fill="#4a9ebb"/>
<text x="525" y="146" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">part_3</text>
</svg>
<img src="docs/diagrams/join-extend.svg" alt="Join Extend layout">
---
@@ -232,22 +151,7 @@ Generate new frames **both before and after** the source clip.
- **`split_index`** — number of generated frames to place before the clip. `0` = even split (half before, half after).
- **`target_frames`** — total output frame count.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="150" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="75" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × pre</text>
<rect x="150" y="18" width="300" height="28" rx="4" fill="#222"/>
<text x="300" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × source</text>
<rect x="450" y="18" width="150" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="525" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × post</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="150" height="28" rx="4" fill="#999"/>
<text x="75" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × pre</text>
<rect x="150" y="68" width="300" height="28" rx="4" fill="#4a9ebb"/>
<text x="300" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">source clip</text>
<rect x="450" y="68" width="150" height="28" rx="4" fill="#999"/>
<text x="525" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × post</text>
</svg>
<img src="docs/diagrams/bidirectional.svg" alt="Bidirectional Extend layout">
---
@@ -257,40 +161,7 @@ Insert generated frames **between each consecutive pair** of source frames.
- **`split_index`** — number of new frames to insert per gap (min 1). `target_frames` is unused.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="40" height="28" rx="4" fill="#222"/>
<text x="20" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">B</text>
<rect x="40" y="18" width="110" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="95" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#333">W × step</text>
<rect x="150" y="18" width="40" height="28" rx="4" fill="#222"/>
<text x="170" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">B</text>
<rect x="190" y="18" width="110" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="245" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#333">W × step</text>
<rect x="300" y="18" width="40" height="28" rx="4" fill="#222"/>
<text x="320" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">B</text>
<rect x="340" y="18" width="110" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="395" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#333">W × step</text>
<rect x="450" y="18" width="40" height="28" rx="4" fill="#222"/>
<text x="470" y="36" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">B</text>
<text x="520" y="36" font-size="14" font-family="sans-serif" fill="#888">…</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="40" height="28" rx="4" fill="#4a9ebb"/>
<text x="20" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">f0</text>
<rect x="40" y="68" width="110" height="28" rx="4" fill="#999"/>
<text x="95" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">GREY</text>
<rect x="150" y="68" width="40" height="28" rx="4" fill="#4a9ebb"/>
<text x="170" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">f1</text>
<rect x="190" y="68" width="110" height="28" rx="4" fill="#999"/>
<text x="245" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">GREY</text>
<rect x="300" y="68" width="40" height="28" rx="4" fill="#4a9ebb"/>
<text x="320" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">f2</text>
<rect x="340" y="68" width="110" height="28" rx="4" fill="#999"/>
<text x="395" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">GREY</text>
<rect x="450" y="68" width="40" height="28" rx="4" fill="#4a9ebb"/>
<text x="470" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">f3</text>
<text x="520" y="86" font-size="14" font-family="sans-serif" fill="#888">…</text>
</svg>
<img src="docs/diagrams/frame-interpolation.svg" alt="Frame Interpolation layout">
---
@@ -302,22 +173,7 @@ Regenerate a range of frames **in-place** within the source clip.
- **`edge_frames`** — number of frames to replace (clamped to remaining frames after start).
- `target_frames` is unused. Total output = `source_frames` (in-place replacement).
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="18" width="200" height="28" rx="4" fill="#222"/>
<text x="100" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × before</text>
<rect x="200" y="18" width="200" height="28" rx="4" fill="#fff" stroke="#ccc"/>
<text x="300" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#333">WHITE × replace</text>
<rect x="400" y="18" width="200" height="28" rx="4" fill="#222"/>
<text x="500" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">BLACK × after</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="68" width="200" height="28" rx="4" fill="#4a9ebb"/>
<text x="100" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">before frames</text>
<rect x="200" y="68" width="200" height="28" rx="4" fill="#999"/>
<text x="300" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">GREY × replace</text>
<rect x="400" y="68" width="200" height="28" rx="4" fill="#4a9ebb"/>
<text x="500" y="86" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">after frames</text>
</svg>
<img src="docs/diagrams/replace-inpaint.svg" alt="Replace/Inpaint layout">
---
@@ -335,26 +191,7 @@ Compositing formula per pixel:
control_frames = source × (1 − mask) + grey × mask
```
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 90" style="max-width:600px">
<text y="12" font-size="11" font-family="sans-serif" fill="#888">mask (per-pixel)</text>
<defs>
<pattern id="checker" width="16" height="16" patternUnits="userSpaceOnUse">
<rect width="8" height="8" fill="#222"/>
<rect x="8" width="8" height="8" fill="#fff"/>
<rect y="8" width="8" height="8" fill="#fff"/>
<rect x="8" y="8" width="8" height="8" fill="#222"/>
</pattern>
</defs>
<rect x="0" y="18" width="600" height="28" rx="4" fill="url(#checker)"/>
<rect x="0" y="18" width="600" height="28" rx="4" fill="rgba(0,0,0,0.4)"/>
<text x="300" y="36" text-anchor="middle" font-size="12" font-family="sans-serif" fill="#fff">per-pixel mask broadcast to (B, H, W, 3)</text>
<text y="62" font-size="11" font-family="sans-serif" fill="#888">control_frames (per-pixel composite)</text>
<rect x="0" y="68" width="300" height="28" rx="4" fill="#4a9ebb"/>
<rect x="300" y="68" width="300" height="28" rx="4" fill="#999"/>
<text x="150" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">source pixels (mask=0)</text>
<text x="450" y="86" text-anchor="middle" font-size="11" font-family="sans-serif" fill="#fff">grey pixels (mask=1)</text>
<text x="300" y="82" text-anchor="middle" font-size="9" font-family="sans-serif" fill="#ddd">↕ blended per-pixel</text>
</svg>
<img src="docs/diagrams/video-inpaint.svg" alt="Video Inpaint layout">
---
@@ -367,39 +204,7 @@ Place keyframe images at specific positions within a `target_frames`-length outp
- **`keyframe_positions`** *(optional)* — comma-separated frame indices (e.g. `"0,20,50,80"`). Must have one value per source frame, sorted ascending, no duplicates, all within [0, target_frames-1]. Leave empty for **auto-spread** (first keyframe at frame 0, last at `target_frames-1`, others evenly distributed).
- **`split_index`**, **`edge_frames`** — unused.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 100" style="max-width:600px">
<text y="12" font-size="10" font-family="sans-serif" fill="#888">Example: 4 keyframes, target_frames=81, positions auto-spread to 0, 27, 53, 80</text>
<text y="30" font-size="11" font-family="sans-serif" fill="#888">mask</text>
<rect x="0" y="36" width="30" height="26" rx="4" fill="#222"/>
<text x="15" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">B</text>
<rect x="30" y="36" width="150" height="26" rx="4" fill="#fff" stroke="#ccc"/>
<text x="105" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#333">W × 26</text>
<rect x="180" y="36" width="30" height="26" rx="4" fill="#222"/>
<text x="195" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">B</text>
<rect x="210" y="36" width="140" height="26" rx="4" fill="#fff" stroke="#ccc"/>
<text x="280" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#333">W × 25</text>
<rect x="350" y="36" width="30" height="26" rx="4" fill="#222"/>
<text x="365" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">B</text>
<rect x="380" y="36" width="150" height="26" rx="4" fill="#fff" stroke="#ccc"/>
<text x="455" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#333">W × 26</text>
<rect x="530" y="36" width="30" height="26" rx="4" fill="#222"/>
<text x="545" y="53" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">B</text>
<text y="78" font-size="11" font-family="sans-serif" fill="#888">control_frames</text>
<rect x="0" y="84" width="30" height="26" rx="4" fill="#4a9ebb"/>
<text x="15" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">k0</text>
<rect x="30" y="84" width="150" height="26" rx="4" fill="#999"/>
<text x="105" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">GREY</text>
<rect x="180" y="84" width="30" height="26" rx="4" fill="#4a9ebb"/>
<text x="195" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">k1</text>
<rect x="210" y="84" width="140" height="26" rx="4" fill="#999"/>
<text x="280" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">GREY</text>
<rect x="350" y="84" width="30" height="26" rx="4" fill="#4a9ebb"/>
<text x="365" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">k2</text>
<rect x="380" y="84" width="150" height="26" rx="4" fill="#999"/>
<text x="455" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">GREY</text>
<rect x="530" y="84" width="30" height="26" rx="4" fill="#4a9ebb"/>
<text x="545" y="101" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#fff">k3</text>
</svg>
<img src="docs/diagrams/keyframe.svg" alt="Keyframe layout">
---
@@ -451,48 +256,7 @@ Merge: result = original[0:121] + vace[0:81] + original[153:274]
### Wiring Diagram
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 310" style="max-width:720px">
<!-- Node boxes -->
<rect x="10" y="10" width="130" height="40" rx="8" fill="#4a7ebb"/>
<text x="75" y="35" text-anchor="middle" font-size="13" font-family="sans-serif" font-weight="bold" fill="#fff">Load Video</text>
<rect x="200" y="10" width="160" height="40" rx="8" fill="#4a7ebb"/>
<text x="280" y="35" text-anchor="middle" font-size="13" font-family="sans-serif" font-weight="bold" fill="#fff">VACE Source Prep</text>
<rect x="430" y="10" width="130" height="40" rx="8" fill="#4a7ebb"/>
<text x="495" y="35" text-anchor="middle" font-size="13" font-family="sans-serif" font-weight="bold" fill="#fff">Mask Generator</text>
<rect x="430" y="120" width="160" height="40" rx="8" fill="#4a7ebb"/>
<text x="510" y="145" text-anchor="middle" font-size="13" font-family="sans-serif" font-weight="bold" fill="#fff">Sampler / VACE Encode</text>
<rect x="280" y="240" width="160" height="40" rx="8" fill="#4a7ebb"/>
<text x="360" y="265" text-anchor="middle" font-size="13" font-family="sans-serif" font-weight="bold" fill="#fff">VACE Merge Back</text>
<!-- Load Video → Source Prep (source_clip) -->
<line x1="140" y1="30" x2="200" y2="30" stroke="#666" stroke-width="2" marker-end="url(#arrow)"/>
<text x="170" y="24" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#888">source_clip</text>
<!-- Source Prep → Mask Gen (trimmed_clip) -->
<line x1="360" y1="30" x2="430" y2="30" stroke="#666" stroke-width="2" marker-end="url(#arrow)"/>
<text x="395" y="24" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#888">trimmed_clip</text>
<!-- Source Prep → Mask Gen (mode) -->
<path d="M360,40 Q400,65 430,45" stroke="#666" stroke-width="1.5" fill="none" marker-end="url(#arrow)"/>
<text x="405" y="58" text-anchor="middle" font-size="10" font-family="sans-serif" fill="#888">mode</text>
<!-- Mask Gen → Sampler (mask + control_frames) -->
<line x1="495" y1="50" x2="495" y2="120" stroke="#666" stroke-width="2" marker-end="url(#arrow)"/>
<text x="520" y="85" font-size="10" font-family="sans-serif" fill="#888">mask</text>
<text x="520" y="97" font-size="10" font-family="sans-serif" fill="#888">control_frames</text>
<text x="520" y="109" font-size="10" font-family="sans-serif" fill="#888">target_frames</text>
<!-- Source Prep → Merge Back (vace_pipe) -->
<path d="M280,50 L280,260 L280,260" stroke="#666" stroke-width="2" stroke-dasharray="6,3" marker-end="url(#arrow)"/>
<text x="264" y="155" font-size="10" font-family="sans-serif" fill="#888" transform="rotate(-90,264,155)">vace_pipe</text>
<!-- Load Video → Merge Back (source_clip) -->
<path d="M75,50 L75,260 L280,260" stroke="#666" stroke-width="2" marker-end="url(#arrow)"/>
<text x="59" y="155" font-size="10" font-family="sans-serif" fill="#888" transform="rotate(-90,59,155)">source_clip</text>
<!-- Sampler → Merge Back (vace_output) -->
<path d="M510,160 L510,200 L440,260" stroke="#666" stroke-width="2" marker-end="url(#arrow)"/>
<text x="500" y="215" font-size="10" font-family="sans-serif" fill="#888">vace_output</text>
<!-- Arrow marker -->
<defs>
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" fill="#666"/>
</marker>
</defs>
</svg>
<img src="docs/diagrams/wiring.svg" alt="Wiring diagram">
---