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/NoteButtonMatrix.hpp>
Public Member Functions | |
NoteButtonMatrix (const PinList< nb_rows > &rowPins, const PinList< nb_cols > &colPins, const AddressMatrix< nb_rows, nb_cols > ¬es, MIDICNChannel channelCN={CHANNEL_1, 0}, uint8_t velocity=0x7F) | |
Create a new NoteButtonMatrix object with the given pins, note 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 () final override |
Initialize this updatable. More... | |
void | update () final 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 | |
AddressMatrix< nb_rows, nb_cols > | addresses |
const MIDICNChannel | baseChannelCN |
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 cannot be banked.
nb_rows | The number of rows of the matrix. |
nb_cols | The number of columns of the matrix. |
Definition at line 26 of file NoteButtonMatrix.hpp.
|
inline |
Create a new NoteButtonMatrix object with the given pins, note numbers and channel.
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 2-dimensional array of the same dimensions as the button matrix that contains the note number of each button. [0, 127] |
channelCN | The MIDI channel [1, 16] and Cable Number [0, 15]. |
velocity | The velocity of the MIDI Note events. |
Definition at line 50 of file NoteButtonMatrix.hpp.
|
inline |
Set the velocity of the MIDI Note events.
Definition at line 60 of file NoteButtonMatrix.hpp.
|
inline |
Get the velocity of the MIDI Note events.
Definition at line 62 of file NoteButtonMatrix.hpp.
|
inlinefinaloverridevirtualinherited |
Initialize this updatable.
Implements Updatable<>.
Definition at line 31 of file Abstract/MIDIButtonMatrix.hpp.
|
inlinefinaloverridevirtualinherited |
Update this updatable.
Implements Updatable<>.
Definition at line 33 of file 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 38 of file 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 46 of file Abstract/MIDIButtonMatrix.hpp.
|
privateinherited |
Definition at line 47 of file Abstract/MIDIButtonMatrix.hpp.
|
inherited |
Definition at line 50 of file 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.