clipasm 0.3.2

A strict, typed language for compiling and rendering Video and Audio graphs
Documentation
<!-- Generated by clipasm-reference-docs. Do not edit directly. -->

# extract_audio

Extract the meaningful Audio from a Video.

## Call shape

```text
extract_audio(video: Video) -> Audio
```

This is call-shape notation for lookup, not ClipAsm declaration syntax.

## Graph inputs

| Name | Type | Cardinality |
| --- | --- | --- |
| `video` | `Video` | exactly one |

## Parameters and defaults

This program has no scalar parameters.

## Result and stack behavior

Outputs: `Audio`.

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

video("assets/interview.mp4")
extract_audio
```

Expected validation result: `Audio`.

This exact example is parsed and compiled by the reference checks; compilation does not inspect the named media files.

## Behavior

- The standalone Audio output covers the complete Video duration on the project sample grid.

## Requirements

- The Video must carry meaningful attached Audio; extracting from a silent Video cannot create Audio content.

## See also

- [`video`]video.md
- [`set_audio`]set_audio.md
- [Statements and calls]../language/statements-and-calls.md
- [Stack binding]../language/stack-binding.md