# image
Create a Video from an image file.
## Call shape
```text
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
| `path` | `File` | required | — |
| `duration` | `Duration` | optional | uses a requested Video extent supplied by the surrounding body; without one, the call reports that an image duration is required |
| `fit` | `Keyword(cover \| contain \| stretch)` | optional | cover |
## Result and stack behavior
Outputs: `Video`.
Default stack access is **owned**. See [stack binding](../language/stack-binding.md) for ownership and visibility rules.
## Timeline and markers
Creates a new timeline when it returns Video or Audio.
## Example
```clipasm
clipasm 1
config {
video {
fps = 30
}
}
image("assets/title.png", 2s, contain)
```
Expected validation result: `Video` with exactly 60 project frames at the example's explicit `fps = 30`.
This exact example is parsed and compiled by the reference checks; compilation does not inspect the named media files.
## Behavior
- The image is fitted to the project Video dimensions; cover fills the frame and crops overflow, contain pads, and stretch may distort.
- A surrounding Video body may supply the requested duration when duration is omitted.
## Requirements
- The resolved duration must contain at least one project frame.
## Common diagnostics
These are the diagnostics most specific to this program.
- [`E_MISSING_IMAGE_DURATION`](https://nikitamgrimm.github.io/clipasm/diagnostics/#e_missing_image_duration) — Missing image duration
- [`E_INVALID_DURATION`](https://nikitamgrimm.github.io/clipasm/diagnostics/#e_invalid_duration) — Invalid duration
## See also
- [`video`](video.md)
- [`during`](during.md)
- [Statements and calls](../language/statements-and-calls.md)
- [Stack binding](../language/stack-binding.md)