change_note()

Changes the MIDI note number of the requested note.

Changing the note number with this function only succeeds if the respective note is new. That effectively means you should change the note number before any wait() calls, and before entering any loops that may execute your script for a very long time. Because in both cases the sampler may suspend your script for a certain amount of time and once your script got resumed, the respective event and the resulting note may already have entered the sampler's regular event processing chain and thus the note's note number can no longer be changed.

Function Prototype

change_note(??event-id??, ??note-number??)

Arguments

Argument Name Data Type Description
??event-id?? Event ID Number Event ID of the note to change.
[required]
??note-number?? Integer Number New MIDI note number (0 to 127).
[required]

Return Value

None.

Examples

None yet.

See also

set_event_par(), change_velo()

Availability

Since LinuxSampler 2.0.0.svn49.