A class for MIDI input elements that represent Mackie Control Universal V-Pots. More...

#include <MIDI_Inputs/MCU/VPotRing.hpp>

Inheritance diagram for GenericVPotRing< NumBanks, Callback >:

Collaboration diagram for GenericVPotRing< NumBanks, Callback >:

Public Member Functions
	GenericVPotRing (BankConfig< NumBanks > config, uint8_t track, const MIDIChannelCN &channelCN, const Callback &callback)

void	begin () override
	Initialize. More...

void	reset () override
	Reset all values to zero. More...

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

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

uint8_t	getPosition () const
	Return the position of the V-Pot ring. [0, 11]. More...

bool	getCenterLed () const
	Return the status of the center LED of the V-Pot ring. More...

uint8_t	getMode () const
	Return the mode of the V-Pot ring: 0 = single dot, 1 = boost/cut, 2 = wrap, 3 = spread. More...

uint8_t	getStartOn () const
	Get the first segment that should be on. More...

uint8_t	getStartOff () const
	Get the first segment that should be off. More...

setting_t	getSelection () const
	Get the current bank setting. More...

uint8_t	getBankIndex (const MIDIAddress &target, const MIDIAddress &base) const
	Calculate the bank setting of a given MIDI address, relative to a base address. More...

Static Public Member Functions
static void	beginAll ()
	Initialize all MIDIInputElementCC elements. More...

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

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

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

Public Attributes
VPotEmptyCallback	callback

Protected Member Functions
bool	matchBankable (uint8_t toMatch, uint8_t base) const
	Check if the given address is part of the bank relative to the base address. More...

bool	matchBankable (const MIDIAddress &toMatch, const MIDIAddress &base) const
	Check whether a given address is part of the bank relative to the base address. More...

bool	matchBankableInRange (uint8_t toMatch, uint8_t base, uint8_t length) const
	Check if the given address is part of the bank relative to the base address. More...

uint8_t	getRangeIndex (MIDIAddress target, MIDIAddress base) const
	If matchBankableAddressInRange returned true, get the index of the message in the range. More...

bool	matchBankableAddressInRange (const MIDIAddress &toMatch, const MIDIAddress &base, uint8_t length) const
	Check whether a given address is part of the bank relative to the base address and within a range with a given length. More...

Static Protected Member Functions
static uint8_t	sanitizeValue (uint8_t value)
	Make sure that the received value is valid and will not result in array out of bounds conditions. More...

static bool	inRange (uint8_t toMatch, uint8_t base, uint8_t length)
	Check whether a given address is within a range of given length starting from the given base address. More...

Protected Attributes
const MIDIAddress	address

MIDIInputElementCC *	next

MIDIInputElementCC *	previous

Private Member Functions
setting_t	getSelection () const override

uint8_t	getBankIndex (const MIDIAddress &target) const override
	Get the bank index from a MIDI address. More...

bool	match (const MIDIAddress &target) const override
	Check if the address of the incoming MIDI message is in one of the banks of this element. More...

void	onBankSettingChange () override
	A function to be executed each time the bank setting changes. More...

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

uint8_t	getValue () const override

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

virtual MIDIAddress	getTarget (const ChannelMessageMatcher &midimsg) const
	Extract the target address from a MIDI message. More...

Static Private Member Functions
static uint8_t	getPosition (uint8_t value)
	Extract the position from the raw value. More...

static bool	getCenterLed (uint8_t value)
	Extract the center LED state from the raw value. More...

static uint8_t	getMode (uint8_t value)
	Extract the mode from the raw value. More...

Private Attributes
Array< uint8_t, NumValues >	values

Bank< N > &	bank

const BankType	type

Static Private Attributes
static DoublyLinkedList< MIDIInputElementCC >	elements

Detailed Description

template<uint8_t NumBanks, class Callback = VPotEmptyCallback>
class MCU::Bankable::GenericVPotRing< NumBanks, Callback >

A class for MIDI input elements that represent Mackie Control Universal V-Pots.

This version is generic to allow for custom callbacks.
This version can be banked.

Template Parameters

NumBanks The number of banks.

Definition at line 179 of file VPotRing.hpp.

Constructor & Destructor Documentation

◆ GenericVPotRing()

GenericVPotRing	(	BankConfig< NumBanks >	config,
		uint8_t	track,
		const MIDIChannelCN &	channelCN,
		const Callback &	callback
	)

inline

Definition at line 182 of file VPotRing.hpp.

Member Function Documentation

◆ getSelection() [1/2]

setting_t getSelection ( ) const

inlineoverrideprivate

Definition at line 188 of file VPotRing.hpp.

◆ getBankIndex() [1/2]

uint8_t getBankIndex ( const MIDIAddress & target ) const

inlineoverrideprivatevirtual

Get the bank index from a MIDI address.

Reimplemented from VPotRing_Base< NumBanks, VPotEmptyCallback >.

Definition at line 192 of file VPotRing.hpp.

◆ match()

bool match ( const MIDIAddress & target ) const

inlineoverrideprivatevirtual

Check if the address of the incoming MIDI message is in one of the banks of this element.

Reimplemented from MIDIInputElement.

Definition at line 198 of file VPotRing.hpp.

◆ onBankSettingChange()

void onBankSettingChange ( )

inlineoverrideprivatevirtual

A function to be executed each time the bank setting changes.

Think of an LED that indicates whether a track is muted or not. If this LED is bankable, let's say with 4 tracks per bank, 2 banks, and a base address of 3, then this LED object keeps the state of tracks 3 and 7. When the bank setting is 0, the LED displays the state of track 3, when the bank setting is 1, the LED displays the state of track 7.
To know when to update the LED, this callback is used.

Reimplemented from BankableMIDIInput< NumBanks >.

Definition at line 203 of file VPotRing.hpp.

◆ begin()

void begin

inlineoverridevirtualinherited

Initialize.

Reimplemented from MIDIInputElement.

Definition at line 92 of file VPotRing.hpp.

◆ reset()

void reset

inlineoverridevirtualinherited

Reset all values to zero.

Reimplemented from MIDIInputElement.

Definition at line 95 of file VPotRing.hpp.

◆ sanitizeValue()

static uint8_t sanitizeValue ( uint8_t value )

inlinestaticprotectedinherited

Make sure that the received value is valid and will not result in array out of bounds conditions.

Definition at line 105 of file VPotRing.hpp.

◆ updateImpl()

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

inlineoverrideprivatevirtualinherited

Update the internal state with the new MIDI message.

Implements MIDIInputElement.

Definition at line 110 of file VPotRing.hpp.

◆ getValue()

uint8_t getValue

inlineoverrideprivateinherited

Definition at line 120 of file VPotRing.hpp.

◆ beginAll()

static void beginAll ( )

inlinestaticinherited

Initialize all MIDIInputElementCC elements.

See also: MIDIInputElementCC::begin

Definition at line 52 of file MIDIInputElementCC.hpp.

◆ updateAll()

static void updateAll ( )

inlinestaticinherited

Update all MIDIInputElementCC elements.

See also: MIDIInputElementCC::update

Definition at line 60 of file MIDIInputElementCC.hpp.

◆ resetAll()

static void resetAll ( )

inlinestaticinherited

Reset all MIDIInputElementCC elements to their initial state.

See also: MIDIInputElementCC::reset

Definition at line 68 of file MIDIInputElementCC.hpp.

◆ updateAllWith()

static void updateAllWith ( const ChannelMessageMatcher & midimsg )

inlinestaticinherited

Update all MIDIInputElementCC elements with a new MIDI message.

See also: MIDIInputElementCC::updateWith

Definition at line 76 of file MIDIInputElementCC.hpp.

◆ moveDown()

void moveDown ( )

inlineprivateinherited

Move down this element in the linked list of elements.

This means that the element will be checked earlier on the next iteration.

Definition at line 94 of file MIDIInputElementCC.hpp.

◆ update()

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.

◆ updateWith()

bool updateWith ( const ChannelMessageMatcher & midimsg )

inlineinherited

Receive a new MIDI message and update the internal state.

Definition at line 39 of file MIDIInputElement.hpp.

◆ getTarget()

virtual MIDIAddress getTarget ( const ChannelMessageMatcher & midimsg ) const

inlineprivatevirtualinherited

Extract the target address from a MIDI message.

Note: This base version of the function is only valid for messages that use data1 as an address (i.e. Note On, Note Off, Polyphonic Key Pressure and Control Change), because it assumes that the target address consists of the address (data 1), the MIDI channel and the cable number.

Reimplemented in MIDIInputElementPC, MIDIInputElementChannelPressure, 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 63 of file MIDIInputElement.hpp.

◆ getPosition() [1/2]

uint8_t getPosition ( ) const

inlineinherited

Return the position of the V-Pot ring. [0, 11].

Definition at line 32 of file VPotRing.hpp.

◆ getPosition() [2/2]

static uint8_t getPosition ( uint8_t value )

inlinestaticprivateinherited

Extract the position from the raw value.

Definition at line 72 of file VPotRing.hpp.

◆ getCenterLed() [1/2]

bool getCenterLed ( ) const

inlineinherited

Return the status of the center LED of the V-Pot ring.

Definition at line 34 of file VPotRing.hpp.

◆ getCenterLed() [2/2]

static bool getCenterLed ( uint8_t value )

inlinestaticprivateinherited

Extract the center LED state from the raw value.

Definition at line 77 of file VPotRing.hpp.

◆ getMode() [1/2]

uint8_t getMode ( ) const

inlineinherited

Return the mode of the V-Pot ring: 0 = single dot, 1 = boost/cut, 2 = wrap, 3 = spread.

Definition at line 37 of file VPotRing.hpp.

◆ getMode() [2/2]

static uint8_t getMode ( uint8_t value )

inlinestaticprivateinherited

Extract the mode from the raw value.

Definition at line 79 of file VPotRing.hpp.

◆ getStartOn()

uint8_t getStartOn ( ) const

inlineinherited

Get the first segment that should be on.

Definition at line 40 of file VPotRing.hpp.

◆ getStartOff()

uint8_t getStartOff ( ) const

inlineinherited

Get the first segment that should be off.

Definition at line 56 of file VPotRing.hpp.

◆ getSelection() [2/2]

setting_t getSelection ( ) const

inlineinherited

Get the current bank setting.

See also: Bank<N>::getSelection()

Definition at line 59 of file BankableMIDIInput.hpp.

◆ getBankIndex() [2/2]

uint8_t getBankIndex	(	const MIDIAddress &	target,
		const MIDIAddress &	base
	)		const

inlineinherited

Calculate the bank setting of a given MIDI address, relative to a base address.

Parameters

target	The MIDI address to calculate the bank setting of.
base	The base address to compare it to (the address of bank setting 0).

Definition at line 71 of file BankableMIDIInput.hpp.

◆ matchBankable() [1/2]

bool matchBankable	(	uint8_t	toMatch,
		uint8_t	base
	)		const

inlineprotectedinherited

Check if the given address is part of the bank relative to the base address.

Consider the following example:
A Bank with 4 tracks per bank (T), 2 bank settings (N), and a base address of 3.

0 1 2 3 4 5 6 7 8 9 10 11 12 ...

F F F T F F F T F F F F F ...

Addresses before the base adddress are not matched (0, 1, 2).
Addresses after N * T are not matched (8, 9, 10, 11, 12).
Addresses with a distance to the base address that is not a multiple of N are not matched (4, 5, 6).

Parameters

toMatch	The address to check.
base	The base address (the address of bank setting 0).

Note: Equivalent to matchBankableInRange(toMatch, base, 1).

Definition at line 113 of file BankableMIDIInput.hpp.

◆ matchBankable() [2/2]

bool matchBankable	(	const MIDIAddress &	toMatch,
		const MIDIAddress &	base
	)		const

inlineprotectedinherited

Check whether a given address is part of the bank relative to the base address.

Parameters

toMatch	The address to check.
base	The base address (the address of bank setting 0).

Definition at line 174 of file BankableMIDIInput.hpp.

◆ matchBankableInRange()

bool matchBankableInRange	(	uint8_t	toMatch,
		uint8_t	base,
		uint8_t	length
	)		const

inlineprotectedinherited

Check if the given address is part of the bank relative to the base address.

Todo:: This is very hard to explain without a specific example ...

Parameters

toMatch	The address to check.
base	The base address (the address of bank setting 0).
length	The length of the range.

Definition at line 132 of file BankableMIDIInput.hpp.

◆ getRangeIndex()

uint8_t getRangeIndex	(	MIDIAddress	target,
		MIDIAddress	base
	)		const

inlineprotectedinherited

If matchBankableAddressInRange returned true, get the index of the message in the range.

Definition at line 143 of file BankableMIDIInput.hpp.

◆ inRange()

static bool inRange	(	uint8_t	toMatch,
		uint8_t	base,
		uint8_t	length
	)

inlinestaticprotectedinherited

Check whether a given address is within a range of given length starting from the given base address.

Parameters

toMatch	The address to check
base	The base address, start of the range.
length	The length of the range.

Definition at line 161 of file BankableMIDIInput.hpp.

◆ matchBankableAddressInRange()

bool matchBankableAddressInRange	(	const MIDIAddress &	toMatch,
		const MIDIAddress &	base,
		uint8_t	length
	)		const

inlineprotectedinherited

Check whether a given address is part of the bank relative to the base address and within a range with a given length.

Parameters

toMatch	The address to check.
base	The base address (the address of bank setting 0).
length	The length of the range.

Definition at line 211 of file BankableMIDIInput.hpp.

Member Data Documentation

◆ values

Array<uint8_t, NumValues> values

privateinherited

Definition at line 131 of file VPotRing.hpp.

◆ callback

VPotEmptyCallback callback

inherited

Definition at line 134 of file VPotRing.hpp.

◆ elements

DoublyLinkedList< MIDIInputElementCC > elements

staticprivateinherited

Definition at line 99 of file MIDIInputElementCC.hpp.

◆ address

const MIDIAddress address

protectedinherited

Definition at line 83 of file MIDIInputElement.hpp.

◆ next

MIDIInputElementCC * next

protectedinherited

Definition at line 323 of file LinkedList.hpp.

◆ previous

MIDIInputElementCC * previous

protectedinherited

Definition at line 324 of file LinkedList.hpp.

◆ bank

Bank<N>& bank

privateinherited

Definition at line 242 of file BankableMIDIInput.hpp.

◆ type

const BankType type

privateinherited

Definition at line 243 of file BankableMIDIInput.hpp.

The documentation for this class was generated from the following file:

VPotRing.hpp

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

template<uint8_t NumBanks, class Callback = VPotEmptyCallback> class MCU::Bankable::GenericVPotRing< NumBanks, Callback >

Constructor & Destructor Documentation

◆ GenericVPotRing()

Member Function Documentation

◆ getSelection() [1/2]

◆ getBankIndex() [1/2]

◆ match()

◆ onBankSettingChange()

◆ begin()

◆ reset()

◆ sanitizeValue()

◆ updateImpl()

◆ getValue()

◆ beginAll()

◆ updateAll()

◆ resetAll()

◆ updateAllWith()

◆ moveDown()

◆ update()

◆ updateWith()

◆ getTarget()

◆ getPosition() [1/2]

◆ getPosition() [2/2]

◆ getCenterLed() [1/2]

◆ getCenterLed() [2/2]

◆ getMode() [1/2]

◆ getMode() [2/2]

◆ getStartOn()

◆ getStartOff()

◆ getSelection() [2/2]

◆ getBankIndex() [2/2]

◆ matchBankable() [1/2]

◆ matchBankable() [2/2]

◆ matchBankableInRange()

◆ getRangeIndex()

◆ inRange()

◆ matchBankableAddressInRange()

Member Data Documentation

◆ values

◆ callback

◆ elements

◆ address

◆ next

◆ previous

◆ bank

◆ type

template<uint8_t NumBanks, class Callback = VPotEmptyCallback>
class MCU::Bankable::GenericVPotRing< NumBanks, Callback >