Documents
Writing Docs Gigedit SFZ Instrument Scripts NKSP Language NKSP Reference

change_release()

This function can be used to modify the amplitude release time of active voices of a particular note. In contrast to other synthesis parameter related functions, this function only allows to change the release 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 release 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 release time changes set by calling this function are always applied relatively to the release time calculated by the synthesis model and sampler format. That means the various sources of release factors like MIDI CCs and other release parameter factors that may be defined by the instrument patch, are always processed and calculated for the voices first, and the final release 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 release set by other synthesis sources with this function.

Release Trigger Samples: In case the affected voices cause release trigger samples to be spawned later on, the release time of those release trigger voices will not be affected by this function at all. So if you need to control the release time of release trigger samples by script, then you might rather also trigger those release trigger samples by script with play_note() instead of using the sampler format's internal support for release trigger samples.

Function Prototype

change_release(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 release 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.

Document Updated:  2019-09-16  |  Author:  Christian Schoenebeck