Voicer

Extension

Arguments:

Discussion:

Each note that is triggered on this last voicer will place two Synths on the server: one for the harpsi, and another for the filter. They will all use the same bus: meaning that if you trigger several notes at once, the effect of the filter will be compounded for each note. This may not be the result you want. In general, you should use simple, self-contained Instr's or synthdefs in a voicer.

MIDI output, as of 8/2022, uses the ddwMIDIMessageSend quark. Create a Voicer with a MIDISender or VSTPluginMIDISender object as the "thing." In the args array, write chan: midichannel_num to specify the output channel. Because MIDI notes don't encapsulate any parameters other than velocity, all other args will be ignored.

GlobalControlMIDIOut is the interface between a global control on this Voicer, and a MIDI CC on the remote device. First, create the global control. (The name doesn't matter.) Then attach a GlobalControlMIDIOut; a shortcut syntax is to call connectMIDIOut on the global control. All value changes will be forwarded to MIDI from this point forward.// MIDI output: m = MIDISender.newByName("device", "port"); // write 'args: [chan: channel number]' to set the output channel v = Voicer(20, m, args: [chan: 0]); // let's say CC 1 on the remote device is connected to filter frequency // (you could use a different spec to display real-world values) v.mapGlobal(\ffreq, nil, 0, \midi).connectMIDIOut(m, 0, 1);

Now deprecated - the gate method uses thisThread.clock instead of a preset clock.

If you want to do sequencing with this Voicer, you should set the clock to a TempoClock, preferably just after creation:t = TempoClock(144/60); // 144 bpm v = Voicer(8, "harpsi").clock_(t);

If you do this, v.gate will only work within a Routine or Task that plays on the same TempoClock. If you will want to gate things from the command line, leave the clock as SystemClock, the default.

Removes all Synth objects associated with this voicer from the server, cleans up its GUI window, and disconnects the Voicer from MIDI.

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:

Arguments:

Discussion:

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:

Negative number / <0:

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

Non-negative number / >=0:

use this number as the latency for this event

nil

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

Arguments:

Discussion:

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

Arguments:

Discussion:

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) }));

Arguments:

Discussion:

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;

Creates 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.

Arguments:

Discussion:

Creates an input to the Synth global, by using the supplied kr bus or creating a new one if no bus is supplied; input is mapped 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;

Arguments:

Discussion:

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.