NoteOnIns

Turns on a note for an instrument.

Synopsis

Err NoteOnIns( Item Instrument, int32 Note, int32 Velocity )

Description

This function turns on a note for an instrument and specifies the pitch and velocity for the instrument to play the note. The function does not use voice allocation for the note. It's called by StartScoreNote() after StartScoreNote() has worked out voice allocation.

Arguments

Instrument: The item number of the instrument.

Note: The MIDI pitch value of the note.

Velocity: The MIDI attack velocity value of the note. If attack velocity is 0, the specified note is released (identical behavior to the MIDI Note On event).

Return Value

This function returns a non-negative value if successful or an error code (a negative value) if an error occurs.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib