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 <array>
#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 hostSampleRate, double speed) = 0;
 
        [[nodiscard]] virtual bool updateBuffer(size_t length, float* buffer,
                                                EmuTime::param time) = 0;
 
protected:
        static void addFill(float*& buffer, float value, unsigned num);
 
        virtual void generateChannels(std::span<float*> buffers, unsigned num) = 0;
 
        [[nodiscard]] bool mixChannels(float* dataOut, size_t samples);
 
        [[nodiscard]] const DynamicClock& getHostSampleClock() const;
        [[nodiscard]] double getEffectiveSpeed() const;
 
private:
        MSXMixer& mixer;
        const std::string name;
        const static_string_view description;
 
        std::array<std::optional<Wav16Writer>, MAX_CHANNELS> writer;
 
        float softwareVolumeLeft = 1.0f;
        float softwareVolumeRight = 1.0f;
        unsigned inputSampleRate;
        const unsigned numChannels;
        const unsigned stereo;
        unsigned numRecordChannels = 0;
        std::array<int,  MAX_CHANNELS> channelBalance;
        std::array<bool, MAX_CHANNELS> channelMuted;
        bool balanceCenter = true;
};
 
} // namespace openmsx
 
#endif