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]
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 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
mpeevent
Arguments
signal
See Also
Name | Description |
---|---|
MC | MC |
mc.voiceallocator~ | |
MC Wrapper Polyphony | MC Wrapper Polyphony |
MC and Polyphony | MC and Polyphony |