NoteGroupReference

A deep copy of the current object.

Note: since NoteGroupReference does not take ownership of the target NoteGroup, this does not copy the target NoteGroup.

The duration of this NoteGroupReference (blicks).

Equivalent to getEnd() - getOnset().

Get the ending position (blicks), that is, the end of the last note in the target NoteGroup plus the time offset.

If the NoteGroupReference holds an audio file (NoteGroupReference#isInstrumental), getEnd() will return the ending position (blicks) of the audio plus the time offset. However, if the NoteGroupReference is not placed inside a Project, there is not enough information to determine the audio's length in musical time units and getEnd() will assume that the duration is zero.

Get index of the current object in its parent. In Lua, this index starts from 1. In JavaScript, this index starts from 0.

Get the beginning position (blicks), that is, the onset of the first Note in the target NoteGroup plus the time offset.

Get the parent NestedObject. Return undefined if the current object is not attached to a parent.

Get the pitch shift (semitones) applied to all notes in the target NoteGroup}.

Get the target NoteGroup.

Get the time offset (blicks) applied to all notes in the target NoteGroup.

Get an object holding the default voice properties for this group, similar to Note#getAttributes.

The object has the following properties.

• tF0Left: number pitch transition - duration left (seconds)
• tF0Right: number pitch transition - duration right (seconds)
• dF0Left: number pitch transition - depth left (semitones)
• dF0Right: number pitch transition - depth right (semitones)
• tF0VbrStart: number vibrato - start (seconds)
• tF0VbrLeft: number vibrato - left (seconds)
• tF0VbrRight: number vibrato - right (seconds)
• dF0Vbr: number vibrato - depth (semitones)
• fF0Vbr: number vibrato - frequency (Hz)
• paramLoudness: number parameters - loudness (dB)
• paramTension: number parameters - tension
• paramBreathiness: number parameters - breathiness
• paramGender: number parameters - gender

Whether this NoteGroupReference refers to an external audio file. If so, it must not refer to a NoteGroup.

Whether this NoteGroupReference refers to the parent Track's main group.

Check whether or not the current object is memory managed (i.e. garbage collected by the script environment).

Set the pitch offset to pitchOffset (semitones).

Set the target NoteGroup.

Note that once set, the target can't be changed.

Set the time offset to blickOffset (blicks).

Set voice properties based on an attribute object (for the definition, see NoteGroupReference#getVoice). The attribute object does not have to be complete; only the given properties will be updated (see Note#setAttributes).