change_attack()
This function can be used to modify the amplitude attack time of active voices of a
particular note.
In contrast to other synthesis parameter related functions,
this function only allows to change the attack time when the respective note
is new, that is either i.e. at the beginning of a note
event handler or right after calling play_note()
. So you should
perform the attack value change as soon as possible, especially before calling any
wait()
function and before entering a loop which might take a
long time to execute (which might cause your script to get
forcely suspended by the script engine due to real-time constraints).
The attack time changes set by calling this function are always applied relatively to the attack time calculated by the synthesis model and sampler format. That means the various sources of attack factors like MIDI CCs and other attack parameter factors that may be defined by the instrument patch, are always processed and calculated for the voices first, and the final attack time applied is always a relative combination of all those factors and the one set with this function call. Or in other words: you cannot replace the attack set by other synthesis sources with this function.
play_note()
instead of using the sampler format's internal support for release trigger samples.
Function Prototype
change_attack(note, time)
Arguments
Argument Name | Data Type | Description |
---|---|---|
note |
Note ID Number or Note ID Array | All voices of this note will be modified. [required] |
time |
Integer Number or Real Number |
Attack Time Value (abstract non-negative value,
0 for shortest time, 1000000 for neutral time factor,
2000000 for doubling the effective attack time).[required] |
Return Value
None.
Remarks
This functions optionally accepts s
as standard unit and
finalness for its argument time
.
Examples
None yet.
Availability
Since LinuxSampler 2.0.0.svn19.
Prior to LinuxSampler 2.0.0.svn68 the value range for time
was limited to a maximum value of 1000000
.