Struct SoundConfig 

pub struct SoundConfig { /* private fields */ }

Hardware and output configuration. Builders are validated by DosAudio::split.

Implementations

impl SoundConfig

pub fn none() -> Self

No installed sound hardware.

pub fn adlib() -> Self

An AdLib with an OPL2 at ports 388h/389h.

pub fn sb2() -> Self

Sound Blaster 2.0 at 220h, IRQ 5, DMA 1, with its OPL2.

pub fn sb1() -> Self

An original Sound Blaster using the default ISA resources.

pub fn sb_pro() -> Self

A first-generation Sound Blaster Pro with dual OPL2.

pub fn sb_pro2() -> Self

A Sound Blaster Pro 2 with OPL3.

pub fn sb16() -> Self

A Sound Blaster 16, with byte DMA 1 and word DMA 5.

pub fn sb_model(self, model: SbModel) -> Self

Select a DSP model, installing default ISA resources if no card is present.

pub fn dma16(self, channel: u8) -> Self

Select SB16 DMA: word channel 5/6/7, or the same byte channel as D.

pub fn from_blaster(value: &str) -> Result<Self>

Parse a BLASTER value containing A (hex), I, D, T and optional H fields.

A/I/D/T are required; T values 1/2/3/4/6 select SB1/Pro/SB2/Pro2/SB16. H is valid only for SB16 and defaults to 5. Unknown or duplicate fields are errors. Resource and feature validation also runs at construction.

pub fn sound_blaster(self, resources: SoundBlasterConfig) -> Self

Install a Sound Blaster 2.0 and its OPL2 using the supplied ISA resources.

pub fn opl3() -> Self

An OPL3 at ports 388h through 38Bh.

pub fn dual_opl2() -> Self

Two OPL2 chips at ports 388h through 38Bh.

pub fn speaker(self, enabled: bool) -> Self

Install or remove PIT channel 2 and the PC speaker.

pub fn mpu401(self, backend: MidiBackend) -> Self

Install an MPU-401 UART and MIDI synthesis backend.

pub fn midi_port(self, base: u16) -> Self

Relocate the MPU-401 to an aligned base in 300h through 360h.

pub fn psg(self, enabled: bool) -> Self

Install or remove the Tandy SN76489 PSG at C0h.

pub fn opl_backend(self, backend: OplBackend) -> Self

Select the FM synthesis backend.

pub fn sample_rate(self, sample_rate: u32) -> Self

Output sample rate, from 8,000 through 192,000 Hz.

pub fn queue_capacity(self, capacity: usize) -> Self

Fixed command queue capacity; must be nonzero.

pub fn latency(self, latency: Tick) -> Self

Delay timestamped port writes by this much output time.

Live playback defaults to 10 ms. Offline machines force zero latency. Increase this for a host with a larger audio callback or game-frame jitter.

Trait Implementations

impl Clone for SoundConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SoundConfig

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

Formats the value using the given formatter.

impl Default for SoundConfig

fn default() -> Self

Returns the “default value” for a type.