rsc3/doc-schelp/HelpSource/Reference/playN.scrbl

109 lines
2.2 KiB
Text
Raw Permalink Normal View History

2022-08-24 13:53:18 +00:00
#lang scribble/manual
@(require (for-label racket))
@title{playN}
distribute audio over multiple non-adjacent channels@section{categories}
Libraries>JITLib>NodeProxy
@section{related}
Classes/Monitor, Classes/Bus, Classes/NodeProxy, Classes/Ndef, Classes/ProxySpace
@section{method}
playN
playN is a multichannel play method for link::Classes/Monitor:: and link::Classes/NodeProxy:: (see also: link::Classes/ProxySpace::, link::Classes/Ndef::) that supports playing proxy outputs over strong::non-adjacent channels::; somewhat like a splitter/line mixer.
@racketblock[
// examples
s.boot;
p = ProxySpace.push;
s.scope(8);
// a 3 channel test sound
~test3 = { SinOsc.ar([2, 3, 5] * 100) * 0.2 };
// compare: play out of 3 adjacent channels
~test3.play(3);
~test3.play(6);
~test3.stop;
~test3.play; // play remembers old (series) output settings;
// outs
~test3.playN([2, 4,7]) // playN to 3 non-adjacent channels
// set outs, amps and vol:
(
~test3.playN(
outs: [2,3,5],
amps: [0.5, 0.25, 0.125],
vol: 1
);
)
~test3.vol_(2);
~test3.stop;
~test3.playN; // remembers last state.
// if playN has been used, one can set outs while playing.
// note: this does not work reliably with the .play method!
~test3.monitor.outs_([3,2,1]);
// set amps while playing.
// note: this does not work with play method!
~test3.monitor.amps_(1/[1, 2, 3]).vol_(1);
~test3.playN;
~test3.monitor.outs_([2, 4, 7]);
// one can also spread out one channel to several, with given amplitudes:
(
~test3.playN(
outs: [1, 3, [5,6,7]],
amps: [0.5, 0.25, [0.125,0.25, 0.5]],
vol: 2
);
)
~test3.stop;
~test3.playN;
// do changes while off:
~test3.stop;
~test3.monitor.outs_([2, 4, [5,6,3]]);
~test3.monitor.amps_(1/[1, 2, [3,2,1]]);
~test3.playN;
// the most comfortable way to edit those parameters is using a text file:
~test3.playNDialog;
// output mapping can be prepared before playN is used:
~test3.clear;
~test3 = { SinOsc.ar([2, 3, 5] * 100) * 0.2 };
~test3.vol_(0.5); // vol can be set already
// outs and amps require making a monitor first;
~test3.initMonitor;
~test3.monitor.outs_([3, 5, 6]);
~test3.monitor.amps_([1, 2, 3]);
~test3.playN;
~test3.end;
~test3.clear;
p.clean;
p.pop;
::
]