#include <tracktion_MIDITrackerModifier.h>

Inheritance diagram for tracktion::engine::MIDITrackerModifier:

Classes
struct	Assignment

Public Types
enum	Type { pitch = 0 , velocity = 1 }

enum	Mode { absolute = 0 , relative = 1 }

using	Ptr = juce::ReferenceCountedObjectPtr< MIDITrackerModifier >

using	Array = juce::ReferenceCountedArray< MIDITrackerModifier >

Public Types inherited from tracktion::engine::Modifier
enum class	ProcessingPosition { none , preFX , postFX }
	Determines the position in the FX chain where the modifier should be processed. More...

using	Ptr = juce::ReferenceCountedObjectPtr< Modifier >

using	Array = juce::ReferenceCountedArray< Modifier >

Public Types inherited from tracktion::engine::Selectable
using	WeakRef = juce::WeakReference< Selectable >

Public Member Functions
	MIDITrackerModifier (Edit &, const juce::ValueTree &)

	~MIDITrackerModifier () override

void	initialise () override
	Call this once after construction to connect it to the audio graph.

juce::String	getName () const override

float	getCurrentValue () override
	Returns the current value of the modifier.

int	getCurrentMIDIValue () const noexcept
	Returns the MIDI value, either a pitch or velocity.

AutomatableParameter::ModifierAssignment *	createAssignment (const juce::ValueTree &) override
	Must return a new ModifierAssignment for a given state.

juce::StringArray	getMidiInputNames () override
	Can return an array of names represeting MIDI inputs.

ProcessingPosition	getProcessingPosition () override
	Should return the position in the plugin chain that this Modifier should be processed.

void	applyToBuffer (const PluginRenderContext &) override
	Sub classes should implement this to process the Modifier.

juce::String	getSelectableDescription () override
	Subclasses must return a description of what they are.

juce::ValueTree	getNodeState () const
	Returns a ValueTree representing the absolute nodes of the map.

virtual void	initialise ()=0
	Call this once after construction to connect it to the audio graph.

virtual void	initialise (double, int)
	Sub classes should implement this to initialise the Modifier.

Public Member Functions inherited from tracktion::engine::Modifier
	Modifier (Edit &, const juce::ValueTree &)
	Creates a Modifier for a given state.

	~Modifier () override
	Destructor.

void	remove ()
	Removes this Modifier from its parent Track.

virtual juce::StringArray	getAudioInputNames ()
	Can return an array of names represeting audio inputs.

virtual void	deinitialise ()
	Sub classes should implement this to deinitialise the Modifier.

bool	baseClassNeedsInitialising () const noexcept
	Returns true if the Modifier needs initialising.

void	baseClassInitialise (double sampleRate, int blockSizeSamples)
	Initialises the Modifier.

void	baseClassDeinitialise ()
	Deinitialises the Modifier.

void	baseClassApplyToBuffer (const PluginRenderContext &)
	Updates internal value history and calls the subclass's applyToBuffer method.

TimePosition	getCurrentTime () const
	Returns the edit time of the current value.

float	getValueAt (TimeDuration numSecondsBeforeNow) const
	Returns the value of the at a given time in the past.

std::vector< float >	getValues (TimeDuration numSecondsBeforeNow) const
	Returns a vector of previous sample values.

double	getSampleRate () const
	Returns the sample rate the Modifier has been initialised with.

void	selectableAboutToBeDeleted () override

Public Member Functions inherited from tracktion::engine::AutomatableEditItem
	AutomatableEditItem (Edit &, const juce::ValueTree &)

	~AutomatableEditItem () override

virtual void	flushPluginStateToValueTree ()

virtual void	restorePluginStateFromValueTree (const juce::ValueTree &)

juce::Array< AutomatableParameter * >	getAutomatableParameters () const

int	getNumAutomatableParameters () const

AutomatableParameter::Ptr	getAutomatableParameter (int index) const

AutomatableParameter::Ptr	getAutomatableParameterByID (const juce::String &paramID) const

void	visitAllAutomatableParams (const std::function< void(AutomatableParameter &)> &visit) const

void	deleteParameter (AutomatableParameter *)

void	deleteAutomatableParameters ()

int	indexOfAutomatableParameter (const AutomatableParameter::Ptr &) const

AutomatableParameterTree &	getParameterTree () const

juce::ReferenceCountedArray< AutomatableParameter >	getFlattenedParameterTree () const

void	addParameterListChangeListener (ParameterListChangeListener *)

void	removeParameterListChangeListener (ParameterListChangeListener *)

bool	isAutomationNeeded () const noexcept

void	setAutomatableParamPosition (TimePosition)

bool	isBeingActivelyPlayed () const

virtual void	updateAutomatableParamPosition (TimePosition)
	Updates all the auto params to their positions at this time.

void	updateParameterStreams (TimePosition)
	Updates all the parameter streams to their positions at this time.

void	updateActiveParameters ()
	Iterates all the parameters to find out which ones need to be automated.

void	resetRecordingStatus ()
	Marks the end of an automation recording stream.

Public Member Functions inherited from tracktion::engine::EditItem
	EditItem (EditItemID, Edit &)

	EditItem (Edit &, const juce::ValueTree &)

virtual	~EditItem ()=default

Public Member Functions inherited from tracktion::engine::Selectable
	Selectable ()

virtual	~Selectable ()

virtual void	selectionStatusChanged (bool isNowSelected)
	Can be overridden to tell this object that it has just been selected or deselected.

virtual void	changed ()
	This should be called to send a change notification to any SelectableListeners that are registered with this object.

void	addListener (SelectableListener *)

void	removeListener (SelectableListener *)

void	addSelectableListener (SelectableListener *)

void	removeSelectableListener (SelectableListener *)

void	cancelAnyPendingUpdates ()
	If changed() has been called, this will cancel any pending async change notificaions.

void	deselect ()

void	propertiesChanged ()

void	notifyListenersOfDeletion ()

WeakRef	getWeakRef ()

Public Member Functions inherited from tracktion::engine::AutomatableParameter::ModifierSource
	ModifierSource ()=default

virtual	~ModifierSource ()

Static Public Member Functions
static juce::StringArray	getTypeNames ()

static juce::StringArray	getModeNames ()

Static Public Member Functions inherited from tracktion::engine::Selectable
static void	initialise ()

static bool	isSelectableValid (const Selectable *) noexcept
	checks whether this object has been deleted.

Public Attributes
juce::CachedValue< float >	type

juce::CachedValue< float >	mode

juce::CachedValue< float >	relativeRoot

juce::CachedValue< float >	relativeSpread

AutomatableParameter::Ptr	typeParam

AutomatableParameter::Ptr	modeParam

AutomatableParameter::Ptr	relativeRootParam

AutomatableParameter::Ptr	relativeSpreadParam

Public Attributes inherited from tracktion::engine::Modifier
juce::ValueTree	state
	Modifier internal state.

juce::CachedValue< juce::Colour >	colour
	Colour property.

juce::CachedValue< float >	enabled
	Enabled property.

AutomatableParameter::Ptr	enabledParam
	Parameter to change the enabled state.

Public Attributes inherited from tracktion::engine::AutomatableEditItem
juce::ValueTree	elementState

juce::CachedValue< bool >	remapOnTempoChange

Public Attributes inherited from tracktion::engine::EditItem
Edit &	edit

const EditItemID	itemID
	Every EditItem has an ID which is unique within the edit.

Public Attributes inherited from tracktion::engine::Selectable
WeakRef::Master	masterReference

Additional Inherited Members
Static Public Attributes inherited from tracktion::engine::Modifier
static constexpr TimeDuration	maxHistoryTime = TimeDuration::fromSeconds (3.0)
	The max number of seconds of modifier value history that is stored.

Protected Member Functions inherited from tracktion::engine::Modifier
void	setEditTime (TimePosition newEditTime)
	Subclasses can call this to update the edit time of the current value.

Protected Member Functions inherited from tracktion::engine::AutomatableEditItem
virtual void	buildParameterTree () const

void	updateLastPlaybackTime ()

void	clearParameterList ()

void	addAutomatableParameter (const AutomatableParameter::Ptr &)

void	rebuildParameterTree ()

void	saveChangedParametersToState ()
	Saves the explicit value of any parameters that have deviated to the state.

void	restoreChangedParametersFromState ()
	Restores the value of any explicitly set parameters.

Member Typedef Documentation

◆ Ptr

using tracktion::engine::MIDITrackerModifier::Ptr = juce::ReferenceCountedObjectPtr<MIDITrackerModifier>

◆ Array

using tracktion::engine::MIDITrackerModifier::Array = juce::ReferenceCountedArray<MIDITrackerModifier>

Member Enumeration Documentation

◆ Type

enum tracktion::engine::MIDITrackerModifier::Type

Enumerator
pitch
velocity

◆ Mode

enum tracktion::engine::MIDITrackerModifier::Mode

Enumerator
absolute
relative

Constructor & Destructor Documentation

◆ MIDITrackerModifier()

tracktion::engine::MIDITrackerModifier::MIDITrackerModifier	(	Edit &	,
		const juce::ValueTree &
	)

◆ ~MIDITrackerModifier()

tracktion::engine::MIDITrackerModifier::~MIDITrackerModifier ( )

override

Member Function Documentation

◆ initialise() [1/3]

void tracktion::engine::MIDITrackerModifier::initialise ( )

overridevirtual

Call this once after construction to connect it to the audio graph.

Implements tracktion::engine::Modifier.

◆ getName()

juce::String tracktion::engine::MIDITrackerModifier::getName ( ) const

overridevirtual

Implements tracktion::engine::EditItem.

Referenced by getSelectableDescription().

◆ getCurrentValue()

float tracktion::engine::MIDITrackerModifier::getCurrentValue ( )

overridevirtual

Returns the current value of the modifier.

Implements tracktion::engine::Modifier.

◆ getCurrentMIDIValue()

int tracktion::engine::MIDITrackerModifier::getCurrentMIDIValue ( ) const

noexcept

Returns the MIDI value, either a pitch or velocity.

◆ createAssignment()

AutomatableParameter::ModifierAssignment * tracktion::engine::MIDITrackerModifier::createAssignment ( const juce::ValueTree & )

overridevirtual

Must return a new ModifierAssignment for a given state.

Implements tracktion::engine::Modifier.

◆ getMidiInputNames()

juce::StringArray tracktion::engine::MIDITrackerModifier::getMidiInputNames ( )

overridevirtual

Can return an array of names represeting MIDI inputs.

Reimplemented from tracktion::engine::Modifier.

◆ getProcessingPosition()

ProcessingPosition tracktion::engine::MIDITrackerModifier::getProcessingPosition ( )

overridevirtual

Should return the position in the plugin chain that this Modifier should be processed.

Reimplemented from tracktion::engine::Modifier.

References tracktion::engine::Modifier::preFX.

◆ applyToBuffer()

void tracktion::engine::MIDITrackerModifier::applyToBuffer ( const PluginRenderContext & )

overridevirtual

Sub classes should implement this to process the Modifier.

Reimplemented from tracktion::engine::Modifier.

◆ getSelectableDescription()

juce::String tracktion::engine::MIDITrackerModifier::getSelectableDescription ( )

overridevirtual

Subclasses must return a description of what they are.

Implements tracktion::engine::Selectable.

References getName().

◆ getTypeNames()

static juce::StringArray tracktion::engine::MIDITrackerModifier::getTypeNames ( )

static

◆ getModeNames()

static juce::StringArray tracktion::engine::MIDITrackerModifier::getModeNames ( )

static

◆ getNodeState()

juce::ValueTree tracktion::engine::MIDITrackerModifier::getNodeState ( ) const

Returns a ValueTree representing the absolute nodes of the map.

This will have 5 children each with a midi and value property which you can adjust.

◆ initialise() [2/3]

virtual void tracktion::engine::Modifier::initialise ( )

virtual

Call this once after construction to connect it to the audio graph.

Implements tracktion::engine::Modifier.

◆ initialise() [3/3]

virtual void tracktion::engine::Modifier::initialise	(	double	,
		int
	)

virtual

Sub classes should implement this to initialise the Modifier.

Reimplemented from tracktion::engine::Modifier.

Member Data Documentation

◆ type

juce::CachedValue<float> tracktion::engine::MIDITrackerModifier::type

◆ mode

juce::CachedValue<float> tracktion::engine::MIDITrackerModifier::mode

◆ relativeRoot

juce::CachedValue<float> tracktion::engine::MIDITrackerModifier::relativeRoot

◆ relativeSpread

juce::CachedValue<float> tracktion::engine::MIDITrackerModifier::relativeSpread

◆ typeParam

AutomatableParameter::Ptr tracktion::engine::MIDITrackerModifier::typeParam

◆ modeParam

AutomatableParameter::Ptr tracktion::engine::MIDITrackerModifier::modeParam

◆ relativeRootParam

AutomatableParameter::Ptr tracktion::engine::MIDITrackerModifier::relativeRootParam

◆ relativeSpreadParam

AutomatableParameter::Ptr tracktion::engine::MIDITrackerModifier::relativeSpreadParam

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

tracktion_MIDITrackerModifier.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Additional Inherited Members

Member Typedef Documentation

◆ Ptr

◆ Array

Member Enumeration Documentation

◆ Type

◆ Mode

Constructor & Destructor Documentation

◆ MIDITrackerModifier()

◆ ~MIDITrackerModifier()

Member Function Documentation

◆ initialise() [1/3]

◆ getName()

◆ getCurrentValue()

◆ getCurrentMIDIValue()

◆ createAssignment()

◆ getMidiInputNames()

◆ getProcessingPosition()

◆ applyToBuffer()

◆ getSelectableDescription()

◆ getTypeNames()

◆ getModeNames()

◆ getNodeState()

◆ initialise() [2/3]

◆ initialise() [3/3]

Member Data Documentation

◆ type

◆ mode

◆ relativeRoot

◆ relativeSpread

◆ typeParam

◆ modeParam

◆ relativeRootParam

◆ relativeSpreadParam