set_event_par()

This function can be used to change the current value of a certain parameter of the requested note. If the passed note ID is invalid or if the requested note is no longer alive, then this function does nothing.

You might use function get_event_par() to retrieve the current value of those parameters.

Function Prototype

set_event_par(??note??, ??parameter??, ??value??)

Arguments

Argument Name Data Type Description
??note?? Note ID Number or Note ID Array The note whose current parameter shall be changed.
[required]
??parameter?? Integer Number The actual parameter whose value should be modified. This must be one of the following built-in constants:
$EVENT_PAR_NOTE: Change the note's MIDI note number (only possible when note is new).
$EVENT_PAR_TUNE: Change the note's tuning in milli cents (currently ignored, use change_tune() instead).
$EVENT_PAR_VELOCITY: Change the note's MIDI note velocity (only possible when note is new).
$EVENT_PAR_VOLUME: Change the note's volume (currently ignored, use change_vol() instead).
$EVENT_PAR_0 to $EVENT_PAR_3: To change the current value of one of the 4 available user specific parameters. Those user parameters are not used by the sampler itself, they can be used by the script author to pass data from one script (slot) to another script (slot) for example, or as an alternative to polyphonic variables.
[required]
??value?? Integer Number The new value to set for the selected ??parameter??. The precise value range and meaning differs and depends on the respective parameter (see description of argument ??parameter?? above).
[required]

Return Value

None.

Examples

None yet.

See also

get_event_par(), change_vol(), change_tune()

Availabilty

Since LinuxSampler 2.0.0.svn46.