mirror of
https://git.citron-emu.org/Citron/Citron.git
synced 2026-05-09 20:20:52 +00:00
9ae0eeeb87
- In commit b3facaa6bb, the copyright header was
updated to include "Citron Homebrew Project" across multiple files, regardless
of whether any contributions were made.
- This commit removes the incorrect attribution and reverts the copyright header
to its previous state.
- Copyright attribution should only be added when meaningful contributions have
been made to the file.
- This commit ensures proper compliance with copyright standards and maintains
correct attribution to the respective contributors.
- Special thanks to Tachi for pointing out the need for these corrections and
ensuring that proper attribution practices are followed.
88 lines
2.3 KiB
C++
88 lines
2.3 KiB
C++
// SPDX-FileCopyrightText: Copyright 2022 yuzu Emulator Project
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
#pragma once
|
|
|
|
#include <array>
|
|
#include <atomic>
|
|
#include <functional>
|
|
#include <mutex>
|
|
#include <thread>
|
|
|
|
#include "common/polyfill_thread.h"
|
|
|
|
#include "audio_core/audio_event.h"
|
|
|
|
union Result;
|
|
|
|
namespace AudioCore {
|
|
|
|
/**
|
|
* The AudioManager's main purpose is to wait for buffer events for the audio in and out managers,
|
|
* and call an associated callback to release buffers.
|
|
*
|
|
* Execution pattern is:
|
|
* Buffers appended ->
|
|
* Buffers queued and played by the backend stream ->
|
|
* When consumed, set the corresponding manager event and signal the audio manager ->
|
|
* Consumed buffers are released, game is signalled ->
|
|
* Game appends more buffers.
|
|
*
|
|
* This is only used by audio in and audio out.
|
|
*/
|
|
class AudioManager {
|
|
using BufferEventFunc = std::function<void()>;
|
|
|
|
public:
|
|
explicit AudioManager();
|
|
|
|
/**
|
|
* Shutdown the audio manager.
|
|
*/
|
|
void Shutdown();
|
|
|
|
/**
|
|
* Register the out manager, keeping a function to be called when the out event is signalled.
|
|
*
|
|
* @param buffer_func - Function to be called on signal.
|
|
* @return Result code.
|
|
*/
|
|
Result SetOutManager(BufferEventFunc buffer_func);
|
|
|
|
/**
|
|
* Register the in manager, keeping a function to be called when the in event is signalled.
|
|
*
|
|
* @param buffer_func - Function to be called on signal.
|
|
* @return Result code.
|
|
*/
|
|
Result SetInManager(BufferEventFunc buffer_func);
|
|
|
|
/**
|
|
* Set an event to signalled, and signal the thread.
|
|
*
|
|
* @param type - Manager type to set.
|
|
* @param signalled - Set the event to true or false?
|
|
*/
|
|
void SetEvent(Event::Type type, bool signalled);
|
|
|
|
private:
|
|
/**
|
|
* Main thread, waiting on a manager signal and calling the registered function.
|
|
*/
|
|
void ThreadFunc();
|
|
|
|
/// Is the main thread running?
|
|
std::atomic<bool> running{};
|
|
/// Unused
|
|
bool needs_update{};
|
|
/// Events to be set and signalled
|
|
Event events{};
|
|
/// Callbacks for each manager
|
|
std::array<BufferEventFunc, 3> buffer_events{};
|
|
/// General lock
|
|
std::mutex lock{};
|
|
/// Main thread for waiting and callbacks
|
|
std::jthread thread;
|
|
};
|
|
|
|
} // namespace AudioCore
|