A type of AudioProcessor which plays back a graph of other AudioProcessors. More...

#include <juce_AudioProcessorGraph.h>

Inheritance diagram for juce::AudioProcessorGraph:

[legend]

Collaboration diagram for juce::AudioProcessorGraph:

[legend]

Classes
class	AudioGraphIOProcessor
	A special type of AudioProcessor that can live inside an AudioProcessorGraph in order to use the audio that comes into and out of the graph itself. More...

struct	Connection
	Represents a connection between two channels of two nodes in an AudioProcessorGraph. More...

class	Node
	Represents one of the nodes, or processors, in an AudioProcessorGraph. More...

struct	NodeAndChannel
	Represents an input or output channel of a node in an AudioProcessorGraph. More...

struct	NodeID
	Each node in the graph has a UID of this type. More...

struct	PrepareSettings

Public Types
enum	{ midiChannelIndex = 0x1000 }
	A special index that represents the midi channel of a node. More...

using	ChangeDetails = AudioProcessorListener::ChangeDetails

enum	ProcessingPrecision { singlePrecision, doublePrecision }

enum	WrapperType { wrapperType_Undefined = 0, wrapperType_VST, wrapperType_VST3, wrapperType_AudioUnit, wrapperType_AudioUnitv3, wrapperType_RTAS, wrapperType_AAX, wrapperType_Standalone, wrapperType_Unity }
	Flags to indicate the type of plugin context in which a processor is being used. More...

Public Member Functions
	AudioProcessorGraph ()
	Creates an empty graph. More...

	~AudioProcessorGraph () override
	Destructor. More...

bool	acceptsMidi () const override
	Returns true if the processor wants MIDI messages. More...

bool	addBus (bool isInput)
	Dynamically request an additional bus. More...

void	addChangeListener (ChangeListener *listener)
	Registers a listener to receive change callbacks from this broadcaster. More...

bool	addConnection (const Connection &)
	Attempts to connect two specified channels of two nodes. More...

virtual void	addListener (AudioProcessorListener *newListener)
	Adds a listener that will be called when an aspect of this processor changes. More...

Node::Ptr	addNode (std::unique_ptr< AudioProcessor > newProcessor, NodeID nodeId={})
	Adds a node to the graph. More...

void	addParameter (AudioProcessorParameter *)
	Adds a parameter to the AudioProcessor. More...

void	addParameterGroup (std::unique_ptr< AudioProcessorParameterGroup >)
	Adds a group of parameters to the AudioProcessor. More...

virtual bool	canAddBus (bool isInput) const
	Callback to query if a bus can currently be added. More...

bool	canConnect (const Connection &) const
	Returns true if it would be legal to connect the specified points. More...

virtual bool	canRemoveBus (bool isInput) const
	Callback to query if the last bus can currently be removed. More...

void	changeProgramName (int, const String &) override
	Called by the host to rename a program. More...

bool	checkBusesLayoutSupported (const BusesLayout &) const
	Returns true if the Audio processor is likely to support a given layout. More...

void	clear ()
	Deletes all nodes and connections from this graph. More...

AudioProcessorEditor *	createEditor () override
	Creates the processor's GUI. More...

AudioProcessorEditor *	createEditorIfNeeded ()
	Returns the active editor, or if there isn't one, it will create one. More...

bool	disableNonMainBuses ()
	Disables all non-main buses (aux and sidechains). More...

bool	disconnectNode (NodeID)
	Removes all connections from the specified node. More...

void	dispatchPendingMessages ()
	If a change message has been sent but not yet dispatched, this will call sendSynchronousChangeMessage() to make the callback immediately. More...

void	editorBeingDeleted (AudioProcessorEditor *) noexcept
	Not for public use - this is called before deleting an editor component. More...

bool	enableAllBuses ()
	Enables all buses. More...

virtual int32	getAAXPluginIDForMainBusConfig (const AudioChannelSet &mainInputLayout, const AudioChannelSet &mainOutputLayout, bool idForAudioSuite) const
	AAX plug-ins need to report a unique "plug-in id" for every audio layout configuration that your AudioProcessor supports on the main bus. More...

AudioProcessorEditor *	getActiveEditor () const noexcept
	Returns the active editor, if there is one. More...

virtual StringArray	getAlternateDisplayNames () const
	Returns a list of alternative names to use for this processor. More...

int	getBlockSize () const noexcept
	Returns the current typical block size that is being used. More...

const Bus *	getBus (bool isInput, int busIndex) const noexcept
	Returns the audio bus with a given index and direction. More...

Bus *	getBus (bool isInput, int busIndex) noexcept
	Returns the audio bus with a given index and direction. More...

template<typename FloatType >
AudioBuffer< FloatType >	getBusBuffer (AudioBuffer< FloatType > &processBlockBuffer, bool isInput, int busIndex) const
	Returns an AudioBuffer containing a set of channel pointers for a specific bus. More...

int	getBusCount (bool isInput) const noexcept
	Returns the number of buses on the input or output side. More...

BusesLayout	getBusesLayout () const
	Provides the current channel layouts of this audio processor. More...

virtual AudioProcessorParameter *	getBypassParameter () const
	Returns the parameter that controls the AudioProcessor's bypass state. More...

const CriticalSection &	getCallbackLock () const noexcept
	This returns a critical section that will automatically be locked while the host is calling the processBlock() method. More...

int	getChannelCountOfBus (bool isInput, int busIndex) const noexcept
	Provides the number of channels of the bus with a given index and direction. More...

int	getChannelIndexInProcessBlockBuffer (bool isInput, int busIndex, int channelIndex) const noexcept
	Returns the position of a bus's channels within the processBlock buffer. More...

AudioChannelSet	getChannelLayoutOfBus (bool isInput, int busIndex) const noexcept
	Provides the channel layout of the bus with a given index and direction. More...

std::vector< Connection >	getConnections () const
	Returns the list of connections in the graph. More...

int	getCurrentProgram () override
	Returns the number of the currently active program. More...

virtual void	getCurrentProgramStateInformation (juce::MemoryBlock &destData)
	The host will call this method if it wants to save the state of just the processor's current program. More...

int	getLatencySamples () const noexcept
	This returns the number of samples delay that the processor imposes on the audio passing through it. More...

int	getMainBusNumInputChannels () const noexcept
	Returns the number of input channels on the main bus. More...

int	getMainBusNumOutputChannels () const noexcept
	Returns the number of output channels on the main bus. More...

const String	getName () const override
	Returns the name of this processor. More...

template<size_t numLayouts>
BusesLayout	getNextBestLayoutInLayoutList (const BusesLayout &layouts, const short(&channelLayoutList)[numLayouts][2])
	Returns the next best layout which is contained in a channel layout map. More...

Node::Ptr	getNode (int index) const noexcept
	Returns a pointer to one of the nodes in the graph. More...

Node *	getNodeForId (NodeID) const
	Searches the graph for a node with the given ID number and returns it. More...

const ReferenceCountedArray< Node > &	getNodes () const noexcept
	Returns the array of nodes in the graph. More...

int	getNumNodes () const noexcept
	Returns the number of nodes in the graph. More...

int	getNumPrograms () override
	Returns the number of preset programs the processor supports. More...

int	getOffsetInBusBufferForAbsoluteChannelIndex (bool isInput, int absoluteChannelIndex, int &busIndex) const noexcept
	Returns the offset in a bus's buffer from an absolute channel index. More...

const Array< AudioProcessorParameter * > &	getParameters () const
	Returns a flat list of the parameters in the current tree. More...

const AudioProcessorParameterGroup &	getParameterTree () const
	Returns the group of parameters managed by this AudioProcessor. More...

AudioPlayHead *	getPlayHead () const noexcept
	Returns the current AudioPlayHead object that should be used to find out the state and position of the playhead. More...

ProcessingPrecision	getProcessingPrecision () const noexcept
	Returns the precision-mode of the processor. More...

const String	getProgramName (int) override
	Must return the name of a given program. More...

virtual CurveData	getResponseCurve (CurveData::Type) const

double	getSampleRate () const noexcept
	Returns the current sample rate. More...

void	getStateInformation (juce::MemoryBlock &) override
	The host will call this method when it wants to save the processor's internal state. More...

double	getTailLengthSeconds () const override
	Returns the length of the processor's tail, in seconds. More...

int	getTotalNumInputChannels () const noexcept
	Returns the total number of input channels. More...

int	getTotalNumOutputChannels () const noexcept
	Returns the total number of output channels. More...

bool	hasEditor () const override
	Your processor subclass must override this and return true if it can create an editor component. More...

bool	isAnInputTo (Node &source, Node &destination) const noexcept
	Does a recursive check to see if there's a direct or indirect series of connections between these two nodes. More...

bool	isConnected (const Connection &) const noexcept
	Returns true if the given connection exists. More...

bool	isConnected (NodeID possibleSourceNodeID, NodeID possibleDestNodeID) const noexcept
	Returns true if there is a direct connection between any of the channels of two specified nodes. More...

bool	isConnectionLegal (const Connection &) const
	Returns true if the given connection's channel numbers map on to valid channels at each end. More...

virtual bool	isMidiEffect () const
	Returns true if this is a MIDI effect plug-in and does no audio processing. More...

bool	isNonRealtime () const noexcept
	Returns true if the processor is being run in an offline mode for rendering. More...

bool	isSuspended () const noexcept
	Returns true if processing is currently suspended. More...

bool	isUsingDoublePrecision () const noexcept
	Returns true if the current precision is set to doublePrecision. More...

virtual void	memoryWarningReceived ()
	Called by the host to indicate that you should reduce your memory footprint. More...

virtual void	numBusesChanged ()
	This method is called when the number of buses is changed. More...

virtual void	numChannelsChanged ()
	This method is called when the total number of input or output channels is changed. More...

void	prepareToPlay (double, int) override
	Called before playback starts, to let the processor prepare itself. More...

void	processBlock (AudioBuffer< double > &, MidiBuffer &) override
	Renders the next block. More...

void	processBlock (AudioBuffer< float > &, MidiBuffer &) override
	Renders the next block. More...

virtual void	processBlockBypassed (AudioBuffer< double > &buffer, MidiBuffer &midiMessages)
	Renders the next block when the processor is being bypassed. More...

virtual void	processBlockBypassed (AudioBuffer< float > &buffer, MidiBuffer &midiMessages)
	Renders the next block when the processor is being bypassed. More...

virtual void	processorLayoutsChanged ()
	This method is called when the layout of the audio processor changes. More...

bool	producesMidi () const override
	Returns true if the processor produces MIDI messages. More...

virtual void	refreshParameterList ()
	A processor should implement this method so that the host can ask it to rebuild its parameter tree. More...

void	releaseResources () override
	Called after playback has stopped, to let the object free up any resources it no longer needs. More...

void	removeAllChangeListeners ()
	Removes all listeners from the list. More...

bool	removeBus (bool isInput)
	Dynamically remove the latest added bus. More...

void	removeChangeListener (ChangeListener *listener)
	Unregisters a listener from the list. More...

bool	removeConnection (const Connection &)
	Deletes the given connection. More...

bool	removeIllegalConnections ()
	Performs a sanity checks of all the connections. More...

virtual void	removeListener (AudioProcessorListener *listenerToRemove)
	Removes a previously added listener. More...

Node::Ptr	removeNode (Node *)
	Deletes a node within the graph. More...

Node::Ptr	removeNode (NodeID)
	Deletes a node within the graph which has the specified ID. More...

void	reset () override
	A plugin can override this to be told when it should reset any playing voices. More...

void	sendChangeMessage ()
	Causes an asynchronous change message to be sent to all the registered listeners. More...

void	sendSynchronousChangeMessage ()
	Sends a synchronous change message to all the registered listeners. More...

bool	setBusesLayout (const BusesLayout &)
	Set the channel layouts of this audio processor. More...

bool	setBusesLayoutWithoutEnabling (const BusesLayout &)
	Set the channel layouts of this audio processor without changing the enablement state of the buses. More...

bool	setChannelLayoutOfBus (bool isInput, int busIndex, const AudioChannelSet &layout)
	Set the channel layout of the bus with a given index and direction. More...

void	setCurrentProgram (int) override
	Called by the host to change the current program. More...

virtual void	setCurrentProgramStateInformation (const void *data, int sizeInBytes)
	The host will call this method if it wants to restore the state of just the processor's current program. More...

void	setLatencySamples (int newLatency)
	Your processor subclass should call this to set the number of samples delay that it introduces. More...

void	setNonRealtime (bool) noexcept override
	Called by the host to tell this processor whether it's being used in a non-realtime capacity for offline rendering or bouncing. More...

void	setParameterTree (AudioProcessorParameterGroup &&newTree)
	Sets the group of parameters managed by this AudioProcessor. More...

void	setPlayConfigDetails (int numIns, int numOuts, double sampleRate, int blockSize)
	This is called by the processor to specify its details before being played. More...

virtual void	setPlayHead (AudioPlayHead *newPlayHead)
	Tells the processor to use this playhead object. More...

void	setProcessingPrecision (ProcessingPrecision newPrecision) noexcept
	Changes the processing precision of the receiver. More...

void	setRateAndBufferSizeDetails (double sampleRate, int blockSize) noexcept
	This is called by the processor to specify its details before being played. More...

void	setStateInformation (const void *data, int sizeInBytes) override
	This must restore the processor's state from a block of data previously created using getStateInformation(). More...

bool	supportsDoublePrecisionProcessing () const override
	Returns true if the Audio processor supports double precision floating point processing. More...

virtual bool	supportsMPE () const
	Returns true if the processor supports MPE. More...

void	suspendProcessing (bool shouldBeSuspended)
	Enables and disables the processing callback. More...

void	updateHostDisplay (const ChangeDetails &details=ChangeDetails::getDefaultFlags())
	The processor can call this when something (apart from a parameter value) has changed. More...

virtual void	updateTrackProperties (const TrackProperties &properties)
	Informs the AudioProcessor that track properties such as the track's name or colour has been changed. More...

Static Public Member Functions
template<size_t numLayouts>
static bool	containsLayout (const BusesLayout &layouts, const short(&channelLayoutList)[numLayouts][2])

static bool	containsLayout (const BusesLayout &layouts, const std::initializer_list< const short[2]> &channelLayoutList)
	Returns true if the channel layout map contains a certain layout. More...

static void	copyXmlToBinary (const XmlElement &xml, juce::MemoryBlock &destData)
	Helper function that just converts an xml element into a binary blob. More...

static int	getDefaultNumParameterSteps () noexcept
	Returns the default number of steps for a parameter. More...

static const char *	getWrapperTypeDescription (AudioProcessor::WrapperType) noexcept
	Returns a textual description of a WrapperType value. More...

static std::unique_ptr< XmlElement >	getXmlFromBinary (const void *data, int sizeInBytes)
	Retrieves an XML element that was stored as binary with the copyXmlToBinary() method. More...

static void	setTypeOfNextNewPlugin (WrapperType)

Public Attributes
const WrapperType	wrapperType
	When loaded by a plugin wrapper, this flag will be set to indicate the type of plugin within which the processor is running. More...

Protected Member Functions
virtual bool	applyBusLayouts (const BusesLayout &layouts)
	This method will be called when a new bus layout needs to be applied. More...

virtual bool	canApplyBusCountChange (bool isInput, bool isAddingBuses, BusProperties &outNewBusProperties)
	Callback to query if adding/removing buses currently possible. More...

virtual bool	canApplyBusesLayout (const BusesLayout &layouts) const
	Callback to check if a certain bus layout can now be applied. More...

virtual bool	isBusesLayoutSupported (const BusesLayout &) const
	Callback to query if the AudioProcessor supports a specific layout. More...

void	sendParamChangeMessageToListeners (int parameterIndex, float newValue)

Protected Attributes
std::atomic< AudioPlayHead * >	playHead { nullptr }

Private Member Functions
bool	anyNodesNeedPreparing () const noexcept

void	audioIOChanged (bool busNumberChanged, bool channelNumChanged)

void	buildRenderingSequence ()

void	callListeners ()

void	cancelPendingUpdate () noexcept
	This will stop any pending updates from happening. More...

bool	canConnect (Node src, int sourceChannel, Node dest, int destChannel) const noexcept

void	checkForDuplicateGroupIDs (const AudioProcessorParameterGroup &)

void	checkForDuplicateParamID (AudioProcessorParameter *)

void	checkForDuplicateTrimmedParamID (AudioProcessorParameter *)

void	clearRenderingSequence ()

void	createBus (bool isInput, const BusProperties &)

AudioProcessorListener *	getListenerLocked (int) const noexcept

void	getNextBestLayout (const BusesLayout &, BusesLayout &) const

BusesLayout	getNextBestLayoutInList (const BusesLayout &, const Array< InOutChannelPair > &) const

AudioProcessorParameter *	getParamChecked (int) const

void	handleAsyncUpdate () override
	Called back to do whatever your class needs to do. More...

void	handleUpdateNowIfNeeded ()
	If an update has been triggered and is pending, this will invoke it synchronously. More...

bool	isAnInputTo (Node &src, Node &dst, int recursionCheck) const noexcept

bool	isConnected (Node src, int sourceChannel, Node dest, int destChannel) const noexcept

bool	isLegal (Node src, int sourceChannel, Node dest, int destChannel) const noexcept

bool	isUpdatePending () const noexcept
	Returns true if there's an update callback in the pipeline. More...

template<typename floatType >
void	processBypassed (AudioBuffer< floatType > &, MidiBuffer &)

virtual bool	silenceInProducesSilenceOut () const

void	topologyChanged ()

void	triggerAsyncUpdate ()
	Causes the callback to be triggered at a later time. More...

void	unprepare ()

void	updateSpeakerFormatStrings ()

void	validateParameter (AudioProcessorParameter *)

Static Private Member Functions
static BusesProperties	busesPropertiesFromLayoutArray (const Array< InOutChannelPair > &)

static bool	containsLayout (const BusesLayout &, const Array< InOutChannelPair > &)

static void	getNodeConnections (Node &, std::vector< Connection > &)

template<size_t numLayouts>
static Array< InOutChannelPair >	layoutListToArray (const short(&configuration)[numLayouts][2])

static Array< InOutChannelPair >	layoutListToArray (const std::initializer_list< const short[2]> &configuration)

Private Attributes
Component::SafePointer< AudioProcessorEditor >	activeEditor

CriticalSection	activeEditorLock

ReferenceCountedObjectPtr< AsyncUpdaterMessage >	activeMessage

std::atomic< bool >	anyListeners { false }

int	blockSize = 0

ChangeBroadcasterCallback	broadcastCallback

String	cachedInputSpeakerArrString

String	cachedOutputSpeakerArrString

int	cachedTotalIns = 0

int	cachedTotalOuts = 0

CriticalSection	callbackLock

ListenerList< ChangeListener >	changeListeners

BigInteger	changingParams

double	currentSampleRate = 0

Array< AudioProcessorParameter * >	flatParameterList

std::unordered_set< String >	groupIDs

OwnedArray< Bus >	inputBuses

std::atomic< bool >	isPrepared { false }

NodeID	lastNodeID = {}

int	latencySamples = 0

CriticalSection	listenerLock

Array< AudioProcessorListener * >	listeners

ReferenceCountedArray< Node >	nodes

std::atomic< bool >	nonRealtime { false }

OwnedArray< Bus >	outputBuses

AudioProcessorParameterGroup	parameterTree

std::unordered_set< String >	paramIDs

PrepareSettings	prepareSettings

ProcessingPrecision	processingPrecision = singlePrecision

std::unique_ptr< RenderSequenceDouble >	renderSequenceDouble

std::unique_ptr< RenderSequenceFloat >	renderSequenceFloat

bool	suspended = false

bool	textRecursionCheck = false

std::unordered_set< String >	trimmedParamIDs

Friends
class	AudioGraphIOProcessor

Detailed Description

A type of AudioProcessor which plays back a graph of other AudioProcessors.

Use one of these objects if you want to wire-up a set of AudioProcessors and play back the result.

Processors can be added to the graph as "nodes" using addNode(), and once added, you can connect any of their input or output channels to other nodes using addConnection().

To play back a graph through an audio device, you might want to use an AudioProcessorPlayer object.

@tags{Audio}

Member Typedef Documentation

◆ ChangeDetails

using juce::AudioProcessor::ChangeDetails = AudioProcessorListener::ChangeDetails

inherited

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

A special index that represents the midi channel of a node.

This is used as a channel index value if you want to refer to the midi input or output instead of an audio channel.

Enumerator
midiChannelIndex

◆ ProcessingPrecision

enum juce::AudioProcessor::ProcessingPrecision

inherited

Enumerator
singlePrecision
doublePrecision

◆ WrapperType

enum juce::AudioProcessor::WrapperType

inherited

Flags to indicate the type of plugin context in which a processor is being used.

Enumerator
wrapperType_Undefined
wrapperType_VST
wrapperType_VST3
wrapperType_AudioUnit
wrapperType_AudioUnitv3
wrapperType_RTAS
wrapperType_AAX
wrapperType_Standalone
wrapperType_Unity

Constructor & Destructor Documentation

◆ AudioProcessorGraph()

juce::AudioProcessorGraph::AudioProcessorGraph ( )

Creates an empty graph.

◆ ~AudioProcessorGraph()

juce::AudioProcessorGraph::~AudioProcessorGraph ( )

override

Destructor.

Any processor objects that have been added to the graph will also be deleted.

Member Function Documentation

◆ acceptsMidi()

bool juce::AudioProcessorGraph::acceptsMidi ( ) const

overridevirtual

Returns true if the processor wants MIDI messages.

Implements juce::AudioProcessor.

◆ addBus()

bool juce::AudioProcessor::addBus ( bool isInput )

inherited

Dynamically request an additional bus.

Request an additional bus from the audio processor. If the audio processor does not support adding additional buses then this method will return false.

Most audio processors will not allow you to dynamically add/remove audio buses and will return false.

This method will invoke the canApplyBusCountChange callback to probe if a bus can be added and, if yes, will use the supplied bus properties of the canApplyBusCountChange callback to create a new bus.

See also: canApplyBusCountChange, removeBus

◆ addChangeListener()

void juce::ChangeBroadcaster::addChangeListener ( ChangeListener * listener )

inherited

Registers a listener to receive change callbacks from this broadcaster.

Trying to add a listener that's already on the list will have no effect.

◆ addConnection()

bool juce::AudioProcessorGraph::addConnection ( const Connection & )

Attempts to connect two specified channels of two nodes.

If this isn't allowed (e.g. because you're trying to connect a midi channel to an audio one or other such nonsense), then it'll return false.

◆ addListener()

virtual void juce::AudioProcessor::addListener ( AudioProcessorListener * newListener )

virtualinherited

Adds a listener that will be called when an aspect of this processor changes.

◆ addNode()

Node::Ptr juce::AudioProcessorGraph::addNode	(	std::unique_ptr< AudioProcessor >	newProcessor,
		NodeID	nodeId = `{}`
	)

Adds a node to the graph.

This creates a new node in the graph, for the specified processor. Once you have added a processor to the graph, the graph owns it and will delete it later when it is no longer needed.

The optional nodeId parameter lets you specify a unique ID to use for the node. If the value is already in use, this method will fail and return an empty node.

If this succeeds, it returns a pointer to the newly-created node.

◆ addParameter()

void juce::AudioProcessor::addParameter ( AudioProcessorParameter * )

inherited

Adds a parameter to the AudioProcessor.

The parameter object will be managed and deleted automatically by the AudioProcessor when no longer needed.

◆ addParameterGroup()

void juce::AudioProcessor::addParameterGroup ( std::unique_ptr< AudioProcessorParameterGroup > )

inherited

Adds a group of parameters to the AudioProcessor.

All the parameter objects contained within the group will be managed and deleted automatically by the AudioProcessor when no longer needed.

See also: addParameter

◆ anyNodesNeedPreparing()

bool juce::AudioProcessorGraph::anyNodesNeedPreparing ( ) const

privatenoexcept

◆ applyBusLayouts()

virtual bool juce::AudioProcessor::applyBusLayouts ( const BusesLayout & layouts )

protectedvirtualinherited

This method will be called when a new bus layout needs to be applied.

Most subclasses will not need to override this method and should just use the default implementation.

◆ audioIOChanged()

void juce::AudioProcessor::audioIOChanged	(	bool	busNumberChanged,
		bool	channelNumChanged
	)

privateinherited

◆ buildRenderingSequence()

void juce::AudioProcessorGraph::buildRenderingSequence ( )

private

◆ busesPropertiesFromLayoutArray()

static BusesProperties juce::AudioProcessor::busesPropertiesFromLayoutArray ( const Array< InOutChannelPair > & )

staticprivateinherited

◆ callListeners()

void juce::ChangeBroadcaster::callListeners ( )

privateinherited

◆ canAddBus()

virtual bool juce::AudioProcessor::canAddBus ( bool isInput ) const

inlinevirtualinherited

Callback to query if a bus can currently be added.

This callback probes if a bus can currently be added. You should override this callback if you want to support dynamically adding/removing buses by the host. This is useful for mixer audio processors.

The default implementation will always return false.

See also: addBus

References juce::ignoreUnused().

◆ canApplyBusCountChange()

virtual bool juce::AudioProcessor::canApplyBusCountChange	(	bool	isInput,
		bool	isAddingBuses,
		BusProperties &	outNewBusProperties
	)

protectedvirtualinherited

Callback to query if adding/removing buses currently possible.

This callback is called when the host calls addBus or removeBus. Similar to canApplyBusesLayout, this callback is only called while the AudioProcessor is stopped and gives the processor a last chance to reject a requested bus change. It can also be used to apply the bus count change to an underlying wrapped plug-in.

When adding a bus, isAddingBuses will be true and the plug-in is expected to fill out outNewBusProperties with the properties of the bus which will be created just after the successful return of this callback.

Implementations of AudioProcessor will rarely need to override this method. Only override this method if your processor supports adding and removing buses and if it needs more fine grain control over the naming of new buses or may reject bus number changes although canAddBus or canRemoveBus returned true.

The default implementation will return false if canAddBus/canRemoveBus returns false (the default behavior). Otherwise, this method returns "Input #busIndex" for input buses and "Output #busIndex" for output buses where busIndex is the index for newly created buses. The default layout in this case will be the layout of the previous bus of the same direction.

◆ canApplyBusesLayout()

virtual bool juce::AudioProcessor::canApplyBusesLayout ( const BusesLayout & layouts ) const

inlineprotectedvirtualinherited

Callback to check if a certain bus layout can now be applied.

Most subclasses will not need to override this method and should instead override the isBusesLayoutSupported callback to reject certain layout changes.

This callback is called when the user requests a layout change. It will only be called if processing of the AudioProcessor has been stopped by a previous call to releaseResources or after the construction of the AudioProcessor. It will be called just before the actual layout change. By returning false you will abort the layout change and setBusesLayout will return false indicating that the layout change was not successful.

The default implementation will simply call isBusesLayoutSupported.

You only need to override this method if there is a chance that your AudioProcessor may not accept a layout although you have previously claimed to support it via the isBusesLayoutSupported callback. This can occur if your AudioProcessor's supported layouts depend on other plug-in parameters which may have changed since the last call to isBusesLayoutSupported, such as the format of an audio file which can be selected by the user in the AudioProcessor's editor. This callback gives the AudioProcessor a last chance to reject a layout if conditions have changed as it is always called just before the actual layout change.

As it is never called while the AudioProcessor is processing audio, it can also be used for AudioProcessors which wrap other plug-in formats to apply the current layout to the underlying plug-in. This callback gives such AudioProcessors a chance to reject the layout change should an error occur with the underlying plug-in during the layout change.

See also: isBusesLayoutSupported, setBusesLayout

◆ cancelPendingUpdate()

void juce::AsyncUpdater::cancelPendingUpdate ( )

noexceptinherited

This will stop any pending updates from happening.

If called after triggerAsyncUpdate() and before the handleAsyncUpdate() callback happens, this will cancel the handleAsyncUpdate() callback.

Note that this method simply cancels the next callback - if a callback is already in progress on a different thread, this won't block until the callback finishes, so there's no guarantee that the callback isn't still running when the method returns.

◆ canConnect() [1/2]

bool juce::AudioProcessorGraph::canConnect ( const Connection & ) const

Returns true if it would be legal to connect the specified points.

◆ canConnect() [2/2]

bool juce::AudioProcessorGraph::canConnect	(	Node *	src,
		int	sourceChannel,
		Node *	dest,
		int	destChannel
	)		const

privatenoexcept

◆ canRemoveBus()

virtual bool juce::AudioProcessor::canRemoveBus ( bool isInput ) const

inlinevirtualinherited

Callback to query if the last bus can currently be removed.

This callback probes if the last bus can currently be removed. You should override this callback if you want to support dynamically adding/removing buses by the host. This is useful for mixer audio processors.

If you return true in this callback then the AudioProcessor will go ahead and delete the bus.

The default implementation will always return false.

References juce::ignoreUnused().

◆ changeProgramName()

void juce::AudioProcessorGraph::changeProgramName	(	int	index,
		const String &	newName
	)

inlineoverridevirtual

Called by the host to rename a program.

Implements juce::AudioProcessor.

◆ checkBusesLayoutSupported()

bool juce::AudioProcessor::checkBusesLayoutSupported ( const BusesLayout & ) const

inherited

Returns true if the Audio processor is likely to support a given layout.

This can be called regardless if the processor is currently running.

◆ checkForDuplicateGroupIDs()

void juce::AudioProcessor::checkForDuplicateGroupIDs ( const AudioProcessorParameterGroup & )

privateinherited

◆ checkForDuplicateParamID()

void juce::AudioProcessor::checkForDuplicateParamID ( AudioProcessorParameter * )

privateinherited

◆ checkForDuplicateTrimmedParamID()

void juce::AudioProcessor::checkForDuplicateTrimmedParamID ( AudioProcessorParameter * )

privateinherited

◆ clear()

void juce::AudioProcessorGraph::clear ( )

Deletes all nodes and connections from this graph.

Any processor objects in the graph will be deleted.

◆ clearRenderingSequence()

void juce::AudioProcessorGraph::clearRenderingSequence ( )

private

◆ containsLayout() [1/3]

static bool juce::AudioProcessor::containsLayout	(	const BusesLayout &	,
		const Array< InOutChannelPair > &
	)

staticprivateinherited

◆ containsLayout() [2/3]

template<size_t numLayouts>

static bool juce::AudioProcessor::containsLayout	(	const BusesLayout &	layouts,
		const short(&)	channelLayoutList[numLayouts][2]
	)

inlinestaticinherited

◆ containsLayout() [3/3]

static bool juce::AudioProcessor::containsLayout	(	const BusesLayout &	layouts,
		const std::initializer_list< const short[2]> &	channelLayoutList
	)

inlinestaticinherited

Returns true if the channel layout map contains a certain layout.

You can use this method to help you implement the checkBusesLayoutSupported method. For example

bool checkBusesLayoutSupported (const BusesLayout& layouts) override
{
    return containsLayout (layouts, {{1,1},{2,2}});
}

◆ copyXmlToBinary()

static void juce::AudioProcessor::copyXmlToBinary	(	const XmlElement &	xml,
		juce::MemoryBlock &	destData
	)

staticinherited

Helper function that just converts an xml element into a binary blob.

Use this in your processor's getStateInformation() method if you want to store its state as xml.

Then use getXmlFromBinary() to reverse this operation and retrieve the XML from a binary blob.

◆ createBus()

void juce::AudioProcessor::createBus	(	bool	isInput,
		const BusProperties &
	)

privateinherited

◆ createEditor()

AudioProcessorEditor* juce::AudioProcessorGraph::createEditor ( )

inlineoverridevirtual

Creates the processor's GUI.

This can return nullptr if you want a GUI-less processor, in which case the host may create a generic UI that lets the user twiddle the parameters directly.

If you do want to pass back a component, the component should be created and set to the correct size before returning it. If you implement this method, you must also implement the hasEditor() method and make it return true.

Remember not to do anything silly like allowing your processor to keep a pointer to the component that gets created - it could be deleted later without any warning, which would make your pointer into a dangler. Use the getActiveEditor() method instead.

The correct way to handle the connection between an editor component and its processor is to use something like a ChangeBroadcaster so that the editor can register itself as a listener, and be told when a change occurs. This lets them safely unregister themselves when they are deleted.

Here are a few things to bear in mind when writing an editor:

Initially there won't be an editor, until the user opens one, or they might not open one at all. Your processor mustn't rely on it being there.
An editor object may be deleted and a replacement one created again at any time.
It's safe to assume that an editor will be deleted before its processor.

See also: hasEditor

Implements juce::AudioProcessor.

◆ createEditorIfNeeded()

AudioProcessorEditor* juce::AudioProcessor::createEditorIfNeeded ( )

inherited

Returns the active editor, or if there isn't one, it will create one.

This may call createEditor() internally to create the component.

◆ disableNonMainBuses()

bool juce::AudioProcessor::disableNonMainBuses ( )

inherited

Disables all non-main buses (aux and sidechains).

◆ disconnectNode()

bool juce::AudioProcessorGraph::disconnectNode ( NodeID )

Removes all connections from the specified node.

◆ dispatchPendingMessages()

void juce::ChangeBroadcaster::dispatchPendingMessages ( )

inherited

If a change message has been sent but not yet dispatched, this will call sendSynchronousChangeMessage() to make the callback immediately.

For thread-safety reasons, you must only call this method on the main message thread.

◆ editorBeingDeleted()

void juce::AudioProcessor::editorBeingDeleted ( AudioProcessorEditor * )

noexceptinherited

Not for public use - this is called before deleting an editor component.

◆ enableAllBuses()

bool juce::AudioProcessor::enableAllBuses ( )

inherited

Enables all buses.

◆ getAAXPluginIDForMainBusConfig()

virtual int32 juce::AudioProcessor::getAAXPluginIDForMainBusConfig	(	const AudioChannelSet &	mainInputLayout,
		const AudioChannelSet &	mainOutputLayout,
		bool	idForAudioSuite
	)		const

virtualinherited

AAX plug-ins need to report a unique "plug-in id" for every audio layout configuration that your AudioProcessor supports on the main bus.

Override this function if you want your AudioProcessor to use a custom "plug-in id" (for example to stay backward compatible with older versions of JUCE).

The default implementation will compute a unique integer from the input and output layout and add this value to the 4 character code 'jcaa' (for native AAX) or 'jyaa' (for AudioSuite plug-ins).

◆ getActiveEditor()

AudioProcessorEditor* juce::AudioProcessor::getActiveEditor ( ) const

noexceptinherited

Returns the active editor, if there is one.

Bear in mind this can return nullptr even if an editor has previously been opened.

Note that you should only call this method from the message thread as the active editor may be deleted by the message thread, causing a dangling pointer.

◆ getAlternateDisplayNames()

virtual StringArray juce::AudioProcessor::getAlternateDisplayNames ( ) const

virtualinherited

Returns a list of alternative names to use for this processor.

Some hosts truncate the name of your AudioProcessor when there isn't enough space in the GUI to show the full name. Overriding this method, allows the host to choose an alternative name (such as an abbreviation) to better fit the available space.

◆ getBlockSize()

int juce::AudioProcessor::getBlockSize ( ) const

inlinenoexceptinherited

Returns the current typical block size that is being used.

This can be called from your processBlock() method - it's not guaranteed to be valid at any other time.

Remember it's not the ONLY block size that may be used when calling processBlock, it's just the normal one. The actual block sizes used may be larger or smaller than this, and will vary between successive calls.

◆ getBus() [1/2]

const Bus* juce::AudioProcessor::getBus	(	bool	isInput,
		int	busIndex
	)		const

inlinenoexceptinherited

Returns the audio bus with a given index and direction.

If busIndex is invalid then this method will return a nullptr.

◆ getBus() [2/2]

Bus* juce::AudioProcessor::getBus	(	bool	isInput,
		int	busIndex
	)

inlinenoexceptinherited

Returns the audio bus with a given index and direction.

If busIndex is invalid then this method will return a nullptr.

◆ getBusBuffer()

template<typename FloatType >

AudioBuffer<FloatType> juce::AudioProcessor::getBusBuffer	(	AudioBuffer< FloatType > &	processBlockBuffer,
		bool	isInput,
		int	busIndex
	)		const

inlineinherited

Returns an AudioBuffer containing a set of channel pointers for a specific bus.

This can be called in processBlock to get a buffer containing a sub-group of the master AudioBuffer which contains all the plugin channels.

References juce::AudioBuffer< Type >::getArrayOfWritePointers(), and juce::AudioBuffer< Type >::getNumSamples().

◆ getBusCount()

int juce::AudioProcessor::getBusCount ( bool isInput ) const

inlinenoexceptinherited

Returns the number of buses on the input or output side.

◆ getBusesLayout()

BusesLayout juce::AudioProcessor::getBusesLayout ( ) const

inherited

Provides the current channel layouts of this audio processor.

◆ getBypassParameter()

virtual AudioProcessorParameter* juce::AudioProcessor::getBypassParameter ( ) const

inlinevirtualinherited

Returns the parameter that controls the AudioProcessor's bypass state.

If this method returns a nullptr then you can still control the bypass by calling processBlockBypassed instead of processBlock. On the other hand, if this method returns a non-null value, you should never call processBlockBypassed but use the returned parameter to control the bypass state instead.

A plug-in can override this function to return a parameter which control's your plug-in's bypass. You should always check the value of this parameter in your processBlock callback and bypass any effects if it is non-zero.

◆ getCallbackLock()

const CriticalSection& juce::AudioProcessor::getCallbackLock ( ) const

inlinenoexceptinherited

This returns a critical section that will automatically be locked while the host is calling the processBlock() method.

Use it from your UI or other threads to lock access to variables that are used by the process callback, but obviously be careful not to keep it locked for too long, because that could cause stuttering playback. If you need to do something that'll take a long time and need the processing to stop while it happens, use the suspendProcessing() method instead.

See also: suspendProcessing

◆ getChannelCountOfBus()

int juce::AudioProcessor::getChannelCountOfBus	(	bool	isInput,
		int	busIndex
	)		const

inlinenoexceptinherited

Provides the number of channels of the bus with a given index and direction.

If the index, direction combination is invalid then this will return zero.

◆ getChannelIndexInProcessBlockBuffer()

int juce::AudioProcessor::getChannelIndexInProcessBlockBuffer	(	bool	isInput,
		int	busIndex,
		int	channelIndex
	)		const

noexceptinherited

Returns the position of a bus's channels within the processBlock buffer.

This can be called in processBlock to figure out which channel of the master AudioBuffer maps onto a specific bus's channel.

◆ getChannelLayoutOfBus()

AudioChannelSet juce::AudioProcessor::getChannelLayoutOfBus	(	bool	isInput,
		int	busIndex
	)		const

noexceptinherited

Provides the channel layout of the bus with a given index and direction.

If the index, direction combination is invalid then this will return an AudioChannelSet with no channels.

◆ getConnections()

std::vector<Connection> juce::AudioProcessorGraph::getConnections ( ) const

Returns the list of connections in the graph.

◆ getCurrentProgram()

int juce::AudioProcessorGraph::getCurrentProgram ( )

inlineoverridevirtual

Returns the number of the currently active program.

Implements juce::AudioProcessor.

◆ getCurrentProgramStateInformation()

virtual void juce::AudioProcessor::getCurrentProgramStateInformation ( juce::MemoryBlock & destData )

virtualinherited

The host will call this method if it wants to save the state of just the processor's current program.

Unlike getStateInformation, this should only return the current program's state.

Not all hosts support this, and if you don't implement it, the base class method just calls getStateInformation() instead. If you do implement it, be sure to also implement getCurrentProgramStateInformation.

See also: getStateInformation, setCurrentProgramStateInformation

◆ getDefaultNumParameterSteps()

static int juce::AudioProcessor::getDefaultNumParameterSteps ( )

staticnoexceptinherited

Returns the default number of steps for a parameter.

NOTE! This method is deprecated! It's recommended that you use AudioProcessorParameter::getNumSteps() instead.

See also: getParameterNumSteps

◆ getLatencySamples()

int juce::AudioProcessor::getLatencySamples ( ) const

inlinenoexceptinherited

This returns the number of samples delay that the processor imposes on the audio passing through it.

The host will call this to find the latency - the processor itself should set this value by calling setLatencySamples() as soon as it can during its initialisation.

◆ getListenerLocked()

AudioProcessorListener* juce::AudioProcessor::getListenerLocked ( int ) const

privatenoexceptinherited

◆ getMainBusNumInputChannels()

int juce::AudioProcessor::getMainBusNumInputChannels ( ) const

inlinenoexceptinherited

Returns the number of input channels on the main bus.

◆ getMainBusNumOutputChannels()

int juce::AudioProcessor::getMainBusNumOutputChannels ( ) const

inlinenoexceptinherited

Returns the number of output channels on the main bus.

◆ getName()

const String juce::AudioProcessorGraph::getName ( ) const

overridevirtual

Returns the name of this processor.

Implements juce::AudioProcessor.

◆ getNextBestLayout()

void juce::AudioProcessor::getNextBestLayout	(	const BusesLayout &	,
		BusesLayout &
	)		const

privateinherited

◆ getNextBestLayoutInLayoutList()

template<size_t numLayouts>

BusesLayout juce::AudioProcessor::getNextBestLayoutInLayoutList	(	const BusesLayout &	layouts,
		const short(&)	channelLayoutList[numLayouts][2]
	)

inlineinherited

Returns the next best layout which is contained in a channel layout map.

You can use this method to help you implement getNextBestLayout. For example:

BusesLayout getNextBestLayout (const BusesLayout& layouts) override
{
    return getNextBestLayoutInLayoutList (layouts, {{1,1},{2,2}});
}

◆ getNextBestLayoutInList()

BusesLayout juce::AudioProcessor::getNextBestLayoutInList	(	const BusesLayout &	,
		const Array< InOutChannelPair > &
	)		const

privateinherited

◆ getNode()

Node::Ptr juce::AudioProcessorGraph::getNode ( int index ) const

inlinenoexcept

Returns a pointer to one of the nodes in the graph.

This will return nullptr if the index is out of range.

See also: getNodeForId

References juce::gl::index.

◆ getNodeConnections()

static void juce::AudioProcessorGraph::getNodeConnections	(	Node &	,
		std::vector< Connection > &
	)

staticprivate

◆ getNodeForId()

Node* juce::AudioProcessorGraph::getNodeForId ( NodeID ) const

Searches the graph for a node with the given ID number and returns it.

If no such node was found, this returns nullptr.

See also: getNode

◆ getNodes()

const ReferenceCountedArray<Node>& juce::AudioProcessorGraph::getNodes ( ) const

inlinenoexcept

Returns the array of nodes in the graph.

◆ getNumNodes()

int juce::AudioProcessorGraph::getNumNodes ( ) const

inlinenoexcept

Returns the number of nodes in the graph.

◆ getNumPrograms()

int juce::AudioProcessorGraph::getNumPrograms ( )

inlineoverridevirtual

Returns the number of preset programs the processor supports.

The value returned must be valid as soon as this object is created, and must not change over its lifetime.

This value shouldn't be less than 1.

Implements juce::AudioProcessor.

◆ getOffsetInBusBufferForAbsoluteChannelIndex()

int juce::AudioProcessor::getOffsetInBusBufferForAbsoluteChannelIndex	(	bool	isInput,
		int	absoluteChannelIndex,
		int &	busIndex
	)		const

noexceptinherited

Returns the offset in a bus's buffer from an absolute channel index.

This method returns the offset in a bus's buffer given an absolute channel index. It also provides the bus index. For example, this method would return one for a processor with two stereo buses when given the absolute channel index.

◆ getParamChecked()

AudioProcessorParameter* juce::AudioProcessor::getParamChecked ( int ) const

privateinherited

◆ getParameters()

const Array<AudioProcessorParameter*>& juce::AudioProcessor::getParameters ( ) const

inherited

Returns a flat list of the parameters in the current tree.

◆ getParameterTree()

const AudioProcessorParameterGroup& juce::AudioProcessor::getParameterTree ( ) const

inherited

Returns the group of parameters managed by this AudioProcessor.

◆ getPlayHead()

AudioPlayHead* juce::AudioProcessor::getPlayHead ( ) const

inlinenoexceptinherited

Returns the current AudioPlayHead object that should be used to find out the state and position of the playhead.

You can ONLY call this from your processBlock() method! Calling it at other times will produce undefined behaviour, as the host may not have any context in which a time would make sense, and some hosts will almost certainly have multithreading issues if it's not called on the audio thread.

The AudioPlayHead object that is returned can be used to get the details about the time of the start of the block currently being processed. But do not store this pointer or use it outside of the current audio callback, because the host may delete or re-use it.

If the host can't or won't provide any time info, this will return nullptr.

◆ getProcessingPrecision()

ProcessingPrecision juce::AudioProcessor::getProcessingPrecision ( ) const

inlinenoexceptinherited

Returns the precision-mode of the processor.

Depending on the result of this method you MUST call the corresponding version of processBlock. The default processing precision is single precision.

See also: setProcessingPrecision, supportsDoublePrecisionProcessing

◆ getProgramName()

const String juce::AudioProcessorGraph::getProgramName ( int index )

inlineoverridevirtual

Must return the name of a given program.

Implements juce::AudioProcessor.

◆ getResponseCurve()

virtual CurveData juce::AudioProcessor::getResponseCurve ( CurveData::Type ) const

inlinevirtualinherited

◆ getSampleRate()

double juce::AudioProcessor::getSampleRate ( ) const

inlinenoexceptinherited

Returns the current sample rate.

This can be called from your processBlock() method - it's not guaranteed to be valid at any other time, and may return 0 if it's unknown.

◆ getStateInformation()

void juce::AudioProcessorGraph::getStateInformation ( juce::MemoryBlock & destData )

overridevirtual

The host will call this method when it wants to save the processor's internal state.

This must copy any info about the processor's state into the block of memory provided, so that the host can store this and later restore it using setStateInformation().

Note that there's also a getCurrentProgramStateInformation() method, which only stores the current program, not the state of the entire processor.

See also the helper function copyXmlToBinary() for storing settings as XML.

See also: getCurrentProgramStateInformation

Implements juce::AudioProcessor.

◆ getTailLengthSeconds()

double juce::AudioProcessorGraph::getTailLengthSeconds ( ) const

overridevirtual

Returns the length of the processor's tail, in seconds.

Implements juce::AudioProcessor.

◆ getTotalNumInputChannels()

int juce::AudioProcessor::getTotalNumInputChannels ( ) const

inlinenoexceptinherited

Returns the total number of input channels.

This method will return the total number of input channels by accumulating the number of channels on each input bus. The number of channels of the buffer passed to your processBlock callback will be equivalent to either getTotalNumInputChannels or getTotalNumOutputChannels - which ever is greater.

Note that getTotalNumInputChannels is equivalent to getMainBusNumInputChannels if your processor does not have any sidechains or aux buses.

◆ getTotalNumOutputChannels()

int juce::AudioProcessor::getTotalNumOutputChannels ( ) const

inlinenoexceptinherited

Returns the total number of output channels.

This method will return the total number of output channels by accumulating the number of channels on each output bus. The number of channels of the buffer passed to your processBlock callback will be equivalent to either getTotalNumInputChannels or getTotalNumOutputChannels - which ever is greater.

Note that getTotalNumOutputChannels is equivalent to getMainBusNumOutputChannels if your processor does not have any sidechains or aux buses.

◆ getWrapperTypeDescription()

static const char* juce::AudioProcessor::getWrapperTypeDescription ( AudioProcessor::WrapperType )

staticnoexceptinherited

Returns a textual description of a WrapperType value.

◆ getXmlFromBinary()

static std::unique_ptr<XmlElement> juce::AudioProcessor::getXmlFromBinary	(	const void *	data,
		int	sizeInBytes
	)

staticinherited

Retrieves an XML element that was stored as binary with the copyXmlToBinary() method.

This might return nullptr if the data's unsuitable or corrupted.

◆ handleAsyncUpdate()

void juce::AudioProcessorGraph::handleAsyncUpdate ( )

overrideprivatevirtual

Called back to do whatever your class needs to do.

This method is called by the message thread at the next convenient time after the triggerAsyncUpdate() method has been called.

Implements juce::AsyncUpdater.

◆ handleUpdateNowIfNeeded()

void juce::AsyncUpdater::handleUpdateNowIfNeeded ( )

inherited

If an update has been triggered and is pending, this will invoke it synchronously.

Use this as a kind of "flush" operation - if an update is pending, the handleAsyncUpdate() method will be called immediately; if no update is pending, then nothing will be done.

Because this may invoke the callback, this method must only be called on the main event thread.

◆ hasEditor()

bool juce::AudioProcessorGraph::hasEditor ( ) const

inlineoverridevirtual

Your processor subclass must override this and return true if it can create an editor component.

See also: createEditor

Implements juce::AudioProcessor.

◆ isAnInputTo() [1/2]

bool juce::AudioProcessorGraph::isAnInputTo	(	Node &	source,
		Node &	destination
	)		const

noexcept

Does a recursive check to see if there's a direct or indirect series of connections between these two nodes.

◆ isAnInputTo() [2/2]

bool juce::AudioProcessorGraph::isAnInputTo	(	Node &	src,
		Node &	dst,
		int	recursionCheck
	)		const

privatenoexcept

◆ isBusesLayoutSupported()

virtual bool juce::AudioProcessor::isBusesLayoutSupported ( const BusesLayout & ) const

inlineprotectedvirtualinherited

Callback to query if the AudioProcessor supports a specific layout.

This callback is called when the host probes the supported bus layouts via the checkBusesLayoutSupported method. You should override this callback if you would like to limit the layouts that your AudioProcessor supports. The default implementation will accept any layout. JUCE does basic sanity checks so that the provided layouts parameter will have the same number of buses as your AudioProcessor.

See also: checkBusesLayoutSupported

◆ isConnected() [1/3]

bool juce::AudioProcessorGraph::isConnected ( const Connection & ) const

noexcept

Returns true if the given connection exists.

◆ isConnected() [2/3]

bool juce::AudioProcessorGraph::isConnected	(	Node *	src,
		int	sourceChannel,
		Node *	dest,
		int	destChannel
	)		const

privatenoexcept

◆ isConnected() [3/3]

bool juce::AudioProcessorGraph::isConnected	(	NodeID	possibleSourceNodeID,
		NodeID	possibleDestNodeID
	)		const

noexcept

Returns true if there is a direct connection between any of the channels of two specified nodes.

◆ isConnectionLegal()

bool juce::AudioProcessorGraph::isConnectionLegal ( const Connection & ) const

Returns true if the given connection's channel numbers map on to valid channels at each end.

Even if a connection is valid when created, its status could change if a node changes its channel config.

◆ isLegal()

bool juce::AudioProcessorGraph::isLegal	(	Node *	src,
		int	sourceChannel,
		Node *	dest,
		int	destChannel
	)		const

privatenoexcept

◆ isMidiEffect()

virtual bool juce::AudioProcessor::isMidiEffect ( ) const

inlinevirtualinherited

Returns true if this is a MIDI effect plug-in and does no audio processing.

◆ isNonRealtime()

bool juce::AudioProcessor::isNonRealtime ( ) const

inlinenoexceptinherited

Returns true if the processor is being run in an offline mode for rendering.

If the processor is being run live on realtime signals, this returns false. If the mode is unknown, this will assume it's realtime and return false.

This value may be unreliable until the prepareToPlay() method has been called, and could change each time prepareToPlay() is called.

See also: setNonRealtime()

◆ isSuspended()

bool juce::AudioProcessor::isSuspended ( ) const

inlinenoexceptinherited

Returns true if processing is currently suspended.

See also: suspendProcessing

◆ isUpdatePending()

bool juce::AsyncUpdater::isUpdatePending ( ) const

noexceptinherited

Returns true if there's an update callback in the pipeline.

◆ isUsingDoublePrecision()

bool juce::AudioProcessor::isUsingDoublePrecision ( ) const

inlinenoexceptinherited

Returns true if the current precision is set to doublePrecision.

◆ layoutListToArray() [1/2]

template<size_t numLayouts>

static Array<InOutChannelPair> juce::AudioProcessor::layoutListToArray ( const short(&) configuration[numLayouts][2] )

inlinestaticprivateinherited

References juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::add().

◆ layoutListToArray() [2/2]

static Array<InOutChannelPair> juce::AudioProcessor::layoutListToArray ( const std::initializer_list< const short[2]> & configuration )

inlinestaticprivateinherited

References juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::add().

◆ memoryWarningReceived()

virtual void juce::AudioProcessor::memoryWarningReceived ( )

inlinevirtualinherited

Called by the host to indicate that you should reduce your memory footprint.

You should override this method to free up some memory gracefully, if possible, otherwise the host may forcibly unload your AudioProcessor.

At the moment this method is only called when your AudioProcessor is an AUv3 plug-in running on iOS.

References jassertfalse.

◆ numBusesChanged()

virtual void juce::AudioProcessor::numBusesChanged ( )

virtualinherited

This method is called when the number of buses is changed.

◆ numChannelsChanged()

virtual void juce::AudioProcessor::numChannelsChanged ( )

virtualinherited

This method is called when the total number of input or output channels is changed.

◆ prepareToPlay()

void juce::AudioProcessorGraph::prepareToPlay	(	double	sampleRate,
		int	maximumExpectedSamplesPerBlock
	)

overridevirtual

Called before playback starts, to let the processor prepare itself.

The sample rate is the target sample rate, and will remain constant until playback stops.

You can call getTotalNumInputChannels and getTotalNumOutputChannels or query the busLayout member variable to find out the number of channels your processBlock callback must process.

The maximumExpectedSamplesPerBlock value is a strong hint about the maximum number of samples that will be provided in each block. You may want to use this value to resize internal buffers. You should program defensively in case a buggy host exceeds this value. The actual block sizes that the host uses may be different each time the callback happens: completely variable block sizes can be expected from some hosts.

See also: busLayout, getTotalNumInputChannels, getTotalNumOutputChannels

Implements juce::AudioProcessor.

◆ processBlock() [1/2]

void juce::AudioProcessorGraph::processBlock	(	AudioBuffer< double > &	buffer,
		MidiBuffer &	midiMessages
	)

overridevirtual

Renders the next block.

When this method is called, the buffer contains a number of channels which is at least as great as the maximum number of input and output channels that this processor is using. It will be filled with the processor's input data and should be replaced with the processor's output.

So for example if your processor has a combined total of 2 input channels and 4 output channels, then the buffer will contain 4 channels, the first two being filled with the input data. Your processor should read these, do its processing, and replace the contents of all 4 channels with its output.

Or if your processor has 5 inputs and 2 outputs, the buffer will have 5 channels, all filled with data, and your processor should overwrite the first 2 of these with its output. But be VERY careful not to write anything to the last 3 channels, as these might be mapped to memory that the host assumes is read-only!

If your plug-in has more than one input or output buses then the buffer passed to the processBlock methods will contain a bundle of all channels of each bus. Use getBusBuffer to obtain a audio buffer for a particular bus.

Note that if you have more outputs than inputs, then only those channels that correspond to an input channel are guaranteed to contain sensible data - e.g. in the case of 2 inputs and 4 outputs, the first two channels contain the input, but the last two channels may contain garbage, so you should be careful not to let this pass through without being overwritten or cleared.

Also note that the buffer may have more channels than are strictly necessary, but you should only read/write from the ones that your processor is supposed to be using.

If your plugin uses buses, then you should use getBusBuffer() or getChannelIndexInProcessBlockBuffer() to find out which of the input and output channels correspond to which of the buses.

The number of samples in these buffers is NOT guaranteed to be the same for every callback, and may be more or less than the estimated value given to prepareToPlay(). Your code must be able to cope with variable-sized blocks, or you're going to get clicks and crashes!

Also note that some hosts will occasionally decide to pass a buffer containing zero samples, so make sure that your algorithm can deal with that!

If the processor is receiving a MIDI input, then the midiMessages array will be filled with the MIDI messages for this block. Each message's timestamp will indicate the message's time, as a number of samples from the start of the block.

Any messages left in the MIDI buffer when this method has finished are assumed to be the processor's MIDI output. This means that your processor should be careful to clear any incoming messages from the array if it doesn't want them to be passed-on.

If you have implemented the getBypassParameter method, then you need to check the value of this parameter in this callback and bypass your processing if the parameter has a non-zero value.

Note that when calling this method as a host, the result may still be bypassed as the parameter that controls the bypass may be non-zero.

Be very careful about what you do in this callback - it's going to be called by the audio thread, so any kind of interaction with the UI is absolutely out of the question. If you change a parameter in here and need to tell your UI to update itself, the best way is probably to inherit from a ChangeBroadcaster, let the UI components register as listeners, and then call sendChangeMessage() inside the processBlock() method to send out an asynchronous message. You could also use the AsyncUpdater class in a similar way.

See also: getBusBuffer

Reimplemented from juce::AudioProcessor.

◆ processBlock() [2/2]

void juce::AudioProcessorGraph::processBlock	(	AudioBuffer< float > &	buffer,
		MidiBuffer &	midiMessages
	)

overridevirtual

Renders the next block.

When this method is called, the buffer contains a number of channels which is at least as great as the maximum number of input and output channels that this processor is using. It will be filled with the processor's input data and should be replaced with the processor's output.

So for example if your processor has a total of 2 input channels and 4 output channels, then the buffer will contain 4 channels, the first two being filled with the input data. Your processor should read these, do its processing, and replace the contents of all 4 channels with its output.

Or if your processor has a total of 5 inputs and 2 outputs, the buffer will have 5 channels, all filled with data, and your processor should overwrite the first 2 of these with its output. But be VERY careful not to write anything to the last 3 channels, as these might be mapped to memory that the host assumes is read-only!

If your plug-in has more than one input or output buses then the buffer passed to the processBlock methods will contain a bundle of all channels of each bus. Use getBusBuffer to obtain an audio buffer for a particular bus.