Selector that listens for MIDI Program Change events on a given MIDI Channel, and uses the program number as its selection. This version displays the setting using LEDs. More...

#include <Selectors/LEDs/SelectorLEDs.hpp>

Inheritance diagram for ProgramChangeSelectorLEDs< N >:

Collaboration diagram for ProgramChangeSelectorLEDs< N >:

Public Types
using	Mutex = typename std::conditional< ThreadSafe, DefaultMutEx, EmptyMutex >::type

using	LockGuard = typename std::conditional< ThreadSafe, DefaultLockGuard< Mutex >, EmptyLockGuard< Mutex > >::type

Public Member Functions
	ProgramChangeSelectorLEDs (Selectable< N > &selectable, const MIDIChannelCN &address, const PinList< N > &ledPins)

void	begin () override
	Initialize the input element. More...

void	reset () override
	Reset the input element to its initial state. More...

bool	updateImpl (const ChannelMessageMatcher &midimsg, const MIDIAddress &target) override
	Update the internal state with the new MIDI message. More...

void	update () override
	Update this updatable. More...

virtual void	update ()
	Update the value of the input element. Used for decaying VU meters etc. More...

void	set (setting_t newSetting)
	Select the given selection. More...

void	increment (Wrap wrap)
	Add one to the setting, wrap around or clamp, depending on the parameter, if the new setting would be out of range. More...

void	decrement (Wrap wrap)
	Subtract one from the setting, wrap around or clamp, depending on the parameter, if the new setting would be out of range. More...

setting_t	get () const
	Get the current selection/setting. More...

bool	updateWith (const ChannelMessageMatcher &midimsg)
	Receive a new MIDI message and update the internal state. More...

Static Public Member Functions
static void	beginAll ()

static void	updateAll ()
	Update all MIDIInputElementPC elements. More...

static Mutex &	getMutex ()

static void	resetAll ()
	Reset all MIDIInputElementPC elements to their initial state. More...

static void	updateAllWith (const ChannelMessageMatcher &midimsg)
	Update all MIDIInputElementPC elements with a new MIDI message. More...

Public Attributes
SelectorLEDsCallback< N >	callback

Protected Attributes
setting_t	setting = 0
	The selection of the selector. More...

Updatable< NormalUpdatable, false > *	next

MIDIInputElementPC *	next

Updatable< NormalUpdatable, false > *	previous

MIDIInputElementPC *	previous

const MIDIAddress	address

Static Protected Attributes
static DoublyLinkedList< Updatable< NormalUpdatable, false > >	updatables

static Mutex	mutex

Private Member Functions
MIDIAddress	getTarget (const ChannelMessageMatcher &midimsg) const override
	Program Change doesn't have an address, so the target consists of just the channel and the cable number. More...

virtual bool	match (const MIDIAddress &target) const
	Check if the address of the incoming MIDI message matches an address of this element. More...

Private Attributes
Selectable< N > &	selectable

Static Private Attributes
static DoublyLinkedList< MIDIInputElementPC >	elements

Main initialization and updating methods
static void	applyToAll (const LockGuard &, void(Derived::*method)(Args &&...), Args &&... args)

static void	applyToAll (void(Derived::*method)(Args &&...), Args &&... args)

Enabling and disabling updatables
void	enable (const LockGuard &lock)
	Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. More...

void	enable ()
	Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. More...

void	disable (const LockGuard &lock)
	Disable this updatable: remove it from the linked list of instances, so it no longer 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 (const LockGuard &) const
	Check if this updatable is enabled. More...

bool	isEnabled ()
	Check if this updatable is enabled. More...

void	moveDown (const LockGuard &)
	Move down this element in the list. More...

void	moveDown ()
	Move down this element in the list. More...

static void	enable (UpdatableCRTP *element)
	Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. More...

static void	enable (UpdatableCRTP &element)
	Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. More...

static void	enable (U(&array)[N])
	Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. More...

static void	disable (UpdatableCRTP *element)
	Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. More...

static void	disable (UpdatableCRTP &element)
	Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. More...

static void	disable (U(&array)[N])
	Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. More...

Main initialization and updating methods
static void	beginAll ()
	Begin all enabled instances of this class. More...

static void	updateAll ()
	Update all enabled instances of this class. More...

Detailed Description

template<setting_t N>
class ProgramChangeSelectorLEDs< N >

Selector that listens for MIDI Program Change events on a given MIDI Channel, and uses the program number as its selection. This version displays the setting using LEDs.

Template Parameters

N	The number of settings. The maximum program number is \( N - 1 \).

Definition at line 181 of file SelectorLEDs.hpp.

Member Typedef Documentation

◆ Mutex

using Mutex = typename std::conditional<ThreadSafe, DefaultMutEx, EmptyMutex>::type

inherited

Definition at line 36 of file Updatable.hpp.

◆ LockGuard

using LockGuard = typename std::conditional<ThreadSafe, DefaultLockGuard<Mutex>, EmptyLockGuard<Mutex> >::type

inherited

Definition at line 38 of file Updatable.hpp.

Constructor & Destructor Documentation

◆ ProgramChangeSelectorLEDs()

ProgramChangeSelectorLEDs	(	Selectable< N > &	selectable,
		const MIDIChannelCN &	address,
		const PinList< N > &	ledPins
	)

inline

Definition at line 184 of file SelectorLEDs.hpp.

Member Function Documentation

◆ begin()

void begin

inlineoverridevirtualinherited

Initialize the input element.

Reimplemented from MIDIInputElement.

Definition at line 18 of file ProgramChangeSelector.hpp.

◆ reset()

void reset

inlineoverridevirtualinherited

Reset the input element to its initial state.

Reimplemented from MIDIInputElement.

Definition at line 23 of file ProgramChangeSelector.hpp.

◆ updateImpl()

bool updateImpl	(	const ChannelMessageMatcher &	midimsg,
		const MIDIAddress &	target
	)

inlineoverridevirtualinherited

Update the internal state with the new MIDI message.

Implements MIDIInputElement.

Definition at line 25 of file ProgramChangeSelector.hpp.

◆ update() [1/2]

void update

inlineoverridevirtualinherited

Update this updatable.

Implements Updatable<>.

Definition at line 78 of file Selector.hpp.

◆ update() [2/2]

virtual void update ( )

inlinevirtualinherited

Update the value of the input element. Used for decaying VU meters etc.

Reimplemented in VU_Base< NumValues, Callback >, VU_Base< NumBanks, VULEDsCallback< NumLEDs > >, VU_Base< NumBanks, VUEmptyCallback >, VU_Base< 1, VUEmptyCallback >, and VU_Base< 1, VULEDsCallback< NumLEDs > >.

Definition at line 36 of file MIDIInputElement.hpp.

◆ set()

void set ( setting_t newSetting )

inlineinherited

Select the given selection.

Parameters

newSetting The new setting to select [0, N-1].

Definition at line 94 of file Selector.hpp.

◆ increment()

void increment ( Wrap wrap )

inlineinherited

Add one to the setting, wrap around or clamp, depending on the parameter, if the new setting would be out of range.

Parameters

wrap	Wrap or clamp if the new setting would be out of range.

Definition at line 110 of file Selector.hpp.

◆ decrement()

void decrement ( Wrap wrap )

inlineinherited

Subtract one from the setting, wrap around or clamp, depending on the parameter, if the new setting would be out of range.

Parameters

wrap	Wrap or clamp if the new setting would be out of range.

Definition at line 129 of file Selector.hpp.

◆ get()

setting_t get ( ) const

inlineinherited

Get the current selection/setting.

Definition at line 47 of file Selector.hpp.

◆ beginAll() [1/2]

static void beginAll ( )

inlinestaticinherited

Begin all enabled instances of this class.

See also: begin()

Definition at line 208 of file Updatable.hpp.

◆ beginAll() [2/2]

static void beginAll ( )

inlinestaticinherited

Definition at line 42 of file MIDIInputElementPC.hpp.

◆ updateAll() [1/2]

static void updateAll ( )

inlinestaticinherited

Update all enabled instances of this class.

See also: update()

Definition at line 212 of file Updatable.hpp.

◆ updateAll() [2/2]

static void updateAll ( )

inlinestaticinherited

Update all MIDIInputElementPC elements.

Definition at line 63 of file MIDIInputElementPC.hpp.

◆ getMutex()

static Mutex& getMutex ( )

inlinestaticinherited

Definition at line 79 of file Updatable.hpp.

◆ applyToAll() [1/2]

static void applyToAll	(	const LockGuard &	,
		void(Derived::*)(Args &&...)	method,
		Args &&...	args
	)

inlinestaticinherited

Definition at line 85 of file Updatable.hpp.

◆ applyToAll() [2/2]

static void applyToAll	(	void(Derived::*)(Args &&...)	method,
		Args &&...	args
	)

inlinestaticinherited

Definition at line 93 of file Updatable.hpp.