PLn | SuperCollider 3.13.0 Help

Description

Takes Symbol args for later reference by the Streams, which will read from variables in the Environments of their instantiation. See PLx_suite. In contrast to PL a replacement doesn't take effect immediately, but with the next embedding. This behaviour might be preferred with syncing.

NOTE: As sources are finished before next replacements are possible, infinite source streams, other than with other PLx patterns, inhibit further replacements at all. For the option of finishing substreams with PLx list patterns see their cutItems arg and Ex.3.

Class Methods

.new

Creates a new PL object.

Arguments:

item	Symbol or other Object. If a Symbol is passed, item can be assigned to an envir variable later on. Can be dynamically replaced by Patterns or Streams.
repeats	Symbol or repeats arg. If a Symbol is passed, repeats can be assigned to an envir variable later on. Defaults to inf.
envir	Dictionary or one of the Symbols \top, \t (topEnvironment), \current, \c (currentEnvironment). Dictionary to be taken for variable reference. Defaults to \current.

Examples

Ex.1: Protection of periods

Ex.2: Protection of periods for syncing

Ex.3: Protection of periods and subperiods with event streams

// define two Pbinds of same length, play first

(
x = Pbind(
    \dur, Pseq([0.4, 0.2, 0.2]),
    \note, Pseq([4, 2, 0]) 
);

y = Pbind(
    \dur, 0.2,
    \note, Pseq([7, 7, 5, 4]) 
);

~a = x;

PLn(\a).play;
)

// switch between them several times, periods are protected

~a = y;

~a = x;

// define a sequence of parts, we want to exchange parts later on

(
~trill_1 = Pbind(
    \dur, 0.4/3,
    \note, Pseq([7, 9, 7]) 
);

~trill_2 = Pbind(
    \dur, 0.4/5,
    \note, Pseq([7, 8, 7, 8, 7]) 
);

~fin = Pbind(
    \dur, 0.2,
    \note, Pseq([5, 4]) 
);

~b = [~trill_1, ~fin];
)

// replace with a PLseq
// note that source must have repeats = 1,
// in order to protect substreams with PLseq and change the behaviour later on
// we pass to cutItmes a Function that, for now, returns false

(
~cutItems = false;
~a = PLseq(\b, 1, cutItems: \cutItems);

~b[0] = ~trill_2;
)

// helper function to generate trill patterns

~trill = { |lo, hi, dur, reps| Pbind(\dur, dur / reps, \note, Pser([lo, hi], reps)) };

// replace with a long slow trill

~b[0] = ~trill_3 = ~trill.(7, 9, 0.9, 5);

// replace back while long trill, 
// due to the current value ~cutItems = false it will be completed and
// replacement takes effect in next loop
    
~b[0] = ~trill_2;

// replace back

~b[0] = ~trill_3;

// change replacing behaviour

~cutItems = true;

// now replacing while long trill will take immediate effect

~b[0] = ~trill_2;

// stop

~a = nil

helpfile source: HelpSource/Classes/PLn.schelp
link::miSCellaneous_lib/Classes/PLn::

PLnExtension