#include <audiooutput.h>

Inheritance diagram for AudioOutput:

[legend]

Collaboration diagram for AudioOutput:

[legend]

Classes
class	AudioDeviceConfig

Public Types
using	ADCVect = QVector< AudioDeviceConfig >

Public Member Functions
	AudioOutput ()=default

	~AudioOutput () override

virtual void	Reconfigure (const AudioSettings &settings)=0

virtual void	SetStretchFactor (float factor)

virtual float	GetStretchFactor (void) const

virtual int	GetChannels (void) const

virtual AudioFormat	GetFormat (void) const

virtual int	GetBytesPerFrame (void) const

virtual AudioOutputSettings *	GetOutputSettingsCleaned (bool digital=true)

virtual AudioOutputSettings *	GetOutputSettingsUsers (bool digital=true)

virtual bool	CanPassthrough (int samplerate, int channels, AVCodecID codec, int profile) const

virtual bool	CanDownmix (void) const

virtual void	SetEffDsp (int dsprate)=0

virtual void	Reset (void)=0

virtual bool	AddFrames (void *buffer, int frames, int64_t timecode)=0
	Add frames to the audiobuffer for playback. More...

virtual bool	AddData (void *buffer, int len, int64_t timecode, int frames)=0
	Add data to the audiobuffer for playback. More...

virtual bool	NeedDecodingBeforePassthrough (void) const

virtual int64_t	LengthLastData (void) const

virtual void	SetTimecode (int64_t timecode)=0

virtual bool	IsPaused (void) const =0

virtual void	Pause (bool paused)=0

virtual void	PauseUntilBuffered (void)=0

virtual void	Drain (void)=0

virtual int64_t	GetAudiotime (void)=0

virtual int64_t	GetAudioBufferedTime (void)
	report amount of audio buffered in milliseconds. More...

virtual void	SetSourceBitrate (int)

QString	GetError (void) const

QString	GetWarning (void) const

virtual void	GetBufferStatus (uint &fill, uint &total)

virtual void	bufferOutputData (bool y)=0

virtual int	readOutputData (unsigned char *read_buffer, int max_length)=0

virtual bool	IsUpmixing (void)

virtual bool	ToggleUpmix (void)

virtual bool	CanUpmix (void)

bool	PulseStatus (void)

virtual bool	CanProcess (AudioFormat fmt)

virtual uint32_t	CanProcess (void)

virtual int	DecodeAudio (AVCodecContext ctx, uint8_t buffer, int &data_size, const AVPacket *pkt)
	Utility routine. More...

Public Member Functions inherited from VolumeBase
	VolumeBase ()

virtual	~VolumeBase ()=default

void	SWVolume (bool set)

bool	SWVolume (void) const

virtual uint	GetCurrentVolume (void) const

virtual void	SetCurrentVolume (int value)

virtual void	AdjustCurrentVolume (int change)

virtual void	ToggleMute (void)

virtual MuteState	GetMuteState (void) const

virtual MuteState	SetMuteState (MuteState)

Public Member Functions inherited from OutputListeners
	OutputListeners ()=default

	~OutputListeners () override=default

bool	hasVisual (void)

void	addVisual (MythTV::Visual *v)

void	removeVisual (MythTV::Visual *v)

QMutex *	mutex ()

void	setBufferSize (unsigned int sz)

unsigned int	bufferSize () const

Public Member Functions inherited from MythObservable
	MythObservable ()

virtual	~MythObservable ()

void	addListener (QObject *listener)
	Add a listener to the observable. More...

void	removeListener (QObject *listener)
	Remove a listener to the observable. More...

void	dispatch (const MythEvent &event)
	Dispatch an event to all listeners. More...

bool	hasListeners (void)

Static Public Member Functions
static void	Cleanup (void)

static ADCVect *	GetOutputList (void)

static AudioDeviceConfig *	GetAudioDeviceConfig (QString &name, QString &desc, bool willsuspendpa=false)

static AudioOutput *	OpenAudio (const QString &main_device, const QString &passthru_device, AudioFormat format, int channels, AVCodecID codec, int samplerate, AudioOutputSource source, bool set_initial_vol, bool passthru, int upmixer_startup=0, AudioOutputSettings *custom=nullptr)

static AudioOutput *	OpenAudio (AudioSettings &settings, bool willsuspendpa=true)

static AudioOutput *	OpenAudio (const QString &main_device, const QString &passthru_device=QString(), bool willsuspendpa=true)

Static Public Member Functions inherited from VolumeBase
static MuteState	NextMuteState (MuteState)

Static Public Attributes
static const int	kMaxSizeBuffer = 384000
	kMaxSizeBuffer is the maximum size of a buffer to be used with DecodeAudio More...

Protected Member Functions
void	Error (const QString &msg)

void	SilentError (const QString &msg)

void	Warn (const QString &msg)

void	ClearError (void)

void	ClearWarning (void)

Protected Member Functions inherited from VolumeBase
virtual int	GetVolumeChannel (int channel) const =0

virtual void	SetVolumeChannel (int channel, int volume)=0

virtual void	SetSWVolume (int new_volume, bool save)=0

virtual int	GetSWVolume (void)=0

void	UpdateVolume (void)

void	SyncVolume (void)

void	SetChannels (int new_channels)

Protected Member Functions inherited from OutputListeners
void	error (const QString &e)

void	dispatchVisual (uchar *b, unsigned long b_len, unsigned long written, int chan, int prec)

void	prepareVisuals ()

Protected Attributes
QString	m_lastError

QString	m_lastWarn

bool	m_pulseWasSuspended {false}

AVFrame *	m_frame {nullptr}

Protected Attributes inherited from VolumeBase
bool	m_internalVol {false}

Protected Attributes inherited from MythObservable
QMutex *	m_lock {nullptr}

QSet< QObject * >	m_listeners

Private Member Functions
	Q_DECLARE_TR_FUNCTIONS (AudioOutput)

Detailed Description

Definition at line 24 of file audiooutput.h.

Member Typedef Documentation

◆ ADCVect

using AudioOutput::ADCVect = QVector<AudioDeviceConfig>

Definition at line 47 of file audiooutput.h.

Constructor & Destructor Documentation

◆ AudioOutput()

AudioOutput::AudioOutput ( )

default

◆ ~AudioOutput()

AudioOutput::~AudioOutput ( )

override

Definition at line 244 of file audiooutput.cpp.

Member Function Documentation

◆ Q_DECLARE_TR_FUNCTIONS()

AudioOutput::Q_DECLARE_TR_FUNCTIONS ( AudioOutput )

private

◆ Cleanup()

void AudioOutput::Cleanup ( void )

static

Definition at line 51 of file audiooutput.cpp.

◆ GetOutputList()

AudioOutput::ADCVect * AudioOutput::GetOutputList ( void )

static

Definition at line 417 of file audiooutput.cpp.

Referenced by AudioConfigSettings::AudioRescan(), and AudioSetupWizard::Load().

◆ GetAudioDeviceConfig()

AudioOutput::AudioDeviceConfig * AudioOutput::GetAudioDeviceConfig	(	QString &	name,
		QString &	desc,
		bool	willsuspendpa = `false`
	)

static

Definition at line 304 of file audiooutput.cpp.

Referenced by AudioConfigSettings::AudioRescan(), AudioConfigSettings::CheckConfiguration(), AudioConfigSettings::CheckPassthrough(), fillSelectionsFromDir(), and AudioSetupWizard::Init().

◆ OpenAudio() [1/3]

AudioOutput * AudioOutput::OpenAudio	(	const QString &	main_device,
		const QString &	passthru_device,
		AudioFormat	format,
		int	channels,
		AVCodecID	codec,
		int	samplerate,
		AudioOutputSource	source,
		bool	set_initial_vol,
		bool	passthru,
		int	upmixer_startup = `0`,
		AudioOutputSettings *	custom = `nullptr`
	)

static

Definition at line 58 of file audiooutput.cpp.

Referenced by AudioTestThread::AudioTestThread(), MythRAOPConnection::OpenAudioDevice(), MusicPlayer::openOutputDevice(), and AudioPlayer::ReinitAudio().

◆ OpenAudio() [2/3]

AudioOutput * AudioOutput::OpenAudio	(	AudioSettings &	settings,
		bool	willsuspendpa = `true`
	)

static

Definition at line 80 of file audiooutput.cpp.

◆ OpenAudio() [3/3]

AudioOutput * AudioOutput::OpenAudio	(	const QString &	main_device,
		const QString &	passthru_device = `QString()`,
		bool	willsuspendpa = `true`
	)

static

Definition at line 71 of file audiooutput.cpp.

◆ Reconfigure()

virtual void AudioOutput::Reconfigure ( const AudioSettings & settings )

pure virtual

Implemented in AudioOutputBase, and AudioReencodeBuffer.

Referenced by avfDecoder::initialize(), CdDecoder::initialize(), and AudioPlayer::ReinitAudio().

◆ SetStretchFactor()

void AudioOutput::SetStretchFactor ( float factor )

virtual

Reimplemented in AudioOutputBase.

Definition at line 253 of file audiooutput.cpp.

Referenced by MusicPlayer::setSpeed(), and AudioPlayer::SetStretchFactor().

◆ GetStretchFactor()

virtual float AudioOutput::GetStretchFactor ( void ) const

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 74 of file audiooutput.h.

◆ GetChannels()

virtual int AudioOutput::GetChannels ( void ) const

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 75 of file audiooutput.h.

◆ GetFormat()

virtual AudioFormat AudioOutput::GetFormat ( void ) const

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 76 of file audiooutput.h.

◆ GetBytesPerFrame()

virtual int AudioOutput::GetBytesPerFrame ( void ) const

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 77 of file audiooutput.h.

Referenced by AudioPlayer::AddAudioData(), and MythRAOPConnection::ProcessAudio().

◆ GetOutputSettingsCleaned()

AudioOutputSettings * AudioOutput::GetOutputSettingsCleaned ( bool digital = true )

virtual

Reimplemented in AudioOutputBase.

Definition at line 257 of file audiooutput.cpp.

Referenced by GetAudioDeviceConfig().

◆ GetOutputSettingsUsers()

AudioOutputSettings * AudioOutput::GetOutputSettingsUsers ( bool digital = true )

virtual

Reimplemented in AudioOutputBase.

Definition at line 262 of file audiooutput.cpp.

Referenced by AudioPlayer::GetMaxChannels(), AudioPlayer::GetMaxHDRate(), and TestDigitalFeature().

◆ CanPassthrough()

bool AudioOutput::CanPassthrough	(	int	samplerate,
		int	channels,
		AVCodecID	codec,
		int	profile
	)		const

virtual

Reimplemented in AudioOutputBase, and AudioReencodeBuffer.

Definition at line 267 of file audiooutput.cpp.

Referenced by AudioPlayer::CanPassthrough().

◆ CanDownmix()

virtual bool AudioOutput::CanDownmix ( void ) const

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 83 of file audiooutput.h.

Referenced by AudioPlayer::CanDownmix().

◆ SetEffDsp()

virtual void AudioOutput::SetEffDsp ( int dsprate )

pure virtual

Implemented in AudioOutputBase, and AudioReencodeBuffer.

Referenced by AudioPlayer::SetEffDsp().

◆ Reset()

virtual void AudioOutput::Reset ( void )

pure virtual

Implemented in AudioOutputBase, AudioReencodeBuffer, and AudioOutputNULL.

Referenced by MythRAOPConnection::ProcessAudio(), AudioPlayer::Reset(), MythRAOPConnection::ResetAudio(), and MusicPlayer::stop().

◆ AddFrames()

virtual bool AudioOutput::AddFrames	(	void *	buffer,
		int	frames,
		int64_t	timecode
	)

pure virtual

Add frames to the audiobuffer for playback.

Parameters

[in]	buffer	pointer to audio data
[in]	frames	number of frames added.
[in]	timecode	timecode of the first sample added (in msec)

Returns: false if there wasn't enough space in audio buffer to process all the data

Implemented in AudioOutputBase, and AudioReencodeBuffer.

Referenced by AudioTestThread::run().

◆ AddData()

virtual bool AudioOutput::AddData	(	void *	buffer,
		int	len,
		int64_t	timecode,
		int	frames
	)

pure virtual

Add data to the audiobuffer for playback.

Parameters

[in]	buffer	pointer to audio data
[in]	len	length of audio data added
[in]	timecode	timecode of the first sample added (in msec)
[in]	frames	number of frames added.

Returns: false if there wasn't enough space in audio buffer to process all the data

Implemented in AudioOutputBase, AudioReencodeBuffer, and AudioOutputAudioTrack.

Referenced by AudioPlayer::AddAudioData(), MythRAOPConnection::AudioCardLatency(), MythRAOPConnection::ProcessAudio(), and avfDecoder::run().

◆ NeedDecodingBeforePassthrough()

virtual bool AudioOutput::NeedDecodingBeforePassthrough ( void ) const

inlinevirtual

Returns: true if AudioOutput class can determine the length in millisecond of native audio frames bitstreamed passed to AddData. If false, LengthLastData method must be implemented

Reimplemented in AudioOutputBase.

Definition at line 121 of file audiooutput.h.

Referenced by AudioPlayer::NeedDecodingBeforePassthrough().

◆ LengthLastData()

virtual int64_t AudioOutput::LengthLastData ( void ) const

inlinevirtual

Returns: the length of the last data added in millisecond. This function must be implemented if NeedDecodingBeforePassthrough returned false

Reimplemented in AudioOutputBase.

Definition at line 128 of file audiooutput.h.

Referenced by AudioPlayer::LengthLastData(), MythRAOPConnection::ProcessAudio(), and AudioTestThread::run().

◆ SetTimecode()

virtual void AudioOutput::SetTimecode ( int64_t timecode )

pure virtual

Implemented in AudioOutputBase, and AudioReencodeBuffer.

Referenced by MusicCommon::seek(), and MusicPlayer::seek().

◆ IsPaused()

virtual bool AudioOutput::IsPaused ( void ) const

pure virtual

Implemented in AudioOutputBase, and AudioReencodeBuffer.

Referenced by AudioPlayer::IsPaused(), MusicPlayer::isPaused(), MusicCommon::keyPressEvent(), MythRAOPConnection::ProcessAudio(), and MusicPlayer::stop().

◆ Pause()

virtual void AudioOutput::Pause ( bool paused )

pure virtual

Implemented in AudioOutputBase, AudioReencodeBuffer, and AudioOutputAudioTrack.

Referenced by AudioTestThread::AudioTestThread(), AudioPlayer::Pause(), MusicPlayer::pause(), MythRAOPConnection::ProcessAudio(), and AudioTestThread::run().

◆ PauseUntilBuffered()

virtual void AudioOutput::PauseUntilBuffered ( void )

pure virtual

Implemented in AudioOutputBase, and AudioReencodeBuffer.

Referenced by MusicPlayer::decoderHandlerReady(), avfDecoder::initialize(), CdDecoder::initialize(), AudioPlayer::PauseAudioUntilBuffered(), and CdDecoder::seek().

◆ Drain()

virtual void AudioOutput::Drain ( void )

pure virtual

Implemented in AudioOutputBase, AudioReencodeBuffer, and AudioOutputPulseAudio.

Referenced by AudioPlayer::AddAudioData(), avfDecoder::run(), CdDecoder::run(), and AudioTestThread::run().

◆ GetAudiotime()

virtual int64_t AudioOutput::GetAudiotime ( void )

pure virtual

Implemented in AudioOutputBase, AudioReencodeBuffer, and AudioOutputCA.

Referenced by MythRAOPConnection::AudioCardLatency(), AudioPlayer::GetAudioTime(), MythRAOPConnection::ProcessRequest(), MythRAOPConnection::ProcessSync(), LyricsView::setLyricTime(), and MainVisual::timeout().

◆ GetAudioBufferedTime()

virtual int64_t AudioOutput::GetAudioBufferedTime ( void )

inlinevirtual

report amount of audio buffered in milliseconds.

Reimplemented in AudioOutputBase.

Definition at line 141 of file audiooutput.h.

Referenced by MythPlayer::EventLoop(), AudioPlayer::GetAudioBufferedTime(), MythRAOPConnection::ProcessAudio(), MythRAOPConnection::ProcessSync(), and avfDecoder::run().

◆ SetSourceBitrate()

virtual void AudioOutput::SetSourceBitrate ( int )

inlinevirtual

Reimplemented in AudioOutputBase, and AudioOutputAudioTrack.

Definition at line 143 of file audiooutput.h.

Referenced by avfDecoder::initialize(), CdDecoder::initialize(), and AvFormatDecoder::SetupAudioStream().

◆ GetError()

QString AudioOutput::GetError ( void ) const

inline

Definition at line 145 of file audiooutput.h.

Referenced by MythRAOPConnection::OpenAudioDevice(), MusicPlayer::openOutputDevice(), AudioOutputBase::Reconfigure(), AudioPlayer::ReinitAudio(), and AudioTestThread::result().

◆ GetWarning()

QString AudioOutput::GetWarning ( void ) const

inline

Definition at line 146 of file audiooutput.h.

◆ GetBufferStatus()

virtual void AudioOutput::GetBufferStatus	(	uint &	fill,
		uint &	total
	)

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 148 of file audiooutput.h.

Referenced by AudioPlayer::GetBufferStatus(), and CdDecoder::run().

◆ bufferOutputData()

virtual void AudioOutput::bufferOutputData ( bool y )

pure virtual

Implemented in AudioOutputBase, and AudioReencodeBuffer.

◆ readOutputData()

virtual int AudioOutput::readOutputData	(	unsigned char *	read_buffer,
		int	max_length
	)

pure virtual

Implemented in AudioOutputBase, AudioReencodeBuffer, and AudioOutputNULL.

◆ IsUpmixing()

virtual bool AudioOutput::IsUpmixing ( void )

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 156 of file audiooutput.h.

Referenced by AudioPlayer::IsUpmixing().

◆ ToggleUpmix()

virtual bool AudioOutput::ToggleUpmix ( void )

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 157 of file audiooutput.h.

Referenced by AudioPlayer::EnableUpmix(), and MusicCommon::toggleUpmix().

◆ CanUpmix()

virtual bool AudioOutput::CanUpmix ( void )

inlinevirtual

Reimplemented in AudioOutputBase.

Definition at line 158 of file audiooutput.h.

Referenced by AudioPlayer::CanUpmix().

◆ PulseStatus()

bool AudioOutput::PulseStatus ( void )

inline

Definition at line 159 of file audiooutput.h.

◆ CanProcess() [1/2]

virtual bool AudioOutput::CanProcess ( AudioFormat fmt )

inlinevirtual

Parameters

fmt	The audio format in question. return true if class can handle AudioFormat All AudioOutput derivative must be able to handle S16

Reimplemented in AudioOutputBase.

Definition at line 166 of file audiooutput.h.

Referenced by AudioPlayer::CanProcess().

◆ CanProcess() [2/2]

virtual uint32_t AudioOutput::CanProcess ( void )

inlinevirtual

Returns: bitmask of all AudioFormat handled All AudioOutput derivative must be able to handle S16

Reimplemented in AudioOutputBase.

Definition at line 172 of file audiooutput.h.

◆ DecodeAudio()

int AudioOutput::DecodeAudio	(	AVCodecContext *	ctx,
		uint8_t *	buffer,
		int &	data_size,
		const AVPacket *	pkt
	)

virtual

Utility routine.

DecodeAudio Decode an audio packet, and compact it if data is planar Return negative error code if an error occurred during decoding or the number of bytes consumed from the input AVPacket data_size contains the size of decoded data copied into buffer.

Decode an audio packet, and compact it if data is planar Return negative error code if an error occurred during decoding or the number of bytes consumed from the input AVPacket data_size contains the size of decoded data copied into buffer data decoded will be S16 samples if class instance can't handle HD audio or S16 and above otherwise. No U8 PCM format can be returned

Parameters

[in]	ctx	The current audio context information.
[in]	buffer	Destination for the copy
[out]	data_size	The number of bytes copied.
[in]	pkt	The source data packet

Definition at line 597 of file audiooutput.cpp.

Referenced by AudioPlayer::DecodeAudio(), and avfDecoder::run().

◆ Error()

void AudioOutput::Error ( const QString & msg )

protected

Definition at line 277 of file audiooutput.cpp.

Referenced by AudioOutputWin::OpenDevice(), AudioOutputOSS::OpenDevice(), AudioOutputALSA::OpenDevice(), AudioOutputBase::Reconfigure(), AudioOutputALSA::SetParameters(), and AudioOutputALSA::WriteAudio().

◆ SilentError()

void AudioOutput::SilentError ( const QString & msg )

protected

Definition at line 283 of file audiooutput.cpp.

Referenced by AudioOutputBase::Reconfigure().

◆ Warn()

void AudioOutput::Warn ( const QString & msg )

protected

Definition at line 288 of file audiooutput.cpp.

Referenced by AudioOutputALSA::GetOutputSettings().

◆ ClearError()

void AudioOutput::ClearError ( void )

protected

Definition at line 294 of file audiooutput.cpp.

Referenced by AudioReencodeBuffer::Reconfigure(), and AudioOutputBase::Reconfigure().

◆ ClearWarning()

void AudioOutput::ClearWarning ( void )

protected

Definition at line 299 of file audiooutput.cpp.

Member Data Documentation

◆ kMaxSizeBuffer

const int AudioOutput::kMaxSizeBuffer = 384000

static

kMaxSizeBuffer is the maximum size of a buffer to be used with DecodeAudio

Definition at line 194 of file audiooutput.h.

Referenced by MythRAOPConnection::AudioCardLatency(), avfDecoder::avfDecoder(), AvFormatDecoder::AvFormatDecoder(), MythRAOPConnection::decodeAudioPacket(), and NuppelDecoder::NuppelDecoder().

◆ m_lastError

QString AudioOutput::m_lastError

protected

Definition at line 203 of file audiooutput.h.

◆ m_lastWarn

QString AudioOutput::m_lastWarn

protected

Definition at line 204 of file audiooutput.h.

◆ m_pulseWasSuspended

bool AudioOutput::m_pulseWasSuspended {false}

protected

Definition at line 205 of file audiooutput.h.

Referenced by OpenAudio().

◆ m_frame

AVFrame* AudioOutput::m_frame {nullptr}

protected

Definition at line 206 of file audiooutput.h.

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Member Typedef Documentation

◆ ADCVect

Constructor & Destructor Documentation

◆ AudioOutput()

◆ ~AudioOutput()

Member Function Documentation

◆ Q_DECLARE_TR_FUNCTIONS()

◆ Cleanup()

◆ GetOutputList()

◆ GetAudioDeviceConfig()

◆ OpenAudio() [1/3]

◆ OpenAudio() [2/3]

◆ OpenAudio() [3/3]

◆ Reconfigure()

◆ SetStretchFactor()

◆ GetStretchFactor()

◆ GetChannels()

◆ GetFormat()

◆ GetBytesPerFrame()

◆ GetOutputSettingsCleaned()

◆ GetOutputSettingsUsers()

◆ CanPassthrough()

◆ CanDownmix()

◆ SetEffDsp()

◆ Reset()

◆ AddFrames()

◆ AddData()

◆ NeedDecodingBeforePassthrough()

◆ LengthLastData()

◆ SetTimecode()

◆ IsPaused()

◆ Pause()

◆ PauseUntilBuffered()

◆ Drain()

◆ GetAudiotime()

◆ GetAudioBufferedTime()

◆ SetSourceBitrate()

◆ GetError()

◆ GetWarning()

◆ GetBufferStatus()

◆ bufferOutputData()

◆ readOutputData()

◆ IsUpmixing()

◆ ToggleUpmix()

◆ CanUpmix()

◆ PulseStatus()

◆ CanProcess() [1/2]

◆ CanProcess() [2/2]

◆ DecodeAudio()

◆ Error()

◆ SilentError()

◆ Warn()

◆ ClearError()

◆ ClearWarning()

Member Data Documentation

◆ kMaxSizeBuffer

◆ m_lastError

◆ m_lastWarn

◆ m_pulseWasSuspended

◆ m_frame