A class of MIDIOutputElements that read the input from a matrix of momentary push buttons or switches, and send out MIDI Note events. More...
#include <MIDI_Outputs/ManyAddresses/NoteButtonMatrix.hpp>
Public Member Functions | |
NoteButtonMatrix (const OutputBankConfig &config, const PinList< nb_rows > &rowPins, const PinList< nb_cols > &colPins, const Array< AddressMatrix< nb_rows, nb_cols >, NumBanks > ¬es, const Array< MIDICNChannel, NumBanks > &channelCNs, uint8_t velocity=0x7F) | |
Create a new Bankable NoteButtonMatrix object with the given pins, controller numbers and channel. More... | |
void | setVelocity (uint8_t velocity) |
Set the velocity of the MIDI Note events. More... | |
uint8_t | getVelocity () const |
Get the velocity of the MIDI Note events. More... | |
void | begin () override |
Initialize this updatable. More... | |
void | update () override |
Update this updatable. More... | |
void | enable () |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. More... | |
void | disable () |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. More... | |
bool | isEnabled () |
Check if this updatable is enabled. More... | |
bool | getPrevState (uint8_t col, uint8_t row) |
Get the state of the button in the given column and row. More... | |
Static Public Member Functions | |
static void | enable (Updatable *element) |
static void | enable (Updatable &element) |
static void | enable (U(&array)[N]) |
static void | disable (Updatable< NormalUpdatable > *element) |
static void | disable (Updatable< NormalUpdatable > &element) |
static void | disable (U(&array)[N]) |
static void | beginAll () |
Begin all enabled instances of this class. More... | |
static void | updateAll () |
Update all enabled instances of this class. More... | |
Public Attributes | |
DigitalNoteSender | sender |
Protected Attributes | |
Updatable< NormalUpdatable > * | next |
Updatable< NormalUpdatable > * | previous |
Private Member Functions | |
void | onButtonChanged (uint8_t row, uint8_t col, bool state) final override |
The callback function that is called whenever a button changes state. More... | |
void | setPrevState (uint8_t col, uint8_t row, bool state) |
Static Private Member Functions | |
static uint8_t | positionToBits (uint8_t col, uint8_t row) |
static uint8_t | bitsToIndex (uint8_t bits) |
static uint8_t | bitsToBitmask (uint8_t bits) |
Private Attributes | |
ManyMatrixAddresses< NumBanks, nb_rows, nb_cols > | address |
uint16_t | activeButtons |
unsigned long | prevRefresh = 0 |
uint8_t | prevStates [(nb_cols *nb_rows+7)/8] |
const PinList< nb_rows > | rowPins |
const PinList< nb_cols > | colPins |
Static Private Attributes | |
static DoublyLinkedList< Updatable< NormalUpdatable > > | updatables |
A class of MIDIOutputElements that read the input from a matrix of momentary push buttons or switches, and send out MIDI Note events.
A Note On event is sent when a button is pressed, and a Note Off event is sent when a button is released.
Crude software debouncing is implemented by limiting the refresh rate.
This version can be banked using an arbitrary list of alternative addresses.
NumBanks | The number of variants/alternative addresses the element has. |
nb_rows | The number of rows of the matrix. |
nb_cols | The number of columns of the matrix. |
Definition at line 33 of file ManyAddresses/NoteButtonMatrix.hpp.
|
inline |
Create a new Bankable NoteButtonMatrix object with the given pins, controller numbers and channel.
config | The bank configuration to use: the bank to add this element to, and whether to change the address, channel or cable number. |
rowPins | A list of pin numbers connected to the rows of the button matrix. ⚠ These pins will be driven LOW as outputs (Lo-Z). |
colPins | A list of pin numbers connected to the columns of the button matrix. These pins will be used as inputs (Hi-Z), and the internal pull-up resistor will be enabled. |
notes | A list of 2-dimensional arrays of the same dimensions as the button matrix that contains the MIDI Note number of each button. [0, 127] |
channelCNs | The a list containing the MIDI channels [CHANNEL_1, CHANNEL_16] and Cable Numbers [0, 15]. |
velocity | The velocity of the MIDI Note events. |
Definition at line 63 of file ManyAddresses/NoteButtonMatrix.hpp.
|
inline |
Set the velocity of the MIDI Note events.
Definition at line 78 of file ManyAddresses/NoteButtonMatrix.hpp.
|
inline |
Get the velocity of the MIDI Note events.
Definition at line 80 of file ManyAddresses/NoteButtonMatrix.hpp.
|
inlineoverridevirtualinherited |
Initialize this updatable.
Implements Updatable<>.
Definition at line 57 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inlineoverridevirtualinherited |
Update this updatable.
Implements Updatable<>.
Definition at line 59 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inlinefinaloverrideprivatevirtualinherited |
The callback function that is called whenever a button changes state.
row | The row of the button that changed state. |
col | The column of the button that changed state. |
state | The new state of the button. |
Implements ButtonMatrix< nb_rows, nb_cols >.
Definition at line 62 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inlineinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 45 of file Updatable.hpp.
|
inlinestaticinherited |
Definition at line 85 of file Updatable.hpp.
|
inlinestaticinherited |
Definition at line 87 of file Updatable.hpp.
|
inlinestaticinherited |
Definition at line 90 of file Updatable.hpp.
|
inlineinherited |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 55 of file Updatable.hpp.
|
inlinestaticinherited |
Definition at line 95 of file Updatable.hpp.
|
inlinestaticinherited |
Definition at line 97 of file Updatable.hpp.
|
inlinestaticinherited |
Definition at line 100 of file Updatable.hpp.
|
inlineinherited |
Check if this updatable is enabled.
Definition at line 69 of file Updatable.hpp.
|
inlinestaticinherited |
Begin all enabled instances of this class.
Definition at line 73 of file Updatable.hpp.
|
inlinestaticinherited |
Update all enabled instances of this class.
Definition at line 80 of file Updatable.hpp.
|
inherited |
Get the state of the button in the given column and row.
Definition at line 69 of file ButtonMatrix.ipp.
|
inlinestaticprivateinherited |
Definition at line 52 of file ButtonMatrix.ipp.
|
inlinestaticprivateinherited |
Definition at line 59 of file ButtonMatrix.ipp.
|
inlinestaticprivateinherited |
Definition at line 64 of file ButtonMatrix.ipp.
|
privateinherited |
Definition at line 75 of file ButtonMatrix.ipp.
|
privateinherited |
Definition at line 76 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
privateinherited |
Definition at line 77 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inherited |
Definition at line 80 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
staticprivateinherited |
Definition at line 106 of file Updatable.hpp.
|
protectedinherited |
Definition at line 305 of file LinkedList.hpp.
|
protectedinherited |
Definition at line 306 of file LinkedList.hpp.
|
privateinherited |
Definition at line 82 of file ButtonMatrix.hpp.
|
privateinherited |
Definition at line 83 of file ButtonMatrix.hpp.
|
privateinherited |
Definition at line 85 of file ButtonMatrix.hpp.
|
privateinherited |
Definition at line 86 of file ButtonMatrix.hpp.