1
0
Fork 0
mirror of https://github.com/juce-framework/JUCE.git synced 2026-01-10 23:44:24 +00:00
JUCE/modules/juce_midi_ci/ci/juce_CIChannelAddress.h
2023-10-31 11:46:49 +00:00

83 lines
3.1 KiB
C++

/*
==============================================================================
This file is part of the JUCE library.
Copyright (c) 2022 - Raw Material Software Limited
JUCE is an open source library subject to commercial or open-source
licensing.
By using JUCE, you agree to the terms of both the JUCE 7 End-User License
Agreement and JUCE Privacy Policy.
End User License Agreement: www.juce.com/juce-7-licence
Privacy Policy: www.juce.com/juce-privacy-policy
Or: You may also use this code under the terms of the GPL v3 (see
www.gnu.org/licenses).
JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
DISCLAIMED.
==============================================================================
*/
namespace juce::midi_ci
{
/**
Identifies a channel or set of channels in a multi-group MIDI endpoint.
@tags{Audio}
*/
class ChannelAddress
{
private:
uint8_t group{}; ///< A group within a MIDI endpoint, where 0 <= group && group < 16
ChannelInGroup channel{}; ///< A set of channels related to specified group
auto tie() const { return std::tie (group, channel); }
public:
/** Returns a copy of this object with the specified group. */
[[nodiscard]] ChannelAddress withGroup (int g) const
{
jassert (isPositiveAndBelow (g, 16));
return withMember (*this, &ChannelAddress::group, (uint8_t) g);
}
/** Returns a copy of this object with the specified channel. */
[[nodiscard]] ChannelAddress withChannel (ChannelInGroup c) const
{
return withMember (*this, &ChannelAddress::channel, c);
}
/** Returns the group. */
[[nodiscard]] uint8_t getGroup() const { return group; }
/** Returns the channel in the group. */
[[nodiscard]] ChannelInGroup getChannel() const { return channel; }
/** Returns true if this address refers to all channels in the function
block containing the specified group.
*/
bool isBlock() const { return channel == ChannelInGroup::wholeBlock; }
/** Returns true if this address refers to all channels in the specified
group.
*/
bool isGroup() const { return channel == ChannelInGroup::wholeGroup; }
/** Returns true if this address refers to a single channel. */
bool isSingleChannel() const { return ! isBlock() && ! isGroup(); }
bool operator< (const ChannelAddress& other) const { return tie() < other.tie(); }
bool operator<= (const ChannelAddress& other) const { return tie() <= other.tie(); }
bool operator> (const ChannelAddress& other) const { return tie() > other.tie(); }
bool operator>= (const ChannelAddress& other) const { return tie() >= other.tie(); }
bool operator== (const ChannelAddress& other) const { return tie() == other.tie(); }
bool operator!= (const ChannelAddress& other) const { return ! operator== (other); }
};
} // namespace juce::midi_ci