NoteOffIns

Turns off a note played by an instrument.

Synopsis

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

Description

This function releases a note being played by an instrument and specifies the pitch and velocity for the instrument to release the note. The function does not use voice allocation for the note. It's called by ReleaseScoreNote() after ReleaseScoreNote() has worked out voice allocation.

Arguments

Instrument: The item number of the instrument.

Note: The MIDI pitch value of the note.

Velocity: The MIDI release velocity value of the note.

Return Value

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

Caveats

At present, release velocity is ignored.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib