BufRd | SuperCollider 3.14.0-dev Help

Description

Read the content of a buffer at an index.

In comparison to PlayBuf : PlayBuf plays through the buffer by itself, BufRd only moves its read point by the phase input and therefore has no pitch input. BufRd has variable interpolation.

Class Methods

BufRd.ar(numChannels, bufnum: 0, phase: 0.0, loop: 1.0, interpolation: 2)

BufRd.kr(numChannels, bufnum: 0, phase: 0.0, loop: 1.0, interpolation: 2)

Arguments:

numChannels	Number of channels that the buffer will be. This must be a fixed integer. The architecture of the SynthDef cannot change after it is compiled. NOTE: If you supply a `bufnum` of a buffer that has a different `numChannels` than you have specified to the BufRd, it will post a warning and output the channels it can.
bufnum	The index of the buffer to use.
phase	Audio rate modulateable index into the buffer. WARNING: The phase argument only offers precision for addressing 2**24 samples (about 6.3 minutes at 44100Hz).
loop	1 means true, 0 means false. This is modulateable.
interpolation	1 means no interpolation, 2 is linear, 4 is cubic interpolation. (The numbers one, two, and four correspond to the number of consecutive samples needed to compute each type of interpolation.) Any other values for this argument will silently default to no interpolation.

Examples

(
// read a whole sound into memory
s = Server.local;
// note: not *that* columbia, the first one
b = Buffer.read(s, ExampleFiles.child);
)

// use any AUDIO rate ugen as an index generator

{ BufRd.ar(1, b, SinOsc.ar(0.1) * BufFrames.ir(b)) }.play;
{ BufRd.ar(1, b, LFNoise1.ar(1) * BufFrames.ir(b)) }.play;
{ BufRd.ar(1, b, LFNoise1.ar(10) * BufFrames.ir(b)) }.play;
{ BufRd.ar(1, b, LFTri.ar(0.1) + LFTri.ar(0.23) * BufFrames.ir(b)) }.play;
// original duration
{ BufRd.ar(1, b, LFSaw.ar(BufDur.ir(b).reciprocal).range(0, BufFrames.ir(b))) }.play;

// use a phasor index into the file

{ BufRd.ar(1, b, Phasor.ar(0, BufRateScale.kr(b), 0, BufFrames.kr(b))) }.play;

// change rate and interpolation
(
x = { |rate = 1, inter = 2|
    BufRd.ar(1, b, Phasor.ar(0, BufRateScale.kr(b) * rate, 0, BufFrames.kr(b)), 1, inter)
}.play;
)

x.set(\rate, 0.9);
x.set(\rate, 0.6);
x.set(\inter, 1);
x.set(\inter, 0);

// write into the buffer with a BufWr
(
y = { |rate = 1|
    var in;
    in = SinOsc.ar(LFNoise1.kr(2, 300, 400), 0, 0.1);
    BufWr.ar(in, b, Phasor.ar(0, BufRateScale.kr(b) * rate, 0, BufFrames.kr(b)));
    0.0 // quiet
}.play;
)

// read it with a BufRd
(
x = { |rate = 1|
    BufRd.ar(1, b, Phasor.ar(0, BufRateScale.kr(b) * rate, 0, BufFrames.kr(b)))
}.play;
)

x.set(\rate, 5);
y.set(\rate, 2.0.rand);
x.set(\rate, 2);

b.free

helpfile source: /usr/local/share/SuperCollider/HelpSource/Classes/BufRd.schelp
link::Classes/BufRd::

BufRd : MultiOutUGen : UGen : AbstractFunction : Object

Description

Class Methods

BufRd.ar(numChannels, bufnum: 0, phase: 0.0, loop: 1.0, interpolation: 2)

BufRd.kr(numChannels, bufnum: 0, phase: 0.0, loop: 1.0, interpolation: 2)

Arguments:

Inherited class methods

Instance Methods

Inherited instance methods

Examples