softPut | SuperCollider 3.12.2 Help

Description

softPut is an extension method to Dictionary that changes an existing numerical value for key in a dictionary only in two conditions:

if the new value is close enough to the current value at that key;
or if the setting controller knows the previous value and sends it along. the idea here is that if the controller knows it did the last value change, it has authority to jump now.

Typical uses would be switching to a new preset, then using a faderbox, and avoiding sudden controller jumps that could occur (soft takeover).

param	the name of the parameter (key) to set
val	the value to set the param to (can be mapped or unmapped)
within	the normalized range within which the set is accepted - default is 0.025
mapped	a flag whether val is mapped (within the range of param.asSpec) or unmapped (0.0-1.0)
lastVal	the previous value that a control has set - see last examples.
spec	a ControlSpec can be passed in. if nil, param.asSpec is used. NOTE: if no spec is given, or no value exists yet, softSet simply allows setting.