rsc3/doc-schelp/HelpSource/Reference/softVol_.schelp

52 lines
1.3 KiB
Text
Raw Normal View History

2022-08-24 13:53:18 +00:00
title:: softVol_
summary:: set a nodeproxy's vol conditionally
categories:: Libraries>JITLib>GUI
related:: Reference/softSet, Reference/softPut
description::
Extension method to link::Classes/NodeProxy:: to set vol conditionally.
method:: softVol
setter.
argument:: val
the volume value to set to
argument:: within
the normalized range within which the set is accepted
argument:: pause
a flag whether to pause the nodeproxy when volume is 0.
waits for 0.2 seconds for volume to go down first.
argument:: lastVal
the previous value that the controller has set - can be
argument:: spec
a link::Classes/ControlSpec:: can be passed in. if nil, code::\amp.asSpec:: is used.
Examples::
code::
Ndef(\test, { |freq=200| Splay.ar(SinOsc.ar(freq * Array.rand(12, 0.95, 1.05))) });
Ndef(\test).play(vol: 0.1);
// example of softSet, softSet which knows lastVal,
// softVol_ and softVol_ which knows lastVol:
(
w = Window("softVol", Rect(500, 200, 400, 240)).front;
w.view.addFlowLayout;
NdefGui(Ndef(\test), 2, w);
// same for volume - not too safe
EZSlider(w, 340@30, \softVol, \amp, { |sl|
Ndef(\test).softVol_(sl.value, 0.05)
});
// safer
EZSlider(w, 340@30, \knowLastV, \amp, Routine { |sl|
var newVal, lastVal;
loop {
newVal = sl.value;
Ndef(\test).softVol_(sl.value, 0.05, lastVal: lastVal);
lastVal = newVal;
\dummy.yield;
}
});
)
::