A class for MIDI input elements that represent Mackie Control Universal VU meters. More...
#include <MIDI_Inputs/MCU/VU.hpp>
Public Member Functions | |
GenericVU (BankConfig< NumBanks > config, uint8_t track, const MIDIChannelCN &channelCN, unsigned int decayTime, const Callback &callback) | |
Construct a new Bankable VU object. More... | |
void | begin () override |
Initialize. More... | |
void | reset () override |
Reset all values to zero. More... | |
uint8_t | getValue () override |
Return the VU meter value as an integer in [0, 12]. More... | |
bool | getOverload () override |
Return the overload status. More... | |
void | update () override |
Update is called periodically, it decays the meter if the time is right. More... | |
bool | updateWith (const ChannelMessageMatcher &midimsg) |
Receive a new MIDI message and update the internal state. More... | |
virtual float | getFloatValue () |
Get the VU meter value as a floating point number. More... | |
uint8_t | getMax () const |
Get the maximum value that this VU meter can return. More... | |
setting_t | getSelection () const |
Get the current bank setting. More... | |
uint8_t | getBankIndex (const MIDIAddress &target, const MIDIAddress &base) const |
Calculate the bank setting of a given MIDI address, relative to a base address. More... | |
Static Public Member Functions | |
static void | beginAll () |
static void | resetAll () |
Reset all MIDIInputElementChannelPressure elements to their initial state. More... | |
static void | updateAll () |
Update all MIDIInputElementChannelPressure elements. More... | |
static void | updateAllWith (const ChannelMessageMatcher &midimsg) |
Update all MIDIInputElementChannelPressure elements with a new MIDI message. More... | |
Public Attributes | |
VUEmptyCallback | callback |
Protected Member Functions | |
bool | matchBankable (uint8_t toMatch, uint8_t base) const |
Check if the given address is part of the bank relative to the base address. More... | |
bool | matchBankable (const MIDIAddress &toMatch, const MIDIAddress &base) const |
Check whether a given address is part of the bank relative to the base address. More... | |
bool | matchBankableInRange (uint8_t toMatch, uint8_t base, uint8_t length) const |
Check if the given address is part of the bank relative to the base address. More... | |
uint8_t | getRangeIndex (MIDIAddress target, MIDIAddress base) const |
If matchBankableAddressInRange returned true, get the index of the message in the range. More... | |
bool | matchBankableAddressInRange (const MIDIAddress &toMatch, const MIDIAddress &base, uint8_t length) const |
Check whether a given address is part of the bank relative to the base address and within a range with a given length. More... | |
Static Protected Member Functions | |
static bool | inRange (uint8_t toMatch, uint8_t base, uint8_t length) |
Check whether a given address is within a range of given length starting from the given base address. More... | |
Protected Attributes | |
const MIDIAddress | address |
MIDIInputElementChannelPressure * | next |
MIDIInputElementChannelPressure * | previous |
const uint8_t | max |
Private Member Functions | |
setting_t | getSelection () const override |
uint8_t | getBankIndex (const MIDIAddress &target) const override |
Get the bank index from a MIDI address. More... | |
bool | match (const MIDIAddress &target) const override |
Check if the address of the incoming MIDI message is in one of the banks of this element. More... | |
void | onBankSettingChange () override |
A function to be executed each time the bank setting changes. More... | |
uint8_t | getValue (uint8_t index) const |
Get the VU meter value from the raw value. More... | |
bool | getOverload (uint8_t index) const |
Get the overload status value from the raw value. More... | |
bool | updateImpl (const ChannelMessageMatcher &midimsg, const MIDIAddress &target) override |
Called when an incoming MIDI message matches this element. More... | |
MIDIAddress | getTarget (const ChannelMessageMatcher &midimsg) const override |
The address of the VU meter is the high nibble of the first (and only) data byte. More... | |
void | decay () |
void | setValue (uint8_t index, uint8_t newValue) |
Set the VU meter value. More... | |
void | setOverload (uint8_t index) |
Set the overload status. More... | |
void | clearOverload (uint8_t index) |
Clear the overload status. More... | |
void | moveDown () |
Move down this element in the linked list of elements. More... | |
Private Attributes | |
Array< uint8_t, NumValues > | values |
unsigned int | decayTime |
unsigned long | prevDecayTime |
Bank< N > & | bank |
const BankType | type |
Static Private Attributes | |
static DoublyLinkedList< MIDIInputElementChannelPressure > | elements |
A class for MIDI input elements that represent Mackie Control Universal VU meters.
This version is generic to allow for custom callbacks.
This version can be banked.
NumBanks | The number of banks. |
|
inline |
Construct a new Bankable VU object.
config | The bank configuration to use. |
track | The track of the VU meter. [1, 8] |
channelCN | The MIDI channel [CHANNEL_1, CHANNEL_16] and optional Cable Number [CABLE_1, CABLE_16]. |
decayTime | The time in milliseconds it takes for the value to decay one step. The MCU protocol uses 300 ms per division, and two steps per division, so the default is 150 ms per step. Some software doesn't work if the VU meter decays automatically, in that case, you can set the decay time to zero to disable the decay. |
callback | The callback object that is update when the value or bank changes. Used for displaying the value on a range of LEDs etc. |
|
inlineoverrideprivatevirtual |
Get the bank index from a MIDI address.
Reimplemented from VU_Base< NumBanks, VUEmptyCallback >.
|
inlineoverrideprivatevirtual |
Check if the address of the incoming MIDI message is in one of the banks of this element.
Reimplemented from MIDIInputElement.
|
inlineoverrideprivatevirtual |
A function to be executed each time the bank setting changes.
Think of an LED that indicates whether a track is muted or not. If this LED is bankable, let's say with 4 tracks per bank, 2 banks, and a base address of 3, then this LED object keeps the state of tracks 3 and 7. When the bank setting is 0, the LED displays the state of track 3, when the bank setting is 1, the LED displays the state of track 7.
To know when to update the LED, this callback is used.
Reimplemented from BankableMIDIInput< NumBanks >.
|
inlineoverridevirtualinherited |
|
inlineoverridevirtualinherited |
Reset all values to zero.
Reimplemented from MIDIInputElement.
|
inlineoverridevirtualinherited |
|
inlineprivateinherited |
|
inlineoverridevirtualinherited |
|
inlineprivateinherited |
|
inlineoverridevirtualinherited |
Update is called periodically, it decays the meter if the time is right.
Reimplemented from MIDIInputElement.
|
inlineoverrideprivatevirtualinherited |
Called when an incoming MIDI message matches this element.
Implements MIDIInputElement.
|
inlineoverrideprivatevirtualinherited |
The address of the VU meter is the high nibble of the first (and only) data byte.
Reimplemented from MIDIInputElementChannelPressure.
|
inlineprivateinherited |
|
inlineprivateinherited |
|
inlineprivateinherited |
|
inlinestaticinherited |
Definition at line 44 of file MIDIInputElementChannelPressure.hpp.
|
inlinestaticinherited |
Reset all MIDIInputElementChannelPressure elements to their initial state.
Definition at line 56 of file MIDIInputElementChannelPressure.hpp.
|
inlinestaticinherited |
Update all MIDIInputElementChannelPressure elements.
Definition at line 65 of file MIDIInputElementChannelPressure.hpp.
|
inlinestaticinherited |
Update all MIDIInputElementChannelPressure elements with a new MIDI message.
Definition at line 77 of file MIDIInputElementChannelPressure.hpp.
|
inlineprivateinherited |
Move down this element in the linked list of elements.
This means that the element will be checked earlier on the next iteration.
Definition at line 105 of file MIDIInputElementChannelPressure.hpp.
|
inlineinherited |
Receive a new MIDI message and update the internal state.
Definition at line 39 of file MIDIInputElement.hpp.
|
inlinevirtualinherited |
|
inlineinherited |
|
inlineinherited |
Get the current bank setting.
Definition at line 59 of file BankableMIDIInput.hpp.
|
inlineinherited |
Calculate the bank setting of a given MIDI address, relative to a base address.
target | The MIDI address to calculate the bank setting of. |
base | The base address to compare it to (the address of bank setting 0). |
Definition at line 71 of file BankableMIDIInput.hpp.
|
inlineprotectedinherited |
Check if the given address is part of the bank relative to the base address.
Consider the following example:
A Bank with 4 tracks per bank (T), 2 bank settings (N), and a base address of 3.
Addresses before the base adddress are not matched (0, 1, 2).
Addresses after N * T are not matched (8, 9, 10, 11, 12).
Addresses with a distance to the base address that is not a multiple of N are not matched (4, 5, 6).
toMatch | The address to check. |
base | The base address (the address of bank setting 0). |
matchBankableInRange(toMatch, base, 1)
. Definition at line 113 of file BankableMIDIInput.hpp.
|
inlineprotectedinherited |
Check whether a given address is part of the bank relative to the base address.
toMatch | The address to check. |
base | The base address (the address of bank setting 0). |
Definition at line 174 of file BankableMIDIInput.hpp.
|
inlineprotectedinherited |
Check if the given address is part of the bank relative to the base address.
toMatch | The address to check. |
base | The base address (the address of bank setting 0). |
length | The length of the range. |
Definition at line 132 of file BankableMIDIInput.hpp.
|
inlineprotectedinherited |
If matchBankableAddressInRange returned true, get the index of the message in the range.
Definition at line 143 of file BankableMIDIInput.hpp.
|
inlinestaticprotectedinherited |
Check whether a given address is within a range of given length starting from the given base address.
toMatch | The address to check |
base | The base address, start of the range. |
length | The length of the range. |
Definition at line 161 of file BankableMIDIInput.hpp.
|
inlineprotectedinherited |
Check whether a given address is part of the bank relative to the base address and within a range with a given length.
toMatch | The address to check. |
base | The base address (the address of bank setting 0). |
length | The length of the range. |
Definition at line 211 of file BankableMIDIInput.hpp.
|
inherited |
|
staticprivateinherited |
Definition at line 110 of file MIDIInputElementChannelPressure.hpp.
|
protectedinherited |
Definition at line 83 of file MIDIInputElement.hpp.
|
protectedinherited |
Definition at line 323 of file LinkedList.hpp.
|
protectedinherited |
Definition at line 324 of file LinkedList.hpp.
|
privateinherited |
Definition at line 242 of file BankableMIDIInput.hpp.
|
privateinherited |
Definition at line 243 of file BankableMIDIInput.hpp.