SoundDevice.hh

Go to the documentation of this file.

#ifndef SOUNDDEVICE_HH
#define SOUNDDEVICE_HH
 
#include "EmuTime.hh"
#include "WavWriter.hh"
#include "static_string_view.hh"
#include <optional>
#include <string>
#include <string_view>
 
namespace openmsx {
 
class DeviceConfig;
class DynamicClock;
class Filename;
class MSXMixer;
 
class SoundDevice
{
public:
        static constexpr unsigned MAX_CHANNELS = 24;
 
        SoundDevice(const SoundDevice&) = delete;
        SoundDevice& operator=(const SoundDevice&) = delete;
 
        [[nodiscard]] const std::string& getName() const { return name; }
 
        [[nodiscard]] std::string_view getDescription() const { return description; }
 
        [[nodiscard]] bool isStereo() const;
 
        struct AmplificationFactors {
                float left;
                float right;
        };
        [[nodiscard]] AmplificationFactors getAmplificationFactor() const {
                auto f = getAmplificationFactorImpl();
                return {f * softwareVolumeLeft, f * softwareVolumeRight};
        }
 
        void setSoftwareVolume(float volume, EmuTime::param time);
        void setSoftwareVolume(float left, float right, EmuTime::param time);
 
        void recordChannel(unsigned channel, const Filename& filename);
        void muteChannel  (unsigned channel, bool muted);
 
protected:
        SoundDevice(MSXMixer& mixer, std::string_view name, static_string_view description,
                    unsigned numChannels, unsigned inputRate, bool stereo);
        ~SoundDevice();
 
        [[nodiscard]] virtual float getAmplificationFactorImpl() const;
 
        void registerSound(const DeviceConfig& config);
 
        void unregisterSound();
 
        void updateStream(EmuTime::param time);
 
        void setInputRate(unsigned sampleRate) { inputSampleRate = sampleRate; }
        [[nodiscard]] unsigned getInputRate() const { return inputSampleRate; }
 
public: // Will be called by Mixer:
        virtual void setOutputRate(unsigned sampleRate) = 0;
 
        [[nodiscard]] virtual bool updateBuffer(unsigned length, float* buffer,
                                                EmuTime::param time) = 0;
 
protected:
        static void addFill(float*& buffer, float value, unsigned num);
 
        virtual void generateChannels(float** buffers, unsigned num) = 0;
 
        [[nodiscard]] bool mixChannels(float* dataOut, unsigned samples);
 
        [[nodiscard]] const DynamicClock& getHostSampleClock() const;
        [[nodiscard]] double getEffectiveSpeed() const;
 
private:
        MSXMixer& mixer;
        const std::string name;
        const static_string_view description;
 
        std::optional<Wav16Writer> writer[MAX_CHANNELS];
 
        float softwareVolumeLeft = 1.0f;
        float softwareVolumeRight = 1.0f;
        unsigned inputSampleRate;
        const unsigned numChannels;
        const unsigned stereo;
        unsigned numRecordChannels;
        int channelBalance[MAX_CHANNELS];
        bool channelMuted[MAX_CHANNELS];
        bool balanceCenter;
};
 
} // namespace openmsx
 
#endif