soundfont 0.1.0

sf2 file parser
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

//! A low-level SoundFont™ file reader
//!
//! This performs no postprocessing, it just presents the data from the file as is.
//!
//! [`SFData`] is the entry point to the low-level reader,
//! its data structures should mostly reflect [SoundFont™ 2.04 spec](https://github.com/PolyMeilex/OxiSynth/wiki/SoundFont%E2%84%A2-Specification).
//!
//! For higher level abstraction see [`crate::SoundFont2`].

mod utils;

mod hydra;
mod info;
mod sample_data;

use crate::{
    error::{Error, MissingChunk},
    riff::{self, ChunkId},
};
use std::io::{Read, Seek};

pub use hydra::*;
pub use info::*;
pub use sample_data::*;

/// A low-level SoundFont™ file reader
///
/// Read [`module level docs`](self) for more information.
#[derive(Debug)]
pub struct RawSoundFontData {
    pub info: Info,
    pub sample_data: SampleData,
    pub hydra: Hydra,
}

impl RawSoundFontData {
    pub fn load<F: Read + Seek>(file: &mut F) -> Result<Self, Error> {
        let sfbk = riff::Chunk::read(file, 0)?;
        assert_eq!(sfbk.id(), ChunkId::RIFF);
        assert_eq!(sfbk.read_type(file)?, ChunkId::sfbk);

        let mut info = None;
        let mut sample_data = None;
        let mut hydra = None;

        let mut file = riff::ScratchReader::new(file);
        let mut iter = sfbk.iter();
        while let Some(ch) = iter.next(&mut file) {
            let ch = ch?;
            assert_eq!(ch.id(), ChunkId::LIST);

            match ch.read_type(&mut file)? {
                ChunkId::INFO => {
                    info = Some(Info::read(&ch, &mut file)?);
                }
                ChunkId::sdta => {
                    sample_data = Some(SampleData::read(&ch, &mut file)?);
                }
                ChunkId::pdta => {
                    hydra = Some(Hydra::read(&ch, &mut file)?);
                }
                _ => {
                    return Err(Error::UnexpectedMemberOfRoot(ch));
                }
            }
        }

        Ok(RawSoundFontData {
            info: info.ok_or(MissingChunk::Info)?,
            sample_data: sample_data.ok_or(MissingChunk::SampleData)?,
            hydra: hydra.ok_or(MissingChunk::Hydra)?,
        })
    }
}