mc.noteallocator~ Reference

Manage voice numbers for MIDI note events

mc.noteallocator~

Description

The mc.noteallocator~ object assigns voice numbers for MIDI and MPE note events using an optional multichannel signal to determine voice busy state. It also maintains a voice busy map used by other MC objects to avoid unnecessary processing for channels that are not actively playing notes.

Examples

Arguments

voice count [int]

Optional

If present, a number argument sets the maximum voice count. You can change the voice count during the lifetime of the object by setting the voices attribute.

Attributes

direct [int] (default: 0)

Set Busy Map With Signal Input

mpemode [int] (default: 0)

When mpemode is enabled, mc.noteallocator~ outputs the voice number contained in mpeevent messages instead of allocating a voice number based on its internal busy state. When using MPE mode, the source of incoming MPE messages (such as a keyboard or other device) assumes responsibility for the details of voice allocation. MPE mode is disabled by default.

name [symbol] (default: )

The name attribute assigns a global name to the object's busy map. By default, mc.noteallocator~ 's busy map does not have a name and is available only to MC objects within the same patcher. A named busy map is accessible to all MC objects (in any patcher) that refer to it using the busymapname attribute.

steal [int] (default: 1)

When steal is enabled, mc.noteallocator~ will re-allocate ("steal") a busy voice if it runs out of non-busy voices. The stolen voice number used will be the one least recently allocated. When steal is disabled, mc.noteallocator~ will not produce any output if all voices are busy. Output resumes only when a voice becomes free, either via the input multichannel audio signal or an incoming MIDI note-off event.

voices [int] (default: 0)

The voices attribute sets the maximum voice number mc.noteallocator~ will allocate and output. When voices is 0 (the default), the active voice count is determined by the number of channels in the connected multichannel signal. If there is no connected signal, mc.noteallocator~ defaults to 15 voices.

Common Box Attributes

Messages

midievent

Arguments

MIDI [list]
When mc.noteallocator~ receieves a midievent message (from a midiparse object) in its inlet, it allocates and outputs a voice number out its right outlet, then sends the MIDI note, controller, aftertouch, or pitch bend values in the midievent message out the designated outlets.

mpeevent

Arguments

MPE [list]
When mc.noteallocator~ receieves an mpeevent message (from an mpeparse object) in its inlet, it allocates and outputs a voice number out its right outlet, then sends the MIDI note, controller, aftertouch, or pitch bend values in the mpeevent message out the designated outlets.

signal

Connect an optional multichannel signal to prevent mc.noteallocator~ from reallocating a voice until its audio level goes to zero.

See Also

Name Description
MC MC
mc.voiceallocator~
MC Wrapper Polyphony MC Wrapper Polyphony
MC and Polyphony MC and Polyphony