A track is a <TRACK {GUID} block, its header naming the track’s GUID. The
tables follow the Ultraschall documentation and, for VOLPAN and the fields it
marks, the Cockos wiki. The same text is what REAPER’s
GetTrackStateChunk returns.
Keywords
| Keyword | Fields | Meaning |
|---|---|---|
NAME | str | Track name |
PEAKCOL | int | Colour, in the native format: 0x1BBGGRR, where 0x1000000 means a colour is set. |
BEAT | num | Timebase: −1 project, 0 time, 1 beats (position, length, rate), 2 beats (position only) |
AUTOMODE | int | 0 trim/read, 1 read, 2 touch, 3 write, 4 latch |
AUTO_RECARM | int | 1 when automatic record arm is on; absent otherwise |
VOLPAN | num × 5 | Volume, pan, pan law, then two further fields not documented |
MUTESOLO | int, int, int | Mute (0 or 1), solo (0 off, 1 solo ignoring routing, 2 solo in place), solo defeat (0 or 1) |
IPHASE | num | 0 normal, 1 inverted |
ISBUS | int, int | 1 1 is a folder, 2 −1 ends a folder, 0 0 otherwise. The Cockos wiki marks this as unconfirmed. |
BUSCOMP | num, num | Folder compaction: 0 none, 1 compacted, 2 minimised; second field 0 or 1, unknown |
SHOWINMIX | 8 fields | Mixer visible (0 or 1), mixer FX visibility (0 visible, 1 parameters visible, 2 hidden), send area ratio, track-panel visible (0 or 1), four more not documented |
SEL | int | 1 selected, 0 not |
FREEMODE | int | 1 if free item positioning is on |
REC | int × 7 | See below. |
VU | int | 2 multichannel metering on, 3 off; absent when not set |
TRACKHEIGHT | int, int, int | Height (24 to 443), 0 use the height or 1 compact, third unknown |
INQ | int, int, int, num, int, int, int, int | See below. |
NCHAN | int | Number of track channels |
FX | int | 0 bypassed, 1 not |
TRACKID | str | The track’s GUID |
PERF | int | 0 allow anticipative FX and media buffering, 1 allow FX and prevent buffering, 2 prevent FX and allow buffering, 3 prevent both |
MIDIOUT | int | −1 none. Negative values give a MIDI destination and channel; the documentation lists few and writes some with doubled signs. |
MAINSEND | int, int | Send to parent (0 or 1), and the parent channel (0 to 63) |
GROUP_FLAGS | 23 × int | Membership of groups 1 to 32. See below. |
GROUP_FLAGS_HIGH | 23 × int | The same for groups 33 to 64 |
LOCK | int | 1 locked; absent otherwise |
LAYOUTS | str, str | Track panel and mixer layout names |
TRACKIMGFN | str | Track image file |
RECCFG | block | Track’s recording format, base64. Also an integer in the header: 0 project default, 1 customised. |
MIDI_INPUT_CHANMAP | int | 0 means channel 1, 1 channel 2 and so on; absent when not set |
MIDICTL | int, int | Link to MIDI channel; the second is unknown |
WIDTH | num | −1 to 1 |
PANMODE | int | 0 REAPER 3.x balance (deprecated), 3 stereo balance/mono pan, 5 stereo balance, 6 dual pan; absent for project default |
MIDICOLORMAPFN, MIDIBANKPROGFN, MIDIEXTSTRFN | str | MIDI colour map, bank and program names, text strings; absent when not set |
SCORE | int, int, num, num | Not documented |
REC
| Field | Name | Values |
|---|---|---|
| 1 | Arm | 1 armed, 0 not |
| 2 | Input | −1 none; 1 to 16 mono input; 1024 stereo 1/2, 1026 stereo 3/4, 1028 stereo 5/6; 5056 virtual MIDI keyboard all channels, 5057 to 5072 channels 1 to 16; 5088 all MIDI inputs all channels, 5089 to 5104 channels 1 to 16. The sign of some values is uncertain in the source. |
| 3 | Monitor | 0 off, 1 on, 2 on (tape style) |
| 4 | Record mode | 0 input (audio or MIDI), 1 output stereo, 2 disabled (monitoring only), 3 output stereo with latency compensation, 4 output MIDI, 5 output mono, 6 output mono with compensation, 7 MIDI overdub, 8 MIDI replace, 9 MIDI touch replace, 10 output multichannel, 11 multichannel with compensation, 12 input force mono, 13 force stereo, 14 force multichannel, 15 force MIDI, 16 MIDI latch replace |
| 5 | Monitor track while recording | 0 or 1 |
| 6 | Preserve PDC delayed monitoring in items | |
| 7 | Record path | 0 primary only, 1 secondary only, 2 both |
INQ
| Field | Type | Meaning |
|---|---|---|
| 1 | int | Quantise MIDI, 0 or 1 |
| 2 | int | Position: −1 previous, 0 nearest, 1 next |
| 3 | int | Quantise note-offs, 0 or 1 |
| 4 | num | Quantise to, as a fraction of a beat |
| 5 | int | Strength |
| 6 | int | Swing strength |
| 7 | int | Range minimum |
| 8 | int | Range maximum |
Fields 5 to 8 run from −128 to 127.
GROUP_FLAGS
Each of the 23 fields is a bit field of group numbers, with the value 1 for group 1 up
to the bit for group 32. In GROUP_FLAGS_HIGH the low bit is group 33. The
fields are, in order:
Volume master, volume slave, pan master, pan slave, mute master, mute slave, solo master, solo slave, record arm master, record arm slave, polarity master, polarity slave, automation mode master, automation mode slave, reverse volume, reverse pan, do not master when slaving, reverse width, width master, width slave, VCA master, VCA slave, VCA pre-FX slave.
Not confirmed
- Fields that the sources describe as unknown, listed above.
- The full meaning of
ISBUSandBUSCOMP, and the enumeration ofMIDIOUTvalues.