Manage voice numbers for MIDI note events 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. Cycling '74 MC Multichannel signal representing busy state; midievent or mpeevent Messages A multichannel signal connected to mc.noteallocator~'s left inlet establishes a voice busy state. Typically you'll connect the multichannel output of the sounds triggered by mc.noteallocator~ events. This permits you to hold a voice busy during its "release" phase after a note-off is received until the level for that voice goes to zero.

Send midievent messages produced by the midiparse object or mpeevent messages produced by the mpeparse object to the inlet of mc.noteallocator~ to generate voice numbers accompanying note and controller events. Busy Signal, midievent or mpeevent Messages TEXT_HERE Note-on (Pitch, Attack Velocity) TEXT_HERE Note-off (Pitch, Release Velocity) TEXT_HERE Controller (Number, Value) TEXT_HERE Aftertouch TEXT_HERE Pitch Bend TEXT_HERE Voice Number Connect the voice number output to the right inlet of mc.target to direct notes or control information to specific channels within an MC object. Voice Count 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. MIDI events 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. MPE events 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. Sets busy state Connect an optional multichannel signal to prevent mc.noteallocator~ from reallocating a voice until its audio level goes to zero. Set Busy Map With Signal Input TEXT_HERE High-resolution Pitch Bend The hires attribute is used to support high-resolution pitch bend scaling. When the attribute is set to 0, mc.noteallocator~ will accept and output pitch bend integer values in the standard MIDI range of 0 to 127. When the attribute is set to 1, it accepts high resolution MIDI data and outputs float values in the range of -1 to 1. When the attribute is set to 2, it accepts high resolution MIDI data and outputs integer values in the range of -8192 to 8191 (standard 14-bit MIDI high resolution pitch bend range). When the attribute is set to 3 (default), it accepts high resolution MIDI data and outputs integer values in the range of 0 to 16383 (unsigned 14-bit MIDI high resolution pitch bend range). TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE MPE voice allocation mode 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. Busy map name 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. Voice Stealing 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. Voice Count 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.