HelpSource/Classes/IEnvGen.schelp

   1 class:: IEnvGen
   2 summary:: Envelope generator for polling values from an InterplEnv
   3 categories:: UGens>Envelopes
   4 related:: Classes/InterplEnv
   5
   6 description::
   7 Envelope generator for polling values from an InterplEnv. IEnvGen plays back break point envelopes from the code::index:: point. The envelopes are instances of the link::Classes/InterplEnv:: class.
   8
   9 classmethods::
  10 private:: categories, new1
  11
  12 method:: ar, kr
  13
  14 argument:: ienvelope
  15 an instance of InterplEnv (this is static for the life of the UGen)
  16 argument:: index
  17 a point to access within the InterplEnv
  18
  19 instancemethods::
  20 private:: init, argNamesInputsOffset
  21
  22 examples::
  23
  24 code::
  25 SynthDef(\test, {arg gate = 1;
  26         var env, sin;
  27         sin = SinOsc.ar(440, 0, 1);
  28         env = InterplEnv([0, 0.6, 0.3, 1.0, 0], [0.1, 0.02, 0.4, 1.1], [\lin, \exp, -6, \sin]).plot;
  29         Out.ar(0, sin *
  30                 // use MouseX to index into the InterplEnv to control amps
  31                 IEnvGen.kr(env, MouseX.kr(0, env.times.sum)) *
  32                 EnvGen.kr(Env.asr(0.01, 1, 0.01), gate, doneAction: 2);
  33                 )
  34 }).add;
  35
  36 s = Server.internal.boot;
  37 s.scope;
  38
  39 s.sendMsg(\s_new, \test, a = s.nextNodeID, 0, 1);
  40 s.sendMsg(\n_set, a, \gate, 0);
  41
  42 // index with an SinOsc ... mouse controls amplitude of SinOsc
  43 SynthDef(\test, {
  44         var env, sin;
  45         sin = SinOsc.ar(440, 0, MouseX.kr(0, 1));
  46         // use offset so negative values of SinOsc will map into the InterplEnv
  47         env = InterplEnv([-1, -0.7, 0.7, 1], [ 0.8666, 0.2666, 0.8668 ], \lin, -1.0);
  48         Out.ar(0, IEnvGen.ar(env, sin))
  49 }).add;
  50
  51 s.sendMsg(\s_new, \test, a = s.nextNodeID, 0, 1);
  52 s.sendMsg(\n_free, a);
  53
  54
  55 // index with Amplitude of input, control freq of SinOsc
  56 SynthDef(\test, {arg inbus;
  57         var env, point;
  58         point = Amplitude.ar(In.ar(inbus), 0.01, 0.2);
  59         // use offset so negative values of SinOsc will map into the InterplEnv
  60         env = InterplXYC([[0, 330, \exp], [0.5, 440, \exp], [1.0, 1760]]);
  61         Out.ar(1, SinOsc.ar(IEnvGen.kr(env, point), 0, 0.2))
  62 }).add;
  63
  64 s.sendMsg(\s_new, \test, a = s.nextNodeID, 0, 1, \inbus, s.options.numOutputBusChannels);
  65 s.sendMsg(\n_free, a);
  66 ::
  67