#include <MIDI_Outputs/Bankable/NoteButtons.hpp>
A class of MIDIOutputElements that read the input of a collection 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.
The buttons are debounced in software.
This version can be banked.
NumButtons | The number of buttons in the collection. |
Definition at line 27 of file Bankable/NoteButtons.hpp.
Enabling and disabling updatables | |
void | enable () |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
void | disable () |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
bool | isEnabled () const |
Check if this updatable is enabled. | |
void | moveDown () |
Move down this element in the list. | |
static void | enable (UpdatableCRTP *element) |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
static void | enable (UpdatableCRTP &element) |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
template<class U , size_t N> | |
static void | enable (U(&array)[N]) |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
static void | disable (UpdatableCRTP *element) |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
static void | disable (UpdatableCRTP &element) |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
template<class U , size_t N> | |
static void | disable (U(&array)[N]) |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
Main initialization and updating methods | |
static void | beginAll () |
Begin all enabled instances of this class. | |
static void | updateAll () |
Update all enabled instances of this class. | |
Public Member Functions | |
NoteButtons (OutputBankConfig<> config, const Array< AH::Button, NumButtons > &buttons, MIDIAddress baseAddress, RelativeMIDIAddress incrementAddress, uint8_t velocity=0x7F) | |
Create a new Bankable NoteButtons object with the given pins, the given controller number and channel. | |
void | setVelocity (uint8_t velocity) |
Set the velocity of the MIDI Note events. | |
uint8_t | getVelocity () const |
Get the velocity of the MIDI Note events. | |
void | begin () final override |
Initialize this updatable. | |
void | update () final override |
Update this updatable. | |
void | invert () |
AH::Button::State | getButtonState (size_t index) const |
Public Attributes | |
DigitalNoteSender | sender |
Protected Attributes | |
SingleAddress | address |
Array< AH::Button, NumButtons > | buttons |
RelativeMIDIAddress | incrementAddress |
uint8_t | activeButtons |
Derived * | next |
Derived * | previous |
Static Protected Attributes | |
static DoublyLinkedList< Derived > | updatables |
|
inline |
Create a new Bankable NoteButtons object with the given pins, the given controller number 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. |
buttons | A list of digital input pins with the buttons connected. The internal pull-up resistors will be enabled. |
baseAddress | The MIDI address of the first button, containing the note number [0, 127], channel [Channel_1, Channel_16], and optional cable number [Cable_1, Cable_16]. |
incrementAddress | The number of addresses to increment for each next button. E.g. if baseAddress is 8, and incrementAddress is 2, then the first button will send on address 8, the second button will send on address 10, button three on address 12, etc. |
velocity | The velocity of the MIDI Note events. |
Definition at line 52 of file Bankable/NoteButtons.hpp.
Set the velocity of the MIDI Note events.
Definition at line 64 of file Bankable/NoteButtons.hpp.
Get the velocity of the MIDI Note events.
Definition at line 66 of file Bankable/NoteButtons.hpp.
|
inlinefinaloverridevirtualinherited |
Initialize this updatable.
Implements Updatable< T >.
Definition at line 37 of file Bankable/Abstract/MIDIButtons.hpp.
|
inlinefinaloverridevirtualinherited |
Update this updatable.
Implements Updatable< T >.
Definition at line 41 of file Bankable/Abstract/MIDIButtons.hpp.
|
inlineinherited |
Definition at line 63 of file Bankable/Abstract/MIDIButtons.hpp.
|
inlineinherited |
Definition at line 68 of file Bankable/Abstract/MIDIButtons.hpp.
|
inlinestaticinherited |
Begin all enabled instances of this class.
Definition at line 182 of file Updatable.hpp.
|
inlinestaticinherited |
Update all enabled instances of this class.
Definition at line 186 of file Updatable.hpp.
|
inlineinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 96 of file Updatable.hpp.
|
inlinestaticinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 125 of file Updatable.hpp.
|
inlinestaticinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 127 of file Updatable.hpp.
|
inlinestaticinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 130 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 106 of file Updatable.hpp.
|
inlinestaticinherited |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 136 of file Updatable.hpp.
|
inlinestaticinherited |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 138 of file Updatable.hpp.
|
inlinestaticinherited |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 141 of file Updatable.hpp.
|
inlineinherited |
Check if this updatable is enabled.
Definition at line 120 of file Updatable.hpp.
|
inlineinherited |
Move down this element in the list.
Definition at line 147 of file Updatable.hpp.
|
protectedinherited |
Definition at line 73 of file Bankable/Abstract/MIDIButtons.hpp.
|
protectedinherited |
Definition at line 74 of file Bankable/Abstract/MIDIButtons.hpp.
|
protectedinherited |
Definition at line 75 of file Bankable/Abstract/MIDIButtons.hpp.
|
protectedinherited |
Definition at line 76 of file Bankable/Abstract/MIDIButtons.hpp.
|
inherited |
Definition at line 79 of file Bankable/Abstract/MIDIButtons.hpp.
|
staticprotectedinherited |
Definition at line 152 of file Updatable.hpp.
|
protectedinherited |
Definition at line 320 of file LinkedList.hpp.
|
protectedinherited |
Definition at line 321 of file LinkedList.hpp.