JackIO is an IO that uses a thread and a timer to call its graph's nextBuffer(); it doesn't do anything with the resulting buffer, but assumes that other objects (observers of the graph) will handle some actual IO. More...

#include <JackIO.h>

Inheritance diagram for csl::JackIO:

Public Member Functions
	JackIO ()
	Constructor. More...

	JackIO (unsigned s_rate, unsigned b_size, int in_device=0, int out_device=0, unsigned in_chans=0, unsigned out_chans=2)

virtual	~JackIO ()

void	open () throw (CException)
	open/close start/stop methods More...

void	close () throw (CException)
	open/close start/stop methods More...

void	start () throw (CException)
	start my timer thread More...

void	stop () throw (CException)
	stop the timer thread More...

virtual void	test () throw (CException)

virtual void	capture_on (float dur)
	test the IO's graph More...

virtual void	capture_off ()
	end output capture More...

virtual Buffer *	get_capture ()
	answer the capture buffer More...

void	setRoot (UnitGenerator &root)
	set/clear my graph root generator More...

void	clearRoot ()

void	pullInput (Buffer &outBuffer, SampleBuffer out=0) throw (CException)
	get a buffer from the CSL graph More...

virtual Buffer &	getInput () throw (CException)
	Get the current input from the sound card. More...

virtual Buffer &	getInput (unsigned numFrames, unsigned numChannels) throw (CException)

unsigned	getAndIncrementSequence ()
	increment and answer my seq # More...

void	printTimeStatistics (struct timeval tthen, struct timeval tnow, long tsecond, long ttimeSum, long *ttimeVals)

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)

Public Attributes
jack_port_t *	mInput_port

jack_port_t *	mOutput_port

jack_client_t *	mClient

UnitGenerator *	mGraph
	the root of my client DSP graph, often a mixer or panner More...

Buffer	mInputBuffer
	the most recent input buffer (if it's turned on) More...

Buffer	mOutputBuffer
	the output buffer I use (passed to nextBuffer calls) More...

Buffer	mCaptureBuffer
	the output buffer I use for capturing output (for testing) More...

SampleBuffer	mInputPointer
	the buffer for holding the sound card input (if open) More...

unsigned *	mChannelMap
	the output channel remapping array More...

unsigned	mNumFramesPlayed
	counter of frames I've played More...

unsigned	mSequence
	sequence counter More...

unsigned	mLoggingPeriod
	logging period in seconds More...

unsigned	mNumInChannels
	inputs More...

unsigned	mNumOutChannels
	outputs More...

unsigned	mNumRealInChannels
	physical inputs More...

unsigned	mNumRealOutChannels
	physical outputs More...

IO_Status	mStatus
	status flag More...

bool	mInterleaved
	flag if IO is interleaved More...

unsigned	mOffset
	used for capture offset More...

struct timeval mThen	mNow
	used for getting the real time More...

long	mTimeVals

long	mThisSec

long	mTimeSum
	for printing run-time statistics More...

float	mUsage
	cpu usage % print the CPU usage message More...

Protected Member Functions
virtual void	initialize (unsigned sr, unsigned bs, int is, int os, unsigned ic, unsigned oc)
	initialize overridden in subclasses More...

Protected Attributes
float	maxSampEver

Detailed Description

JackIO is an IO that uses a thread and a timer to call its graph's nextBuffer(); it doesn't do anything with the resulting buffer, but assumes that other objects (observers of the graph) will handle some actual IO.

Definition at line 22 of file JackIO.h.

Constructor & Destructor Documentation

JackIO::JackIO ( )

Constructor.

Definition at line 41 of file JackIO.cpp.

JackIO::JackIO	(	unsigned	s_rate,
		unsigned	b_size,
		int	in_device = `0`,
		int	out_device = `0`,
		unsigned	in_chans = `0`,
		unsigned	out_chans = `2`
	)

Definition at line 45 of file JackIO.cpp.

JackIO::~JackIO ( )

virtual

Definition at line 52 of file JackIO.cpp.

Member Function Documentation

void JackIO::open	(		)
throw	(	CException
	)

virtual

open/close start/stop methods

< open/close start/stop methods

Reimplemented from csl::IO.

Definition at line 66 of file JackIO.cpp.

References jack_shutdown(), JackCallback(), csl::kLogError, csl::logMsg(), mClient, mInput_port, and mOutput_port.

void JackIO::close	(		)
throw	(	CException
	)

virtual

open/close start/stop methods

Reimplemented from csl::IO.

Definition at line 124 of file JackIO.cpp.

References mClient.

void JackIO::start	(		)
throw	(	CException
	)

virtual

start my timer thread

< start my timer thread

Reimplemented from csl::IO.

Definition at line 128 of file JackIO.cpp.

void JackIO::stop	(		)
throw	(	CException
	)

virtual

stop the timer thread

< stop the timer thread

Reimplemented from csl::IO.

Definition at line 131 of file JackIO.cpp.

virtual void csl::IO::test	(		)
throw	(	CException
	)

inlinevirtualinherited

Reimplemented in csl::FileIO, and csl::PAIO.

Definition at line 763 of file CSL_Core.h.

void IO::capture_on ( float dur )

virtualinherited

test the IO's graph

begin output capture

Definition at line 1536 of file CSL_Core.cpp.

References csl::Buffer::allocateBuffers(), csl::CGestalt::frameRateF(), csl::IO::mCaptureBuffer, csl::IO::mNumOutChannels, csl::IO::mOffset, and csl::Buffer::setSize().

Referenced by test_convolution_file().

void IO::capture_off ( )

virtualinherited

end output capture

Definition at line 1544 of file CSL_Core.cpp.

References csl::IO::mCaptureBuffer, and csl::Buffer::setSize().

Referenced by test_convolution_file().

Buffer * IO::get_capture ( )

virtualinherited

answer the capture buffer

Definition at line 1550 of file CSL_Core.cpp.

References csl::IO::mCaptureBuffer.

Referenced by test_convolution_file().

void IO::setRoot ( UnitGenerator & root )

inherited

set/clear my graph root generator

Definition at line 1405 of file CSL_Core.cpp.

References csl::UnitGenerator::addOutput(), and csl::IO::mGraph.

Referenced by main(), oscServer(), playSineMixer(), test_Ambi_horiz(), test_Binaural_horiz(), test_Binaural_vertAxial(), test_Binaural_vertMedian(), test_convolution(), test_convolution_file(), test_SimpleP(), test_VBAP_horiz(), testMultiTap(), testReverb(), testSndFileBank(), testSoundFileTranspose(), testStereoverb(), testStringChorus(), and csl::VSTIO::VSTIO().

void IO::clearRoot ( )

inherited

void IO::pullInput	(	Buffer &	outBuffer,
		SampleBuffer	out = `0`
	)
throw	(	CException
	)

inherited

get a buffer from the CSL graph

Definition at line 1425 of file CSL_Core.cpp.

References GET_TIME, csl::kLogError, csl::logMsg(), and csl::CException::mMessage.

Referenced by csl::JUCEIO::audioDeviceIOCallback(), CSLServerComponent::audioDeviceIOCallback(), CSLMIDIComponent::audioDeviceIOCallback(), CSLAbstComponent::audioDeviceIOCallback(), CSLComponent::audioDeviceIOCallback(), csl::NullIO::FeederFunction(), csl::StdIO::FeederFunction(), JackCallback(), pa_callback(), csl::VSTIO::processReplacing(), and RenderCallback().

Buffer & IO::getInput	(		)
throw	(	CException
	)

virtualinherited

Get the current input from the sound card.

Reimplemented in csl::FileIO, csl::AUIO, csl::AUIO, and csl::NullIO.

Definition at line 1517 of file CSL_Core.cpp.

References csl::IO::mInputBuffer, csl::Buffer::mNumChannels, and csl::Buffer::mNumFrames.

Buffer & IO::getInput	(	unsigned	numFrames,
		unsigned	numChannels
	)
throw	(	CException
	)

virtualinherited

Reimplemented in csl::FileIO, csl::AUIO, csl::AUIO, and csl::NullIO.

Definition at line 1523 of file CSL_Core.cpp.

References csl::Interleaver::deinterleave(), and mNumInChannels.

unsigned IO::getAndIncrementSequence ( )

inherited

increment and answer my seq #

Definition at line 1418 of file CSL_Core.cpp.

References csl::IO::mSequence.

void IO::printTimeStatistics	(	struct timeval *	tthen,
		struct timeval *	tnow,
		long *	tsecond,
		long *	ttimeSum,
		long *	ttimeVals
	)

inherited

Definition at line 1486 of file CSL_Core.cpp.

References csl::CGestalt::blockSize(), csl::CGestalt::frameRateF(), csl::logMsg(), csl::IO::maxSampEver, csl::IO::mLoggingPeriod, csl::IO::mUsage, and SUB_TIMES.

Referenced by csl::FileIO::threadFunction().

virtual void csl::IO::initialize	(	unsigned	sr,
		unsigned	bs,
		int	is,
		int	os,
		unsigned	ic,
		unsigned	oc
	)

inlineprotectedvirtualinherited

initialize overridden in subclasses

Reimplemented in csl::PAIO.

Definition at line 805 of file CSL_Core.h.

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.