CSL  6.0
csl::AmbisonicRotator Class Reference

#include <AmbisonicUtilities.h>

+ Inheritance diagram for csl::AmbisonicRotator:

Public Member Functions

 AmbisonicRotator (AmbisonicUnitGenerator &input)
 initializes with no rotation More...
 
 AmbisonicRotator (UnitGenerator &input, unsigned order)
 initializes with uniform Ambisonic order and no rotation More...
 
 AmbisonicRotator (UnitGenerator &input, unsigned vorder, unsigned horder)
 initializes with hybrid Ambisonic order and no rotation More...
 
 ~AmbisonicRotator ()
 
void setNthInput (float amount, Axes axis)
 
void setTilt (float amount)
 
void setTumble (float amount)
 
void setRotate (float amount)
 
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...
 
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 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

unsigned mNumFrames
 
unsigned mGreaterOrder
 
unsigned mNumChannelsGreaterOrder
 
unsigned * mChannelIndex
 
unsigned * mInputChannelIndex
 
bool mShouldRotate
 
bool mShouldTurn
 
bool mShouldTilt
 
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 initialize (UnitGenerator &input)
 
void tiltFirstOrder ()
 
void tiltSecondOrder ()
 
void tiltThirdOrder ()
 
void tumbleFirstOrder ()
 
void tumbleSecondOrder ()
 
void tumbleThirdOrder ()
 
void rotateZerothOrder ()
 
void rotateFirstOrderHorizontal ()
 
void rotateSecondOrderHorizontal ()
 
void rotateThirdOrderHorizontal ()
 
void rotateFirstOrderVertical ()
 
void rotateSecondOrderVertical ()
 
void rotateThirdOrderVertical ()
 

Private Attributes

PortmInputPort
 
sample mRotate
 
sample mTumble
 
sample mTilt
 
SampleBuffer mSinAngle
 
SampleBuffer mCosAngle
 
SampleBufferVector mOutPtr
 
SampleBufferVector mInPtr
 

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

Definition at line 84 of file AmbisonicUtilities.h.

Constructor & Destructor Documentation

AmbisonicRotator::AmbisonicRotator ( AmbisonicUnitGenerator input)

initializes with no rotation

Definition at line 146 of file AmbisonicUtilities.cpp.

References initialize().

AmbisonicRotator::AmbisonicRotator ( UnitGenerator input,
unsigned  order 
)

initializes with uniform Ambisonic order and no rotation

Definition at line 151 of file AmbisonicUtilities.cpp.

References initialize().

AmbisonicRotator::AmbisonicRotator ( UnitGenerator input,
unsigned  vorder,
unsigned  horder 
)

initializes with hybrid Ambisonic order and no rotation

Definition at line 156 of file AmbisonicUtilities.cpp.

References initialize().

Member Function Documentation

void AmbisonicRotator::setNthInput ( float  amount,
Axes  axis 
)
void AmbisonicRotator::setTilt ( float  amount)
void AmbisonicRotator::setTumble ( float  amount)
void AmbisonicRotator::setRotate ( float  amount)

Definition at line 282 of file AmbisonicUtilities.cpp.

References mRotate, and mShouldRotate.

Referenced by csl::AmbisonicPanner::rotate(), and setNthInput().

void AmbisonicRotator::nextBuffer ( Buffer outputBuffer,
unsigned  outBufNum 
)
throw (CException
)
virtual

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

Reimplemented from csl::UnitGenerator.

Definition at line 297 of file AmbisonicUtilities.cpp.

References csl::Buffer::buffer(), csl::kLogError, csl::kSamples, csl::logMsg(), csl::Buffer::mIsPopulated, csl::Buffer::mNumFrames, and csl::Buffer::mType.

void AmbisonicRotator::tiltFirstOrder ( )
private

Definition at line 397 of file AmbisonicUtilities.cpp.

References mCosAngle, mNumFrames, mOutPtr, and mSinAngle.

void AmbisonicRotator::tiltSecondOrder ( )
private
void AmbisonicRotator::tiltThirdOrder ( )
private

Definition at line 434 of file AmbisonicUtilities.cpp.

References mCosAngle, mNumFrames, mOutPtr, and mSinAngle.

Referenced by tiltSecondOrder().

void AmbisonicRotator::tumbleFirstOrder ( )
private

Definition at line 461 of file AmbisonicUtilities.cpp.

References mCosAngle, mNumFrames, mOutPtr, and mSinAngle.

void AmbisonicRotator::tumbleSecondOrder ( )
private
void AmbisonicRotator::tumbleThirdOrder ( )
private

Definition at line 494 of file AmbisonicUtilities.cpp.

References mCosAngle, mNumFrames, mOutPtr, and mSinAngle.

Referenced by tumbleSecondOrder().

void csl::AmbisonicRotator::rotateZerothOrder ( )
private
void AmbisonicRotator::rotateFirstOrderHorizontal ( )
private
void AmbisonicRotator::rotateSecondOrderHorizontal ( )
private
void AmbisonicRotator::rotateThirdOrderHorizontal ( )
private

Definition at line 567 of file AmbisonicUtilities.cpp.

References mCosAngle, mNumFrames, mOutPtr, and mSinAngle.

Referenced by rotateSecondOrderHorizontal().

void csl::AmbisonicRotator::rotateFirstOrderVertical ( )
private
void AmbisonicRotator::rotateSecondOrderVertical ( )
private
void AmbisonicRotator::rotateThirdOrderVertical ( )
private

Definition at line 583 of file AmbisonicUtilities.cpp.

References mCosAngle, mNumFrames, mOutPtr, and mSinAngle.

Referenced by rotateSecondOrderVertical().

AmbisonicOrder csl::AmbisonicUnitGenerator::order ( )
inlineinherited
void AmbisonicUnitGenerator::setOrder ( AmbisonicOrder  order)
protectedinherited

Returns the Ambisonic order.

Definition at line 59 of file Ambisonic.cpp.

References csl::AmbisonicUnitGenerator::initOrder(), and csl::AmbisonicUnitGenerator::mOrder.

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

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 csl::AmbisonicUnitGenerator::channelIndexer(), initialize(), csl::AmbisonicDecoder::initialize(), and csl::AmbisonicDecoder::makeMaxRE().

unsigned AmbisonicUnitGenerator::orderToChannels ( const AmbisonicOrder  order)
protectedinherited

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 csl::AmbisonicUnitGenerator::channelIndexer(), initialize(), csl::AmbisonicDecoder::initialize(), csl::AmbisonicUnitGenerator::initOrder(), and csl::AmbisonicUnitGenerator::invChannelIndexer().

unsigned AmbisonicUnitGenerator::orderToChannels ( unsigned  order)
protectedinherited

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)
protectedinherited

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)
protectedinherited

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)
protectedinherited
void AmbisonicUnitGenerator::invChannelIndexer ( unsigned *  indexArray)
protectedinherited

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, csl::AmbisonicUnitGenerator::mOrder, csl::AmbisonicUnitGenerator::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

unsigned csl::AmbisonicRotator::mGreaterOrder
protected

Definition at line 108 of file AmbisonicUtilities.h.

Referenced by initialize(), tiltSecondOrder(), and tumbleSecondOrder().

unsigned csl::AmbisonicRotator::mNumChannelsGreaterOrder
protected

Definition at line 109 of file AmbisonicUtilities.h.

Referenced by initialize().

unsigned* csl::AmbisonicRotator::mChannelIndex
protected

Definition at line 110 of file AmbisonicUtilities.h.

Referenced by initialize(), and ~AmbisonicRotator().

unsigned* csl::AmbisonicRotator::mInputChannelIndex
protected

Definition at line 111 of file AmbisonicUtilities.h.

Referenced by initialize(), and ~AmbisonicRotator().

bool csl::AmbisonicRotator::mShouldRotate
protected

Definition at line 112 of file AmbisonicUtilities.h.

Referenced by initialize(), and setRotate().

bool csl::AmbisonicRotator::mShouldTurn
protected

Definition at line 112 of file AmbisonicUtilities.h.

Referenced by initialize(), and setTumble().

bool csl::AmbisonicRotator::mShouldTilt
protected

Definition at line 112 of file AmbisonicUtilities.h.

Referenced by initialize(), and setTilt().

Port* csl::AmbisonicRotator::mInputPort
private

Definition at line 115 of file AmbisonicUtilities.h.

Referenced by initialize(), and ~AmbisonicRotator().

sample csl::AmbisonicRotator::mRotate
private

Definition at line 117 of file AmbisonicUtilities.h.

Referenced by setRotate().

sample csl::AmbisonicRotator::mTumble
private

Definition at line 117 of file AmbisonicUtilities.h.

Referenced by setTumble().

sample csl::AmbisonicRotator::mTilt
private

Definition at line 117 of file AmbisonicUtilities.h.

Referenced by setTilt().

SampleBufferVector csl::AmbisonicRotator::mInPtr
private

Definition at line 119 of file AmbisonicUtilities.h.

Referenced by initialize(), and ~AmbisonicRotator().

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: