nord-format 0.4.0

Read and write Clavia / Nord keyboard file formats — programs, samples, set lists, settings, backups — with byte-exact round-trips
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! One synth layer's voice half: oscillator, filter, envelopes and LFO.
//!
//! ⚠️ A layer's **enable and volume are not in here** — the file packs those with
//! the other layers', a bit and 31 bits apart respectively, so they stay on the
//! owning body. This block is the part that repeats at a whole-byte stride.

use crate::components::{Interval, Level, Level6, MorphTarget, Rate, Selector, Time};
#[nord_bits_derive::bitbody(44)]
pub struct SynthVoice {
    #[bits(2..=3)]
    pub analog_type_knob_1: Selector<2>,
    #[bits(7..=9)]
    pub analog_cat_knob_2: Selector<3>,
    #[bits(11..=16)]
    pub analog_wave_partial_knob_3: Selector<6>,
    #[bits(17..=23)]
    pub osc_ctrl: Level,
    #[bits(24..=31)]
    pub osc_ctrl_wheel: MorphTarget,
    #[bits(32..=39)]
    pub osc_ctrl_aftertouch: MorphTarget,
    #[bits(40..=47)]
    pub osc_ctrl_ctrl_pedal: MorphTarget,
    #[bits(48..=54)]
    pub pitch_fine: Level,
    #[bits(55..=60)]
    pub pitch_coarse: Interval,
    #[bits(63..=69)]
    pub osc_env_attack: Time,
    #[bits(70..=76)]
    pub osc_env_decay: Time,
    #[bits(77..=83)]
    pub osc_env_release: Time,
    #[bits(84..=90)]
    pub osc_env_amount: Level,
    #[bits(91..=98)]
    pub osc_env_amount_wheel: MorphTarget,
    #[bits(99..=106)]
    pub osc_env_amount_aftertouch: MorphTarget,
    #[bits(107..=114)]
    pub osc_env_amount_ctrl_pedal: MorphTarget,
    #[bits(115..=115)]
    pub osc_env_to_pitch_enabled: bool,
    #[bits(116..=116)]
    pub osc_env_velocity_enabled: bool,
    #[bits(117..=118)]
    pub sample_options: Selector<2>,
    #[bits(119..=120)]
    pub lfo_target: Selector<2>,
    #[bits(121..=123)]
    pub lfo_shape: Selector<3>,
    #[bits(124..=124)]
    pub lfo_master_clock_enabled: bool,
    #[bits(125..=131)]
    pub lfo_rate_time: Rate,
    #[bits(132..=139)]
    pub lfo_rate_time_wheel: MorphTarget,
    #[bits(140..=147)]
    pub lfo_rate_time_aftertouch: MorphTarget,
    #[bits(148..=155)]
    pub lfo_rate_time_ctrl_pedal: MorphTarget,
    #[bits(156..=162)]
    pub lfo_mod_amount: Level,
    #[bits(163..=170)]
    pub lfo_mod_amount_wheel: MorphTarget,
    #[bits(171..=178)]
    pub lfo_mod_amount_aftertouch: MorphTarget,
    #[bits(179..=186)]
    pub lfo_mod_amount_ctrl_pedal: MorphTarget,
    #[bits(187..=193)]
    pub amp_env_attack: Time,
    #[bits(194..=200)]
    pub amp_env_decay: Time,
    #[bits(201..=207)]
    pub amp_env_release: Time,
    #[bits(208..=209)]
    pub amp_env_velocity: Selector<2>,
    #[bits(210..=212)]
    pub filter_type: Selector<3>,
    #[bits(213..=219)]
    pub filter_freq: Level,
    #[bits(220..=227)]
    pub filter_freq_wheel: MorphTarget,
    #[bits(228..=235)]
    pub filter_freq_aftertouch: MorphTarget,
    #[bits(236..=243)]
    pub filter_freq_ctrl_pedal: MorphTarget,
    #[bits(244..=250)]
    pub filter_resonance_freq_hp: Level,
    #[bits(251..=258)]
    pub filter_resonance_wheel: MorphTarget,
    #[bits(259..=266)]
    pub filter_resonance_aftertouch: MorphTarget,
    #[bits(267..=274)]
    pub filter_resonance_ctrl_pedal: MorphTarget,
    #[bits(275..=276)]
    pub filter_track: Selector<2>,
    #[bits(277..=278)]
    pub filter_drive: Selector<2>,
    #[bits(279..=285)]
    pub filter_env_amount: Level,
    #[bits(286..=293)]
    pub filter_env_amount_wheel: MorphTarget,
    #[bits(294..=301)]
    pub filter_env_amount_aftertouch: MorphTarget,
    #[bits(302..=309)]
    pub filter_env_amount_ctrl_pedal: MorphTarget,
    #[bits(310..=316)]
    pub filter_env_attack: Time,
    #[bits(317..=323)]
    pub filter_env_decay: Time,
    #[bits(324..=330)]
    pub filter_env_release: Time,
    #[bits(331..=331)]
    pub filter_velocity_enabled: bool,
    #[bits(332..=332)]
    pub filter_enabled: bool,
    #[bits(333..=339)]
    pub vibrato_rate: Rate,
    #[bits(340..=345)]
    pub vibrato_amount: Level6,
    #[bits(346..=346)]
    pub sample_bright_enabled: bool,
}