CLAM-Development  1.4.0
Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes
CLAM::MultiChannelAudioFileReader Class Reference

#include <MultiChannelAudioFileReader.hxx>

List of all members.

Public Member Functions

 MultiChannelAudioFileReader ()
 MultiChannelAudioFileReader (const ProcessingConfig &cfg)
 ~MultiChannelAudioFileReader ()
virtual const char * GetClassName () const
 Override it in every subclass and retur the name of that class.
virtual const ProcessingConfigGetConfig () const
 Configuration getter.
virtual bool Do ()
 Supervised mode execution method (using ports)
virtual bool Do (std::vector< Audio > &outputs)
bool ModifiesPortsAndControlsAtConfiguration ()
 This method is used to determine if a given processing can change its interface of ports/controls after its construction (i.e.
const AudioFileHeaderGetHeader () const
const AudioTextDescriptorsGetTextDescriptors () const
const EAudioFileCodec GetCodec () const
const std::vector< TIndex > & GetSelectedChannels () const
void Pause ()
- Public Member Functions inherited from CLAM::Processing
bool Configure (const ProcessingConfig &config)
 Configuration change method.
void Start (void)
 Method to turn the object into running state.
void Stop (void)
 Method to put the object out of running state When in execution mode, this method must be called before any further call to Configure() methods.
 Processing ()
virtual ~Processing ()
virtual bool CanProcessInplace ()
 Override this method if your processing cannot process inplace.
bool CanConsumeAndProduce ()
 Check that Supervised Do() can be safely called.
void ConsumeAndProduce ()
 Acknoledges data tokens in published ports as read/writen by calling Produce() for all registered OutPorts and Consume() to all registered InPorts.
std::string GetExecStateString () const
bool IsConfigured () const
bool IsRunning () const
void RegisterOutPort (OutPortBase *out)
void RegisterInPort (InPortBase *in)
void RegisterOutControl (OutControlBase *out)
void RegisterInControl (InControlBase *in)
void SetParent (Processing *p)
void SetNetworkBackLink (Network *network)
bool HasInPort (const std::string &name)
bool HasOutPort (const std::string &name)
bool HasInControl (const std::string &name)
bool HasOutControl (const std::string &name)
InPortBaseGetInPort (const std::string &name)
OutPortBaseGetOutPort (const std::string &name)
InControlBaseGetInControl (const std::string &name)
OutControlBaseGetOutControl (const std::string &name)
InPortBaseGetInPort (unsigned index)
OutPortBaseGetOutPort (unsigned index)
InControlBaseGetInControl (unsigned index)
OutControlBaseGetOutControl (unsigned index)
unsigned GetNInPorts () const
unsigned GetNOutPorts () const
unsigned GetNInControls () const
unsigned GetNOutControls () const
const std::string & GetConfigErrorMessage () const
 Returns a string describing configuration errors if any.
virtual bool IsSyncSource () const
 Wether the processing is a sync source such as audio i/o device, or an audio callback hook (i.e.
virtual bool SupportsVariableAudioSize () const
 This method reports whether the processing supports dynamic buffer-size host.

Protected Types

typedef std::vector
< AudioOutPort * > 
OutputVector
typedef std::vector< Audio * > OutRefsVector

Protected Member Functions

virtual bool ConcreteConfigure (const ProcessingConfig &cfgObject)
 Configuration method interface.
virtual bool ConcreteStart ()
 Processing objects have to redefine this method when starting them implies some internal changes.
virtual bool ConcreteStop ()
 Processing objects have to redefine this method when stoping them implies some internal changes.
void ResizePorts (unsigned nPorts)
- Protected Member Functions inherited from CLAM::Processing
unsigned BackendBufferSize ()
 Given by the NetworkPlayer (backend) if exists.
unsigned BackendSampleRate ()
 Given by the NetworkPlayer (backend) if exists.
InControlRegistryGetInControls ()
 Accessor to published Controls manager.
OutControlRegistryGetOutControls ()
 Accessor to published Controls manager.
InPortRegistryGetInPorts ()
 Accessor to published Ports manager.
OutPortRegistryGetOutPorts ()
 Accessor to published Portss manager.
bool AddConfigErrorMessage (const std::string &msg)
 Use this method to append a configuration errors to the processing when implementing ConcreteConfigure.
bool AbleToExecute (void) const
 In debug-mode checks that the processing is configured and started.
template<typename ConcreteConfig >
void CopyAsConcreteConfig (ConcreteConfig &concrete, const ProcessingConfig &abstract) const
 Helper template to convert a reference to a ProcessingConfig to the concrete ProcessingConfig specified on the first parameter.
void SetExecState (ExecState state)

Protected Attributes

MultiChannelAudioFileReaderConfig mConfig
OutputVector _outputs
FloatOutControl mTimeOutput
std::vector< TIndexmSelectedChannels
std::vector< TData * > mSamplesMatrix
AudioCodecs::StreammNativeStream
TTime mCurrentBeginTime
TTime mDeltaTime
bool mEOFReached
bool mIsPaused
AudioFileSource mAudioFile
- Protected Attributes inherited from CLAM::Processing
ProcessingCompositempParent
 Pointer to the parent (composite) processing object, or 0.
Network_network
 The parent network if any.

Additional Inherited Members

- Public Types inherited from CLAM::Processing
enum  ExecState { Unconfigured = 0, Ready, Running }
 Processing Object possible execution states. More...
typedef NullProcessingConfig Config

Detailed Description

Definition at line 37 of file MultiChannelAudioFileReader.hxx.


Member Typedef Documentation

Definition at line 67 of file MultiChannelAudioFileReader.hxx.

typedef std::vector< Audio* > CLAM::MultiChannelAudioFileReader::OutRefsVector
protected

Definition at line 68 of file MultiChannelAudioFileReader.hxx.


Constructor & Destructor Documentation

CLAM::MultiChannelAudioFileReader::MultiChannelAudioFileReader ( )

Definition at line 43 of file MultiChannelAudioFileReader.cxx.

References CLAM::Processing::Configure().

CLAM::MultiChannelAudioFileReader::MultiChannelAudioFileReader ( const ProcessingConfig cfg)

Definition at line 50 of file MultiChannelAudioFileReader.cxx.

References CLAM::Processing::Configure().

CLAM::MultiChannelAudioFileReader::~MultiChannelAudioFileReader ( )

Definition at line 57 of file MultiChannelAudioFileReader.cxx.

References mNativeStream, and ResizePorts().


Member Function Documentation

bool CLAM::MultiChannelAudioFileReader::ConcreteConfigure ( const ProcessingConfig )
protectedvirtual

Configuration method interface.

The Processing base class forces all the concrete classes derived from it to implement this method, which must actually perform the specific configuration tasks.

Note that the user can not call this method directly. He will use Configure instead. The argument is expected to be an object of the necesary concrete configuration class.

Parameters:
Referenceto the configuration object.
Returns:
false if the object is not yet fully configured. (For example, if some important configuration attribute such as number of ports was set to zero in the config object)

true if the processing object is left in a consistent state, and can be executed.

Exceptions:
Thismethod must throw a bad_cast exception if the argument is not an object of the expected configuration class.

Reimplemented from CLAM::Processing.

Definition at line 240 of file MultiChannelAudioFileReader.cxx.

References _outputs, CLAM::Processing::AddConfigErrorMessage(), CLAM::Processing::CopyAsConcreteConfig(), CLAM::AudioFile::GetHeader(), CLAM::Array< T >::GetPtr(), CLAM::AudioFile::GetStream(), CLAM::AudioFile::IsReadable(), mAudioFile, mConfig, mNativeStream, mSamplesMatrix, mSelectedChannels, CLAM::AudioFileSource::OpenExisting(), ResizePorts(), and CLAM::Array< T >::Size().

bool CLAM::MultiChannelAudioFileReader::ConcreteStart ( void  )
protectedvirtual

Processing objects have to redefine this method when starting them implies some internal changes.

ie: adquiring resources.

Returns:
Whether start changes have been successful

Reimplemented from CLAM::Processing.

Definition at line 326 of file MultiChannelAudioFileReader.cxx.

References CLAM::AudioFile::GetStream(), mAudioFile, mCurrentBeginTime, mEOFReached, mIsPaused, mNativeStream, NULL, and CLAM::AudioCodecs::Stream::PrepareReading().

bool CLAM::MultiChannelAudioFileReader::ConcreteStop ( )
protectedvirtual

Processing objects have to redefine this method when stoping them implies some internal changes.

ie: releasing resources.

Returns:
Whether stop changes have been successful

Reimplemented from CLAM::Processing.

Definition at line 338 of file MultiChannelAudioFileReader.cxx.

References CLAM::AudioCodecs::Stream::Dispose(), mNativeStream, and NULL.

bool CLAM::MultiChannelAudioFileReader::Do ( )
virtual
bool CLAM::MultiChannelAudioFileReader::Do ( std::vector< Audio > &  outputs)
virtual
const char * CLAM::MultiChannelAudioFileReader::GetClassName ( ) const
virtual

Override it in every subclass and retur the name of that class.

Implements CLAM::Processing.

Definition at line 64 of file MultiChannelAudioFileReader.cxx.

const EAudioFileCodec CLAM::MultiChannelAudioFileReader::GetCodec ( ) const
inline

Definition at line 52 of file MultiChannelAudioFileReader.hxx.

References CLAM::AudioFile::GetCodec(), and mAudioFile.

const ProcessingConfig & CLAM::MultiChannelAudioFileReader::GetConfig ( ) const
virtual

Configuration getter.

Gets the configuration parameters used to create the object.

Returns:
Const reference to the configuration object. The usual way to perform a configuration change in the processing object is to take a copy of this reference, to change it and to send it with the Configure method. If not overriden, it returns a NullProcessingConfig.

Reimplemented from CLAM::Processing.

Definition at line 74 of file MultiChannelAudioFileReader.cxx.

References mConfig.

const AudioFileHeader& CLAM::MultiChannelAudioFileReader::GetHeader ( ) const
inline

Definition at line 50 of file MultiChannelAudioFileReader.hxx.

References CLAM::AudioFile::GetHeader(), and mAudioFile.

Referenced by Do().

const std::vector<TIndex>& CLAM::MultiChannelAudioFileReader::GetSelectedChannels ( ) const
inline

Definition at line 53 of file MultiChannelAudioFileReader.hxx.

References mSelectedChannels.

const AudioTextDescriptors& CLAM::MultiChannelAudioFileReader::GetTextDescriptors ( ) const
inline
bool CLAM::MultiChannelAudioFileReader::ModifiesPortsAndControlsAtConfiguration ( )
virtual

This method is used to determine if a given processing can change its interface of ports/controls after its construction (i.e.

changing the name of ports in ConcreteConfigure). If a concrete processing can do this, it should reimplement the method returning true, in order to notify networks, graphical interfaces, etc.

Reimplemented from CLAM::Processing.

Definition at line 69 of file MultiChannelAudioFileReader.cxx.

void CLAM::MultiChannelAudioFileReader::Pause ( )
inline

Definition at line 55 of file MultiChannelAudioFileReader.hxx.

References mIsPaused.

void CLAM::MultiChannelAudioFileReader::ResizePorts ( unsigned  nPorts)
protected

Definition at line 346 of file MultiChannelAudioFileReader.cxx.

References _outputs.

Referenced by ConcreteConfigure(), and ~MultiChannelAudioFileReader().


Member Data Documentation

OutputVector CLAM::MultiChannelAudioFileReader::_outputs
protected

Definition at line 71 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteConfigure(), Do(), and ResizePorts().

AudioFileSource CLAM::MultiChannelAudioFileReader::mAudioFile
protected
MultiChannelAudioFileReaderConfig CLAM::MultiChannelAudioFileReader::mConfig
protected

Definition at line 70 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteConfigure(), and GetConfig().

TTime CLAM::MultiChannelAudioFileReader::mCurrentBeginTime
protected

Definition at line 76 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteStart(), and Do().

TTime CLAM::MultiChannelAudioFileReader::mDeltaTime
protected

Definition at line 77 of file MultiChannelAudioFileReader.hxx.

Referenced by Do().

bool CLAM::MultiChannelAudioFileReader::mEOFReached
protected

Definition at line 78 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteStart(), and Do().

bool CLAM::MultiChannelAudioFileReader::mIsPaused
protected

Definition at line 79 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteStart(), Do(), and Pause().

AudioCodecs::Stream* CLAM::MultiChannelAudioFileReader::mNativeStream
protected
std::vector< TData* > CLAM::MultiChannelAudioFileReader::mSamplesMatrix
protected

Definition at line 74 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteConfigure(), and Do().

std::vector< TIndex > CLAM::MultiChannelAudioFileReader::mSelectedChannels
protected

Definition at line 73 of file MultiChannelAudioFileReader.hxx.

Referenced by ConcreteConfigure(), Do(), and GetSelectedChannels().

FloatOutControl CLAM::MultiChannelAudioFileReader::mTimeOutput
protected

Definition at line 72 of file MultiChannelAudioFileReader.hxx.

Referenced by Do().


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