/usr/share/SuperCollider/HelpSource/Classes/Pfset.schelp is in supercollider-common 1:3.8.0~repack-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 | class:: Pfset
summary:: Insert an environment into the event prototype before evaluating the supplied pattern
related:: Classes/Pset
categories:: Streams-Patterns-Events>Patterns>Data Sharing
description::
Good for setting default values or loading server objects.
classmethods::
method:: new
argument:: func
Use environment variable syntax (e.g., code:: ~x = 0 ::) to store values in the internal environment. These values are copied into the event prototype before running the supplied pattern.
argument:: pattern
An event pattern (such as link::Classes/Pbind::).
argument:: cleanupFunc
Optional. A function to evaluate when the pattern is stopped, or when the supplied pattern runs out of values. For example, if you loaded a link::Classes/Buffer:: in the initializer function, you could free it in the code::cleanupFunc::.
examples::
code::
(
var a, b;
a = Pfset({
~legato = 0.3;
~detune = rrand(0, 30);
}, Pbind(\dur, 0.5));
x = a.asStream;
9.do({ x.next(Event.new).postln; });
)
::
Pfset does not override values placed into the event by the inner pattern:
code::
(
var a, b;
a = Pfset({
~dur = 0.3;
}, Pbind(\dur, 0.5));
x = a.asStream;
9.do({ x.next(Event.new).postln; });
)
::
Sound example
code::
(
SynthDef(\sinegrain,
{ arg out = 0, freq = 440, sustain = 0.02;
var env;
env = EnvGen.kr(Env.perc(0.001, sustain), 1, doneAction:2);
Out.ar(out, SinOsc.ar(freq, 0, env * 0.1))
}).add;
)
(
a = Pbind(\dur, 0.5, \instrument, \sinegrain, \x, Pfunc { rrand(500, 600) });
a = Pfset({ ~freq = { ~x.postln * 2 }; ~legato = 3; }, a);
a.play;
)
::
|