Items, takes, envelopes and FX chains are nested blocks inside a track. Public documentation of their fields is thinner than for tracks. This page gives what the sources confirm and says plainly where they stop; the Cockos wiki’s “State Chunk Definitions” page is the main source for these blocks and was available only in excerpts when this was written.
ITEM
An <ITEM block holds one media item. Its position and length are
POSITION and LENGTH, in seconds. It holds a nested
<SOURCE block.
| Keyword | Fields | Meaning |
|---|---|---|
POSITION | num | Position in seconds |
LENGTH | num | Length in seconds |
IGUID | str | The item’s GUID. The Cockos wiki advises leaving it alone. |
FADEIN | int, num, num | Fade-in curve type (0 linear), fade length in seconds, and a further value |
VOLPAN | num… | The first field is item trim, not the take’s volume; the others relate to the first take |
PLAYRATE | num, int, num, int | Play rate, preserve pitch (0 or 1), pitch adjustment in semitones and cents, and an integer not documented |
SOURCE
The block’s header gives the type, for example <SOURCE WAVE, and it
contains FILE with a path, such as FILE "Audio/vocals.wav".
Other source types, such as MIDI, have other contents.
FXCHAIN
A track’s <FXCHAIN block holds its plug-ins. A real file shows
SHOW, LASTSEL, DOCKED and BYPASS
keywords, then a nested block per plug-in, named after its type (for example
<AU or <VST), whose body is base64 state. Each plug-in
is followed by keywords such as FLOAT, FXID and
WAK.
Envelopes
Envelope blocks such as MASTERPLAYSPEEDENV, TEMPOENVEX and
PARMENV share these keywords, seen in real files:
| Keyword | Meaning |
|---|---|
ACT | Whether the envelope is active |
VIS | Whether the envelope is visible, and its lane state |
LANEHEIGHT | Lane height |
ARM | Whether it is armed |
DEFSHAPE | Default point shape |
PT | One envelope point, for example PT 0 0.5 0. The meanings of its fields are not confirmed here. |
Not confirmed
- The remaining item and take keywords and their fields (
LOOP,ALLTAKES,FADEOUT,MUTE,SEL,IID,NAME,SOFFS,CHANMODE,GUIDand others). The keyword names are known from real files and from ReaScript attribute names, but this page does not give field meanings without a source. - How takes after the first are marked, and what they repeat.
- The contents of
SOURCE MIDIblocks, including their event lines. - The fields of
VIS,DEFSHAPE, and the trailing fields ofPT; and the FX chain’s keywords in full.