TracktionEngine
Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | List of all members
tracktion::engine::CompressorPlugin Class Reference
Inheritance diagram for tracktion::engine::CompressorPlugin:

Public Member Functions

 CompressorPlugin (PluginCreationInfo)
 
 ~CompressorPlugin () override
 
float getThreshold () const
 
void setThreshold (float)
 
float getRatio () const
 
void setRatio (float)
 
juce::String getName () const override
 The name of the type, e.g. More...
 
juce::String getPluginType () override
 
juce::String getShortName (int) override
 
int getNumOutputChannelsGivenInputs (int numInputChannels) override
 This must return the number of output channels that the plugin will produce, given a number of input channels. More...
 
void getChannelNames (juce::StringArray *, juce::StringArray *) override
 
bool needsConstantBufferSize () override
 
void initialise (const PluginInitialisationInfo &) override
 Gives the plugin a chance to set itself up before being played. More...
 
void deinitialise () override
 Called after play stops to release resources. More...
 
void applyToBuffer (const PluginRenderContext &) override
 Process the next block of data. More...
 
juce::String getSelectableDescription () override
 Subclasses must return a description of what they are. More...
 
void restorePluginStateFromValueTree (const juce::ValueTree &) override
 
- Public Member Functions inherited from tracktion::engine::Plugin
 Plugin (PluginCreationInfo)
 
 ~Plugin () override
 
void selectableAboutToBeDeleted () override
 Called just before the selectable is about to be deleted so any subclasses should still be valid at this point. More...
 
void playStartedOrStopped ()
 called by the system to let the plugin manage its automation stuff More...
 
virtual void initialiseFully ()
 Gives the plugin a chance to do extra initialisation when it's been added to an edit. More...
 
virtual void flushPluginStateToValueTree () override
 
virtual juce::String getVendor ()
 
virtual juce::String getIdentifierString ()
 A unique string to idenitify plugin independant of install location. More...
 
virtual juce::String getTooltip ()
 default returns the name, others can return special stuff if needed More...
 
virtual void setEnabled (bool)
 Enable/disable the plugin. More...
 
bool isEnabled () const noexcept
 
void setFrozen (bool shouldBeFrozen)
 This is a bit different to being enabled as when frozen a plugin can't be interacted with. More...
 
bool isFrozen () const noexcept
 
void setProcessingEnabled (bool p)
 Enable/Disable processing. More...
 
bool isProcessingEnabled () const noexcept
 
virtual void initialiseWithoutStopping (const PluginInitialisationInfo &)
 Tells the plugin that the audio graph has changed but the plugin isn't being re-initialised - i.e. More...
 
virtual void reset ()
 Should reset synth voices, tails, clear delay buffers, etc. More...
 
virtual void trackPropertiesChanged ()
 Track name or colour has changed. More...
 
virtual void prepareForNextBlock (TimePosition)
 Called between successive rendering blocks. More...
 
void applyToBufferWithAutomation (const PluginRenderContext &)
 
double getCpuUsage () const noexcept
 
virtual bool producesAudioWhenNoAudioInput ()
 
virtual bool noTail ()
 
virtual bool takesAudioInput ()
 
virtual bool takesMidiInput ()
 
virtual bool isSynth ()
 
virtual double getLatencySeconds ()
 
virtual double getTailLength () const
 
virtual bool canSidechain ()
 
juce::StringArray getInputChannelNames ()
 
juce::StringArray getSidechainSourceNames (bool allowNone)
 
void setSidechainSourceByName (const juce::String &name)
 
juce::String getSidechainSourceName ()
 
void guessSidechainRouting ()
 
int getNumWires () const
 
WiregetWire (int index) const
 
void makeConnection (int srcChannel, int dstChannel, juce::UndoManager *)
 
void breakConnection (int srcChannel, int dstChannel)
 
virtual bool hasNameForMidiNoteNumber (int note, int midiChannel, juce::String &name)
 If it's a synth that names its notes, this can return the name it uses for this note 0-127. More...
 
virtual bool hasNameForMidiProgram (int programNum, int bank, juce::String &name)
 Returns the name for a midi program, if there is one. More...
 
virtual bool hasNameForMidiBank (int bank, juce::String &name)
 
virtual bool canBeAddedToClip ()
 
virtual bool canBeAddedToRack ()
 
virtual bool canBeAddedToFolderTrack ()
 
virtual bool canBeAddedToMaster ()
 
virtual bool canBeDisabled ()
 
virtual bool canBeMoved ()
 
virtual bool isMissing ()
 for things like VSTs where the DLL is missing. More...
 
virtual bool isDisabled ()
 Plugins can be disabled to avoid them crashing Edits. More...
 
bool isInRack () const
 
juce::ReferenceCountedObjectPtr< RackTypegetOwnerRackType () const
 
bool isClipEffectPlugin () const
 
virtual juce::AudioProcessor * getWrappedAudioProcessor () const
 
AutomatableParameter::Ptr getQuickControlParameter () const
 
void setQuickControlParameter (AutomatableParameter *)
 
virtual void deleteFromParent ()
 Attempts to delete this plugin, whether it's a master plugin, track plugin, etc. More...
 
void removeFromParent ()
 Detaches the plugin from any parent it might be in. More...
 
TrackgetOwnerTrack () const
 Returns the track if it's a track or clip plugin. More...
 
ClipgetOwnerClip () const
 Returns the clip if that's what it's in. More...
 
PluginListgetOwnerList () const
 
Ptr findPluginThatFeedsIntoThis () const
 
Ptr findPluginThatThisFeedsInto () const
 
void changed () override
 method from Selectable, that's been overridden here to also tell the edit that it's changed. More...
 
juce::Array< ReferencedItemgetReferencedItems () override
 
void reassignReferencedItem (const ReferencedItem &, ProjectItemID newID, double newStartTime) override
 
virtual void sourceMediaChanged ()
 Called when ProjectItem sources are re-assigned so you can reload from the new source. More...
 
bool setPluginToMirror (const Plugin::Ptr &)
 
virtual void updateFromMirroredPluginIfNeeded (Plugin &)
 
Plugin::Ptr getMirroredPlugin () const
 
bool baseClassNeedsInitialising () const noexcept
 
void baseClassInitialise (const PluginInitialisationInfo &)
 
void baseClassDeinitialise ()
 
void setSidechainSourceID (EditItemID newID)
 
EditItemID getSidechainSourceID () const
 
void showWindowExplicitly ()
 
void hideWindowForShutdown ()
 
juce::UndoManager * getUndoManager () const noexcept
 
- 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...
 
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::Exportable
virtual ~Exportable ()=default
 
- Public Member Functions inherited from tracktion::engine::AutomatableEditItem
 AutomatableEditItem (Edit &, const juce::ValueTree &)
 
virtual ~AutomatableEditItem ()
 
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::MacroParameterElement
 MacroParameterElement (Edit &, const juce::ValueTree &)
 Constructor. More...
 
virtual ~MacroParameterElement ()=default
 Destructor. More...
 
int getNumMacroParameters () const
 Returns the number of macro parameters for this object. More...
 

Static Public Member Functions

static const char * getPluginName ()
 
static float getMinThreshold ()
 
static float getMaxThreshold ()
 
- Static Public Member Functions inherited from tracktion::engine::Plugin
static bool areSelectedPluginsRackable (SelectionManager &)
 
static RackInstancewrapSelectedPluginsInRack (SelectionManager &)
 
static void sortPlugins (Plugin::Array &)
 
static void sortPlugins (std::vector< Plugin * > &)
 
- 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...
 
- Static Public Member Functions inherited from tracktion::engine::Exportable
static juce::Array< Exportable * > addAllExportables (Edit &)
 Returns all the Exportables contained in an Edit. More...
 

Public Attributes

juce::CachedValue< float > thresholdValue
 
juce::CachedValue< float > ratioValue
 
juce::CachedValue< float > attackValue
 
juce::CachedValue< float > releaseValue
 
juce::CachedValue< float > outputValue
 
juce::CachedValue< float > sidechainValue
 
juce::CachedValue< bool > useSidechainTrigger
 
AutomatableParameter::Ptr thresholdGain
 
AutomatableParameter::Ptr ratio
 
AutomatableParameter::Ptr attackMs
 
AutomatableParameter::Ptr releaseMs
 
AutomatableParameter::Ptr outputDb
 
AutomatableParameter::Ptr sidechainDb
 
- Public Attributes inherited from tracktion::engine::Plugin
std::unique_ptr< WindowStatewindowState
 
Engineengine
 
juce::ValueTree state
 
- Public Attributes inherited from tracktion::engine::Selectable
WeakRef::Master masterReference
 
- 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::MacroParameterElement
MacroParameterList macroParameterList
 

Static Public Attributes

static const char * xmlTypeName
 

Additional Inherited Members

- Public Types inherited from tracktion::engine::Plugin
enum class  Type { allPlugins , folderTrackPlugins , effectPlugins }
 
using Ptr = juce::ReferenceCountedObjectPtr< Plugin >
 
using Array = juce::ReferenceCountedArray< Plugin >
 
- Public Types inherited from tracktion::engine::Selectable
using WeakRef = juce::WeakReference< Selectable >
 
- Protected Member Functions inherited from tracktion::engine::Plugin
void valueTreePropertyChanged (juce::ValueTree &, const juce::Identifier &) override
 
void valueTreeChanged () override
 
void valueTreeChildAdded (juce::ValueTree &, juce::ValueTree &) override
 
void valueTreeChildRemoved (juce::ValueTree &, juce::ValueTree &, int) override
 
void valueTreeParentChanged (juce::ValueTree &) override
 
virtual void processingChanged ()
 
AutomatableParameteraddParam (const juce::String &paramID, const juce::String &name, juce::NormalisableRange< float > valueRange)
 
AutomatableParameteraddParam (const juce::String &paramID, const juce::String &name, juce::NormalisableRange< float > valueRange, std::function< juce::String(float)> valueToStringFunction, std::function< float(const juce::String &)> stringToValueFunction)
 
- 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...
 
- Protected Member Functions inherited from tracktion::engine::ValueTreeAllEventListener
void valueTreePropertyChanged (juce::ValueTree &, const juce::Identifier &) override
 
void valueTreeChildAdded (juce::ValueTree &, juce::ValueTree &) override
 
void valueTreeChildRemoved (juce::ValueTree &, juce::ValueTree &, int) override
 
void valueTreeChildOrderChanged (juce::ValueTree &, int, int) override
 
void valueTreeParentChanged (juce::ValueTree &) override
 
void valueTreeRedirected (juce::ValueTree &) override
 
- Static Protected Member Functions inherited from tracktion::engine::Plugin
static void getLeftRightChannelNames (juce::StringArray *ins, juce::StringArray *outs)
 
static void getLeftRightChannelNames (juce::StringArray *chans)
 
- Protected Attributes inherited from tracktion::engine::Plugin
juce::CachedValue< AtomicWrapper< bool > > enabled
 
juce::CachedValue< bool > frozen
 
juce::CachedValue< bool > processing
 
juce::CachedValue< juce::String > quickParamName
 
juce::CachedValue< EditItemIDmasterPluginID
 
juce::CachedValue< EditItemIDsidechainSourceID
 
double sampleRate = 44100.0
 
int blockSizeSamples = 512
 

Constructor & Destructor Documentation

◆ CompressorPlugin()

tracktion::engine::CompressorPlugin::CompressorPlugin ( PluginCreationInfo  )

◆ ~CompressorPlugin()

tracktion::engine::CompressorPlugin::~CompressorPlugin ( )
override

Member Function Documentation

◆ getThreshold()

float tracktion::engine::CompressorPlugin::getThreshold ( ) const

◆ setThreshold()

void tracktion::engine::CompressorPlugin::setThreshold ( float  )

◆ getRatio()

float tracktion::engine::CompressorPlugin::getRatio ( ) const

◆ setRatio()

void tracktion::engine::CompressorPlugin::setRatio ( float  )

◆ getPluginName()

static const char* tracktion::engine::CompressorPlugin::getPluginName ( )
static

◆ getName()

juce::String tracktion::engine::CompressorPlugin::getName ( ) const
overridevirtual

The name of the type, e.g.

"Compressor"

Implements tracktion::engine::Plugin.

◆ getPluginType()

juce::String tracktion::engine::CompressorPlugin::getPluginType ( )
overridevirtual

Implements tracktion::engine::Plugin.

References xmlTypeName.

◆ getShortName()

juce::String tracktion::engine::CompressorPlugin::getShortName ( int  )
overridevirtual

Reimplemented from tracktion::engine::Plugin.

◆ getNumOutputChannelsGivenInputs()

int tracktion::engine::CompressorPlugin::getNumOutputChannelsGivenInputs ( int  numInputChannels)
overridevirtual

This must return the number of output channels that the plugin will produce, given a number of input channels.

E.g. some might be able to do mono, so will return 1 if the input is 1, 2 if it is 2, etc.

The default impl just returns the number of items that getChannelNames() returns.

Reimplemented from tracktion::engine::Plugin.

◆ getChannelNames()

void tracktion::engine::CompressorPlugin::getChannelNames ( juce::StringArray *  ,
juce::StringArray *   
)
overridevirtual

Reimplemented from tracktion::engine::Plugin.

◆ needsConstantBufferSize()

bool tracktion::engine::CompressorPlugin::needsConstantBufferSize ( )
overridevirtual

◆ initialise()

void tracktion::engine::CompressorPlugin::initialise ( const PluginInitialisationInfo )
overridevirtual

Gives the plugin a chance to set itself up before being played.

This won't be called concurrently with the process thread.

The sample rate and the average block size - although the blocks won't always be the same, and may be bigger.

Don't call this directly or the initialise count will become out of sync.

See also
baseClassInitialise [[ message_thread ]]

Implements tracktion::engine::Plugin.

◆ deinitialise()

void tracktion::engine::CompressorPlugin::deinitialise ( )
overridevirtual

Called after play stops to release resources.

Don't call this directly or the initialise count will become out of sync.

See also
baseClassDeinitialise

Implements tracktion::engine::Plugin.

◆ applyToBuffer()

void tracktion::engine::CompressorPlugin::applyToBuffer ( const PluginRenderContext )
overridevirtual

Process the next block of data.

The incoming buffer will have an unknown number of channels, and the plugin has to deal with them however it wants to.

The buffer should be resized to the number of output channels that the plugin wants to return (which should be the same or less than the number of output channel names it returns from getChannelNames() - never more than this).

Implements tracktion::engine::Plugin.

◆ getSelectableDescription()

juce::String tracktion::engine::CompressorPlugin::getSelectableDescription ( )
overridevirtual

Subclasses must return a description of what they are.

Implements tracktion::engine::Selectable.

◆ restorePluginStateFromValueTree()

void tracktion::engine::CompressorPlugin::restorePluginStateFromValueTree ( const juce::ValueTree &  )
overridevirtual

◆ getMinThreshold()

static float tracktion::engine::CompressorPlugin::getMinThreshold ( )
static

◆ getMaxThreshold()

static float tracktion::engine::CompressorPlugin::getMaxThreshold ( )
static

Member Data Documentation

◆ xmlTypeName

const char* tracktion::engine::CompressorPlugin::xmlTypeName
static

Referenced by getPluginType().

◆ thresholdValue

juce::CachedValue<float> tracktion::engine::CompressorPlugin::thresholdValue

◆ ratioValue

juce::CachedValue<float> tracktion::engine::CompressorPlugin::ratioValue

◆ attackValue

juce::CachedValue<float> tracktion::engine::CompressorPlugin::attackValue

◆ releaseValue

juce::CachedValue<float> tracktion::engine::CompressorPlugin::releaseValue

◆ outputValue

juce::CachedValue<float> tracktion::engine::CompressorPlugin::outputValue

◆ sidechainValue

juce::CachedValue<float> tracktion::engine::CompressorPlugin::sidechainValue

◆ useSidechainTrigger

juce::CachedValue<bool> tracktion::engine::CompressorPlugin::useSidechainTrigger

◆ thresholdGain

AutomatableParameter::Ptr tracktion::engine::CompressorPlugin::thresholdGain

◆ ratio

AutomatableParameter::Ptr tracktion::engine::CompressorPlugin::ratio

◆ attackMs

AutomatableParameter::Ptr tracktion::engine::CompressorPlugin::attackMs

◆ releaseMs

AutomatableParameter::Ptr tracktion::engine::CompressorPlugin::releaseMs

◆ outputDb

AutomatableParameter::Ptr tracktion::engine::CompressorPlugin::outputDb

◆ sidechainDb

AutomatableParameter::Ptr tracktion::engine::CompressorPlugin::sidechainDb

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