#include <MIDI_Outputs/Bankable/PBPotentiometer.hpp>
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 14-bit MIDI Pitch Bend events.
The analog input is filtered and hysteresis is applied for maximum stability.
The actual precision is "only" 10 bits, because this is the resolution of the built-in ADC, and this is the default resolution used by the Mackie Control Universal protocol.
This version can be banked.
Definition at line 25 of file Bankable/PBPotentiometer.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 | |
PBPotentiometer (OutputBankConfig< BankType::ChangeChannel > config, pin_t analogPin, MIDIChannelCable address) | |
Create a new Bankable PBPotentiometer object with the given analog pin and channel. | |
void | begin () final override |
Initialize this updatable. | |
void | update () final override |
Update this updatable. | |
void | forcedUpdate () |
Send the value of the analog input over MIDI, even if the value didn't change. | |
void | map (MappingFunction fn) |
Specify a mapping function that is applied to the raw analog value before sending. | |
void | invert () |
Invert the analog value. | |
analog_t | getRawValue () const |
Get the raw value of the analog input (this is the value without applying the filter or the mapping function first). | |
analog_t | getValue () const |
Get the value of the analog input (this is the value after first applying the mapping function). | |
Static Public Member Functions | |
static constexpr analog_t | getMaxRawValue () |
Get the maximum value that can be returned from getRawValue. | |
Public Attributes | |
PitchBendSender< 10 > | sender |
Protected Types | |
using | FilteredAnalog |
Protected Attributes | |
SingleAddress | address |
FilteredAnalog | filteredAnalog |
Derived * | next |
Derived * | previous |
Static Protected Attributes | |
static DoublyLinkedList< Derived > | updatables |
|
protectedinherited |
Definition at line 90 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inline |
Create a new Bankable PBPotentiometer object with the given analog pin 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. |
analogPin | The analog input pin to read from. |
address | The MIDI channel [Channel_1, Channel_16] and optional Cable Number [Cable_1, Cable_16]. |
Definition at line 41 of file Bankable/PBPotentiometer.hpp.
|
inlinefinaloverridevirtualinherited |
Initialize this updatable.
Implements Updatable< T >.
Definition at line 39 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlinefinaloverridevirtualinherited |
Update this updatable.
Implements Updatable< T >.
Definition at line 41 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlineinherited |
Send the value of the analog input over MIDI, even if the value didn't change.
Definition at line 48 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlineinherited |
Specify a mapping function that is applied to the raw analog value before sending.
fn | A function pointer to the mapping function. This function should take the filtered analog value of \( 16 - \mathrm{ANALOG\_FILTER\_SHIFT\_FACTOR} \) bits as a parameter, and should return a value in the same range. |
Definition at line 64 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlineinherited |
Invert the analog value.
Definition at line 67 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlineinherited |
Get the raw value of the analog input (this is the value without applying the filter or the mapping function first).
Definition at line 73 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlinestaticconstexprinherited |
Get the maximum value that can be returned from getRawValue.
Definition at line 78 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inlineinherited |
Get the value of the analog input (this is the value after first applying the mapping function).
Definition at line 86 of file Bankable/Abstract/MIDIFilteredAnalog.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 89 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
protectedinherited |
Definition at line 91 of file Bankable/Abstract/MIDIFilteredAnalog.hpp.
|
inherited |
Definition at line 94 of file Bankable/Abstract/MIDIFilteredAnalog.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.