game-toolkit-dosaudio 0.1.6

Emulated DOS-era sound hardware for Rust games: PC speaker, AdLib/OPL3, Sound Blaster 1 to 16, MPU-401 with General MIDI and MT-32, and Tandy PSG on one shared hardware clock
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
53
54
55
56
57
58
59
60
61

//! Usage: render_file <input.dro|imf|vgm|mid> <output.wav> [IMF Hz|SF2 path]
use game_toolkit_dosaudio::prelude::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut arguments = std::env::args().skip(1);
    let input = arguments
        .next()
        .ok_or("expected input .dro, .imf, .vgm or .mid")?;
    let output = arguments.next().ok_or("expected output .wav")?;
    let parameter = arguments.next();
    if arguments.next().is_some() {
        return Err("usage: render_file <input> <output.wav> [IMF Hz|SF2 path]".into());
    }
    let bytes = std::fs::read(&input).map_err(|e| format!("{input}: {e}"))?;
    let sequence: PreparedMusic = if bytes.starts_with(b"DBRAWOPL") {
        Dro::load(&bytes)?.into()
    } else if bytes.starts_with(b"Vgm ") || bytes.starts_with(&[0x1f, 0x8b]) {
        Vgm::load(&bytes)?
    } else if bytes.starts_with(b"MThd") {
        Smf::load(&bytes)?
    } else {
        Imf::load(
            &bytes,
            parameter
                .as_deref()
                .ok_or("IMF requires an explicit tick rate, e.g. 560")?
                .parse()?,
        )?
        .into()
    };
    let config = match sequence.target() {
        MusicTarget::Opl(chip) | MusicTarget::OplPsg(chip) => match chip {
            OplChip::Opl2 => SoundConfig::adlib(),
            OplChip::Opl3 => SoundConfig::opl3(),
            OplChip::DualOpl2 => SoundConfig::dual_opl2(),
        },
        MusicTarget::Psg => SoundConfig::none(),
        MusicTarget::Midi => midi_config(parameter.as_deref())?,
        _ => return Err("unsupported file music target".into()),
    };
    let config = match sequence.target() {
        MusicTarget::Psg | MusicTarget::OplPsg(_) => config.psg(true),
        _ => config,
    };
    let mut machine = OfflineMachine::new(config, 48_000)?;
    let _music = machine.play(sequence)?;
    std::fs::write(output, machine.render_to_end()?.to_bytes()?)?;
    Ok(())
}

#[cfg(feature = "gm")]
fn midi_config(path: Option<&str>) -> Result<SoundConfig, Box<dyn std::error::Error>> {
    let path = path.ok_or("MIDI requires a user-supplied SF2 path as the third argument")?;
    let font = game_toolkit_dosaudio::GmSynth::load_soundfont(&mut std::fs::File::open(path)?)?;
    Ok(SoundConfig::gm(font))
}

#[cfg(not(feature = "gm"))]
fn midi_config(_path: Option<&str>) -> Result<SoundConfig, Box<dyn std::error::Error>> {
    Err("MIDI rendering requires --features gm and a user-supplied SF2 path".into())
}