/* ============================================================================== This file is part of the JUCE framework. Copyright (c) Raw Material Software Limited JUCE is an open source framework subject to commercial or open source licensing. By downloading, installing, or using the JUCE framework, or combining the JUCE framework with any other source code, object code, content or any other copyrightable work, you agree to the terms of the JUCE End User Licence Agreement, and all incorporated terms including the JUCE Privacy Policy and the JUCE Website Terms of Service, as applicable, which will bind you. If you do not agree to the terms of these agreements, we will not license the JUCE framework to you, and you must discontinue the installation or download process and cease use of the JUCE framework. JUCE End User Licence Agreement: https://juce.com/legal/juce-8-licence/ JUCE Privacy Policy: https://juce.com/juce-privacy-policy JUCE Website Terms of Service: https://juce.com/juce-website-terms-of-service/ Or: You may also use this code under the terms of the AGPLv3: https://www.gnu.org/licenses/agpl-3.0.en.html THE JUCE FRAMEWORK IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED. ============================================================================== */ namespace juce { MPEChannelAssigner::MPEChannelAssigner (MPEZoneLayout::Zone zoneToUse) : zone (new MPEZoneLayout::Zone (zoneToUse)), channelIncrement (zone->isLowerZone() ? 1 : -1), numChannels (zone->numMemberChannels), firstChannel (zone->getFirstMemberChannel()), lastChannel (zone->getLastMemberChannel()), midiChannelLastAssigned (firstChannel - channelIncrement) { // must be an active MPE zone! jassert (numChannels > 0); } MPEChannelAssigner::MPEChannelAssigner (Range channelRange) : isLegacy (true), channelIncrement (1), numChannels (channelRange.getLength()), firstChannel (channelRange.getStart()), lastChannel (channelRange.getEnd() - 1), midiChannelLastAssigned (firstChannel - channelIncrement) { // must have at least one channel! jassert (! channelRange.isEmpty()); } int MPEChannelAssigner::findMidiChannelForNewNote (int noteNumber) noexcept { if (numChannels <= 1) return firstChannel; for (int ch = firstChannel; (isLegacy || zone->isLowerZone() ? ch <= lastChannel : ch >= lastChannel); ch += channelIncrement) { if (midiChannels[(size_t) ch].isFree() && midiChannels[(size_t) ch].lastNotePlayed == noteNumber) { midiChannelLastAssigned = ch; midiChannels[(size_t) ch].notes.add (noteNumber); return ch; } } for (int ch = midiChannelLastAssigned + channelIncrement; ; ch += channelIncrement) { if (ch == lastChannel + channelIncrement) // loop wrap-around ch = firstChannel; if (midiChannels[(size_t) ch].isFree()) { midiChannelLastAssigned = ch; midiChannels[(size_t) ch].notes.add (noteNumber); return ch; } if (ch == midiChannelLastAssigned) break; // no free channels! } midiChannelLastAssigned = findMidiChannelPlayingClosestNonequalNote (noteNumber); midiChannels[(size_t) midiChannelLastAssigned].notes.add (noteNumber); return midiChannelLastAssigned; } int MPEChannelAssigner::findMidiChannelForExistingNote (int noteNumber) noexcept { const auto iter = std::find_if (midiChannels.cbegin(), midiChannels.cend(), [&] (auto& ch) { return std::find (ch.notes.begin(), ch.notes.end(), noteNumber) != ch.notes.end(); }); return iter != midiChannels.cend() ? (int) std::distance (midiChannels.cbegin(), iter) : -1; } void MPEChannelAssigner::noteOff (int noteNumber, int midiChannel) { const auto removeNote = [] (MidiChannel& ch, int noteNum) { if (ch.notes.removeAllInstancesOf (noteNum) > 0) { ch.lastNotePlayed = noteNum; return true; } return false; }; if (midiChannel >= 0 && midiChannel <= 16) { removeNote (midiChannels[(size_t) midiChannel], noteNumber); return; } for (auto& ch : midiChannels) { if (removeNote (ch, noteNumber)) return; } } void MPEChannelAssigner::allNotesOff() { for (auto& ch : midiChannels) { if (ch.notes.size() > 0) ch.lastNotePlayed = ch.notes.getLast(); ch.notes.clear(); } } int MPEChannelAssigner::findMidiChannelPlayingClosestNonequalNote (int noteNumber) noexcept { auto channelWithClosestNote = firstChannel; int closestNoteDistance = 127; for (int ch = firstChannel; (isLegacy || zone->isLowerZone() ? ch <= lastChannel : ch >= lastChannel); ch += channelIncrement) { for (auto note : midiChannels[(size_t) ch].notes) { auto noteDistance = std::abs (note - noteNumber); if (noteDistance > 0 && noteDistance < closestNoteDistance) { closestNoteDistance = noteDistance; channelWithClosestNote = ch; } } } return channelWithClosestNote; } //============================================================================== MPEChannelRemapper::MPEChannelRemapper (MPEZoneLayout::Zone zoneToRemap) : zone (zoneToRemap), channelIncrement (zone.isLowerZone() ? 1 : -1), firstChannel (zone.getFirstMemberChannel()), lastChannel (zone.getLastMemberChannel()) { // must be an active MPE zone! jassert (zone.numMemberChannels > 0); zeroArrays(); } void MPEChannelRemapper::remapMidiChannelIfNeeded (MidiMessage& message, uint32 mpeSourceID) noexcept { auto channel = message.getChannel(); if (! zone.isUsingChannelAsMemberChannel (channel)) return; if (channel == zone.getMasterChannel() && (message.isResetAllControllers() || message.isAllNotesOff())) { clearSource (mpeSourceID); return; } auto sourceAndChannelID = (((uint32) mpeSourceID << 5) | (uint32) (channel)); if (messageIsNoteData (message)) { ++counter; // fast path - no remap if (applyRemapIfExisting (channel, sourceAndChannelID, message)) return; // find existing remap for (int chan = firstChannel; (zone.isLowerZone() ? chan <= lastChannel : chan >= lastChannel); chan += channelIncrement) if (applyRemapIfExisting (chan, sourceAndChannelID, message)) return; // no remap necessary if (sourceAndChannel[channel] == notMPE) { lastUsed[channel] = counter; sourceAndChannel[channel] = sourceAndChannelID; return; } // remap source & channel to new channel auto chan = getBestChanToReuse(); sourceAndChannel[chan] = sourceAndChannelID; lastUsed[chan] = counter; message.setChannel (chan); } } void MPEChannelRemapper::reset() noexcept { for (auto& s : sourceAndChannel) s = notMPE; } void MPEChannelRemapper::clearChannel (int channel) noexcept { sourceAndChannel[channel] = notMPE; } void MPEChannelRemapper::clearSource (uint32 mpeSourceID) { for (auto& s : sourceAndChannel) { if (uint32 (s >> 5) == mpeSourceID) { s = notMPE; return; } } } bool MPEChannelRemapper::applyRemapIfExisting (int channel, uint32 sourceAndChannelID, MidiMessage& m) noexcept { if (sourceAndChannel[channel] == sourceAndChannelID) { if (m.isNoteOff()) sourceAndChannel[channel] = notMPE; else lastUsed[channel] = counter; m.setChannel (channel); return true; } return false; } int MPEChannelRemapper::getBestChanToReuse() const noexcept { for (int chan = firstChannel; (zone.isLowerZone() ? chan <= lastChannel : chan >= lastChannel); chan += channelIncrement) if (sourceAndChannel[chan] == notMPE) return chan; auto bestChan = firstChannel; auto bestLastUse = counter; for (int chan = firstChannel; (zone.isLowerZone() ? chan <= lastChannel : chan >= lastChannel); chan += channelIncrement) { if (lastUsed[chan] < bestLastUse) { bestLastUse = lastUsed[chan]; bestChan = chan; } } return bestChan; } void MPEChannelRemapper::zeroArrays() { for (int i = 0; i < 17; ++i) { sourceAndChannel[i] = 0; lastUsed[i] = 0; } } //============================================================================== //============================================================================== #if JUCE_UNIT_TESTS struct MPEUtilsUnitTests final : public UnitTest { MPEUtilsUnitTests() : UnitTest ("MPE Utilities", UnitTestCategories::midi) {} void runTest() override { beginTest ("MPEChannelAssigner"); { MPEZoneLayout layout; // lower { layout.setLowerZone (15); // lower zone MPEChannelAssigner channelAssigner (layout.getLowerZone()); // check that channels are assigned in correct order int noteNum = 60; for (int ch = 2; ch <= 16; ++ch) { expectEquals (channelAssigner.findMidiChannelForNewNote (noteNum), ch); expectEquals (channelAssigner.findMidiChannelForExistingNote (noteNum), ch); ++noteNum; } // check that note-offs are processed channelAssigner.noteOff (60); expectEquals (channelAssigner.findMidiChannelForNewNote (60), 2); expectEquals (channelAssigner.findMidiChannelForExistingNote (60), 2); channelAssigner.noteOff (61); expectEquals (channelAssigner.findMidiChannelForNewNote (61), 3); expectEquals (channelAssigner.findMidiChannelForExistingNote (61), 3); // check that assigned channel was last to play note channelAssigner.noteOff (65); channelAssigner.noteOff (66); expectEquals (channelAssigner.findMidiChannelForNewNote (66), 8); expectEquals (channelAssigner.findMidiChannelForNewNote (65), 7); expectEquals (channelAssigner.findMidiChannelForExistingNote (66), 8); expectEquals (channelAssigner.findMidiChannelForExistingNote (65), 7); // find closest channel playing nonequal note expectEquals (channelAssigner.findMidiChannelForNewNote (80), 16); expectEquals (channelAssigner.findMidiChannelForNewNote (55), 2); expectEquals (channelAssigner.findMidiChannelForExistingNote (80), 16); expectEquals (channelAssigner.findMidiChannelForExistingNote (55), 2); // all notes off channelAssigner.allNotesOff(); // last note played expectEquals (channelAssigner.findMidiChannelForNewNote (66), 8); expectEquals (channelAssigner.findMidiChannelForNewNote (65), 7); expectEquals (channelAssigner.findMidiChannelForNewNote (80), 16); expectEquals (channelAssigner.findMidiChannelForNewNote (55), 2); expectEquals (channelAssigner.findMidiChannelForExistingNote (66), 8); expectEquals (channelAssigner.findMidiChannelForExistingNote (65), 7); expectEquals (channelAssigner.findMidiChannelForExistingNote (80), 16); expectEquals (channelAssigner.findMidiChannelForExistingNote (55), 2); // normal assignment expectEquals (channelAssigner.findMidiChannelForNewNote (101), 3); expectEquals (channelAssigner.findMidiChannelForNewNote (20), 4); expectEquals (channelAssigner.findMidiChannelForExistingNote (101), 3); expectEquals (channelAssigner.findMidiChannelForExistingNote (20), 4); } // upper { layout.setUpperZone (15); // upper zone MPEChannelAssigner channelAssigner (layout.getUpperZone()); // check that channels are assigned in correct order int noteNum = 60; for (int ch = 15; ch >= 1; --ch) { expectEquals (channelAssigner.findMidiChannelForNewNote (noteNum), ch); expectEquals (channelAssigner.findMidiChannelForExistingNote (noteNum), ch); ++noteNum; } // check that note-offs are processed channelAssigner.noteOff (60); expectEquals (channelAssigner.findMidiChannelForNewNote (60), 15); expectEquals (channelAssigner.findMidiChannelForExistingNote (60), 15); channelAssigner.noteOff (61); expectEquals (channelAssigner.findMidiChannelForNewNote (61), 14); expectEquals (channelAssigner.findMidiChannelForExistingNote (61), 14); // check that assigned channel was last to play note channelAssigner.noteOff (65); channelAssigner.noteOff (66); expectEquals (channelAssigner.findMidiChannelForNewNote (66), 9); expectEquals (channelAssigner.findMidiChannelForNewNote (65), 10); expectEquals (channelAssigner.findMidiChannelForExistingNote (66), 9); expectEquals (channelAssigner.findMidiChannelForExistingNote (65), 10); // find closest channel playing nonequal note expectEquals (channelAssigner.findMidiChannelForNewNote (80), 1); expectEquals (channelAssigner.findMidiChannelForNewNote (55), 15); expectEquals (channelAssigner.findMidiChannelForExistingNote (80), 1); expectEquals (channelAssigner.findMidiChannelForExistingNote (55), 15); // all notes off channelAssigner.allNotesOff(); // last note played expectEquals (channelAssigner.findMidiChannelForNewNote (66), 9); expectEquals (channelAssigner.findMidiChannelForNewNote (65), 10); expectEquals (channelAssigner.findMidiChannelForNewNote (80), 1); expectEquals (channelAssigner.findMidiChannelForNewNote (55), 15); expectEquals (channelAssigner.findMidiChannelForExistingNote (66), 9); expectEquals (channelAssigner.findMidiChannelForExistingNote (65), 10); expectEquals (channelAssigner.findMidiChannelForExistingNote (80), 1); expectEquals (channelAssigner.findMidiChannelForExistingNote (55), 15); // normal assignment expectEquals (channelAssigner.findMidiChannelForNewNote (101), 14); expectEquals (channelAssigner.findMidiChannelForNewNote (20), 13); expectEquals (channelAssigner.findMidiChannelForExistingNote (101), 14); expectEquals (channelAssigner.findMidiChannelForExistingNote (20), 13); } // legacy { MPEChannelAssigner channelAssigner; // check that channels are assigned in correct order int noteNum = 60; for (int ch = 1; ch <= 16; ++ch) { expectEquals (channelAssigner.findMidiChannelForNewNote (noteNum), ch); expectEquals (channelAssigner.findMidiChannelForExistingNote (noteNum), ch); ++noteNum; } // check that note-offs are processed channelAssigner.noteOff (60); expectEquals (channelAssigner.findMidiChannelForNewNote (60), 1); expectEquals (channelAssigner.findMidiChannelForExistingNote (60), 1); channelAssigner.noteOff (61); expectEquals (channelAssigner.findMidiChannelForNewNote (61), 2); expectEquals (channelAssigner.findMidiChannelForExistingNote (61), 2); // check that assigned channel was last to play note channelAssigner.noteOff (65); channelAssigner.noteOff (66); expectEquals (channelAssigner.findMidiChannelForNewNote (66), 7); expectEquals (channelAssigner.findMidiChannelForNewNote (65), 6); expectEquals (channelAssigner.findMidiChannelForExistingNote (66), 7); expectEquals (channelAssigner.findMidiChannelForExistingNote (65), 6); // find closest channel playing nonequal note expectEquals (channelAssigner.findMidiChannelForNewNote (80), 16); expectEquals (channelAssigner.findMidiChannelForNewNote (55), 1); expectEquals (channelAssigner.findMidiChannelForExistingNote (80), 16); expectEquals (channelAssigner.findMidiChannelForExistingNote (55), 1); // all notes off channelAssigner.allNotesOff(); // last note played expectEquals (channelAssigner.findMidiChannelForNewNote (66), 7); expectEquals (channelAssigner.findMidiChannelForNewNote (65), 6); expectEquals (channelAssigner.findMidiChannelForNewNote (80), 16); expectEquals (channelAssigner.findMidiChannelForNewNote (55), 1); expectEquals (channelAssigner.findMidiChannelForExistingNote (66), 7); expectEquals (channelAssigner.findMidiChannelForExistingNote (65), 6); expectEquals (channelAssigner.findMidiChannelForExistingNote (80), 16); expectEquals (channelAssigner.findMidiChannelForExistingNote (55), 1); // normal assignment expectEquals (channelAssigner.findMidiChannelForNewNote (101), 2); expectEquals (channelAssigner.findMidiChannelForNewNote (20), 3); expectEquals (channelAssigner.findMidiChannelForExistingNote (101), 2); expectEquals (channelAssigner.findMidiChannelForExistingNote (20), 3); } } beginTest ("MPEChannelRemapper"); { // 3 different MPE 'sources', constant IDs const int sourceID1 = 0; const int sourceID2 = 1; const int sourceID3 = 2; MPEZoneLayout layout; { layout.setLowerZone (15); // lower zone MPEChannelRemapper channelRemapper (layout.getLowerZone()); // first source, shouldn't remap for (int ch = 2; ch <= 16; ++ch) { auto noteOn = MidiMessage::noteOn (ch, 60, 1.0f); channelRemapper.remapMidiChannelIfNeeded (noteOn, sourceID1); expectEquals (noteOn.getChannel(), ch); } auto noteOn = MidiMessage::noteOn (2, 60, 1.0f); // remap onto oldest last-used channel channelRemapper.remapMidiChannelIfNeeded (noteOn, sourceID2); expectEquals (noteOn.getChannel(), 2); // remap onto oldest last-used channel channelRemapper.remapMidiChannelIfNeeded (noteOn, sourceID3); expectEquals (noteOn.getChannel(), 3); // remap to correct channel for source ID auto noteOff = MidiMessage::noteOff (2, 60, 1.0f); channelRemapper.remapMidiChannelIfNeeded (noteOff, sourceID3); expectEquals (noteOff.getChannel(), 3); } { layout.setUpperZone (15); // upper zone MPEChannelRemapper channelRemapper (layout.getUpperZone()); // first source, shouldn't remap for (int ch = 15; ch >= 1; --ch) { auto noteOn = MidiMessage::noteOn (ch, 60, 1.0f); channelRemapper.remapMidiChannelIfNeeded (noteOn, sourceID1); expectEquals (noteOn.getChannel(), ch); } auto noteOn = MidiMessage::noteOn (15, 60, 1.0f); // remap onto oldest last-used channel channelRemapper.remapMidiChannelIfNeeded (noteOn, sourceID2); expectEquals (noteOn.getChannel(), 15); // remap onto oldest last-used channel channelRemapper.remapMidiChannelIfNeeded (noteOn, sourceID3); expectEquals (noteOn.getChannel(), 14); // remap to correct channel for source ID auto noteOff = MidiMessage::noteOff (15, 60, 1.0f); channelRemapper.remapMidiChannelIfNeeded (noteOff, sourceID3); expectEquals (noteOff.getChannel(), 14); } } } }; static MPEUtilsUnitTests MPEUtilsUnitTests; #endif } // namespace juce