ZRegion struct

A region (clip) is an object on the timeline that contains either MidiNote's or AudioClip's.

Contents

It is uniquely identified using its name, so it must be unique throughout the Project.

Public variables

ArrangerObject base
Base struct.
RegionIdentifier id
Unique ID.
char* name
Name to be shown on the widget.
GdkRGBA color
TODO region color independent of track.
MidiNote** midi_notes
MIDI notes.
MidiNote* unended_notes
Unended notes started in recording with MIDI NOTE ON signal but haven't received a NOTE OFF yet.
int pool_id
Audio pool ID of the associated audio file, mostly use during serialization.
bool stretching
Whether currently running the stretching algorithm.
double before_length
The length before stretching, in ticks.
double stretch_ratio
Used during arranger UI overlay actions.
sample_t* frames
Frames to actually use, interleaved.
sample_t* ch_frames
Per-channel frames for convenience.
RegionMusicalMode musical_mode
Musical mode setting.
AutomationPoint** aps
The automation points.
AutomationPoint* last_recorded_ap
Last recorded automation point.
ChordObject** chord_objects
ChordObject's in this Region.
PangoLayout* layout
Cache layout for drawing the name.
PangoLayout* chords_layout
Cache layout for drawing the chord names inside the region.
int bounce
Set to ON during bouncing if this region should be included.
GdkRectangle last_main_draw_rect
Last main draw rect.

Variable documentation

GdkRGBA ZRegion::color

TODO region color independent of track.

If null, the track color is used.

MidiNote* ZRegion::unended_notes

Unended notes started in recording with MIDI NOTE ON signal but haven't received a NOTE OFF yet.

This is also used temporarily when reading from MIDI files.

FIXME allocate.

bool ZRegion::stretching

Whether currently running the stretching algorithm.

If this is true, region drawing will be deferred.

sample_t* ZRegion::frames

Frames to actually use, interleaved.

Properties such as AudioClip::channels can be fetched from the AudioClip.

AutomationPoint** ZRegion::aps

The automation points.

Must always stay sorted by position.

int ZRegion::bounce

Set to ON during bouncing if this region should be included.

Only relevant for audio and midi regions.