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. -->

# concat

Concatenate one or more homogeneous timelines.

## Call shape

```text
concat<T: Video | Audio>(values: T...) -> T
```

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

## Graph inputs

| Name | Type | Cardinality |
| --- | --- | --- |
| `values` | `T` | one or more (minimum 1) |

## Parameters and defaults

This program has no scalar parameters.

## Result and stack behavior

Outputs: `T`.

All `T` inputs and outputs use one homogeneous type: Video or Audio. Use an explicit `<Video>` or `<Audio>` argument when the accessible stack makes inference ambiguous.

Default stack access is **owned**. See [stack binding](../language/stack-binding.md) for ownership and visibility rules.

## Timeline and markers

Places the values bound to `values` one after another in their existing order.

## Example

```clipasm
clipasm 1

config {
    video {
        fps = 30
    }
}

image("assets/one.png", 1s)
image("assets/two.png", 1s)
concat
```

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

- Every bound value must use the same inferred Video or Audio type and is concatenated in stack order.
- Use `concat<Video>` or `concat<Audio>` when both homogeneous bindings are possible.

## See also

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