This device plays back through JACK. More...

#include <JackDevice.h>

Inheritance diagram for JackDevice:

[legend]

Public Member Functions
	JackDevice (std::string name, DeviceSpecs specs, int buffersize=AUD_DEFAULT_BUFFER_SIZE)
	Creates a JACK client for audio output.

virtual	~JackDevice ()
	Closes the JACK client.

virtual ISynchronizer *	getSynchronizer ()
	Retrieves the synchronizer for this device, which enables accurate synchronization between audio playback and video playback for example.

void	startPlayback ()
	Starts jack transport playback.

void	stopPlayback ()
	Stops jack transport playback.

void	seekPlayback (double time)
	Seeks jack transport playback.

void	setSyncCallback (ISynchronizer::syncFunction sync, void *data)
	Sets the sync callback for jack transport playback.

double	getPlaybackPosition ()
	Retrieves the jack transport playback time.

bool	doesPlayback ()
	Returns whether jack transport plays back.

Public Member Functions inherited from SoftwareDevice
void	setQuality (bool quality)
	Sets the resampling quality.

virtual DeviceSpecs	getSpecs () const
	Returns the specification of the device.

virtual std::shared_ptr< IHandle >	play (std::shared_ptr< IReader > reader, bool keep=false)
	Plays a sound source.

virtual std::shared_ptr< IHandle >	play (std::shared_ptr< ISound > sound, bool keep=false)
	Plays a sound source.

virtual void	stopAll ()
	Stops all playing sounds.

virtual void	lock ()
	Locks the device.

virtual void	unlock ()
	Unlocks the previously locked device.

virtual float	getVolume () const
	Retrieves the overall device volume.

virtual void	setVolume (float volume)
	Sets the overall device volume.

virtual ISynchronizer *	getSynchronizer ()
	Retrieves the synchronizer for this device, which enables accurate synchronization between audio playback and video playback for example.

virtual Vector3	getListenerLocation () const
	Retrieves the listener location.

virtual void	setListenerLocation (const Vector3 &location)
	Sets the listener location.

virtual Vector3	getListenerVelocity () const
	Retrieves the listener velocity.

virtual void	setListenerVelocity (const Vector3 &velocity)
	Sets the listener velocity.

virtual Quaternion	getListenerOrientation () const
	Retrieves the listener orientation.

virtual void	setListenerOrientation (const Quaternion &orientation)
	Sets the listener orientation.

virtual float	getSpeedOfSound () const
	Retrieves the speed of sound.

virtual void	setSpeedOfSound (float speed)
	Sets the speed of sound.

virtual float	getDopplerFactor () const
	Retrieves the doppler factor.

virtual void	setDopplerFactor (float factor)
	Sets the doppler factor.

virtual DistanceModel	getDistanceModel () const
	Retrieves the distance model.

virtual void	setDistanceModel (DistanceModel model)
	Sets the distance model.

Public Member Functions inherited from IDevice
virtual	~IDevice ()
	Destroys the device.

virtual DeviceSpecs	getSpecs () const =0
	Returns the specification of the device.

virtual std::shared_ptr< IHandle >	play (std::shared_ptr< IReader > reader, bool keep=false)=0
	Plays a sound source.

virtual std::shared_ptr< IHandle >	play (std::shared_ptr< ISound > sound, bool keep=false)=0
	Plays a sound source.

virtual void	stopAll ()=0
	Stops all playing sounds.

virtual void	lock ()=0
	Locks the device.

virtual void	unlock ()=0
	Unlocks the previously locked device.

virtual float	getVolume () const =0
	Retrieves the overall device volume.

virtual void	setVolume (float volume)=0
	Sets the overall device volume.

virtual ISynchronizer *	getSynchronizer ()=0
	Retrieves the synchronizer for this device, which enables accurate synchronization between audio playback and video playback for example.

virtual void	lock ()=0
	Locks the object.

virtual void	unlock ()=0
	Unlocks the previously locked object.

virtual Vector3	getListenerLocation () const =0
	Retrieves the listener location.

virtual void	setListenerLocation (const Vector3 &location)=0
	Sets the listener location.

virtual Vector3	getListenerVelocity () const =0
	Retrieves the listener velocity.

virtual void	setListenerVelocity (const Vector3 &velocity)=0
	Sets the listener velocity.

virtual Quaternion	getListenerOrientation () const =0
	Retrieves the listener orientation.

virtual void	setListenerOrientation (const Quaternion &orientation)=0
	Sets the listener orientation.

virtual float	getSpeedOfSound () const =0
	Retrieves the speed of sound.

virtual void	setSpeedOfSound (float speed)=0
	Sets the speed of sound.

virtual float	getDopplerFactor () const =0
	Retrieves the doppler factor.

virtual void	setDopplerFactor (float factor)=0
	Sets the doppler factor.

virtual DistanceModel	getDistanceModel () const =0
	Retrieves the distance model.

virtual void	setDistanceModel (DistanceModel model)=0
	Sets the distance model.

Static Public Member Functions
static void	registerPlugin ()
	Registers this plugin.

Static Public Member Functions inherited from SoftwareDevice
static void	setPanning (IHandle *handle, float pan)
	Sets the panning of a specific handle.

Protected Member Functions
virtual void	playing (bool playing)
	This function tells the device, to start or pause playback.

Protected Member Functions inherited from SoftwareDevice
void	create ()
	Initializes member variables.

void	destroy ()
	Uninitializes member variables.

void	mix (data_t *buffer, int length)
	Mixes the next samples into the buffer.

virtual void	playing (bool playing)=0
	This function tells the device, to start or pause playback.

void	setSpecs (Specs specs)
	Sets the audio output specification of the device.

void	setSpecs (DeviceSpecs specs)
	Sets the audio output specification of the device.

	SoftwareDevice ()
	Empty default constructor.

Additional Inherited Members
Protected Attributes inherited from SoftwareDevice
DeviceSpecs	m_specs
	The specification of the device.

std::shared_ptr< Mixer >	m_mixer
	The mixer.

bool	m_quality
	Whether to do high or low quality resampling.

Detailed Description

This device plays back through JACK.

Constructor & Destructor Documentation

◆ JackDevice()

JackDevice::JackDevice	(	std::string	name,
		DeviceSpecs	specs,
		int	buffersize = `AUD_DEFAULT_BUFFER_SIZE`
	)

Creates a JACK client for audio output.

Parameters

name	The client name.
specs	The wanted audio specification, where only the channel count is important.
buffersize	The size of the internal buffer.

Exceptions

Exception Thrown if the audio device cannot be opened.

Member Function Documentation

◆ doesPlayback()

bool JackDevice::doesPlayback ( )

Returns whether jack transport plays back.

Returns: Whether jack transport plays back.

◆ getPlaybackPosition()

double JackDevice::getPlaybackPosition ( )

Retrieves the jack transport playback time.

Returns: The current time position.

◆ getSynchronizer()

virtual ISynchronizer * JackDevice::getSynchronizer ( )

virtual

Retrieves the synchronizer for this device, which enables accurate synchronization between audio playback and video playback for example.

Returns: The synchronizer which will be the DefaultSynchronizer if synchonization is not supported.

Reimplemented from SoftwareDevice.

◆ playing()

virtual void JackDevice::playing ( bool playing )

protectedvirtual

This function tells the device, to start or pause playback.

Parameters

playing True if device should playback.

Note: This method is only called when the device is locked.

Implements SoftwareDevice.

◆ seekPlayback()

void JackDevice::seekPlayback ( double time )

Seeks jack transport playback.

Parameters

time	The time to seek to.

◆ setSyncCallback()

void JackDevice::setSyncCallback	(	ISynchronizer::syncFunction	sync,
		void *	data
	)

Sets the sync callback for jack transport playback.

Parameters

sync	The callback function.
data	The data for the function.

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

jack/JackDevice.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ JackDevice()

Member Function Documentation

◆ doesPlayback()

◆ getPlaybackPosition()

◆ getSynchronizer()

◆ playing()

◆ seekPlayback()

◆ setSyncCallback()