Acts as a holder for a ControlSurface object. More...

#include "tracktion_ExternalController.h"

Inheritance diagram for tracktion::engine::ExternalController:

Public Member Functions
	ExternalController (Engine &, ControlSurface *)

juce::String	getName () const

bool	wantsDevice (const MidiID &m)

bool	needsMidiChannel () const

bool	needsMidiBackChannel () const

juce::String	getDesiredMidiChannel () const

juce::String	getDesiredMidiBackChannel () const

bool	needsOSCSocket () const

int	getNumDevices () const

void	setNumDevices (int)

int	getMainDevice () const

void	setMainDevice (int)

juce::String	getMidiInputDevice (int idx) const

void	setMidiInputDevice (int idx, const juce::String &nameOfMidiInput)

juce::String	getBackChannelDevice (int idx) const

void	setBackChannelDevice (int idx, const juce::String &nameOfMidiOutput)

bool	isUsingMidiOutputDevice (const MidiOutputDevice *d) const noexcept

int	getOSCInputPort ()

void	setOSCInputPort (int port)

int	getOSCOutputPort ()

void	setOSCOutputPort (int port)

juce::String	getOSCOutputAddress ()

void	setOSCOutputAddress (const juce::String addr)

bool	isEnabled () const

void	setEnabled (bool)

bool	isDeletable () const

void	deleteController ()

bool	wantsMidiClock () const

void	currentEditChanged (Edit *)

void	currentSelectionManagerChanged (SelectionManager *)

void	moveFader (int channelNum, float newSliderPos)

void	moveMasterFader (float newPos)

void	movePanPot (int channelNum, float newPan)

void	moveMasterPanPot (float newPos)

void	updateSoloAndMute (int channelNum, Track::MuteAndSoloLightState, bool isBright)

void	soloCountChanged (bool)

void	playStateChanged (bool isPlaying)

void	recordStateChanged (bool isRecording)

void	automationModeChanged (bool isReading, bool isWriting)

void	snapChanged (bool isOn)

void	loopChanged (bool isOn)

void	clickChanged (bool isOn)

void	channelLevelChanged (int channel, float l, float r)

void	masterLevelsChanged (float leftLevel, float rightLevel)

void	timecodeChanged (int barsOrHours, int beatsOrMinutes, int ticksOrSeconds, int millisecs, bool isBarsBeats, bool isFrames)

void	trackSelected (int channel, bool isSelected)

void	selectOtherObject (SelectableClass::Relationship, bool moveFromCurrentPlugin)

void	muteOrUnmutePlugin ()

void	muteOrUnmutePluginsInTrack ()

void	changePluginPreset (int delta)

void	soloPluginTrack ()

void	auxSendLevelsChanged ()

void	updateDeviceState ()

void	updateParameters ()

void	updateMarkers ()

void	selectedPluginChanged ()

void	selectableObjectChanged (Selectable *) override

void	selectableObjectAboutToBeDeleted (Selectable *) override

void	curveHasChanged (AutomatableParameter &) override
	Called when the automation curve has changed, point time, value or curve.

void	currentValueChanged (AutomatableParameter &) override
	Called when the current value of the parameter changed, either from setting the parameter, automation, a macro or modifier.

void	updateTrackSelectLights ()

void	updateTrackRecordLights ()

void	updatePunchLights ()

void	updateScrollLights ()

void	updateUndoLights ()

void	updatePadColours ()

void	clearPadColours ()

int	getNumFaderChannels () const noexcept

int	getFaderIndexInActiveRegion (int num) const noexcept

juce::Range< int >	getActiveChannels () const noexcept

int	getNumParameterControls () const noexcept

juce::Range< int >	getActiveParams () const noexcept

void	midiInOutDevicesChanged ()

void	oscSettingsChanged ()

void	handleAsyncUpdate () override

void	acceptMidiMessage (MidiInputDevice &, const juce::MidiMessage &)

bool	wantsMessage (MidiInputDevice &, const juce::MidiMessage &)

bool	eatsAllMessages () const

bool	canSetEatsAllMessages ()

void	setEatsAllMessages (bool eatAll)

juce::Colour	getSelectionColour () const

bool	getShowTrackSelectionColour () const

bool	getShowClipSlotSelectionColour () const

void	setSelectionColour (juce::Colour)

void	setShowTrackSelectionColour (bool)

void	setShowClipSlotSelectionColour (bool)

bool	shouldTrackBeColoured (int channelNum)

void	getTrackColour (int channelNum, juce::Colour &)

std::optional< ColourArea >	getColouredArea (const Edit &)

bool	shouldPluginBeColoured (Plugin *)

void	getPluginColour (Plugin *, juce::Colour &)

void	repaintParamSource ()

void	redrawTracks ()

ControlSurface &	getControlSurface () const noexcept

template<typename Type >
Type *	getControlSurfaceIfType () const noexcept

ExternalControllerManager &	getExternalControllerManager () const noexcept

Edit *	getEdit () const

TransportControl *	getTransport () const noexcept

juce::String	getInputDeviceName (int idx) const

juce::String	getOutputDeviceName (int idx) const

juce::StringArray	getMidiInputPorts () const

juce::StringArray	getMidiOutputPorts () const

Static Public Member Functions
static juce::String	shortenName (juce::String, int maxLen)

static juce::String	getNoDeviceSelectedMessage ()

Public Attributes
Engine &	engine

Friends
class	ExternalControllerManager

class	ControlSurface

class	MackieC4

class	MackieMCU

Detailed Description

Acts as a holder for a ControlSurface object.

Definition at line 17 of file tracktion_ExternalController.h.

Constructor & Destructor Documentation

◆ ExternalController()

tracktion::engine::ExternalController::ExternalController	(	Engine &	e,
		ControlSurface *	c
	)

Definition at line 14 of file tracktion_ExternalController.cpp.

◆ ~ExternalController()

tracktion::engine::ExternalController::~ExternalController ( )

override

Definition at line 71 of file tracktion_ExternalController.cpp.

Member Function Documentation

◆ acceptMidiMessage()

void tracktion::engine::ExternalController::acceptMidiMessage	(	MidiInputDevice &	d,
		const juce::MidiMessage &	m
	)

Definition at line 1399 of file tracktion_ExternalController.cpp.

◆ automationModeChanged()

void tracktion::engine::ExternalController::automationModeChanged	(	bool	isReading,
		bool	isWriting
	)

Definition at line 526 of file tracktion_ExternalController.cpp.

◆ auxSendLevelsChanged()

void tracktion::engine::ExternalController::auxSendLevelsChanged ( )

Definition at line 1333 of file tracktion_ExternalController.cpp.

◆ changePluginPreset()

void tracktion::engine::ExternalController::changePluginPreset ( int delta )

Definition at line 608 of file tracktion_ExternalController.cpp.

◆ channelLevelChanged()

void tracktion::engine::ExternalController::channelLevelChanged	(	int	channel,
		float	l,
		float	r
	)

Definition at line 553 of file tracktion_ExternalController.cpp.

◆ clearPadColours()

void tracktion::engine::ExternalController::clearPadColours ( )

Definition at line 1034 of file tracktion_ExternalController.cpp.

◆ clickChanged()

void tracktion::engine::ExternalController::clickChanged ( bool isOn )

Definition at line 547 of file tracktion_ExternalController.cpp.

◆ currentEditChanged()

void tracktion::engine::ExternalController::currentEditChanged ( Edit * edit )

Definition at line 139 of file tracktion_ExternalController.cpp.

◆ currentSelectionManagerChanged()

void tracktion::engine::ExternalController::currentSelectionManagerChanged ( SelectionManager * sm )

Definition at line 148 of file tracktion_ExternalController.cpp.

◆ currentValueChanged()

void tracktion::engine::ExternalController::currentValueChanged ( AutomatableParameter & )

overridevirtual

Called when the current value of the parameter changed, either from setting the parameter, automation, a macro or modifier.

This is async so you won't get a callback for every parameter change.

Reimplemented from tracktion::engine::AutomatableParameter::Listener.

Definition at line 953 of file tracktion_ExternalController.cpp.

◆ curveHasChanged()

void tracktion::engine::ExternalController::curveHasChanged ( AutomatableParameter & )

overridevirtual

Called when the automation curve has changed, point time, value or curve.

Implements tracktion::engine::AutomatableParameter::Listener.

Definition at line 947 of file tracktion_ExternalController.cpp.

◆ deleteController()

void tracktion::engine::ExternalController::deleteController ( )

Definition at line 255 of file tracktion_ExternalController.cpp.

◆ eatsAllMessages()

bool tracktion::engine::ExternalController::eatsAllMessages ( ) const

Definition at line 1426 of file tracktion_ExternalController.cpp.

◆ getActiveChannels()

juce::Range< int > tracktion::engine::ExternalController::getActiveChannels ( ) const

noexcept

Definition at line 261 of file tracktion_ExternalController.cpp.

◆ getActiveParams()

juce::Range< int > tracktion::engine::ExternalController::getActiveParams ( ) const

noexcept

Definition at line 266 of file tracktion_ExternalController.cpp.

◆ getBackChannelDevice()

juce::String tracktion::engine::ExternalController::getBackChannelDevice ( int idx ) const

Definition at line 245 of file tracktion_ExternalController.cpp.

◆ getColouredArea()

std::optional< ColourArea > tracktion::engine::ExternalController::getColouredArea ( const Edit & e )

Definition at line 1536 of file tracktion_ExternalController.cpp.

◆ getControlSurface()

ControlSurface & tracktion::engine::ExternalController::getControlSurface ( ) const

noexcept

Definition at line 150 of file tracktion_ExternalController.h.

◆ getControlSurfaceIfType()

template<typename Type >

Type * tracktion::engine::ExternalController::getControlSurfaceIfType ( ) const

noexcept

Definition at line 152 of file tracktion_ExternalController.h.

◆ getDesiredMidiBackChannel()

juce::String tracktion::engine::ExternalController::getDesiredMidiBackChannel ( ) const

Definition at line 126 of file tracktion_ExternalController.cpp.

◆ getDesiredMidiChannel()

juce::String tracktion::engine::ExternalController::getDesiredMidiChannel ( ) const

Definition at line 118 of file tracktion_ExternalController.cpp.

◆ getEdit()

Edit * tracktion::engine::ExternalController::getEdit ( ) const

Definition at line 156 of file tracktion_ExternalController.h.

◆ getExternalControllerManager()

ExternalControllerManager & tracktion::engine::ExternalController::getExternalControllerManager ( ) const

noexcept

Definition at line 154 of file tracktion_ExternalController.h.

◆ getFaderIndexInActiveRegion()

int tracktion::engine::ExternalController::getFaderIndexInActiveRegion ( int num ) const

noexcept

Definition at line 271 of file tracktion_ExternalController.cpp.

◆ getInputDeviceName()

juce::String tracktion::engine::ExternalController::getInputDeviceName ( int idx ) const

Definition at line 161 of file tracktion_ExternalController.h.

◆ getMainDevice()

int tracktion::engine::ExternalController::getMainDevice ( ) const

Definition at line 202 of file tracktion_ExternalController.cpp.

◆ getMidiInputDevice()

juce::String tracktion::engine::ExternalController::getMidiInputDevice ( int idx ) const

Definition at line 216 of file tracktion_ExternalController.cpp.

◆ getMidiInputPorts()

juce::StringArray tracktion::engine::ExternalController::getMidiInputPorts ( ) const

Definition at line 1472 of file tracktion_ExternalController.cpp.

◆ getMidiOutputPorts()

juce::StringArray tracktion::engine::ExternalController::getMidiOutputPorts ( ) const

Definition at line 1497 of file tracktion_ExternalController.cpp.

◆ getName()

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

Definition at line 102 of file tracktion_ExternalController.cpp.

◆ getNoDeviceSelectedMessage()

juce::String tracktion::engine::ExternalController::getNoDeviceSelectedMessage ( )

static

Definition at line 1467 of file tracktion_ExternalController.cpp.

◆ getNumDevices()

int tracktion::engine::ExternalController::getNumDevices ( ) const

Definition at line 187 of file tracktion_ExternalController.cpp.

◆ getNumFaderChannels()

int tracktion::engine::ExternalController::getNumFaderChannels ( ) const

noexcept

Definition at line 277 of file tracktion_ExternalController.cpp.

◆ getNumParameterControls()

int tracktion::engine::ExternalController::getNumParameterControls ( ) const

noexcept

Definition at line 285 of file tracktion_ExternalController.cpp.

◆ getOSCInputPort()

int tracktion::engine::ExternalController::getOSCInputPort ( )

Definition at line 54 of file tracktion_ExternalController.h.

◆ getOSCOutputAddress()

juce::String tracktion::engine::ExternalController::getOSCOutputAddress ( )

Definition at line 58 of file tracktion_ExternalController.h.

◆ getOSCOutputPort()

int tracktion::engine::ExternalController::getOSCOutputPort ( )

Definition at line 56 of file tracktion_ExternalController.h.

◆ getOutputDeviceName()

juce::String tracktion::engine::ExternalController::getOutputDeviceName ( int idx ) const

Definition at line 162 of file tracktion_ExternalController.h.

◆ getPluginColour()

void tracktion::engine::ExternalController::getPluginColour	(	Plugin *	plugin,
		juce::Colour &	color
	)

Definition at line 1571 of file tracktion_ExternalController.cpp.

◆ getSelectionColour()

juce::Colour tracktion::engine::ExternalController::getSelectionColour ( ) const

Definition at line 134 of file tracktion_ExternalController.h.

◆ getShowClipSlotSelectionColour()

bool tracktion::engine::ExternalController::getShowClipSlotSelectionColour ( ) const

Definition at line 136 of file tracktion_ExternalController.h.

◆ getShowTrackSelectionColour()

bool tracktion::engine::ExternalController::getShowTrackSelectionColour ( ) const

Definition at line 135 of file tracktion_ExternalController.h.

◆ getTrackColour()

void tracktion::engine::ExternalController::getTrackColour	(	int	channelNum,
		juce::Colour &	color
	)

Definition at line 1521 of file tracktion_ExternalController.cpp.

◆ getTransport()

TransportControl * tracktion::engine::ExternalController::getTransport ( ) const

noexcept

Definition at line 157 of file tracktion_ExternalController.h.

◆ handleAsyncUpdate()

void tracktion::engine::ExternalController::handleAsyncUpdate ( )

overridevirtual

Implements juce::AsyncUpdater.

Definition at line 1437 of file tracktion_ExternalController.cpp.

◆ isDeletable()

bool tracktion::engine::ExternalController::isDeletable ( ) const

Definition at line 64 of file tracktion_ExternalController.h.

◆ isEnabled()

bool tracktion::engine::ExternalController::isEnabled ( ) const

Definition at line 157 of file tracktion_ExternalController.cpp.

◆ isUsingMidiOutputDevice()

bool tracktion::engine::ExternalController::isUsingMidiOutputDevice ( const MidiOutputDevice * d ) const

noexcept

Definition at line 409 of file tracktion_ExternalController.cpp.

◆ loopChanged()

void tracktion::engine::ExternalController::loopChanged ( bool isOn )

Definition at line 541 of file tracktion_ExternalController.cpp.

◆ masterLevelsChanged()

void tracktion::engine::ExternalController::masterLevelsChanged	(	float	leftLevel,
		float	rightLevel
	)

Definition at line 561 of file tracktion_ExternalController.cpp.

◆ midiInOutDevicesChanged()

void tracktion::engine::ExternalController::midiInOutDevicesChanged ( )

Definition at line 293 of file tracktion_ExternalController.cpp.

◆ moveFader()

void tracktion::engine::ExternalController::moveFader	(	int	channelNum,
		float	newSliderPos
	)

Definition at line 472 of file tracktion_ExternalController.cpp.

◆ moveMasterFader()

void tracktion::engine::ExternalController::moveMasterFader ( float newPos )

Definition at line 480 of file tracktion_ExternalController.cpp.

◆ moveMasterPanPot()

void tracktion::engine::ExternalController::moveMasterPanPot ( float newPos )

Definition at line 495 of file tracktion_ExternalController.cpp.

◆ movePanPot()

void tracktion::engine::ExternalController::movePanPot	(	int	channelNum,
		float	newPan
	)

Definition at line 487 of file tracktion_ExternalController.cpp.

◆ muteOrUnmutePlugin()

void tracktion::engine::ExternalController::muteOrUnmutePlugin ( )

Definition at line 602 of file tracktion_ExternalController.cpp.

◆ muteOrUnmutePluginsInTrack()

void tracktion::engine::ExternalController::muteOrUnmutePluginsInTrack ( )

Definition at line 625 of file tracktion_ExternalController.cpp.

◆ needsMidiBackChannel()

bool tracktion::engine::ExternalController::needsMidiBackChannel ( ) const

Definition at line 34 of file tracktion_ExternalController.h.

◆ needsMidiChannel()

bool tracktion::engine::ExternalController::needsMidiChannel ( ) const

Definition at line 33 of file tracktion_ExternalController.h.

◆ needsOSCSocket()

bool tracktion::engine::ExternalController::needsOSCSocket ( ) const

Definition at line 39 of file tracktion_ExternalController.h.

◆ oscSettingsChanged()

void tracktion::engine::ExternalController::oscSettingsChanged ( )

Definition at line 374 of file tracktion_ExternalController.cpp.

◆ playStateChanged()

void tracktion::engine::ExternalController::playStateChanged ( bool isPlaying )

Definition at line 514 of file tracktion_ExternalController.cpp.

◆ recordStateChanged()

void tracktion::engine::ExternalController::recordStateChanged ( bool isRecording )

Definition at line 520 of file tracktion_ExternalController.cpp.

◆ redrawTracks()

void tracktion::engine::ExternalController::redrawTracks ( )

Definition at line 1590 of file tracktion_ExternalController.cpp.

◆ repaintParamSource()

void tracktion::engine::ExternalController::repaintParamSource ( )

Definition at line 1582 of file tracktion_ExternalController.cpp.

◆ selectableObjectAboutToBeDeleted()

void tracktion::engine::ExternalController::selectableObjectAboutToBeDeleted ( Selectable * s )

overridevirtual

Implements tracktion::engine::SelectableListener.

Definition at line 926 of file tracktion_ExternalController.cpp.

◆ selectableObjectChanged()

void tracktion::engine::ExternalController::selectableObjectChanged ( Selectable * )

overridevirtual

Implements tracktion::engine::SelectableListener.

Definition at line 920 of file tracktion_ExternalController.cpp.

◆ selectedPluginChanged()

void tracktion::engine::ExternalController::selectedPluginChanged ( )

Definition at line 892 of file tracktion_ExternalController.cpp.

◆ selectOtherObject()

void tracktion::engine::ExternalController::selectOtherObject	(	SelectableClass::Relationship	relationship,
		bool	moveFromCurrentPlugin
	)

Definition at line 587 of file tracktion_ExternalController.cpp.

◆ setBackChannelDevice()

void tracktion::engine::ExternalController::setBackChannelDevice	(	int	idx,
		const juce::String &	nameOfMidiOutput
	)

Definition at line 389 of file tracktion_ExternalController.cpp.

◆ setEatsAllMessages()

void tracktion::engine::ExternalController::setEatsAllMessages ( bool eatAll )

Definition at line 1431 of file tracktion_ExternalController.cpp.

◆ setEnabled()

void tracktion::engine::ExternalController::setEnabled ( bool e )

Definition at line 172 of file tracktion_ExternalController.cpp.

◆ setMainDevice()

void tracktion::engine::ExternalController::setMainDevice ( int num )

Definition at line 207 of file tracktion_ExternalController.cpp.

◆ setMidiInputDevice()

void tracktion::engine::ExternalController::setMidiInputDevice	(	int	idx,
		const juce::String &	nameOfMidiInput
	)

Definition at line 226 of file tracktion_ExternalController.cpp.

◆ setNumDevices()

void tracktion::engine::ExternalController::setNumDevices ( int num )

Definition at line 192 of file tracktion_ExternalController.cpp.

◆ setOSCInputPort()

void tracktion::engine::ExternalController::setOSCInputPort ( int port )

Definition at line 418 of file tracktion_ExternalController.cpp.

◆ setOSCOutputAddress()

void tracktion::engine::ExternalController::setOSCOutputAddress ( const juce::String addr )

Definition at line 434 of file tracktion_ExternalController.cpp.

◆ setOSCOutputPort()

void tracktion::engine::ExternalController::setOSCOutputPort ( int port )

Definition at line 426 of file tracktion_ExternalController.cpp.

◆ setSelectionColour()

void tracktion::engine::ExternalController::setSelectionColour ( juce::Colour c )

Definition at line 442 of file tracktion_ExternalController.cpp.

◆ setShowClipSlotSelectionColour()

void tracktion::engine::ExternalController::setShowClipSlotSelectionColour ( bool b )

Definition at line 462 of file tracktion_ExternalController.cpp.

◆ setShowTrackSelectionColour()

void tracktion::engine::ExternalController::setShowTrackSelectionColour ( bool b )

Definition at line 452 of file tracktion_ExternalController.cpp.

◆ shortenName()

juce::String tracktion::engine::ExternalController::shortenName	(	juce::String	s,
		int	maxLen
	)

static

Definition at line 1684 of file tracktion_ExternalController.cpp.

◆ shouldPluginBeColoured()

bool tracktion::engine::ExternalController::shouldPluginBeColoured ( Plugin * p )

Definition at line 1562 of file tracktion_ExternalController.cpp.

◆ shouldTrackBeColoured()

bool tracktion::engine::ExternalController::shouldTrackBeColoured ( int channelNum )

Definition at line 1512 of file tracktion_ExternalController.cpp.

◆ snapChanged()

void tracktion::engine::ExternalController::snapChanged ( bool isOn )

Definition at line 535 of file tracktion_ExternalController.cpp.

◆ soloCountChanged()

void tracktion::engine::ExternalController::soloCountChanged ( bool anySoloTracks )

Definition at line 508 of file tracktion_ExternalController.cpp.

◆ soloPluginTrack()

void tracktion::engine::ExternalController::soloPluginTrack ( )

Definition at line 618 of file tracktion_ExternalController.cpp.

◆ timecodeChanged()

void tracktion::engine::ExternalController::timecodeChanged	(	int	barsOrHours,
		int	beatsOrMinutes,
		int	ticksOrSeconds,
		int	millisecs,
		bool	isBarsBeats,
		bool	isFrames
	)