Using Voicer

Extension

Sends the same /n_set message to each node in this voicer. Global controls (see below) send the value to the associated kr bus.

Arguments:

Trigger a note (trigger1), or several notes (trigger). For trigger1, freq must be a float or int. For trigger, freq can be a single value or a collection. If you are triggering several notes, args can also be a collection of argument arrays e.g. [ [\filter, 300], [\filter, 500], [\filter, 700] ]. Each set of args will be sent in succession to the nodes as they're triggered (using wrapAt). In this case, the first node triggered will get \filter = 300, the second \filter = 500, etc.trigger1(freq, gate = 1, args, lat) trigger(freq, gate = 1, args, lat)

lat is the Server latency to use for this event. The following values are allowed for all methods with a "lat" argument:

< 0 :

Use the Voicer's default latency (set by myVoicer.latency = 1)

>= 0 :

Non-negative number: use this number as the latency for this event

nil :

No latency: Server will play the message as soon as received

Returns the node played, or a collection of nodes played.release1(freq, lat) release(freq, lat)

Find the earliest-triggered note(s) with the frequency/frequencies given and send [\gate,0] to it. release1 allows only one frequency to be given; release works with either a single value or a collection. If there is no node with a given frequency, that frequency is ignored.

Returns the node(s) released.v = Voicer.new(8, "harpsi"); // uses Server.local f = Array.fill(5, { 1000.0.rand + 50 }); v.trigger(f); // play 5 notes v.release(f); // release the same gate1(freq, dur, gate = 1, args, lat) gate(freq, dur, gate = 1, args, lat)

Triggers the notes and schedules their releases. If freq is a collection, dur and args may be the same thing for every node, or you can supply collections to have different arguments and different release times for each node.

Returns the node(s) played.f = Array.fill(5, { 1000.0.rand + 50 }); // listen to the notes stop one by one v.gate(f, Array.fill(5, { arg i; 2*(i+1) }));

Uses a negative gate to cause an instant release. Sec determines how long the release takes. Unlike gate, you may not supply a collection for sec. (Sec is converted to the negative gate by sec.abs.neg-1)

Stops all active Synths belonging to this Voicer immediately.

Sends the n_trace message to all active Synths. Useful for debugging SynthDefs. You can also trace a single playing node using the following:aVoicer.playingNodes.choose.trace;

Makes a window showing all global controls (see mapGlobal) and processes (see addProcess).

Voicer-gui uses a proxy system so that you can display different voicers without incurring the overhead of removing views, resizing the window, adding views, and resizing again. For normal use, this process is transparent to the user. To change the Voicer shown in a particular GUI, drag an expression that evaluates to the Voicer (usually a variable name) into the drag sink immediately to the right of the Voicer GUI label.

Makes an input to the Synth global, by using the supplied kr bus (or creating a new one if no bus is supplied) and mapping the input to that bus in each Voicer node. Newly triggered Voicer nodes will be mapped automatically. This lets you control filter cutoff frequencies, pitch bends, etc. globally for all nodes in a voicer. A kr Synth can be played on the bus to provide an LFO.( i = Instr([\harpsi], { arg freq = 440, gate = 0; var out; out = EnvGen.ar(Env.adsr, gate, doneAction:2) * Pulse.ar(freq, 0.25, 0.25); [out,out] }/*, [\freq, \amp]*/); f = Instr([\test, \rlpf], { arg audio, ffreq = 500, rq = 0.1; RLPF.ar(audio, ffreq, rq); }); v = Voicer(8, f, [\audio, i, nil, \ffreq, 5000, \rq, 0.08]); ) // globalize the filter cutoff b = v.mapGlobal(\ffreq);

( SynthDef.new("SinLFO", { // sinewave lfo arg outbus, freq = 1, phase = 0, mul = 1, add = 0; ReplaceOut.kr(outbus, SinOsc.kr(freq, phase, mul, add)); }).add; ) l = Synth.new("SinLFO", [\freq, 0.2, \mul, 500, \add, 1400, \outbus, b.index]); // all notes have the same filter LFO v.trigger([60, 64, 67].midicps); v.unmapGlobal(\ffreq); // LFO stops v.mapGlobal(\ffreq, b); // set LFO to bus (which is still active) v.release([60, 64, 67].midicps); l.free;

Adds a VoicerProcessGroup to this Voicer. The group will be displayed as a button or pop-up menu in the voicer's GUI. For a button, specify type as \toggle in the addProcess message. See the VoicerProcessGroup help file for the correct syntax for states. Returns the new process group.

This allows you to add graphically triggered sequencers and other processes directly to the Voicer GUI.

VoicerProcessGroups belong to the voicer's proxy, not to the Voicer itself. This means you can change the Voicer that is to play the sequence while the sequence is playing (provided both voicers use the same clock as the sequence). As with Voicer-gui, under normal circumstances this is transparent to the user.

VoicerProcesses and VoicerProcessGroups are deprecated and no longer maintained.

Stops the process group if playing and removes it from the Voicer and GUI.

Chooses the algorithm the Voicer uses to find the next node to play. Your choices are:

\preferLate:

prefers nodes that were more recently played

\preferEarly:

the default setting; prefers nodes that were played longer ago

\random:

chooses a non-playing node at random

\cycle:

cycles through the nodes in sequence, skipping nodes that are playing

\strictCycle:

cycles through the nodes in sequence, always in order whether they're playing or not

Sets the default latency for this voicer. Default latency should be a positive number and can be overridden using the lat argument in trigger, release, gate, and set method calls.