Skip to content
  1. Audio
  2. Other

Automation Clip

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 beat
length 8
loop 1
key 0 0.0 smooth
key 4 1.0 expo shape 3
key 8 0.0

For 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 beat
length 16
loop 1
lane kick
key 0 0 hold
key 4 1 hold
lane filter
key 0 0.2 smooth
key 16 0.9
lane fx_send
length 32
key 0 0
key 24 0.6 expo

kick is channel 0, filter channel 1 and fx_send channel 2, looping over 32 beats. out has one channel per lane.

  • Input 0: timeline timeline clock. Optional.
  • Output 0: out control lanes, one channel per lane.
  • Enable: turn the curves on or off. When off, every channel of out sits 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>, key lines and lane [<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. shape is the exponent for expo, default 2.
  • bezier segments use the out handle of one key and the in handle of the next. A key without handles gets a neutral handle, which draws a straight line.
  • spread adds 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

  • timeline row
    timeline_state_f32_v1

Outputs

  • out row
    control_f32_v1
Enable (Enable) Toggle op('automation_clip').par.Enable
Default:
On
Options:
Off, On
Basevalue (Basevalue) Float op('automation_clip').par.Basevalue
Default:
0
Range:
-1000000 to 1000000
Gain (Gain) Float op('automation_clip').par.Gain
Default:
1
Range:
-1000000 to 1000000
Offsetout (Offsetout) Float op('automation_clip').par.Offsetout
Default:
0
Range:
-1000000 to 1000000
Doc (Doc) Str op('automation_clip').par.Doc
Default:
"" (Empty String)