// Copyright 2016 Citra Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #pragma once #include #include #include #include #include #include #include #include "audio_core/audio_types.h" #include "audio_core/codec.h" #include "audio_core/hle/common.h" #include "audio_core/hle/filter.h" #include "audio_core/interpolate.h" #include "common/common_types.h" namespace Memory { class MemorySystem; } namespace AudioCore::HLE { /** * This module performs: * - Buffer management * - Decoding of buffers * - Buffer resampling and interpolation * - Per-source filtering (SimpleFilter, BiquadFilter) * - Per-source gain * - Other per-source processing */ class Source final { public: explicit Source(std::size_t source_id_) : source_id(source_id_) { Reset(); } /// Resets internal state. void Reset(); /// Sets the memory system to read data from void SetMemory(Memory::MemorySystem& memory); /** * This is called once every audio frame. This performs per-source processing every frame. * @param config The new configuration we've got for this Source from the application. * @param adpcm_coeffs ADPCM coefficients to use if config tells us to use them (may contain * invalid values otherwise). * @return The current status of this Source. This is given back to the emulated application via * SharedMemory. */ SourceStatus::Status Tick(SourceConfiguration::Configuration& config, const s16_le (&adpcm_coeffs)[16]); /** * Mix this source's output into dest, using the gains for the `intermediate_mix_id`-th * intermediate mixer. * @param dest The QuadFrame32 to mix into. * @param intermediate_mix_id The id of the intermediate mix whose gains we are using. */ void MixInto(QuadFrame32& dest, std::size_t intermediate_mix_id) const; private: const std::size_t source_id; Memory::MemorySystem* memory_system; StereoFrame16 current_frame; using Format = SourceConfiguration::Configuration::Format; using InterpolationMode = SourceConfiguration::Configuration::InterpolationMode; using MonoOrStereo = SourceConfiguration::Configuration::MonoOrStereo; /// Internal representation of a buffer for our buffer queue struct Buffer { PAddr physical_address; u32 length; u8 adpcm_ps; std::array adpcm_yn; bool adpcm_dirty; bool is_looping; u16 buffer_id; MonoOrStereo mono_or_stereo; Format format; bool from_queue; u32_dsp play_position; // = 0; bool has_played; // = false; private: template void serialize(Archive& ar, const unsigned int) { ar& physical_address; ar& length; ar& adpcm_ps; ar& adpcm_yn; ar& adpcm_dirty; ar& is_looping; ar& buffer_id; ar& mono_or_stereo; ar& format; ar& from_queue; ar& play_position; ar& has_played; } friend class boost::serialization::access; }; struct BufferOrder { bool operator()(const Buffer& a, const Buffer& b) const { // Lower buffer_id comes first. return a.buffer_id > b.buffer_id; } }; struct { // State variables bool enabled = false; u16 sync = 0; // Mixing std::array, 3> gain = {}; // Buffer queue std::priority_queue, BufferOrder> input_queue = {}; MonoOrStereo mono_or_stereo = MonoOrStereo::Mono; Format format = Format::ADPCM; // Current buffer u32 current_sample_number = 0; u32 next_sample_number = 0; AudioInterp::StereoBuffer16 current_buffer = {}; // buffer_id state bool buffer_update = false; u32 current_buffer_id = 0; // Decoding state std::array adpcm_coeffs = {}; Codec::ADPCMState adpcm_state = {}; // Resampling state float rate_multiplier = 1.0; InterpolationMode interpolation_mode = InterpolationMode::Polyphase; AudioInterp::State interp_state = {}; // Filter state SourceFilters filters = {}; private: template void serialize(Archive& ar, const unsigned int) { ar& enabled; ar& sync; ar& gain; ar& input_queue; ar& mono_or_stereo; ar& format; ar& current_sample_number; ar& next_sample_number; ar& current_buffer; ar& buffer_update; ar& current_buffer_id; ar& adpcm_coeffs; ar& rate_multiplier; ar& interpolation_mode; } friend class boost::serialization::access; } state; // Internal functions /// INTERNAL: Update our internal state based on the current config. void ParseConfig(SourceConfiguration::Configuration& config, const s16_le (&adpcm_coeffs)[16]); /// INTERNAL: Generate the current audio output for this frame based on our internal state. void GenerateFrame(); /// INTERNAL: Dequeues a buffer and does preprocessing on it (decoding, resampling). Puts it /// into current_buffer. bool DequeueBuffer(); /// INTERNAL: Generates a SourceStatus::Status based on our internal state. SourceStatus::Status GetCurrentStatus(); template void serialize(Archive& ar, const unsigned int) { ar& state; } friend class boost::serialization::access; }; } // namespace AudioCore::HLE