CSL  6.0
csl::AmbisonicUnitGenerator Class Reference

Ambisonic Abstract Base Class. More...

#include <Ambisonic.h>

+ Inheritance diagram for csl::AmbisonicUnitGenerator:

Public Member Functions

 AmbisonicUnitGenerator (unsigned order=0)
 Initialize with uniform Ambisonic order. Defaults to zeroth order. More...
 
 AmbisonicUnitGenerator (unsigned horder, unsigned vorder)
 Initialize with hybrid Ambisonic order. More...
 
 AmbisonicUnitGenerator (AmbisonicOrder order)
 
virtual ~AmbisonicUnitGenerator ()
 
AmbisonicOrder order ()
 
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) throw (CException)
 get a buffer of Frames – this is the core CSL "pull" function; the given buffer can be written into, and a changed() message is sent. 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...
 
virtual bool isActive ()
 query whether I'm currently active (Envelopes can go inactive) 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 dump ()
 pretty-print the receiver More...
 
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)
 

Protected Member Functions

void setOrder (AmbisonicOrder order)
 Returns the Ambisonic order. More...
 
unsigned channelsToUniformOrder (const unsigned channels)
 
unsigned greaterOrder (const AmbisonicOrder order)
 Compares the horizontal and vertical Ambisonic order of a hybrid order and returns the largest. More...
 
unsigned orderToChannels (const AmbisonicOrder order)
 Returns the number of Ambisonic channels from a hybrid Ambisonic order: N = 2*M_h + 1 + (M_v + 1)^2 - (2*M_v + 1) More...
 
unsigned orderToChannels (unsigned order)
 Returns the number of Ambisonic channels corresponding to a uniform Ambisonic order: N = (M+1)^2. More...
 
unsigned orderToHorizontalChannels (const AmbisonicOrder order)
 Returns the number of horizontal Ambisonic channels from a hybrid Ambisonic order: N_h = 2*M_h + 1. More...
 
unsigned orderToVerticalChannels (const AmbisonicOrder order)
 Returns the number of vertical Ambisonic channels from a hybrid Ambisonic order: N_v = (M_v + 1)^2 - (2*M_v + 1) More...
 
void channelIndexer (unsigned *indexArray)
 Calculates a lookup table to map Ambisonic channel index to actually used UnitGenerator channel. More...
 
void invChannelIndexer (unsigned *indexArray)
 Calculates a lookup table to map actually used UnitGenerator channel to Ambisonic channel index. More...
 
void zeroBuffer (Buffer &outputBuffer, unsigned outBufNum)
 utility method to zero out an outputBuffer More...
 

Protected Attributes

AmbisonicOrder mOrder
 the order of the Unit Generator 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...
 
BuffermOutputCache
 my past output ring buffer (only used in case of fan-out) More...
 
unsigned mSequence
 the highest-seen buffer seq number More...
 

Private Member Functions

void initOrder ()
 

Related Functions

(Note that these are not member functions.)

void singularValueDecomposition (sample **a, int m, int n, sample *w, sample **v)
 
void fumaEncodingWeights (SampleBuffer weights, const AmbisonicOrder &order, float azimuth, float elevation)
 
void fumaIndexedEncodingWeights (SampleBuffer weights, const AmbisonicOrder &order, sample &azimuth, sample &elevation)
 

Detailed Description

Ambisonic Abstract Base Class.

Definition at line 69 of file Ambisonic.h.

Constructor & Destructor Documentation

AmbisonicUnitGenerator::AmbisonicUnitGenerator ( unsigned  order = 0)

Initialize with uniform Ambisonic order. Defaults to zeroth order.

Definition at line 34 of file Ambisonic.cpp.

References initOrder().

AmbisonicUnitGenerator::AmbisonicUnitGenerator ( unsigned  horder,
unsigned  vorder 
)

Initialize with hybrid Ambisonic order.

Definition at line 38 of file Ambisonic.cpp.

References initOrder(), mOrder, and csl::AmbisonicOrder::verticalOrder.

AmbisonicUnitGenerator::AmbisonicUnitGenerator ( AmbisonicOrder  order)

Definition at line 43 of file Ambisonic.cpp.

References initOrder().

AmbisonicUnitGenerator::~AmbisonicUnitGenerator ( )
virtual

Definition at line 47 of file Ambisonic.cpp.

Member Function Documentation

AmbisonicOrder csl::AmbisonicUnitGenerator::order ( )
inline
void AmbisonicUnitGenerator::setOrder ( AmbisonicOrder  order)
protected

Returns the Ambisonic order.

Definition at line 59 of file Ambisonic.cpp.

References initOrder(), and mOrder.

unsigned AmbisonicUnitGenerator::channelsToUniformOrder ( const unsigned  channels)
protected
unsigned AmbisonicUnitGenerator::greaterOrder ( const AmbisonicOrder  order)
protected

Compares the horizontal and vertical Ambisonic order of a hybrid order and returns the largest.

Definition at line 71 of file Ambisonic.cpp.

References csl::AmbisonicOrder::horizontalOrder, and csl::AmbisonicOrder::verticalOrder.

Referenced by channelIndexer(), csl::AmbisonicRotator::initialize(), csl::AmbisonicDecoder::initialize(), and csl::AmbisonicDecoder::makeMaxRE().

unsigned AmbisonicUnitGenerator::orderToChannels ( const AmbisonicOrder  order)
protected

Returns the number of Ambisonic channels from a hybrid Ambisonic order: N = 2*M_h + 1 + (M_v + 1)^2 - (2*M_v + 1)

Definition at line 75 of file Ambisonic.cpp.

References csl::AmbisonicOrder::horizontalOrder, and csl::AmbisonicOrder::verticalOrder.

Referenced by channelIndexer(), csl::AmbisonicRotator::initialize(), csl::AmbisonicDecoder::initialize(), initOrder(), and invChannelIndexer().

unsigned AmbisonicUnitGenerator::orderToChannels ( unsigned  order)
protected

Returns the number of Ambisonic channels corresponding to a uniform Ambisonic order: N = (M+1)^2.

Definition at line 80 of file Ambisonic.cpp.

unsigned AmbisonicUnitGenerator::orderToHorizontalChannels ( const AmbisonicOrder  order)
protected

Returns the number of horizontal Ambisonic channels from a hybrid Ambisonic order: N_h = 2*M_h + 1.

Definition at line 85 of file Ambisonic.cpp.

References csl::AmbisonicOrder::horizontalOrder.

unsigned AmbisonicUnitGenerator::orderToVerticalChannels ( const AmbisonicOrder  order)
protected

Returns the number of vertical Ambisonic channels from a hybrid Ambisonic order: N_v = (M_v + 1)^2 - (2*M_v + 1)

Definition at line 90 of file Ambisonic.cpp.

References csl::AmbisonicOrder::verticalOrder.

void AmbisonicUnitGenerator::channelIndexer ( unsigned *  indexArray)
protected

Calculates a lookup table to map Ambisonic channel index to actually used UnitGenerator channel.

Definition at line 98 of file Ambisonic.cpp.

References greaterOrder(), csl::AmbisonicOrder::horizontalOrder, mOrder, orderToChannels(), and csl::AmbisonicOrder::verticalOrder.

Referenced by csl::AmbisonicRotator::initialize(), and csl::AmbisonicDecoder::initialize().

void AmbisonicUnitGenerator::invChannelIndexer ( unsigned *  indexArray)
protected

Calculates a lookup table to map actually used UnitGenerator channel to Ambisonic channel index.

Definition at line 146 of file Ambisonic.cpp.

References csl::AmbisonicOrder::horizontalOrder, mOrder, orderToChannels(), and csl::AmbisonicOrder::verticalOrder.

Referenced by csl::AmbisonicDecoder::initialize().

unsigned csl::UnitGenerator::frameRate ( )
inlineinherited
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.

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
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.

virtual bool csl::UnitGenerator::isActive ( )
inlinevirtualinherited
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
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
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.

Friends And Related Function Documentation

void singularValueDecomposition ( sample **  a,
int  m,
int  n,
sample w,
sample **  v 
)
related

Given a matrix a[m][n], this routine computes its singular value decomposition, A = U*W*V^{T}. The matrix U replaces a on output. The diagonal matrix of singular values W is output as a vector w[n]. The matrix V (not the transpose V^{T}) is output as v[n][n]. m must be greater or equal to n; if it is smaller, then a should be filled up to square with zero rows.

Definition at line 630 of file AmbisonicUtilities.cpp.

References MAX, PYTHAG, and SIGN.

Referenced by csl::AmbisonicDecoder::asPseudoInverse().

void fumaEncodingWeights ( SampleBuffer  weights,
const AmbisonicOrder order,
float  azimuth,
float  elevation 
)
related
void fumaIndexedEncodingWeights ( SampleBuffer  weights,
const AmbisonicOrder order,
sample azimuth,
sample elevation 
)
related

Member Data Documentation

BufferCopyPolicy csl::UnitGenerator::mCopyPolicy
protectedinherited

the policy I use if asked for more or fewer channels

Definition at line 293 of file CSL_Core.h.

Referenced by csl::UnitGenerator::copyPolicy(), and csl::UnitGenerator::setCopyPolicy().

UGenVector csl::UnitGenerator::mOutputs
protectedinherited
unsigned csl::UnitGenerator::mNumOutputs
protectedinherited

the number of outputs

Definition at line 295 of file CSL_Core.h.

Referenced by csl::UnitGenerator::addOutput(), csl::UnitGenerator::numOutputs(), and csl::UnitGenerator::removeOutput().

Buffer* csl::UnitGenerator::mOutputCache
protectedinherited

my past output ring buffer (only used in case of fan-out)

Definition at line 296 of file CSL_Core.h.

Referenced by csl::UnitGenerator::addOutput().

unsigned csl::UnitGenerator::mSequence
protectedinherited

the highest-seen buffer seq number

Definition at line 297 of file CSL_Core.h.


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