neser 0.3.1

NESER - NES Emulator in Rust. Desktop (SDL) and WebAssembly frontends.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

/// Audio output trait for the NES APU.
///
/// Implemented by `NativeAudio` (cpal backend)
/// to provide a common interface for audio playback.
#[allow(dead_code)]
pub trait EmulatorAudio {
    /// Send an audio sample to the audio output.
    ///
    /// Sends a sample to the audio callback for playback.
    /// If the buffer is full, this will block until the audio callback consumes samples.
    ///
    /// # Arguments
    /// * `sample` - Audio sample in range 0.0 to 1.0
    fn queue_sample(&mut self, sample: f32);

    /// Start audio playback.
    fn resume(&self);

    /// Pause audio playback.
    fn pause(&self);

    /// Set audio volume.
    ///
    /// # Arguments
    /// * `volume` - Volume level from 0.0 (mute) to 1.0 (full volume)
    fn set_volume(&self, volume: f32);

    /// Get current audio volume.
    ///
    /// # Returns
    /// Current volume level from 0.0 to 1.0
    fn get_volume(&self) -> f32;

    /// Pre-fills the audio buffer with silence to avoid startup underruns.
    fn prime_startup(&mut self, samples: usize);

    /// Returns and resets audio stats counters.
    ///
    /// Returns (received_samples, dropped_samples, underrun_samples).
    fn take_and_reset_stats(&self) -> (u64, u64, u64);

    /// Returns the actual sample rate of the opened audio device.
    fn actual_sample_rate(&self) -> i32;

    /// Marks all currently buffered samples as stale so the audio callback
    /// discards them silently before playing new audio.
    ///
    /// Intended to be called after an abrupt state change (e.g. save-state
    /// restore) so pre-change audio does not bleed into post-change playback.
    /// Unlike `pause()`, this does *not* change the paused state.
    fn drain_buffer(&self) {}
}