TracktionEngine
Classes | Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | List of all members
tracktion::engine::MIDITrackerModifier Class Reference
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. More...
 
juce::String getName () const override
 
float getCurrentValue () override
 Returns the current value of the modifier. More...
 
int getCurrentMIDIValue () const noexcept
 Returns the MIDI value, either a pitch or velocity. More...
 
AutomatableParameter::ModifierAssignmentcreateAssignment (const juce::ValueTree &) override
 Must return a new ModifierAssignment for a given state. More...
 
juce::StringArray getMidiInputNames () override
 Can return an array of names represeting MIDI inputs. More...
 
ProcessingPosition getProcessingPosition () override
 Should return the position in the plugin chain that this Modifier should be processed. More...
 
void applyToBuffer (const PluginRenderContext &) override
 Sub classes should implement this to process the Modifier. More...
 
juce::String getSelectableDescription () override
 Subclasses must return a description of what they are. More...
 
juce::ValueTree getNodeState () const
 Returns a ValueTree representing the absolute nodes of the map. More...
 
virtual void initialise ()=0
 Call this once after construction to connect it to the audio graph. More...
 
virtual void initialise (double, int)
 Sub classes should implement this to initialise the Modifier. More...
 
- Public Member Functions inherited from tracktion::engine::Modifier
 Modifier (Edit &, const juce::ValueTree &)
 Creates a Modifier for a given state. More...
 
 ~Modifier ()
 Destructor. More...
 
void remove ()
 Removes this Modifier from its parent Track. More...
 
virtual juce::StringArray getAudioInputNames ()
 Can return an array of names represeting audio inputs. More...
 
virtual void initialise (double, int)
 Sub classes should implement this to initialise the Modifier. More...
 
virtual void deinitialise ()
 Sub classes should implement this to deinitialise the Modifier. More...
 
bool baseClassNeedsInitialising () const noexcept
 Returns true if the Modifier needs initialising. More...
 
void baseClassInitialise (double sampleRate, int blockSizeSamples)
 Initialises the Modifier. More...
 
void baseClassDeinitialise ()
 Deinitialises the Modifier. More...
 
void baseClassApplyToBuffer (const PluginRenderContext &)
 Updates internal value history and calls the subclass's applyToBuffer method. More...
 
TimePosition getCurrentTime () const
 Returns the edit time of the current value. More...
 
float getValueAt (TimeDuration numSecondsBeforeNow) const
 Returns the value of the at a given time in the past. More...
 
std::vector< float > getValues (TimeDuration numSecondsBeforeNow) const
 Returns a vector of previous sample values. More...
 
double getSampleRate () const
 Returns the sample rate the Modifier has been initialised with. More...
 
- Public Member Functions inherited from tracktion::engine::AutomatableEditItem
 AutomatableEditItem (Edit &, const juce::ValueTree &)
 
virtual ~AutomatableEditItem ()
 
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 deleteParameter (AutomatableParameter *)
 
void deleteAutomatableParameters ()
 
int indexOfAutomatableParameter (const AutomatableParameter::Ptr &) const
 
AutomatableParameterTreegetParameterTree () const
 
juce::ReferenceCountedArray< AutomatableParametergetFlattenedParameterTree () 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. More...
 
void updateParameterStreams (TimePosition)
 Updates all the parameter streams to their positions at this time. More...
 
void updateActiveParameters ()
 Iterates all the parameters to find out which ones need to be automated. More...
 
void resetRecordingStatus ()
 Marks the end of an automation recording stream. More...
 
- Public Member Functions inherited from tracktion::engine::EditItem
 EditItem (EditItemID, Edit &)
 
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. More...
 
virtual void changed ()
 This should be called to send a change notification to any SelectableListeners that are registered with this object. More...
 
virtual void selectableAboutToBeDeleted ()
 Called just before the selectable is about to be deleted so any subclasses should still be valid at this point. More...
 
void addSelectableListener (SelectableListener *)
 
void removeSelectableListener (SelectableListener *)
 
void cancelAnyPendingUpdates ()
 If changed() has been called, this will cancel any pending async change notificaions. More...
 
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. More...
 

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. More...
 
juce::CachedValue< juce::Colour > colour
 Colour property. More...
 
juce::CachedValue< float > enabled
 Enabled property. More...
 
AutomatableParameter::Ptr enabledParam
 Parameter to change the enabled state. More...
 
- Public Attributes inherited from tracktion::engine::AutomatableEditItem
juce::ValueTree elementState
 
juce::CachedValue< bool > remapOnTempoChange
 
- Public Attributes inherited from tracktion::engine::EditItem
Editedit
 
const EditItemID itemID
 Every EditItem has an ID which is unique within the edit. More...
 
- 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. More...
 
- 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. More...
 
- 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. More...
 
void restoreChangedParametersFromState ()
 Restores the value of any explicitly set parameters. More...
 

Member Typedef Documentation

◆ Ptr

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

◆ Array

Member Enumeration Documentation

◆ Type

Enumerator
pitch 
velocity 

◆ 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

◆ 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
virtual

Sub classes should implement this to initialise the Modifier.

Implements 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: