nord-format 0.1.0

Parse and write Clavia / Nord keyboard binary file formats (Electro 5, …)
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

//! Nord Stage 2 and 2 EX (`.ns2p`, `.ns2l`, `.ns2s`, `.ns2y`).
//!
//! The program body decodes in full, **both slots**. A program is 23 bytes of
//! globals then two 249-byte slot blocks of the same layout — Slot A and Slot B,
//! the two complete setups the panel's Slot buttons switch between, each with its
//! own organ, piano, synth, extern and effects. They are not copies: no corpus
//! program has them equal. Slot A's fields are unprefixed and Slot B's carry
//! `slot_b_`. The rest are container-verified stubs; the synth file (`ns2s`) is
//! Slot A's synth block, located but not yet declared. ⚠️ `s` is a synth patch here
//! (a song on the Stage 3) and `y` is the settings (a synth patch on the 3/4).

use super::raw::raw_format;

pub mod slot;
pub use slot::Slot;
pub mod program;
pub use program::Program;

pub mod live {
    //! The live buffer (`.ns2l`): same body as a program, under its own tag.

    use super::program::{self, Program};
    use crate::cbin::{self, Cbin};
    use crate::error::Error;
    use std::io::{Read, Seek};

    pub const FORMAT: &str = "ns2l";

    pub fn read_from(reader: &mut (impl Read + Seek)) -> Result<Cbin<Program>, Error> {
        let file: Cbin<Program> = cbin::read(reader, FORMAT)?;
        crate::formats::known_version(FORMAT, file.header.version, program::KNOWN_VERSIONS)?;
        Ok(file)
    }
}

raw_format!(
    /// Synth patches (`.ns2s`).
    synth,
    "ns2s",
    34
);
raw_format!(
    /// Settings (`.ns2y`).
    settings,
    "ns2y",
    32
);