rsc3/doc-schelp/HelpSource/Classes/Ptpar.scrbl

54 lines
1.1 KiB
Racket

#lang scribble/manual
@(require (for-label racket))
@title{Ptpar}
embed event streams in parallel, with time offset@section{related}
Classes/Ppar
@section{categories}
Streams-Patterns-Events>Patterns>Parallel
@section{description}
Embeds several event streams so that they form a single output stream with all their events in temporal order, providing a global strong::offset:: for each. When one stream ends, the other streams are further embedded until all have ended.
@section{ClassMethods}
@section{method}
new
@section{argument}
list
list of pairs of times and patterns: [time, pat, time, pat .. ].
@section{argument}
repeats
repeat the whole pattern n times.
@section{Examples}
@racketblock[
// see the delta values in the resulting events
(
var a, b, c, t;
a = Pbind(\x, Pseq([1, 2, 3, 4]), \dur, 1);
b = Pbind(\x, Pseq([10, 20, 30, 40]), \dur, 0.4);
c = Ptpar([0.0, a, 1.3, b]);
t = c.asStream;
20.do({ t.next(Event.default).postln; });
)
// sound example
(
var a, b;
a = Pbind(\note, Pseq([7, 4, 0], 4), \dur, Pseq([1, 0.5, 1.5], inf));
b = Pbind(\note, Pseq([5, 10, 12], 4), \dur, 1);
Ptpar([ 0.0, a, 1.3, b ]).play;
)
::
]