This function can be used to modify the tuning of active voices during their entire life time. So you may for example implement very sophisticated pitch envelopes by script by using this function. You need to pass the note ID of the voices you want to alter. This function will change the tuning of all active voices associated with the requested note. So if you are using a layered instrument patch, then it will change the tuning of all layers.
The tuning changes set by calling this function are always applied relatively to
the tuning/pitch calculated by the synthesis model and sampler format. That means
the various sources of tuning/pitch factors like MIDI pitch bend wheel, Pitch Envelopes,
Pitch LFOs and other tuning factors that may be defined by the
instrument patch, are always processed and calculated for the voices first,
and the final pitch applied is always a relative combination of all those
factors and the one set with this function call. This does also not change
when you pass
1 for argument
Or in other words: you cannot replace the tuning/pitch set by other synthesis
sources with this function.
play_note()instead of using the sampler format's internal support for release trigger samples.
change_tune(note, tuning, [relative])
|Argument Name||Data Type||Description|
||Note ID Number or Note ID Array||All voices of this note will be modified.
||Integer Number||Tuning change in milli cents. A positive value increases the tuning, a negative value decreases the tuning.|
||Integer Number||Whether change_tune() calls should be relative to each other.
0: A call to
1: Successive calls to
[optional, default: 0]
Since LinuxSampler 2.0.0.svn11.