#lang scribble/manual
@(require (for-label racket))

@title{PbindProxy}
 incremental event pattern reference@section{categories}
  Libraries>JITLib>Patterns,  Streams-Patterns-Events>Patterns, Live Coding
@section{related}
  Classes/Pbindef, Classes/Pdef

@section{description}

keeps a reference to a link::Classes/Pbind:: in which single keys can be replaced. It plays on when the old stream ended and a new stream is set and schedules the changes to the beat.

@section{ClassMethods}
 

@section{method}
 new
create a new instance of PbindProxy with the given patternpairs

@section{InstanceMethods}
 

@section{method}
 source
returns the wrapper for the Pbind

@section{method}
 set
set the given patternpairs.

@section{method}
 at
return a pattern at that key. this can be used to set quant value individually, so different elementary patterns can be quantized differently.

@racketblock[
x.at(\freq).quant = 2;
::

]
@section{method}
 quant
set the quant of all elementary patterns, or return the quant value of the source pattern.

@section{Examples}
 


@racketblock[
(
SynthDef("Pdefhelp", { arg out, freq, sustain=1, amp=1, pan;
	var env, u=1;
	env = EnvGen.kr(Env.perc(0.03, sustain), 1, doneAction: Done.freeSelf);
	5.do { var d; d = exprand(0.01, 1); u = SinOsc.ar(d * 300, u, rrand(0.1,1.2) * d, 1) };
	Out.ar(out, Pan2.ar(SinOsc.ar(u + 1 * freq, 0, amp * env), pan));
}).add;
)
s.boot;


x = PbindProxy.new;
x.set(\instrument, \Pdefhelp);

x.play;

x.set(\degree, Pseq([0, 2, 5b, 1b], inf));
x.set(\dur, 0.1);
x.set(\degree, Pseq([1b, 5, 3, 1b, 6, 2, 5, 0, 3, 0, 2], inf));
x.set(\legato, Prand([1.0, 2.4, 0.2], inf), \mtranspose, -3);
x.set(\mtranspose, nil); // remove key

x.set(\degree, Pseq([1, 2, 3, 4, 5, 6], 1));
x.play;

x.set( \degree, Pseq([1, 2, 3, 4, 5, 6], 3), \dur, 0.02);
x.play;

x.set(\degree, Pseq([1, 2, 3, 4, 5, 6], 3), \dur, 0.1);
x.play;


// embed in other patterns:
(
x.set(\degree, Pseq([1b, 5, 3, 1b, 6, 2, 5, 0, 3, 0, 2], inf));
Ppar([
x,
Pbindf(x, \ctranspose, 4)
]).play;
)


x.set(\degree, Pseq([1b, 5, 1b, 4, 0], inf), \dur, 0.4);
::
]