envelope_add_points
Insert automation points into a track or FX parameter envelope, supporting point shapes and tension. Create the envelope if needed.
Instructions
Batch-insert automation points into an envelope.
Point shape codes: 0=linear, 1=square, 2=slow start/end, 3=fast start, 4=fast end, 5=bezier. Tension -1 to +1 for curve skew.
Value units:
Volume track env: linear gain where 1.0 = unity (0 dB), 2.0 ≈ +6 dB, 0.5 ≈ -6 dB. Use 10**(db/20) to convert from dB.
Pan: -1.0 (hard left) to +1.0 (hard right).
Mute: 0.0 or 1.0.
FX params: 0.0-1.0 normalized (same as fx_set_param).
Args:
track_index: Track.
points: JSON array of {"time":s, "value":v, "shape":0, "tension":0}.
envelope_name: Track envelope name (ignored with FX param).
fx_index / param_index: Target FX param envelope (-1 for track env).
create: If the envelope doesn't exist yet, create it (default True).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| points | Yes | ||
| envelope_name | No | Volume | |
| fx_index | No | ||
| param_index | No | ||
| create | No |