#include <MIDI_Outputs/Bankable/Abstract/SmartMIDIFilteredAnalog.hpp>
A class for potentiometers and faders that send MIDI events.
When changing banks, it disables the potentiometer until you move it to the position where it was last time the current bank was active. This prevents the values changing when changing banks.
The analog input is filtered and hysteresis is applied.
Definition at line 26 of file SmartMIDIFilteredAnalog.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 Types | |
enum | State { Active , Lower , Higher } |
State of the smart potentiometer. More... | |
Public Member Functions | |
void | begin () override |
Initialize this updatable. | |
void | update () override |
Update this updatable. | |
State | getState () const |
Get the state of the smart potentiometer, to know whether the position has to be lower or higher in order to activate it. | |
void | activate () |
Activate the potentiometer in the current bank, regardless of its current and previous position. | |
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). | |
analog_t | getPreviousValue (setting_t bank) const |
Get the previous value of the analog input of the given bank. | |
analog_t | getPreviousValue () const |
Get the previous value of the analog input of the active bank. | |
Static Public Member Functions | |
static constexpr analog_t | getMaxRawValue () |
Get the maximum value that can be returned from getRawValue. | |
Public Attributes | |
Sender | sender |
Protected Types | |
using | FilteredAnalog = AH::FilteredAnalog<Sender::precision()> |
Protected Member Functions | |
SmartMIDIFilteredAnalog (BankAddress bankAddress, pin_t analogPin, const Sender &sender) | |
Construct a new SmartMIDIFilteredAnalog. | |
Protected Attributes | |
BankAddress | address |
FilteredAnalog | filteredAnalog |
AH::Array< analog_t, NumBanks > | previousValues = {{}} |
State | state = Active |
setting_t | previousBank = 0 |
Derived * | next |
Derived * | previous |
Static Protected Attributes | |
static constexpr analog_t | initial = 1u << 14 |
static DoublyLinkedList< Derived > | updatables |
|
protected |
Definition at line 157 of file SmartMIDIFilteredAnalog.hpp.
enum State |
State of the smart potentiometer.
Definition at line 45 of file SmartMIDIFilteredAnalog.hpp.
|
inlineprotected |
Construct a new SmartMIDIFilteredAnalog.
bankAddress | The bankable MIDI address to send to. |
analogPin | The analog input pin with the wiper of the potentiometer connected. |
sender | The MIDI sender to use. |
Definition at line 39 of file SmartMIDIFilteredAnalog.hpp.
|
inlineoverridevirtual |
Initialize this updatable.
Implements Updatable< T >.
Definition at line 59 of file SmartMIDIFilteredAnalog.hpp.
|
inlineoverridevirtual |
Update this updatable.
Implements Updatable< T >.
Definition at line 66 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Get the state of the smart potentiometer, to know whether the position has to be lower or higher in order to activate it.
Definition at line 97 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Activate the potentiometer in the current bank, regardless of its current and previous position.
Definition at line 103 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
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 117 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Invert the analog value.
Definition at line 120 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Get the raw value of the analog input (this is the value without applying the filter or the mapping function first).
Definition at line 126 of file SmartMIDIFilteredAnalog.hpp.
|
inlinestaticconstexpr |
Get the maximum value that can be returned from getRawValue.
Definition at line 131 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Get the value of the analog input (this is the value after first applying the mapping function).
Definition at line 139 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Get the previous value of the analog input of the given bank.
Definition at line 144 of file SmartMIDIFilteredAnalog.hpp.
|
inline |
Get the previous value of the analog input of the active bank.
Definition at line 151 of file SmartMIDIFilteredAnalog.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.
|
protected |
Definition at line 156 of file SmartMIDIFilteredAnalog.hpp.
|
protected |
Definition at line 158 of file SmartMIDIFilteredAnalog.hpp.
|
staticconstexprprotected |
Definition at line 163 of file SmartMIDIFilteredAnalog.hpp.
|
protected |
Definition at line 164 of file SmartMIDIFilteredAnalog.hpp.
Definition at line 165 of file SmartMIDIFilteredAnalog.hpp.
|
protected |
Definition at line 166 of file SmartMIDIFilteredAnalog.hpp.
Sender sender |
Definition at line 169 of file SmartMIDIFilteredAnalog.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.