Notes in ARA correspond to what a composer would notate to describe the music. Notes are described by their position in time, their pitch and their relative volume. The pitch can be interpreted as frequency, but ARA also offers a musical description of the pitch very similar to MIDI: it defines the tuning for the overall musical scale and provides an integer number to identify the pitch for each note within this tuning, along with an average detune for each note actually played. ARA pitch numbers match MIDI note numbers, so that the note A4 has the value 69. This note is also used to specify the tuning reference, commonly at 440 Hz. At 440 Hz reference tuning the ARA pitch number 0 thus equals 8.1757989 Hz. Some notes may not have a well-defined pitch, such as percussive notes. For such notes, a frequency of kARAInvalidFrequency and a pitch number of kARAInvalidPitchNumber are used.
|
| struct | ARAContentNote |
| | Content reader event class: notes provided by kARAContentTypeNotes. Event sort order is by startPosition. As with all content readers, a pointer to this struct retrieved via getContentReaderDataForEvent() is still owned by the callee and must remain valid until either getContentReaderDataForEvent() is called again or the reader is destroyed via destroyContentReader(). More...
|
| |
|
|
typedef ARAInt32 | ARAPitchNumber |
| | Quantized pitch, corresponds to the MIDI note number in the range 0...127, but may exceed this range.
|
| |
◆ ARAContentNote
Content reader event class: notes provided by kARAContentTypeNotes. Event sort order is by startPosition. As with all content readers, a pointer to this struct retrieved via getContentReaderDataForEvent() is still owned by the callee and must remain valid until either getContentReaderDataForEvent() is called again or the reader is destroyed via destroyContentReader().
Public Attributes |
|
float | frequency |
| | Average frequency in Hz, kARAInvalidFrequency if note has no defined pitch (percussive).
|
| |
|
ARAPitchNumber | pitchNumber |
| | Index corresponding to MIDI note number (or kARAInvalidPitchNumber).
|
| |
|
float | volume |
| | Normalized level: 0.0f (weak) <= level <= 1.0f (strong). This value is scaled according to human perception (i.e. closer to a dB scale than to a linear one).
|
| |
|
ARATimePosition | startPosition |
| | Time marking the beginning of the note (aka "note on" in MIDI), relative to the start of the described object (audio source/playback region).
|
| |
|
ARATimeDuration | attackDuration |
| | Time marking the musical/quantization anchor of the note, relative to the start of the note.
|
| |
|
ARATimeDuration | noteDuration |
| | Time marking the release point of the note (aka "note off" in MIDI), relative to the start of the note.
|
| |
|
ARATimeDuration | signalDuration |
| | Time marking the end of the entire sound of the note (end of release phase), relative to the start of the note.
|
| |