ksynth 0.18.0

Patch manipulation for Kawai digital synths
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

use std::fmt;
use rand::Rng;

use crate::Ranged;

pub mod amp;
pub mod effect;
pub mod filter;
pub mod lfo;
pub mod multi;
pub mod single;
pub mod source;
pub mod wave;
pub mod drum;
pub mod bank;
pub mod sysex;

/// Length of patch name
pub const NAME_LENGTH: usize = 10;

/// Number of sources in a single patch
pub const SOURCE_COUNT: usize = 4;

/// Number of DRUM notes
pub const DRUM_NOTE_COUNT: usize = 61;

/// Number of submix channels / outputs
pub const SUBMIX_COUNT: usize = 8;

fn get_effect_number(b: u8) -> u8 {
    let value = b & 0b00011111;
    // Now we should have a value in the range 0~31.
    // Use range 1~32 when storing the value.
    value + 1
}

/// Envelope time for DCA/DCF attack, decay and release
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct EnvelopeTime(i32);
crate::ranged_impl!(EnvelopeTime, 0, 100, 0);

/// Envelope level for DCA/DCF sustain (level from 0 to 100)
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct EnvelopeLevel(i32);
crate::ranged_impl!(EnvelopeLevel, 0, 100, 0);

#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Level(i32);
crate::ranged_impl!(Level, 0, 100, 0);

/// Depth used for DCA/DCF modulation values
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct ModulationDepth(i32);
crate::ranged_impl!(ModulationDepth, -50, 50, 0);

/// Drum source 1 and 2 decay
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Decay(i32);
crate::ranged_impl!(Decay, 1, 100, 0);

/// Small effect parameter
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct SmallEffectParameter(i32);
crate::ranged_impl!(SmallEffectParameter, -7, 7, 0);

/// Big effect parameter
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct BigEffectParameter(i32);
crate::ranged_impl!(BigEffectParameter, 0, 31, 0);

/// Envelope level for DCF sustain
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct FilterEnvelopeLevel(i32);
crate::ranged_impl!(FilterEnvelopeLevel, -50, 50, 0);

/// Filter cutoff
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Cutoff(i32);
crate::ranged_impl!(Cutoff, 0, 100, 0);

/// Filter resonance
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Resonance(i32);
crate::ranged_impl!(Resonance, 0, 7, 0);

/// Effect number
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct EffectNumber(i32);
crate::ranged_impl!(EffectNumber, 1, 32, 0);

/// Velocity or Key Scaling curve 1~8
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Curve(i32);
crate::ranged_impl!(Curve, 1, 8, 1);

/// DCO coarse tuning
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Coarse(i32);
crate::ranged_impl!(Coarse, -24, 24, 0);

/// DCO fine tuning
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Fine(i32);
crate::ranged_impl!(Fine, -50, 50, 0);

/// Wave number
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct WaveNumber(i32);
crate::ranged_impl!(WaveNumber, 1, 256, 0);

/// Patch number 0...63 (can be converted to A-1...D-16)
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct PatchNumber(i32);
crate::ranged_impl!(PatchNumber, 0, 63, 0);

/// Transpose
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Transpose(i32);
crate::ranged_impl!(Transpose, -24, 24, 0); // +-24 (in SysEx 0~48)