Mixer – The n-input m-channel mixer class. More...

#include <Mixer.h>

Inheritance diagram for csl::Mixer:

Public Member Functions
	Mixer ()
	Constructors. More...

	Mixer (unsigned chans)

	Mixer (UnitGenerator &mScale)

	Mixer (unsigned chans, UnitGenerator &mScale)

virtual	~Mixer ()

UGenVector *	getInputs (void)

unsigned	getNumInputs (void)
	list of inputs, arbitrary # of channels More...

void	addInput (UnitGenerator &inp)

void	addInput (UnitGenerator *inp)

void	addInput (UnitGenerator &inp, float ampl)

void	addInput (UnitGenerator *inp, float ampl)

void	removeInput (UnitGenerator &inp)

void	removeInput (UnitGenerator *inp)
	number of active inputs More...

void	deleteInputs ()

void	scaleInput (UnitGenerator &inp, float val)
	set the scale of an input More...

void	nextBuffer (Buffer &outputBuffer) throw (CException)
	fill the buffer with the next buffer_length of values More...

void	dump ()
	print info about this instance More...

unsigned	activeSources ()

bool	isActive ()
	query whether I'm currently active (Envelopes can go inactive) More...

unsigned	frameRate ()

void	setFrameRate (unsigned rate)
	get/set the receiver's frame rate More...

virtual unsigned	numChannels ()

void	setNumChannels (unsigned ch)
	get/set the receiver's number of outputs More...

BufferCopyPolicy	copyPolicy ()

void	setCopyPolicy (BufferCopyPolicy ch)
	get/set the receiver's buffer copy policy More...

virtual void	nextBuffer (Buffer &outputBuffer, unsigned outBufNum) throw (CException)
	really compute the next buffer given an offset base channel; this is called by nextBuffer, possibly multiple times More...

virtual bool	isFixed ()
	query whether I'm fixed (StaticVariable overrides this) More...

void	addOutput (UnitGenerator *ugen)
	add to or return the UGen vector of outputs More...

void	removeOutput (UnitGenerator *ugen)

UGenVector	outputs ()

virtual unsigned	numOutputs ()

bool	checkFanOut (Buffer &outputBuffer) throw (CException)
	check for fan-out and copy previous buffer; return true if fanning out More...

void	handleFanOut (Buffer &outputBuffer) throw (CException)

virtual void	setValue (sample theValue)
	set/get the value (not allowed in the abstract, useful for static values) More...

virtual sample	value ()

virtual void	trigger ()

void	attachObserver (Observer *)
	(possibly notify obersvers on my death) More...

void	detachObserver (Observer *)

void	changed (void *argument)
	this is what I send to myself to notify my observers; It's not overridden in general. It results in the observers receiving update() calls < override evaluate to filter updates to the observer map More...

virtual int	evaluate (void *argument)

void	setScale (UnitGenerator &scale)
	set the receiver's scale member to a UGen or a float More...

void	setScale (float scale)

void	setOffset (UnitGenerator &offset)
	set the receiver's offset member to a UGen or a float More...

void	setOffset (float offset)

virtual void	trigger ()
	trigger passed on here More...

void	isScaled ()
	answer whether scale = 1 & offset = 0 More...

Port *	getPort (CSL_MAP_KEY name)

Protected Member Functions
void	allocateOpBuffer (unsigned chans)
	allocate the op buffer More...

void	zeroBuffer (Buffer &outputBuffer, unsigned outBufNum)
	utility method to zero out an outputBuffer More...

void	addInput (CSL_MAP_KEY name, UnitGenerator &ugen)
	Plug in a unit generator to the named input slot. More...

void	addInput (CSL_MAP_KEY name, float value)
	Plug in a float to the named input slot. More...

void	pullInput (Port *thePort, unsigned numFrames) throw (CException)
	method to read the control values (in case they're dynamic). this sends nextBuffer() to the input. More...

void	pullInput (Port *thePort, Buffer &theBuffer) throw (CException)

Protected Attributes
UGenVector	mSources
	mixers with inputs are always active More...

FloatVector	mScaleValues
	scales of inputs More...

Buffer	mOpBuffer
	buffer used for operations, if needed More...

bool	hasScales
	set to true if any of the scale values != 1.0 More...

unsigned	mFrameRate
	trigger ignored here More...

unsigned	mNumChannels
	my "expected" number of output channels More...

BufferCopyPolicy	mCopyPolicy
	the policy I use if asked for more or fewer channels More...

UGenVector	mOutputs
	the vector of my output UGens More...

unsigned	mNumOutputs
	the number of outputs More...

Buffer *	mOutputCache
	my past output ring buffer (only used in case of fan-out) More...

unsigned	mSequence
	the highest-seen buffer seq number More...

PortMap	mInputs
	the map of my inputs or controls (used by the mix-in classes) More...

Detailed Description

Mixer – The n-input m-channel mixer class.

This is like a binary operator, except that it has an array of inputs and cycles through them for each output buffer. Clients can add and remove inputs at run-time.

Definition at line 21 of file Mixer.h.

Constructor & Destructor Documentation

Mixer::Mixer ( )

Constructors.

Definition at line 17 of file Mixer.cpp.

References allocateOpBuffer(), and csl::UnitGenerator::mNumChannels.

Mixer::Mixer ( unsigned chans )

Definition at line 22 of file Mixer.cpp.

References allocateOpBuffer(), and csl::UnitGenerator::mNumChannels.

Mixer::Mixer ( UnitGenerator & mScale )

Definition at line 27 of file Mixer.cpp.

References allocateOpBuffer(), and csl::UnitGenerator::mNumChannels.

Mixer::Mixer	(	unsigned	chans,
		UnitGenerator &	mScale
	)

Definition at line 32 of file Mixer.cpp.

References allocateOpBuffer(), and csl::UnitGenerator::mNumChannels.

Mixer::~Mixer ( )

virtual

Definition at line 37 of file Mixer.cpp.

References csl::Buffer::freeBuffers(), and mOpBuffer.

Member Function Documentation

UGenVector* csl::Mixer::getInputs ( void )

inline

Definition at line 29 of file Mixer.h.

References mSources.

Referenced by testDynamicMixer().

unsigned Mixer::getNumInputs ( void )

list of inputs, arbitrary # of channels

number of active inputs add/remove inputs

Definition at line 95 of file Mixer.cpp.

References mSources.

void Mixer::addInput ( UnitGenerator & inp )

Definition at line 43 of file Mixer.cpp.

References csl::UnitGenerator::addOutput(), mScaleValues, and mSources.

Referenced by addSndtoBank(), csl::SimplePanner::addSource(), oscServer(), playSineMixer(), csl::SimplePanner::SimplePanner(), test50RandFreqEnv(), test_SHARC2(), test_SimpleP(), testBigPanMix(), testDynamicMixer(), testFanMix1(), testFanMix2(), testManyRandSOS(), testMultiTap(), testNDynamicFilters(), testOscBank(), testPanMix(), testSineMixer(), testSplitJoin2(), and testStringChorus().

void Mixer::addInput ( UnitGenerator * inp )

Definition at line 49 of file Mixer.cpp.

References csl::UnitGenerator::addOutput(), mScaleValues, and mSources.

void Mixer::addInput	(	UnitGenerator &	inp,
		float	ampl
	)

Definition at line 55 of file Mixer.cpp.

References csl::UnitGenerator::addOutput(), mScaleValues, and mSources.

void Mixer::addInput	(	UnitGenerator *	inp,
		float	ampl
	)

Definition at line 61 of file Mixer.cpp.

References csl::UnitGenerator::addOutput(), mScaleValues, and mSources.

void Mixer::removeInput ( UnitGenerator & inp )

Definition at line 69 of file Mixer.cpp.

References mScaleValues, and mSources.

Referenced by csl::SimplePanner::removeSource(), and testDynamicMixer().

void Mixer::removeInput ( UnitGenerator * inp )

number of active inputs

Definition at line 81 of file Mixer.cpp.

References mScaleValues, and mSources.

void Mixer::deleteInputs ( )

Definition at line 114 of file Mixer.cpp.

References mScaleValues, and mSources.

Referenced by test50RandFreqEnv(), testBigPanMix(), testDynamicMixer(), testManyRandSOS(), testNDynamicFilters(), testOscBank(), and CSLServerComponent::~CSLServerComponent().

void Mixer::scaleInput	(	UnitGenerator &	inp,
		float	val
	)

set the scale of an input

Definition at line 102 of file Mixer.cpp.

References csl::logMsg(), mScaleValues, and mSources.

Referenced by csl::SimplePanner::SimplePanner(), and testDynamicMixer().

void Mixer::nextBuffer	(	Buffer &	outputBuffer	)
throw	(	CException
	)

virtual

fill the buffer with the next buffer_length of values

Reimplemented from csl::UnitGenerator.

Definition at line 150 of file Mixer.cpp.

References DECLARE_SCALABLE_CONTROLS, csl::UnitGenerator::isActive(), csl::kLogError, LOAD_SCALABLE_CONTROLS, csl::logMsg(), csl::UnitGenerator::nextBuffer(), csl::UnitGenerator::numChannels(), and UPDATE_SCALABLE_CONTROLS.

void Mixer::dump ( void )

virtual

print info about this instance

Reimplemented from csl::UnitGenerator.

Definition at line 232 of file Mixer.cpp.

References mSources.

unsigned Mixer::activeSources ( )

Definition at line 132 of file Mixer.cpp.

References mSources.

bool csl::Mixer::isActive ( )

inlinevirtual

query whether I'm currently active (Envelopes can go inactive)

Reimplemented from csl::UnitGenerator.

Definition at line 47 of file Mixer.h.

void Mixer::allocateOpBuffer ( unsigned chans )

protected

allocate the op buffer

Definition at line 124 of file Mixer.cpp.

References csl::Buffer::allocateBuffers(), csl::CGestalt::blockSize(), csl::UnitGenerator::mNumChannels, mOpBuffer, and csl::Buffer::setSize().

Referenced by Mixer().

unsigned csl::UnitGenerator::frameRate ( )

inlineinherited

Definition at line 249 of file CSL_Core.h.

References csl::UnitGenerator::mFrameRate.

Referenced by csl::CASoundFile::dump(), csl::Abst_SoundFile::dump(), and csl::SoundCue::dump().

void csl::UnitGenerator::setFrameRate ( unsigned rate )

inlineinherited

get/set the receiver's frame rate

Definition at line 250 of file CSL_Core.h.

References csl::UnitGenerator::mFrameRate.

virtual unsigned csl::UnitGenerator::numChannels ( )

inlinevirtualinherited

Reimplemented in csl::Splitter, and csl::Stereoverb.

Definition at line 252 of file CSL_Core.h.

References csl::UnitGenerator::mNumChannels.

Referenced by csl::AmbisonicMixer::addInput(), csl::BlockResizer::BlockResizer(), csl::Port::checkBuffer(), csl::Effect::Effect(), csl::AmbisonicRotator::initialize(), csl::AmbisonicDecoder::initialize(), nextBuffer(), csl::Convolver2::setIRFile(), csl::Convolver::setIRFile(), and csl::SpatialSource::SpatialSource().

void csl::UnitGenerator::setNumChannels ( unsigned ch )

inlineinherited

get/set the receiver's number of outputs

Definition at line 253 of file CSL_Core.h.

References csl::UnitGenerator::mNumChannels.

Referenced by csl::BinauralPanner::BinauralPanner(), csl::Spatializer::Spatializer(), csl::VBAP::speakerLayoutChanged(), and csl::VBAP::VBAP().

BufferCopyPolicy csl::UnitGenerator::copyPolicy ( )

inlineinherited

Definition at line 255 of file CSL_Core.h.

References csl::UnitGenerator::mCopyPolicy.

void csl::UnitGenerator::setCopyPolicy ( BufferCopyPolicy ch )

inlineinherited

get/set the receiver's buffer copy policy

Definition at line 256 of file CSL_Core.h.

References csl::UnitGenerator::mCopyPolicy.

Referenced by csl::AmbisonicPanner::AmbisonicPanner(), csl::BinauralPanner::BinauralPanner(), csl::AmbisonicUnitGenerator::initOrder(), csl::Noise::Noise(), csl::PinkNoise::PinkNoise(), csl::Spatializer::Spatializer(), and csl::VBAP::VBAP().

void UnitGenerator::nextBuffer	(	Buffer &	outputBuffer,
		unsigned	outBufNum
	)
throw	(	CException
	)

virtualinherited

really compute the next buffer given an offset base channel; this is called by nextBuffer, possibly multiple times

Reimplemented in csl::Joiner, csl::Splitter, csl::FanOut, SAFliter, csl::RandEnvelope, csl::Moog, csl::AmbisonicDecoder, csl::Biquad, csl::Impulse, csl::Square, csl::AmbisonicEncoder, csl::Sawtooth, csl::FSine, csl::MulOp, csl::Envelope, csl::Filter, csl::Sine, csl::DynamicVariable, csl::AmbisonicRotator, csl::BufferStream, csl::CompOrCacheOscillator, csl::AddOp, csl::FIR, csl::WavetableOscillator, csl::PinkNoise, csl::VBAP, csl::SineAsScaled, csl::SpatialSource, csl::LineSegment, csl::StaticVariable, csl::AmbisonicMixer, csl::WhiteNoise, csl::SineAsPhased, csl::SpatialPanner, csl::Window, csl::RingBufferTap, csl::BinaryOp, csl::Freeverb, csl::KarplusString, csl::Clipper, csl::Lorenz, csl::SimpleSine, csl::DistanceSimulator, and csl::WaveShaper.

Definition at line 755 of file CSL_Core.cpp.

virtual bool csl::UnitGenerator::isFixed ( )

inlinevirtualinherited

query whether I'm fixed (StaticVariable overrides this)

Reimplemented in csl::StaticVariable, and csl::BinaryOp.

Definition at line 271 of file CSL_Core.h.

void UnitGenerator::addOutput ( UnitGenerator * ugen )

inherited

add to or return the UGen vector of outputs

Definition at line 670 of file CSL_Core.cpp.

References csl::Buffer::allocateBuffers(), csl::CGestalt::blockSize(), csl::UnitGenerator::mNumOutputs, csl::UnitGenerator::mOutputCache, and csl::UnitGenerator::mOutputs.

Referenced by addInput(), csl::Controllable::addInput(), csl::AmbisonicRotator::initialize(), csl::AmbisonicDecoder::initialize(), csl::AmbisonicEncoder::setInput(), and csl::IO::setRoot().

void UnitGenerator::removeOutput ( UnitGenerator * ugen )

inherited

Definition at line 680 of file CSL_Core.cpp.

References csl::UnitGenerator::mNumOutputs, and csl::UnitGenerator::mOutputs.

Referenced by csl::IO::clearRoot(), csl::AmbisonicEncoder::setInput(), csl::AmbisonicDecoder::~AmbisonicDecoder(), and csl::AmbisonicRotator::~AmbisonicRotator().

UGenVector csl::UnitGenerator::outputs ( )

inlineinherited

Definition at line 277 of file CSL_Core.h.

References csl::UnitGenerator::mOutputs.

virtual unsigned csl::UnitGenerator::numOutputs ( )

inlinevirtualinherited

Definition at line 278 of file CSL_Core.h.

References csl::UnitGenerator::mNumOutputs.

bool UnitGenerator::checkFanOut	(	Buffer &	outputBuffer	)
throw	(	CException
	)

inherited

check for fan-out and copy previous buffer; return true if fanning out

Definition at line 699 of file CSL_Core.cpp.

void UnitGenerator::handleFanOut	(	Buffer &	outputBuffer	)
throw	(	CException
	)

inherited

Definition at line 713 of file CSL_Core.cpp.

References csl_max.

virtual void csl::UnitGenerator::setValue ( sample theValue )

inlinevirtualinherited

set/get the value (not allowed in the abstract, useful for static values)

Reimplemented in csl::DynamicVariable, and csl::StaticVariable.

Definition at line 284 of file CSL_Core.h.

virtual sample csl::UnitGenerator::value ( )

inlinevirtualinherited

Reimplemented in csl::StaticVariable.

Definition at line 285 of file CSL_Core.h.

virtual void csl::UnitGenerator::trigger ( void )

inlinevirtualinherited

Reimplemented in csl::Joiner, csl::Effect, csl::RandEnvelope, csl::SoundCue, csl::Abst_SoundFile, csl::Envelope, csl::LineSegment, and csl::KarplusString.

Definition at line 288 of file CSL_Core.h.

Referenced by csl::Instrument::play(), csl::Instrument::release(), and csl::Port::trigger().

void UnitGenerator::zeroBuffer	(	Buffer &	outputBuffer,
		unsigned	outBufNum
	)

protectedinherited

utility method to zero out an outputBuffer

Definition at line 663 of file CSL_Core.cpp.

References csl::Buffer::buffer(), and csl::Buffer::mMonoBufferByteSize.

void Model::attachObserver ( Observer * o )

inherited

(possibly notify obersvers on my death)

register/remove observers

Definition at line 502 of file CGestalt.cpp.

References csl::logMsg(), csl::Observer::mKey, and csl::Observer::mPeriod.

Referenced by CSLMIDIComponent::CSLMIDIComponent(), and csl::SpatialPanner::setSpeakerLayout().

void Model::detachObserver ( Observer * o )

inherited

Definition at line 518 of file CGestalt.cpp.

References csl::logMsg().

Referenced by csl::SpatialPanner::setSpeakerLayout(), and csl::SpatialPanner::~SpatialPanner().

void Model::changed ( void * argument )

inherited

this is what I send to myself to notify my observers; It's not overridden in general. It results in the observers receiving update() calls < override evaluate to filter updates to the observer map

Definition at line 540 of file CGestalt.cpp.

References csl::logMsg().

Referenced by csl::SpeakerLayout::addSpeaker(), csl::MIDIIn::handleIncomingMidiMessage(), and csl::SpeakerLayout::setDefaultSpeakerLayout().

virtual int csl::Model::evaluate ( void * argument )

inlinevirtualinherited

Reimplemented in csl::MIDIIn.

Definition at line 270 of file CGestalt.h.

void Scalable::setScale ( UnitGenerator & scale )

inherited

set the receiver's scale member to a UGen or a float

Definition at line 1039 of file CSL_Core.cpp.

References csl::Controllable::addInput(), CSL_SCALE, and csl::logMsg().