#include <MIDI_Outputs/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 cannot be banked.
NumButtons | The number of buttons in the collection. |
Definition at line 24 of file 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 (const Array< AH::Button, NumButtons > &buttons, MIDIAddress baseAddress, RelativeMIDIAddress incrementAddress, uint8_t velocity=0x7F) | |
Create a new 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. | |
AH::Button::State | getButtonState (size_t index) const |
MIDIAddress | getBaseAddress () const |
Get the MIDI base address. | |
void | setBaseAddressUnsafe (MIDIAddress address) |
Set the MIDI base address. | |
RelativeMIDIAddress | getIncrementAddress () const |
Get the MIDI increment address. | |
void | setIncrementAddressUnsafe (RelativeMIDIAddress address) |
Set the MIDI increment address. | |
void | invert () |
Public Attributes | |
DigitalNoteSender | sender |
Protected Attributes | |
Derived * | next |
Derived * | previous |
Static Protected Attributes | |
static DoublyLinkedList< Derived > | updatables |
Private Attributes | |
Array< AH::Button, NumButtons > | buttons |
MIDIAddress | baseAddress |
RelativeMIDIAddress | incrementAddress |
|
inline |
Create a new NoteButtons object with the given pins, the given controller number and channel.
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 45 of file NoteButtons.hpp.
|
inline |
Set the velocity of the MIDI Note events.
Definition at line 56 of file NoteButtons.hpp.
|
inline |
Get the velocity of the MIDI Note events.
Definition at line 58 of file NoteButtons.hpp.
|
inlinefinaloverridevirtualinherited |
Initialize this updatable.
Implements Updatable< T >.
Definition at line 31 of file Abstract/MIDIButtons.hpp.
|
inlinefinaloverridevirtualinherited |
Update this updatable.
Implements Updatable< T >.
Definition at line 35 of file Abstract/MIDIButtons.hpp.
|
inlineinherited |
Definition at line 48 of file Abstract/MIDIButtons.hpp.
|
inlineinherited |
Get the MIDI base address.
Definition at line 53 of file Abstract/MIDIButtons.hpp.
|
inlineinherited |
Set the MIDI base address.
Has unexpected consequences if used while a push button is pressed. Use banks if you need to support that.
Definition at line 57 of file Abstract/MIDIButtons.hpp.
|
inlineinherited |
Get the MIDI increment address.
Definition at line 61 of file Abstract/MIDIButtons.hpp.
|
inlineinherited |
Set the MIDI increment address.
Has unexpected consequences if used while a push button is pressed. Use banks if you need to support that.
Definition at line 67 of file Abstract/MIDIButtons.hpp.
|
inlineinherited |
Definition at line 72 of file 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.
|
privateinherited |
Definition at line 78 of file Abstract/MIDIButtons.hpp.
|
privateinherited |
Definition at line 79 of file Abstract/MIDIButtons.hpp.
|
privateinherited |
Definition at line 80 of file Abstract/MIDIButtons.hpp.
|
inherited |
Definition at line 83 of file 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.