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

This class implements the Texas Instruments SN76489 sound chip. More...

#include <SN76489.hh>

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

Public Member Functions

 SN76489 (const DeviceConfig &config)
 
 ~SN76489 ()
 
void generateChannels (float **buffers, unsigned num) override
 Abstract method to generate the actual sound data. More...
 
void reset (EmuTime::param time)
 
void write (byte value, EmuTime::param time)
 
template<typename Archive >
void serialize (Archive &ar, unsigned version)
 
- Public Member Functions inherited from openmsx::ResampledSoundDevice
bool generateInput (float *buffer, unsigned num)
 Note: To enable various optimizations (like SSE), this method is allowed to generate up to 3 extra sample. More...
 
- Public Member Functions inherited from openmsx::SoundDevice
const std::string & getName () const
 Get the unique name that identifies this sound device. More...
 
const std::string & 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...
 
std::pair< float, float > getAmplificationFactor () const
 Gets this device its 'amplification factor'. More...
 
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)
 

Additional Inherited Members

- Public Types inherited from openmsx::ResampledSoundDevice
enum  ResampleType { RESAMPLE_HQ, RESAMPLE_LQ, RESAMPLE_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, std::string_view description, unsigned channels, unsigned inputSampleRate, bool stereo)
 
 ~ResampledSoundDevice ()
 
void setOutputRate (unsigned sampleRate) override
 When a SoundDevice registers itself with the Mixer, the Mixer sets the required sampleRate through this method. More...
 
bool updateBuffer (unsigned length, float *buffer, EmuTime::param time) override
 Generate sample data. More...
 
void update (const Setting &setting) override
 
void createResampler ()
 
- Protected Member Functions inherited from openmsx::SoundDevice
 SoundDevice (MSXMixer &mixer, std::string_view name, std::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
 
bool mixChannels (float *dataOut, unsigned samples)
 Calls generateChannels() and combines the output to a single channel. More...
 
const DynamicClockgetHostSampleClock () const
 See MSXMixer::getHostSampleClock(). More...
 
double getEffectiveSpeed () const
 
- Protected Member Functions inherited from openmsx::Observer< Setting >
 ~Observer ()=default
 
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. More...
 

Detailed Description

This class implements the Texas Instruments SN76489 sound chip.

Unlike the AY-3-8910, this chip only performs sound synthesis.

Resources used:

Definition at line 24 of file SN76489.hh.

Constructor & Destructor Documentation

◆ SN76489()

openmsx::SN76489::SN76489 ( const DeviceConfig config)

Definition at line 74 of file SN76489.cc.

References openmsx::SoundDevice::registerSound().

◆ ~SN76489()

openmsx::SN76489::~SN76489 ( )

Definition at line 84 of file SN76489.cc.

References openmsx::SoundDevice::unregisterSound().

Member Function Documentation

◆ generateChannels()

void openmsx::SN76489::generateChannels ( float **  buffers,
unsigned  num 
)
overridevirtual

Abstract method to generate the actual sound data.

Parameters
buffersAn array of pointer to buffers. Each buffer must be big enough to hold 'num' samples.
numThe number of samples.

This method should fill each buffer with sound data that corresponds to one channel of the sound device. The same channel should each time be written to the same buffer (needed for record).

If a certain channel is muted it is allowed to set the buffer pointer to nullptr. This has exactly the same effect as filling the buffer completely with zeros, but it can be more efficient.

Implements openmsx::SoundDevice.

Definition at line 281 of file SN76489.cc.

◆ reset()

void openmsx::SN76489::reset ( EmuTime::param  time)

Definition at line 135 of file SN76489.cc.

References openmsx::SoundDevice::updateStream().

◆ serialize()

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

Definition at line 303 of file SN76489.cc.

◆ write()

void openmsx::SN76489::write ( byte  value,
EmuTime::param  time 
)

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