Skip to content

Commit 578a085

Browse files
committed
Explain ordering of --stack and --concat
Signed-off-by: Joshua Minor <joshm@pixar.com>
1 parent 3879989 commit 578a085

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

docs/tutorials/otiotool.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -310,13 +310,22 @@ otiotool -i multitrack.otio --flatten video -o output.otio --list-tracks
310310
```
311311

312312
### Stack or Concatenate Timelines
313-
Stack multiple timelines:
313+
314+
[!NOTE] With `--stack` and `--concat` the order of the input files affects the outcome.
315+
316+
When concatenated, the inputs are assembled in the order listed, so the first input is earliest on the output timeline.
317+
318+
Concat Example:
314319
```bash
315-
otiotool -i multitrack.otio premiere_example.otio --stack -o output.otio --list-tracks
320+
otiotool -i opening.otio end_credits.otio --concat -o output.otio
316321
```
317-
Concatenate timelines end-to-end:
322+
```
323+
324+
When stacked, video tracks layer bottom-to-top, so the video tracks of the second input are layered above the first input. This follows conventional video/audio ordering where video tracks are layered numerically increasing upward (V2 is above V1). Audio tracks are layered in the opposite order, since traditionally audio tracks are layered numerically increasing downward (A2 is below A1).
325+
326+
Stack Example:
318327
```bash
319-
otiotool -i multitrack.otio premiere_example.otio --concat -o output.otio --stats
328+
otiotool -i a.otio b.otio --stack -o output.otio
320329
```
321330

322331
### Redact Timeline

0 commit comments

Comments
 (0)