Track Arp
track_arpArpeggiate a track's held chords into steps at render, using patterns, step lists, or scale degrees within set bars. Write the arp as plain notes in place of the chords, or turn it off.
Instructions
Arpeggiate a track at render: its held chords (the notes written on it) play as steps, or an exact step list over bars=[a, b]. The same core and settings as live_arp, so a part sounds the same played live and rendered. Any subset of settings changes only those; the first call starts with the defaults for the rest. The track's notes stay as written (notes_read shows the chords); the render plays the arp in their place within its bars. Note source (one of): pattern 'up' (default), 'down', 'updown', 'downup', 'order' (the order the notes start, low first in a chord), 'random', 'chord', or a list of held-note numbers ([1, 3, 2, 4]; 1 = the lowest, 0 = a rest); degrees: scale steps above the lowest held note ([0, 2, 4, 7], needs key and scale); notes: an exact step list 'A3 C4 E4 A4 | F3 A3 C4 F4', one bar per '|' group from bars[0], cycling (needs bars when the track has no notes). rate: beats per step (default 0.25 = 16ths). octaves: 1 to 4 (default 1). key + scale: held notes snap onto the scale; on a step list, key= moves it from the key it was given with, each note kept on its scale degree. transpose: semitones. Per step (a number, or a list cycling on its own length; [] clears): gate (fraction of a step, 0.5), velocity (1-127; default each note's own), accent (0/1: velocity 127), slide (0/1: the step overlaps the next, so a synth with mono and glide glides), octave (-3 to 3), cutoff (Hz: written as the instrument's filter.cutoff on a synth or a sampler with a filter, else the track's first filter effect), pan (-1 to 1, as the track's pan automation over the arp's bars). restart: 'key' (default: each chord starts the pattern again), 'bar', 'off'. swing: 0 to 0.5 of a step. bars=[a, b]: where it plays (default the bars of the track's notes). write=True writes the arp's notes into the track in place of the chords (and the cutoff and pan as automation), and turns the arp off: plain notes to edit (undo brings the chords back). Outside the arp's bars a written lane holds the value the track had at the write (an automation lane is held to the song's ends), so a later track_set pan or filter change does not show there until that lane is changed (automation_set) or cleared; the reply says which. off=True turns it off and keeps the chords.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | ||
| off | No | ||
| pan | No | ||
| bars | No | ||
| gate | No | ||
| rate | No | ||
| notes | No | ||
| scale | No | ||
| slide | No | ||
| swing | No | ||
| track | Yes | ||
| write | No | ||
| accent | No | ||
| cutoff | No | ||
| octave | No | ||
| degrees | No | ||
| octaves | No | ||
| pattern | No | ||
| project | Yes | ||
| restart | No | ||
| velocity | No | ||
| transpose | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |