Files
Dreierpack-Manager/src/audio/original.hpp
T

67 lines
2.5 KiB
C++

// SPDX-License-Identifier: GPL-3.0-only
#pragma once
#include <array>
#include <cstdint>
#include <functional>
#include <memory>
#include <span>
#include <string>
#include <vector>
namespace openbmh::audio {
// Read from the user's executable by the application. Audio does not know the
// game state, filesystem layout, simulation clock, or random generators.
struct OriginalTables {
std::array<std::uint16_t, 96> frequencies{}; // Audio_OriginalAudioAssets_RuntimeField2, including key-on bits
std::array<std::uint8_t, 9> operators{}; // Audio_OriginalAudioAssets_RuntimeField, stride16
};
struct OriginalAssets {
std::array<std::vector<std::uint8_t>, 4> containers; // S/2000..2003
OriginalTables tables;
};
struct OriginalAudioOptions {
bool music = true;
bool effects = true;
bool clicks = true;
};
struct OriginalAudioStats {
std::uint64_t ticks{}, register_writes{}, sample_starts{}, frames{};
std::uint32_t bar{}, step{}, song = 255;
bool playing{}, ambient{}, failed{};
};
// The Original MIDILINK sequencer and one Sound Blaster PCM channel. IRQ0 uses
// PIT divisor0x199a. SONG/TRCK/PART, OPL instruments, SFX priorities/lifetimes,
// note durations, sample interruption and the looping crowd are Source-derived.
// Loading owns/validates its inputs. render() allocates nothing and never blocks.
class OriginalSynth {
public:
OriginalSynth();
~OriginalSynth();
OriginalSynth(const OriginalSynth&) = delete;
OriginalSynth& operator=(const OriginalSynth&) = delete;
bool load(OriginalAssets assets, std::uint32_t output_rate, std::string& error);
bool ready() const noexcept;
void set_options(OriginalAudioOptions options) noexcept;
// Source dispatch IDs:0 title,1 desk,2 intro,3 crowd,8 stop,10..22 effects.
bool command(std::uint8_t id) noexcept;
// Direct SFX entry, also used by the standalone driver/oracle.
bool effect(std::uint8_t id) noexcept;
void stop() noexcept;
void render(std::span<std::int16_t> output, float volume = 1.0F) noexcept;
OriginalAudioStats stats() const noexcept;
// Deterministic hardware-independent probe: one Original IRQ0, not one game
// tick. Optional observers are installed only by offline validation tools.
void tick() noexcept;
void set_register_observer(std::function<void(std::uint8_t, std::uint8_t)> observer);
void set_sample_observer(std::function<void(std::uint8_t)> observer);
private:
struct State;
std::unique_ptr<State> state_;
};
} // namespace openbmh::audio