#include <ResampledSoundDevice.hh>

Inheritance diagram for openmsx::ResampledSoundDevice:

[legend]

Collaboration diagram for openmsx::ResampledSoundDevice:

[legend]

Public Types
enum	ResampleType { RESAMPLE_HQ , RESAMPLE_LQ , RESAMPLE_BLIP }

Public Member Functions
bool	generateInput (float *buffer, size_t num)
	Note: To enable various optimizations (like SSE), this method is allowed to generate up to 3 extra sample. More...

DynamicClock &	getEmuClock ()

Public Member Functions inherited from openmsx::SoundDevice
	SoundDevice (const SoundDevice &)=delete

SoundDevice &	operator= (const SoundDevice &)=delete

const std::string &	getName () const
	Get the unique name that identifies this sound device. More...

std::string_view	getDescription () const
	Gets a description of this sound device, to be presented to the user. More...

bool	isStereo () const
	Is this a stereo device? This is set in the constructor and cannot be changed anymore. More...

AmplificationFactors	getAmplificationFactor () const

void	setSoftwareVolume (float volume, EmuTime::param time)
	Change the 'software volume' of this sound device. More...

void	setSoftwareVolume (float left, float right, EmuTime::param time)

void	recordChannel (unsigned channel, const Filename &filename)

void	muteChannel (unsigned channel, bool muted)

virtual void	setOutputRate (unsigned hostSampleRate, double speed)=0
	When a SoundDevice registers itself with the Mixer, the Mixer sets the required sampleRate through this method. More...

virtual bool	updateBuffer (size_t length, float *buffer, EmuTime::param time)=0
	Generate sample data. More...

Protected Member Functions
	ResampledSoundDevice (MSXMotherBoard &motherBoard, std::string_view name, static_string_view description, unsigned channels, unsigned inputSampleRate, bool stereo)

	~ResampledSoundDevice ()

void	setOutputRate (unsigned hostSampleRate, double speed) override
	When a SoundDevice registers itself with the Mixer, the Mixer sets the required sampleRate through this method. More...

bool	updateBuffer (size_t length, float *buffer, EmuTime::param time) override
	Generate sample data. More...

void	update (const Setting &setting) noexcept override

void	createResampler ()

Protected Member Functions inherited from openmsx::SoundDevice
	SoundDevice (MSXMixer &mixer, std::string_view name, static_string_view description, unsigned numChannels, unsigned inputRate, bool stereo)
	Constructor. More...

	~SoundDevice ()

virtual float	getAmplificationFactorImpl () const
	Get amplification/attenuation factor for this device. More...

void	registerSound (const DeviceConfig &config)
	Registers this sound device with the Mixer. More...

void	unregisterSound ()
	Unregisters this sound device with the Mixer. More...

void	updateStream (EmuTime::param time)

void	setInputRate (unsigned sampleRate)

unsigned	getInputRate () const

virtual void	generateChannels (std::span< float * > buffers, unsigned num)=0
	Abstract method to generate the actual sound data. More...

bool	mixChannels (float *dataOut, size_t samples)
	Calls generateChannels() and combines the output to a single channel. More...

const DynamicClock &	getHostSampleClock () const
	See MSXMixer::getHostSampleClock(). More...

double	getEffectiveSpeed () const

Protected Member Functions inherited from openmsx::Observer< Setting >
	Observer ()=default

	~Observer ()=default

	Observer (const Observer &)=delete

Observer &	operator= (const Observer &)=delete

virtual void	update (const Setting &subject) noexcept=0

virtual void	subjectDeleted (const Setting &)

Additional Inherited Members
Static Public Attributes inherited from openmsx::SoundDevice
static constexpr unsigned	MAX_CHANNELS = 24

Static Protected Member Functions inherited from openmsx::SoundDevice
static void	addFill (float *&buffer, float value, unsigned num)
	Adds a number of samples that all have the same value. More...

Detailed Description

Definition at line 16 of file ResampledSoundDevice.hh.

Member Enumeration Documentation

◆ ResampleType

enum openmsx::ResampledSoundDevice::ResampleType

Enumerator
RESAMPLE_HQ
RESAMPLE_LQ
RESAMPLE_BLIP

Definition at line 19 of file ResampledSoundDevice.hh.

Constructor & Destructor Documentation

◆ ResampledSoundDevice()

openmsx::ResampledSoundDevice::ResampledSoundDevice	(	MSXMotherBoard &	motherBoard,
		std::string_view	name,
		static_string_view	description,
		unsigned	channels,
		unsigned	inputSampleRate,
		bool	stereo
	)

protected

Definition at line 16 of file ResampledSoundDevice.cc.

References openmsx::Subject< T >::attach().

◆ ~ResampledSoundDevice()

openmsx::ResampledSoundDevice::~ResampledSoundDevice ( )

protected

Definition at line 28 of file ResampledSoundDevice.cc.

References openmsx::Subject< T >::detach().

Member Function Documentation

◆ createResampler()

void openmsx::ResampledSoundDevice::createResampler ( )

protected

Definition at line 58 of file ResampledSoundDevice.cc.

References openmsx::ResampleLQ< CHANNELS >::create(), openmsx::SoundDevice::getEffectiveSpeed(), openmsx::EnumSetting< T >::getEnum(), openmsx::SoundDevice::getHostSampleClock(), openmsx::SoundDevice::getInputRate(), openmsx::DynamicClock::getPeriod(), openmsx::DynamicClock::getTime(), openmsx::SoundDevice::isStereo(), RESAMPLE_BLIP, RESAMPLE_HQ, RESAMPLE_LQ, openmsx::DynamicClock::reset(), openmsx::DynamicClock::setPeriod(), and UNREACHABLE.

Referenced by setOutputRate().

◆ generateInput()

bool openmsx::ResampledSoundDevice::generateInput	(	float *	buffer,
		size_t	num
	)

Note: To enable various optimizations (like SSE), this method is allowed to generate up to 3 extra sample.

See also: SoundDevice::updateBuffer()

Definition at line 45 of file ResampledSoundDevice.cc.

References openmsx::SoundDevice::mixChannels().

Referenced by openmsx::ResampleTrivial::generateOutputImpl().

◆ getEmuClock()

DynamicClock & openmsx::ResampledSoundDevice::getEmuClock ( )

inline

Definition at line 27 of file ResampledSoundDevice.hh.

Referenced by openmsx::ResampleLQ< CHANNELS >::create(), openmsx::ResampleAlgo::getEmuClock(), and openmsx::YM2413::writePort().

◆ setOutputRate()

void openmsx::ResampledSoundDevice::setOutputRate	(	unsigned	hostSampleRate,
		double	speed
	)

overrideprotectedvirtual

When a SoundDevice registers itself with the Mixer, the Mixer sets the required sampleRate through this method.

All sound devices share a common sampleRate.

Implements openmsx::SoundDevice.

Definition at line 34 of file ResampledSoundDevice.cc.

References createResampler().

◆ update()

void openmsx::ResampledSoundDevice::update ( const Setting & setting )

overrideprotectedvirtualnoexcept

Implements openmsx::Observer< Setting >.

Definition at line 51 of file ResampledSoundDevice.cc.

References setting.

◆ updateBuffer()

bool openmsx::ResampledSoundDevice::updateBuffer	(	size_t	length,
		float *	buffer,
		EmuTime::param	time
	)

overrideprotectedvirtual

Generate sample data.

Parameters

length	The number of required samples
buffer	This buffer should be filled
time	current time

Returns: false iff the output is empty. IOW filling the buffer with zeros or returning false has the same effect, but the latter can be more efficient

This method is regularly called from the Mixer, it should return a pointer to a buffer filled with the required number of samples. Samples are always floats, later they are converted to the systems native format (e.g. 16-bit signed).

Note: To enable various optimizations (like SSE), this method can fill the output buffer with up to 3 extra samples. Those extra samples should be ignored, though the caller must make sure the buffer has enough space to hold them.

Implements openmsx::SoundDevice.

Definition at line 39 of file ResampledSoundDevice.cc.

References gl::length().

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

Public Types

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ResampleType

Constructor & Destructor Documentation

◆ ResampledSoundDevice()

◆ ~ResampledSoundDevice()

Member Function Documentation

◆ createResampler()

◆ generateInput()

◆ getEmuClock()

◆ setOutputRate()

◆ update()

◆ updateBuffer()