- Audio
- Other
Automation Clip
Purpose
Section titled “Purpose”Automation Clip draws curves out of keyframes and plays them back in step with the timeline. Each curve is a lane, sample-accurate, ready to move any parameter that accepts a control signal. One clip carries up to 64 lanes, so a whole song’s automation can live in one node: lane 0 on channel 0 of out, lane 1 on channel 1, and so on.
Wire a timeline clock into timeline, write the keys in Doc, and send out to the control input you want to automate. With nothing wired, a clip in the seconds domain runs on its own from the engine clock.
A Doc with no lane line is one curve:
domain beatlength 8loop 1key 0 0.0 smoothkey 4 1.0 expo shape 3key 8 0.0For several curves, start each with a lane line; the name is for you. Settings above the first lane apply to every lane unless a lane sets its own.
domain beatlength 16loop 1lane kickkey 0 0 holdkey 4 1 holdlane filterkey 0 0.2 smoothkey 16 0.9lane fx_sendlength 32key 0 0key 24 0.6 expokick is channel 0, filter channel 1 and fx_send channel 2, looping over 32 beats. out has one channel per lane.
Inputs and outputs
Section titled “Inputs and outputs”- Input 0:
timelinetimeline clock. Optional. - Output 0:
outcontrol lanes, one channel per lane.
Controls
Section titled “Controls”- Enable: turn the curves on or off. When off, every channel of
outsits at Basevalue. - Basevalue: the value while the clip is disabled, or of a lane with no keys.
- Gain: multiplies every lane. Default 1.
- Offsetout: added to every lane after Gain.
- Doc: the curve text.
#starts a comment. Changes apply live.
- Output is
curve * Gain + Offsetout. - Doc directives:
domain beat|seconds,offset <f>(clip start on the timeline),length <f>(loop length),loop 0|1,rate <f>(time multiplier, default 1),seed <u>,keylines andlane [<name>]. key <pos> <value> [hold|linear|smooth|expo|bezier] [shape <f>] [spread <f>] [out <dx> <dy>] [in <dx> <dy>]. The interpolation name describes the segment leaving that key.shapeis the exponent forexpo, default 2.beziersegments use theouthandle of one key and theinhandle of the next. A key without handles gets a neutral handle, which draws a straight line.spreadadds jitter to a key, different on every loop pass. The same seed always gives the same result, so two renders match exactly. Spread 0 locks the key.- Up to 64 keys per lane and 64 lanes per clip.
- A beat-domain clip needs a wired timeline. Unwired, it holds the value at position 0.
Inputs
-
timelinerow
Outputs
-
outrow
Parameters
Section titled “Parameters”op('automation_clip').par.Enable - Default:
On- Options:
- Off, On
op('automation_clip').par.Basevalue - Default:
0- Range:
- -1000000 to 1000000
op('automation_clip').par.Gain - Default:
1- Range:
- -1000000 to 1000000
op('automation_clip').par.Offsetout - Default:
0- Range:
- -1000000 to 1000000
op('automation_clip').par.Doc - Default:
"" (Empty String)