MSXMixer.hh

Go to the documentation of this file.

#ifndef MSXMIXER_HH
#define MSXMIXER_HH
 
#include "DynamicClock.hh"
#include "EmuTime.hh"
#include "InfoTopic.hh"
#include "Mixer.hh"
#include "Schedulable.hh"
 
#include "Observer.hh"
#include "dynarray.hh"
 
#include <memory>
#include <span>
#include <vector>
 
namespace openmsx {
 
class SoundDevice;
class Mixer;
class MSXMotherBoard;
class MSXCommandController;
class GlobalSettings;
class SpeedManager;
class ThrottleManager;
class IntegerSetting;
class StringSetting;
class BooleanSetting;
class Setting;
class AviRecorder;
 
class MSXMixer final : private Schedulable, private Observer<Setting>
                     , private Observer<SpeedManager>
                     , private Observer<ThrottleManager>
{
public:
        // See SoundDevice::getAmplificationFactor()
        // and MSXMixer::updateVolumeParams()
        static constexpr int AMP_BITS = 9;
 
        struct SoundDeviceInfo {
                explicit SoundDeviceInfo(unsigned numChannels);
 
                SoundDevice* device = nullptr;
                std::unique_ptr<IntegerSetting> volumeSetting;
                std::unique_ptr<IntegerSetting> balanceSetting;
                struct ChannelSettings {
                        std::unique_ptr<StringSetting> record;
                        std::unique_ptr<BooleanSetting> mute;
                };
                dynarray<ChannelSettings> channelSettings;
                float defaultVolume = 0.f;
                float left1 = 0.f, right1 = 0.f, left2 = 0.f, right2 = 0.f;
        };
 
public:
        MSXMixer(const MSXMixer&) = delete;
        MSXMixer& operator=(const MSXMixer&) = delete;
 
        MSXMixer(Mixer& mixer, MSXMotherBoard& motherBoard,
                 GlobalSettings& globalSettings);
        ~MSXMixer();
 
        void registerSound(SoundDevice& device, float volume,
                           int balance, unsigned numChannels);
 
        void unregisterSound(SoundDevice& device);
 
        void updateStream(EmuTime::param time);
 
        void updateSoftwareVolume(SoundDevice& device);
 
        [[nodiscard]] double getEffectiveSpeed() const;
 
        void setSynchronousMode(bool synchronous);
        [[nodiscard]] bool isSynchronousMode() const { return synchronousCounter != 0; }
 
        void mute();
        void unmute();
 
        // Called by Mixer or SoundDriver
 
        void setMixerParams(unsigned fragmentSize, unsigned sampleRate);
 
        [[nodiscard]] const DynamicClock& getHostSampleClock() const { return prevTime; }
 
        // Called by AviRecorder
        [[nodiscard]] bool needStereoRecording() const;
        void setRecorder(AviRecorder* recorder);
 
        // Returns the nominal host sample rate (not adjusted for speed setting)
        [[nodiscard]] unsigned getSampleRate() const { return hostSampleRate; }
 
        [[nodiscard]] SoundDevice* findDevice(std::string_view name) const;
        [[nodiscard]] const SoundDeviceInfo* findDeviceInfo(std::string_view name) const;
        [[nodiscard]] const auto& getDeviceInfos() const { return infos; }
 
        void reInit();
 
private:
        void updateVolumeParams(SoundDeviceInfo& info) const;
        void updateMasterVolume();
        void reschedule();
        void reschedule2();
        void generate(std::span<StereoFloat> output, EmuTime::param time);
 
        // Schedulable
        void executeUntil(EmuTime::param time) override;
 
        // Observer<Setting>
        void update(const Setting& setting) noexcept override;
        // Observer<SpeedManager>
        void update(const SpeedManager& speedManager) noexcept override;
        // Observer<ThrottleManager>
        void update(const ThrottleManager& throttleManager) noexcept override;
 
        void changeRecordSetting(const Setting& setting);
        void changeMuteSetting(const Setting& setting);
 
private:
        unsigned fragmentSize;
        unsigned hostSampleRate; // requested freq by sound driver,
                                 // not compensated for speed
 
        std::vector<SoundDeviceInfo> infos;
 
        Mixer& mixer;
        MSXMotherBoard& motherBoard;
        MSXCommandController& commandController;
 
        IntegerSetting& masterVolume;
        SpeedManager& speedManager;
        ThrottleManager& throttleManager;
 
        DynamicClock prevTime;
 
        struct SoundDeviceInfoTopic final : InfoTopic {
                explicit SoundDeviceInfoTopic(InfoCommand& machineInfoCommand);
                void execute(std::span<const TclObject> tokens,
                             TclObject& result) const override;
                [[nodiscard]] std::string help(std::span<const TclObject> tokens) const override;
                void tabCompletion(std::vector<std::string>& tokens) const override;
        } soundDeviceInfo;
 
        AviRecorder* recorder = nullptr;
        unsigned synchronousCounter = 0;
 
        unsigned muteCount;
        float tl0, tr0; // internal DC-filter state
};
 
} // namespace openmsx
 
#endif