# argus vfx clip

> Talos next · Since next

## Usage

```sh
argus vfx clip [OPTIONS] --out <OUT> <EFFECT>
```

## Arguments

| Argument | Description |
|---|---|
| `<EFFECT>` | A `*.vfx.json` file, or a preset (`builtin:fx/campfire`) |

## Options

| Flag | Value | Default | Allowed values | Description |
|---|---|---|---|---|
| `--out` | `<OUT>` |  |  | The folder to write `clip.mp4`, `clip.json` and `frames/` to |
| `--stage` | `<STAGE>` | `dark` | `dark`, `bright`, `sky`, `void` |  |
| `--seconds` | `<SECONDS>` | `6` |  | Seconds of film |
| `--fps` | `<FPS>` | `30` |  |  |
| `--warmup` | `<WARMUP>` | `0` |  | Seconds the effect runs before the first frame |
| `--distance` | `<DISTANCE>` | `8` |  | The camera's distance, metres |
| `--look-y` | `<LOOK_Y>` |  |  | The height the camera looks at, metres (default: the middle of the effect) |
| `--eye-y` | `<EYE_Y>` |  |  | The camera's height, metres (default: level with what it looks at) |
| `--orbit` | `<ORBIT>` | `0` |  | Degrees a second the camera circles the effect |
| `--angle` | `<ANGLE>` | `0` |  | The camera's first bearing, degrees |
| `--dolly` | `<DOLLY>` | `0` |  | Metres a second the camera moves back from the effect; negative closes in |
| `--param` | `<NAME=VALUE>` |  |  | A param value over its default, `name=value`. Repeatable |
| `--size` | `<SIZE>` | `1280x720` |  | The frame's size, `WIDTHxHEIGHT` |
| `--hd` |  |  |  | Draw with the HD renderer (a build with `hd`) |

## Example

```sh
argus vfx clip --out <OUT> <EFFECT>
```