oxisynth 0.1.0

Rust soundfont synthesizer
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

pub mod generator;
mod instrument;
pub(crate) mod modulator;
mod preset;
mod sample;
mod sample_data;

use std::{
    io::{Read, Seek},
    sync::Arc,
};

use crate::error::LoadError;

pub(crate) use {
    instrument::InstrumentZone, preset::PresetZone, sample::Sample, sample_data::SampleData,
};

pub use preset::Preset;

pub struct SoundFont {
    presets: Vec<Arc<Preset>>,
}

// SondFont::load() might be slow due to IO or SF3 vorbis decompression,
// so we want to allow the font to be loaded on a different thread.
//
// Technically we could also do `load_asnyc()` variant, but IMO that's redundant.
const _: fn() = {
    fn assert_send_sync<T: Send + Sync>() {}
    assert_send_sync::<SoundFont>
};

impl SoundFont {
    /// Load SoundFont™ file, once loaded it can be added to the synth with [crate::Synth::add_font()].
    ///
    /// This operation might be quite slow due to blocking IO operations and potential SF3 vorbis decompression,
    /// so you might consider loading on a secondary thread. [SoundFont] is both [Send] and [Sync].
    pub fn load<F: Read + Seek>(file: &mut F) -> Result<Self, LoadError> {
        let sf2 = soundfont::SoundFont2::load(file)?;

        #[cfg(feature = "sf3")]
        let max_ver = 3;
        #[cfg(not(feature = "sf3"))]
        let max_ver = 2;

        if sf2.info.version.major > max_ver {
            return Err(LoadError::Version {
                version: sf2.info.version,
                max: max_ver,
            });
        }

        let sf2 = sf2.sort_presets();

        let sample_data = SampleData::load(file, sf2.sample_data.smpl.as_ref().unwrap())?;

        let mut samples = Vec::new();

        for sfsample in sf2.sample_headers.iter() {
            let sample = Sample::import(sfsample, sample_data.clone())?;
            samples.push(sample);
        }

        let mut presets = Vec::new();
        for sfpreset in sf2.presets.iter() {
            let preset = Preset::import(&sf2, sfpreset, &samples)?;
            presets.push(Arc::new(preset));
        }

        Ok(Self { presets })
    }

    pub(crate) fn preset(&self, bank: u32, prenum: u8) -> Option<Arc<Preset>> {
        self.presets
            .iter()
            .find(|p| p.banknum() == bank && p.num() == prenum as u32)
            .cloned()
    }
}