cue_set
Set or clear a crossfade or scale punch on one picture cue or across every cue. Adjust dissolve duration, punch zoom, and easing, with plan mode to preview.
Instructions
Set or clear a crossfade or a scale punch on one picture cue, or on every cue.
Address one cue as cue_rm does, or pass every for all of them: "a
scale punch per cut" is one call. dissolve crossfades into the cue (0
clears); punch scales the shot about the canvas centre from its cut (1
clears). A field not given is left alone. A punch and a crossfade on one
cue are refused: the crossfade removes the cut the punch is on.
Checked against the picture plan before writing, and each crossfade is
echoed: from: "outgoing" means the incoming clip had nothing before its
in-point, so the fade starts on the cue's word rather than ending on it —
pin the cue later into its clip (src_start) to move it. The first shot
has nothing to cross from and is reported in crossfades_skipped. A
vignette is not this: it is an overlay, card_new from the vignette
template. plan writes nothing; undo reverses the call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | The project directory to act on. Omit it — the usual case — when this server is bound to a project (started as `proofcut -C DIR mcp`, or inside a project; `ping` says which): it then resolves to that one bound project, a relative path resolves against it, and a path outside it is refused by name. Unbound, `path` is the whole address and omitting it refuses rather than guessing. | |
| plan | No | Resolve the whole call and report what it would do, writing nothing. Prefer it over doing the thing and undoing it. | |
| after | No | A forward cursor over a phrase's matches: any match at or before this word index is skipped. -1, the default, means from the start. | |
| event | No | The event the cue sits on, spelled as `cue_add` was given it. | |
| every | No | Set every cue (of `clip_id`, if given) in one call: a punch or crossfade per cut. | |
| punch | No | A scale punch from the cut, about the canvas centre: 1.1 zooms in 10%. Not with a dissolve on the same cue. 1 clears it. | |
| phrase | No | Address the cue by wording; it resolves to its first word, as `cue_add` placed it. | |
| clip_id | No | The transcript the cue is addressed against. With `every`, narrows to that clip's cues; omitted with `every`, every cue. | |
| dissolve | No | Crossfade into this cue over this many seconds: the incoming shot's frames before its in-point fade in, reaching the shot on the cue's word. Where the clip has none (an unpinned first use), the outgoing shot fades out from the word instead. 0 clears it. | |
| occurrence | No | Disambiguate a phrase by count when it matches more than once, **1-based** in transcript order among the matches after `after`: 1 is the first, 2 the second. Unset, an ambiguous phrase is refused — listing every candidate's range and text — rather than guessed at. | |
| punch_ease | No | The punch's curve. Default ease-out. | |
| punch_mode | No | `in` (default) zooms to `punch` and holds for the shot; `settle` starts there and eases back. | |
| word_index | No | The word the cue sits on. Give this, `phrase` or `event`, or pass `every`. | |
| dissolve_ease | No | The crossfade's curve: linear (the default), ease, ease-in or ease-out. | |
| punch_seconds | No | How long the punch moves. Default 0.2. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||