103 lines
1.5 KiB
Text
103 lines
1.5 KiB
Text
|
class:: Index
|
||
|
|
summary:: Index into a table with a signal
|
||
|
|
related:: Classes/WrapIndex, Classes/Shaper
|
||
|
|
categories:: UGens>Buffer
|
||
|
|
|
||
|
|
Description::
|
||
|
|
Index into a table with a signal.
|
||
|
|
The input signal value is truncated to an integer value and used as an
|
||
|
|
index into the table. Out-of-range index values are clipped to the valid
|
||
|
|
range.
|
||
|
|
|
||
|
|
classmethods::
|
||
|
|
|
||
|
|
method::ar, kr
|
||
|
|
|
||
|
|
argument::bufnum
|
||
|
|
Index of the buffer.
|
||
|
|
|
||
|
|
argument::in
|
||
|
|
The input signal.
|
||
|
|
|
||
|
|
argument::mul
|
||
|
|
Output will be multiplied by this value.
|
||
|
|
|
||
|
|
argument::add
|
||
|
|
This value will be added to the output.
|
||
|
|
|
||
|
|
|
||
|
|
Examples::
|
||
|
|
code::
|
||
|
|
// indexing into a fixed table
|
||
|
|
(
|
||
|
|
{
|
||
|
|
SinOsc.ar(
|
||
|
|
Index.kr(
|
||
|
|
LocalBuf.newFrom([ 200, 300, 400, 500, 600, 800 ]),
|
||
|
|
LFSaw.kr(2.0).range(0, 7)
|
||
|
|
),
|
||
|
|
0,
|
||
|
|
0.5
|
||
|
|
)
|
||
|
|
}.play;
|
||
|
|
)
|
||
|
|
|
||
|
|
// with mouse control
|
||
|
|
(
|
||
|
|
{
|
||
|
|
SinOsc.ar(
|
||
|
|
Index.kr(
|
||
|
|
LocalBuf.newFrom([ 200, 300, 400, 500, 600, 800 ]),
|
||
|
|
MouseX.kr(0, 7)
|
||
|
|
),
|
||
|
|
0,
|
||
|
|
0.5
|
||
|
|
)
|
||
|
|
}.play;
|
||
|
|
)
|
||
|
|
|
||
|
|
(
|
||
|
|
// indexing into a changeable table
|
||
|
|
s = Server.local;
|
||
|
|
t = [ 200, 300, 400, 500, 600, 800 ];
|
||
|
|
b = Buffer(s, t.size, 1);
|
||
|
|
|
||
|
|
// alloc and set the values
|
||
|
|
s.listSendMsg( b.allocMsg( b.setnMsg(0, t) ).postln );
|
||
|
|
|
||
|
|
SynthDef(\help_Index, { arg out = 0, i_bufnum = 0;
|
||
|
|
Out.ar(0,
|
||
|
|
SinOsc.ar(
|
||
|
|
Index.kr(
|
||
|
|
i_bufnum,
|
||
|
|
LFSaw.kr(2).range(0, 7)
|
||
|
|
),
|
||
|
|
0,
|
||
|
|
0.5
|
||
|
|
)
|
||
|
|
)
|
||
|
|
}).play(s, [\i_bufnum, b]);
|
||
|
|
)
|
||
|
|
|
||
|
|
b.setn(*[ 200, 300, 400, 500, 600, 800 ].scramble.postln - 30);
|
||
|
|
|
||
|
|
|
||
|
|
(
|
||
|
|
SynthDef(\help_Index, { arg out=0,i_bufnum=0;
|
||
|
|
Out.ar(0,
|
||
|
|
SinOsc.ar(
|
||
|
|
Index.kr(
|
||
|
|
i_bufnum,
|
||
|
|
MouseX.kr(0, BufFrames.ir(i_bufnum))
|
||
|
|
),
|
||
|
|
0,
|
||
|
|
0.5
|
||
|
|
)
|
||
|
|
)
|
||
|
|
}).play(s, [\i_bufnum, b]);
|
||
|
|
)
|
||
|
|
|
||
|
|
b.free;
|
||
|
|
::
|
||
|
|
|