video
Load a Video from a video file.
Call shape
video(path: File, fit?: Keyword(cover | contain | stretch)) -> Video
This is call-shape notation for lookup, not ClipAsm declaration syntax.
Graph inputs
This program does not take a Video or Audio input from the stack.
Parameters and defaults
| Name | Type | Requirement | Default or omission behavior |
|---|---|---|---|
path | File | required | — |
fit | Keyword(cover | contain | stretch) | optional | cover |
Result and stack behavior
Outputs: Video.
Default stack access is owned. See stack binding for ownership and visibility rules.
Timeline and markers
The program creates a new timeline when it returns Video or Audio.
Example
clipasm 1
video("assets/scene.mp4", contain)
Expected validation result: Video with a source-dependent frame domain resolved during preflight.
The reference checks parse and compile this exact example. Compilation does not inspect the named media files.
Behavior
- Compilation remains media-pure. Preflight probes the source and resolves its exact project-frame domain.
- Preflight requires complete BT.709 SDR color metadata; it does not guess missing metadata or silently tone-map HDR.
- Preflight fits the source to the project Video dimensions and preserves its resolved duration.