REF / Music API / Voices

Ascene . Agraph . Aengine
Anode . Modulator . Envelope
Songbook . Song . TimeKeeper
Voices . SampleMgr . StreamMgr
Loader . Async . Plot
Random . Rhythm . Util
MIDI . OSC . HID . Piano
Music Theory with Tonal

right-click to navigate to page sections

Voices == "polyphonic voice manager"
do you hear Voices?

Most popular CLAP synths manage their own polyphony. This means that a single Anode instance can play multiple notes simultaneously.

With Hz, you can roll your own synthesizer from a network of modular components. If you do this you'll end up with mono-voice synthesizer. As soon as you hit two notes simultaneously you're in a pickle.

To work around this problem you can roll your own meta-synth in the form of an Anode chain and provide that template to Voices which duplicates this chain for a requested voice count. Now a voices instance can play the role of a polyphonic synth, assigning new notes to a quiescent subchain, aka voice. Typically all voices managed by voices are the same, but you can actually provide different graph chains to multiple AddVoices for interesting (or not) results.

These are the awesome deeds of Voices.

Voices Functionality

Voices

intercepts notes and other expression and parameter events and distributes the events to a delegated subgraph. Events are distributed to one or more Anodes or Modulators within the delegate's sub-network that are receptive to events.
enables/disables nodes according its awareness of note release. Its delegate isn't released on NoteOff but rather once the note signals completion of its variable-duration "tail".
manages a pool of voices and assigns new notes according to a MRU (most-recently-used) strategy. When the voice pool is exhausted, Voices employs a voice-stealing strategy that considers the note's MIDI key as well as the pool's NoteOn/Off timestamps.

Voices Methods

Voices method	Description
`AddVoices(voiceTemplateNode, num)`	Duplicates `voicesTemplateNode`'s subgraph `num` times. Sinces this changes the audio graph, it should be followed by `await scene.Sync()`
`Note(...), NoteOn(...)`*	These Anode methods assign a voice and return `[noteid, voiceid]`.
`SetVoiceParam(voiceid, node, paramId, value)` *	Distributes the SetParam to the duplicated node associated with `voiceid`
`NoteExpression(..., noteid), NoteChoke(...,noteid), MidiEvent(...., noteid)`*	These Anode methods distribute events to the voice associated with `noteid`.

* see Anode for method details.

REF / Music API / Voices

Voices Functionality

Voices Methods

See Also