Struct SoundManager 

pub struct SoundManager {
    pub channels: Vec<SndChannel>,
    pub pending_callbacks: Vec<PendingDoubleBackCallback>,
    pub pending_sound_callbacks: Vec<PendingSoundCallback>,
    pub debug_cmd_count: u32,
    pub debug_buffer_cmd_count: u32,
    pub debug_double_buffer_count: u32,
    pub debug_samples_mixed: u64,
    pub debug_unhandled_cmds: Vec<u16>,
    pub debug_cmd_codes_seen: Vec<u16>,
    pub debug_file_play_count: u32,
}

Top-level sound manager state, owned by TrapDispatcher.

Fields

channels: Vec<SndChannel>

pending_callbacks: Vec<PendingDoubleBackCallback>

Pending double-buffer callbacks to fire on the next frame.

pending_sound_callbacks: Vec<PendingSoundCallback>

Pending sound callback procedures / completion routines.

debug_cmd_count: u32

Debug counters for diagnosing sound issues.

debug_buffer_cmd_count: u32

debug_double_buffer_count: u32

SndPlayDoubleBuffer submissions (SoundDispatch routine $20). Separate counter because Marathon 2 uses this path exclusively and bufferCmd-based games like EV use the other path; both feed mix_frame but through different dispatch.

debug_samples_mixed: u64

debug_unhandled_cmds: Vec<u16>

debug_cmd_codes_seen: Vec<u16>

Deduplicated list of distinct SndCommand cmd codes seen via execute_sound_command. Sibling of debug_unhandled_cmds (which only tracks the _ => arm); this tracks ALL cmd codes including the matched ones.

debug_file_play_count: u32

SndStartFilePlay (SoundDispatch routine $00) submissions. M2’s primary audio path goes through this trap and DOES NOT increment debug_buffer_cmd_count or debug_double_buffer_count. Per-path visibility: EV uses bufferCmd (debug_buffer_cmd_count), M2 uses SndStartFilePlay (debug_file_play_count), other games can use SndPlayDoubleBuffer (debug_double_buffer_count).

Implementations

impl SoundManager

pub fn new() -> Self

pub fn find_channel_mut(&mut self, guest_ptr: u32) -> Option<&mut SndChannel>

Find a channel by its guest pointer.

pub fn take_channel(&mut self, guest_ptr: u32) -> Option<SndChannel>

Remove and return a channel by guest pointer.

pub fn remove_channel(&mut self, guest_ptr: u32) -> bool

Remove a channel by guest pointer. Returns true if found.

pub fn mix_frame(&mut self, num_samples: usize) -> Vec<u8>

Process pending commands on all channels, then mix num_samples of output into a buffer of unsigned 8-bit PCM (silence = 0x80).

Trait Implementations

impl Clone for SoundManager

fn clone(&self) -> SoundManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SoundManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SoundManager

fn default() -> Self

Returns the “default value” for a type.