openMSX
Public Member Functions | List of all members
openmsx::SamplePlayer Class Referencefinal

#include <SamplePlayer.hh>

Inheritance diagram for openmsx::SamplePlayer:
Inheritance graph
[legend]
Collaboration diagram for openmsx::SamplePlayer:
Collaboration graph
[legend]

Public Member Functions

 SamplePlayer (const std::string &name, static_string_view desc, const DeviceConfig &config, std::string_view samplesBaseName, unsigned numSamples, std::string_view alternativeName={})
 
 ~SamplePlayer ()
 
void reset ()
 
void play (unsigned sampleNum)
 Start playing a (new) sample.
 
void repeat (unsigned sampleNum)
 Keep on repeating the given sample data.
 
void stopRepeat ()
 Stop repeat mode.
 
bool isPlaying () const
 Is there currently playing a sample.
 
template<typename Archive >
void serialize (Archive &ar, unsigned version)
 
- Public Member Functions inherited from openmsx::ResampledSoundDevice
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.
 
DynamicClockgetEmuClock ()
 
- Public Member Functions inherited from openmsx::SoundDevice
 SoundDevice (const SoundDevice &)=delete
 
 SoundDevice (SoundDevice &&)=delete
 
SoundDeviceoperator= (const SoundDevice &)=delete
 
SoundDeviceoperator= (SoundDevice &&)=delete
 
const std::string & getName () const
 Get the unique name that identifies this sound device.
 
std::string_view getDescription () const
 Gets a description of this sound device, to be presented to the user.
 
unsigned getNumChannels () const
 How many channels does this device have?
 
bool hasStereoChannels () const
 Are the individual channels of this device stereo?
 
bool isStereo () const
 Is the full output of this device stereo?
 
AmplificationFactors getAmplificationFactor () const
 
void setSoftwareVolume (float volume, EmuTime::param time)
 Change the 'software volume' of this sound device.
 
void setSoftwareVolume (float left, float right, EmuTime::param time)
 
void recordChannel (unsigned channel, const Filename &filename)
 
void muteChannel (unsigned channel, bool muted)
 
std::span< const float > getLastBuffer (unsigned channel)
 Query the last generated audio signal for a specific channel.
 
float getNativeSampleRate () const
 The samples returned by 'getLastBuffer()' have this sample rate.
 
unsigned getLastMonoBufferSize () const
 getLastBuffer() with return buffers containing this many samples.
 
unsigned getLastBufferSize () const
 

Additional Inherited Members

- Public Types inherited from openmsx::ResampledSoundDevice
enum class  ResampleType { HQ , LQ , BLIP }
 
- Static Public Attributes inherited from openmsx::SoundDevice
static constexpr unsigned MAX_CHANNELS = 24
 
- Protected Member Functions inherited from openmsx::ResampledSoundDevice
 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.
 
bool updateBuffer (size_t length, float *buffer, EmuTime::param time) override
 Generate sample data.
 
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.
 
 ~SoundDevice ()
 
virtual float getAmplificationFactorImpl () const
 Get amplification/attenuation factor for this device.
 
void registerSound (const DeviceConfig &config)
 Registers this sound device with the Mixer.
 
void unregisterSound ()
 Unregisters this sound device with the Mixer.
 
void updateStream (EmuTime::param time)
 
void setInputRate (unsigned sampleRate)
 
unsigned getInputRate () const
 
bool mixChannels (float *dataOut, size_t samples)
 Calls generateChannels() and combines the output to a single channel.
 
const DynamicClockgetHostSampleClock () const
 See MSXMixer::getHostSampleClock().
 
double getEffectiveSpeed () const
 
- Protected Member Functions inherited from openmsx::Observer< Setting >
 Observer ()=default
 
 ~Observer ()=default
 
 Observer (const Observer &)=delete
 
 Observer (Observer &&)=delete
 
Observeroperator= (const Observer &)=delete
 
Observeroperator= (Observer &&)=delete
 
virtual void subjectDeleted (const Setting &)
 
- 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.
 

Detailed Description

Definition at line 10 of file SamplePlayer.hh.

Constructor & Destructor Documentation

◆ SamplePlayer()

openmsx::SamplePlayer::SamplePlayer ( const std::string &  name,
static_string_view  desc,
const DeviceConfig config,
std::string_view  samplesBaseName,
unsigned  numSamples,
std::string_view  alternativeName = {} 
)

Definition at line 50 of file SamplePlayer.cc.

References openmsx::SoundDevice::registerSound(), and reset().

◆ ~SamplePlayer()

openmsx::SamplePlayer::~SamplePlayer ( )

Definition at line 61 of file SamplePlayer.cc.

References openmsx::SoundDevice::unregisterSound().

Member Function Documentation

◆ isPlaying()

bool openmsx::SamplePlayer::isPlaying ( ) const
inline

Is there currently playing a sample.

Definition at line 42 of file SamplePlayer.hh.

Referenced by openmsx::RomPlayBall::peekMem(), repeat(), and openmsx::RomPlayBall::writeMem().

◆ play()

void openmsx::SamplePlayer::play ( unsigned  sampleNum)

Start playing a (new) sample.

Definition at line 72 of file SamplePlayer.cc.

Referenced by openmsx::RomPlayBall::writeMem().

◆ repeat()

void openmsx::SamplePlayer::repeat ( unsigned  sampleNum)

Keep on repeating the given sample data.

If there is already a sample playing, that sample is still finished. If there was no sample playing, the given sample immediately starts playing. Parameters are the same as for the play() method.

See also
stopRepeat()

Definition at line 100 of file SamplePlayer.cc.

References isPlaying().

Referenced by openmsx::RomNettouYakyuu::writeMem().

◆ reset()

void openmsx::SamplePlayer::reset ( )

◆ serialize()

template<typename Archive >
void openmsx::SamplePlayer::serialize ( Archive &  ar,
unsigned  version 
)

Definition at line 142 of file SamplePlayer.cc.

◆ stopRepeat()

void openmsx::SamplePlayer::stopRepeat ( )
inline

Stop repeat mode.

The currently playing sample will still be finished, but won't be started.

See also
repeat()

Definition at line 39 of file SamplePlayer.hh.

Referenced by reset(), and openmsx::RomNettouYakyuu::writeMem().


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