This function can be used to modify the stereo panorama (stereo balance) of active voices during their entire life time. So you may for example implement pan 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 panning of all active voices associated with the requested note. So if you are using a layered instrument patch, then it will change the panning of all layers.
The panning changes set by calling function are always applied relatively to
the panning/balance calculated by the synthesis model and sampler format. That means
the various sources of panning/balance factors like MIDI CC #10 and other panning
factors that may be defined by the instrument patch, are always processed and
calculated for the voices first,
and the final stereo balance 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 ??relative??
.
Or in other words: you cannot replace the panning/balance set by other synthesis
sources with this function.
play_note()
instead of using the sampler format's internal support for release trigger samples.
change_pan(??note??, ??pan??, [??relative??])
Argument Name | Data Type | Description |
---|---|---|
??note?? |
Note ID Number | All voices of this note will be modified. [required] |
??panning?? |
Integer Number | Value between -1000 (most left) and +1000 (most right). |
??relative?? |
Integer Number | Whether change_pan() calls should be relative to each other. 0: A call to change_pan() upon the same note will
replace the panning change value set by previous
change_pan() calls upon the same note.1: Successive calls to change_pan() upon the same
note will be relatively applied against each other.[optional, default: 0] |
None.
None yet.
Since LinuxSampler 2.0.0.svn11.