CoreAudio client device. More...

#include <dx_coreaudio_device.h>

Inheritance diagram for dx::coreaudio::device< desc_t, preference_t, stream_t >:

Collaboration diagram for dx::coreaudio::device< desc_t, preference_t, stream_t >:

Public Types
typedef dx::virtuel::stream::desc	desc_t
typedef dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > >	stream_t
typedef desc	value_t

Public Member Functions
struct stream *	align (struct stream *sync_reference)
uint32_t	align (uint32_t sync_reference) const
DX_PRAGMA_IGNORE_RETURN_VALUE_BEGIN	catch (const dx::exception &__dx_exception)
virtual void	conclude () noexcept
	conclude notification: object will be removed. If you overwrite conclude() you also need to overwrite destructor and check if its needed to be called from there.
	dx_catchall_handler (this,) void conclude() noexcept override
uint32_t	enumerate (const format &format=any) const
	enumerate typified pins
void	exception (const dx::exception &exception, bool filtered=false) const noexcept override
	notification exception handler
struct stream *	find (const decltype(stream::target.idx())&target)
struct stream *	find (const format &format=any, enum direction::direction direction=direction::any)
struct stream *	find (const target &target)
struct stream *	find (uint32_t &pin, const format &format=any, enum direction::direction direction=direction::any)
	finds and returns the stream description and pin idx into this stream
virtual uint64_t	frame () const
DX_PRAGMA_IGNORE_RETURN_VALUE_END void	halt () noexcept override
virtual bool	hw_clock () const noexcept
virtual void	hw_clock (abstract::event *hw_clock)
void	info (std::ostream &os) noexcept override
virtual void	launch ()
	launch notification: object mounted and ready to use
bool	operator== (const desc &desc) const
virtual device &	operator>> (std::ostream &) const
virtual _device &	reset ()
virtual void	sleep ()
	notify system will sleep stub
DX_PRAGMA_IGNORE_RETURN_VALUE_END bool	start (uint64_t frame=0, unsigned int started=1) override try
virtual unsigned int	stop (bool force=false) noexcept
std::string	string (uint8_t idx) try
uint32_t	sync_reference (struct stream *sync_reference)
struct stream *	sync_reference (uint32_t sync_reference)
void	wake () override

Public Attributes
enum dx::stream::desc::bus	bus
promoted::property< typename super::client_map, typename super::client_map::value_t, false >	clients
abstract::event *	clock
uint32_t	clocks
	number of independent clocks [currenlty only single clock support]
promoted< uint32_t >::preference< decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)>	clocksource
std::atomic< size_t >	counter
bool	dflt
	can be selected as default (OS audio) device
dx::driver< decltype(id), cf::preference > &	driver
bool	editable
	can be edited
bool	hidden
	hide device
struct {
abstract::event * clock
std::atomic< size_t > counter
uint32_t iosize
}	hw
promoted::property< icon, ::CFURLRef, false >	icon
dx::coreaudio::_device::clocksource	id
promoted< uint32_t >::preference< decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)>	iosize
uint32_t	iosize
bool	launched
struct dx::stream::desc::name_id	model
dx::stream::device::monitor	monitor
std::deque< std::function< void(control &)> >	notify
bool	persistence
	device has capability to store persistent settings (i.e. sample rate; clock source; etc.)
cf::preference	preference
std::string	puid
	persistent UID - system unique - could change with location
std::string	puuid
	persistent universal UID - universally unique ID (i.e. serial number)
promoted< uint32_t >::preference< decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)>	safety_offset [direction::directions]
promoted::property<::Float64 >	samplerate
direction::direction	start_stop_order
std::atomic< unsigned int >	started
struct dx::stream::desc::stream	stream [max_streams]
std::map< decltype(dx::virtuel::stream::desc::stream::target.idx()), std::weak_ptr< dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > > >	streams
promoted< uint32_t >::preference< decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)>	sync_cycle_ticks
promoted< structdesc_t::stream * >::template preference< decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference), uint32_t >	sync_reference
struct dx::stream::desc::name_id	vendor
dx::stream::device::monitor	version

Protected Member Functions
virtual void	flush ()

Protected Attributes
std::recursive_mutex	start_stop_in_progress
	start/stop operation in progress

Detailed Description

template<typename desc_t = dx::virtuel::stream::desc, typename preference_t = cf::preference, template< typename ... > typename stream_t = dx::stream::stream>
class dx::coreaudio::device< desc_t, preference_t, stream_t >

CoreAudio client device.

Member Typedef Documentation

◆ desc_t

typedef dx::virtuel::stream::desc dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::dx::virtuel::stream::desc

inherited

◆ stream_t

inherited

◆ value_t

typedef desc dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::value_t

inherited

Member Function Documentation

◆ align() [1/2]

struct stream * dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::align ( struct stream * sync_reference )

inlineinherited

Here is the call graph for this function:

◆ align() [2/2]

uint32_t dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::align ( uint32_t sync_reference ) const

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

◆ catch()

DX_PRAGMA_IGNORE_RETURN_VALUE_BEGIN dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::catch ( const dx::exception & __dx_exception )

inlineinherited

◆ conclude()

virtual void dx::object::conclude ( )

inlinevirtualnoexceptinherited

conclude notification: object will be removed. If you overwrite conclude() you also need to overwrite destructor and check if its needed to be called from there.

◆ dx_catchall_handler()

dx::stream::control< object_t >::dx_catchall_handler ( this )

inlineoverridenoexceptinherited

◆ enumerate()

uint32_t dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::enumerate ( const format & format = any ) const

inlineinherited

enumerate typified pins

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exception()

void dx::device< ::AudioObjectID, cf::preference >::exception	(	const dx::exception &	exception,
		bool	filtered = false ) const

inlineoverridevirtualnoexceptinherited

notification exception handler

Implements dx::object.

◆ find() [1/4]

struct stream * dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::find ( const decltype(stream::target.idx())& target )

inlineinherited

◆ find() [2/4]

struct stream * dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::find	(	const format &	format = any,
		enum direction::direction	direction = direction::any )

inlineinherited

Parameters

format	search stream format filter
direction	search stream direction filter

Here is the call graph for this function:

◆ find() [3/4]

struct stream * dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::find ( const target & target )

inlineinherited

◆ find() [4/4]

struct stream * dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::find	(	uint32_t &	pin,
		const format &	format = any,
		enum direction::direction	direction = direction::any )

inlineinherited

finds and returns the stream description and pin idx into this stream

Returns: stream description of indexed pin, pin idx will be altered on return!

Parameters

pin	in: global pin index, out: pin index into returned stream description
format	search stream format filter
direction	search stream direction filter

Here is the caller graph for this function:

◆ flush()

virtual void dx::stream::control< object_t >::flush ( )

inlineprotectedvirtualinherited

◆ frame()

virtual uint64_t dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::frame ( ) const

inlinevirtualinherited

◆ halt()

DX_PRAGMA_IGNORE_RETURN_VALUE_END void dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::halt ( )

inlineoverridevirtualnoexceptinherited

Reimplemented from dx::stream::control< dx::device<::AudioObjectID, cf::preference > >.

◆ hw_clock() [1/2]

virtual bool dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::hw_clock ( ) const

inlinevirtualnoexceptinherited

◆ hw_clock() [2/2]

virtual void dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::hw_clock ( abstract::event * hw_clock )

inlinevirtualinherited

◆ info()

void dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::info ( std::ostream & os )

inlineoverridevirtualnoexceptinherited

Reimplemented from dx::object.

◆ launch()

virtual void dx::object::launch ( )

inlinevirtualinherited

launch notification: object mounted and ready to use

◆ operator==()

bool dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::operator== ( const desc< target, 2, 2 > & desc ) const

inlineinherited

◆ operator>>()

virtual device & dx::device< ::AudioObjectID, cf::preference >::operator>> ( std::ostream & ) const

inlinevirtualinherited

◆ reset()

virtual _device & dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::reset ( )

inlinevirtualinherited

◆ sleep()

virtual void dx::device< ::AudioObjectID, cf::preference >::sleep ( )

inlinevirtualinherited

notify system will sleep stub

◆ start()

DX_PRAGMA_IGNORE_RETURN_VALUE_END bool dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::start	(	uint64_t	frame = 0,
		unsigned int	started = 1 )

inlineoverridevirtualinherited

result indicates if start changed the state.

Reimplemented from dx::stream::control< dx::device<::AudioObjectID, cf::preference > >.

◆ stop()

virtual unsigned int dx::stream::control< object_t >::stop ( bool force = false )

inlinevirtualnoexceptinherited

result indicates the amount of stopped start references

◆ string()

std::string dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::string ( uint8_t idx )

inlineinherited

◆ sync_reference() [1/2]

uint32_t dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::sync_reference ( struct stream * sync_reference )

inlineinherited

Here is the call graph for this function:

◆ sync_reference() [2/2]

struct stream * dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::sync_reference ( uint32_t sync_reference )

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

◆ wake()

void dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::wake ( )

inlineoverrideinherited

Member Data Documentation

◆ bus

enum dx::stream::desc::bus dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::bus

inherited

◆ clients

promoted::property<typename super::client_map, typename super::client_map::value_t, false> dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::clients

inherited

◆ clock

abstract::event* dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::clock

inherited

◆ clocks

uint32_t dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::clocks

inherited

number of independent clocks [currenlty only single clock support]

◆ clocksource

promoted<uint32_t>::preference<decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)> dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::clocksource

inherited

◆ counter

std::atomic<size_t> dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::counter

inherited

◆ dflt

bool dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::dflt

inherited

can be selected as default (OS audio) device

◆ driver

dx::driver<decltype(id), cf::preference>& dx::device< ::AudioObjectID, cf::preference >::driver

inherited

◆ editable

bool dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::editable

inherited

can be edited

◆ hidden

bool dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::hidden

inherited

hide device

◆ [struct]

struct { ... } dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::hw

◆ icon

promoted::property<icon, ::CFURLRef, false> dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::icon

inherited

◆ id

dx::coreaudio::_device::clocksource dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::id

inherited

◆ iosize [1/2]

promoted<uint32_t>::preference<decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)> dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::iosize

inherited

◆ iosize [2/2]

uint32_t dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::iosize

inherited

◆ launched

bool dx::object::launched

inherited

◆ model

struct dx::stream::desc::name_id dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::model

inherited

◆ monitor

dx::stream::device::monitor dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::monitor

inherited

◆ notify

std::deque<std::function<void(control&)> > dx::stream::control< object_t >::notify

inherited

◆ persistence

bool dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::persistence

inherited

device has capability to store persistent settings (i.e. sample rate; clock source; etc.)

◆ preference

cf::preference dx::device< ::AudioObjectID, cf::preference >::preference

inherited

◆ puid

std::string dx::device< ::AudioObjectID, cf::preference >::puid

inherited

persistent UID - system unique - could change with location

◆ puuid

std::string dx::device< ::AudioObjectID, cf::preference >::puuid

inherited

persistent universal UID - universally unique ID (i.e. serial number)

◆ safety_offset

promoted<uint32_t>::preference<decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)> dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::safety_offset[direction::directions]

inherited

◆ samplerate

promoted::property<::Float64> dx::coreaudio::_device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::samplerate

inherited

◆ start_stop_in_progress

std::recursive_mutex dx::stream::control< object_t >::start_stop_in_progress

protectedinherited

start/stop operation in progress

◆ start_stop_order

direction::direction dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::start_stop_order

inherited

◆ started

std::atomic<unsigned int> dx::stream::control< object_t >::started

inherited

◆ stream

struct dx::stream::desc::stream dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::stream[max_streams]

inherited

◆ streams

std::map<decltype(dx::virtuel::stream::desc::stream::target.idx()), std::weak_ptr<dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > >> > dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::streams

inherited

◆ sync_cycle_ticks

promoted<uint32_t>::preference<decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference)> dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::sync_cycle_ticks

inherited

◆ sync_reference

promoted<structdesc_t::stream*>::template preference<decltype(dx::stream::control< dx::device<::AudioObjectID, cf::preference > >::preference), uint32_t> dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::sync_reference

inherited

◆ vendor

struct dx::stream::desc::name_id dx::stream::desc< target, max_streams, max_pins, 1, 1, 1 >::vendor

inherited

◆ version

dx::stream::device::monitor dx::stream::device< dx::stream::control< dx::device<::AudioObjectID, cf::preference > >, dx::virtuel::stream::desc, dx::stream::stream< device< dx::virtuel::stream::desc, cf::preference, dx::stream::stream > > >::version

inherited

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

dx_coreaudio_device.h

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ desc_t

◆ stream_t

◆ value_t

Member Function Documentation

◆ align() [1/2]

◆ align() [2/2]

◆ catch()

◆ conclude()

◆ dx_catchall_handler()

◆ enumerate()

◆ exception()

◆ find() [1/4]

◆ find() [2/4]

◆ find() [3/4]

◆ find() [4/4]

◆ flush()

◆ frame()

◆ halt()

◆ hw_clock() [1/2]

◆ hw_clock() [2/2]

◆ info()

◆ launch()

◆ operator==()

◆ operator>>()

◆ reset()

◆ sleep()

◆ start()

◆ stop()

◆ string()

◆ sync_reference() [1/2]

◆ sync_reference() [2/2]

◆ wake()

Member Data Documentation

◆ bus

◆ clients

◆ clock

◆ clocks

◆ clocksource

◆ counter

◆ dflt

◆ driver

◆ editable

◆ hidden

◆ [struct]

◆ icon

◆ id

◆ iosize [1/2]

◆ iosize [2/2]

◆ launched

◆ model

◆ monitor

◆ notify

◆ persistence

◆ preference

◆ puid

◆ puuid

◆ safety_offset

◆ samplerate

◆ start_stop_in_progress

◆ start_stop_order

◆ started

◆ stream

◆ streams

◆ sync_cycle_ticks

◆ sync_reference

◆ vendor

◆ version