devalang 0.2.0

Write music with code. Devalang is a domain-specific language (DSL) for sound designers and music hackers. Compose, automate, and control sound — in plain text.
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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use std::fmt;

#[cfg(feature = "cli")]
use clap::ValueEnum;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[cfg_attr(feature = "cli", derive(ValueEnum))]
#[cfg_attr(feature = "cli", clap(rename_all = "lower"))]
pub enum AudioFormat {
    Mp3,
    Wav,
    Flac,
    Mid, // MIDI format
}

impl Default for AudioFormat {
    fn default() -> Self {
        AudioFormat::Mp3
    }
}

impl AudioFormat {
    pub fn label(self) -> &'static str {
        match self {
            AudioFormat::Mp3 => "mp3",
            AudioFormat::Wav => "wav",
            AudioFormat::Flac => "flac",
            AudioFormat::Mid => "mid",
        }
    }

    pub fn file_extension(self) -> &'static str {
        self.label()
    }

    /// Parse format from string
    pub fn from_str(s: &str) -> Option<Self> {
        match s.to_lowercase().as_str() {
            "mp3" => Some(AudioFormat::Mp3),
            "wav" => Some(AudioFormat::Wav),
            "flac" => Some(AudioFormat::Flac),
            "mid" | "midi" => Some(AudioFormat::Mid),
            _ => None,
        }
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[cfg_attr(feature = "cli", derive(ValueEnum))]
#[cfg_attr(feature = "cli", clap(rename_all = "lower"))]
pub enum AudioBitDepth {
    #[cfg_attr(feature = "cli", clap(alias = "8"))]
    Bit8,
    #[cfg_attr(feature = "cli", clap(alias = "16"))]
    Bit16,
    #[cfg_attr(feature = "cli", clap(alias = "24"))]
    Bit24,
    #[cfg_attr(feature = "cli", clap(alias = "32"))]
    Bit32,
}

impl Default for AudioBitDepth {
    fn default() -> Self {
        AudioBitDepth::Bit16
    }
}

impl AudioBitDepth {
    pub fn bits(self) -> u16 {
        match self {
            AudioBitDepth::Bit8 => 8,
            AudioBitDepth::Bit16 => 16,
            AudioBitDepth::Bit24 => 24,
            AudioBitDepth::Bit32 => 32,
        }
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[cfg_attr(feature = "cli", derive(ValueEnum))]
#[cfg_attr(feature = "cli", clap(rename_all = "lower"))]
pub enum AudioChannels {
    #[cfg_attr(feature = "cli", clap(alias = "1"))]
    Mono,
    #[cfg_attr(feature = "cli", clap(alias = "2"))]
    Stereo,
}

impl Default for AudioChannels {
    fn default() -> Self {
        AudioChannels::Stereo
    }
}

impl AudioChannels {
    pub fn count(self) -> u16 {
        match self {
            AudioChannels::Mono => 1,
            AudioChannels::Stereo => 2,
        }
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[cfg_attr(feature = "cli", derive(ValueEnum))]
#[cfg_attr(feature = "cli", clap(rename_all = "kebab-case"))]
pub enum ResampleQuality {
    #[cfg_attr(feature = "cli", clap(alias = "linear"))]
    Linear2,
    #[cfg_attr(feature = "cli", clap(alias = "sinc-12"))]
    Sinc12,
    Sinc24,
    Sinc48,
    Sinc96,
    Sinc192,
    Sinc512,
}

impl Default for ResampleQuality {
    fn default() -> Self {
        ResampleQuality::Sinc24
    }
}

impl ResampleQuality {
    pub fn label(self) -> &'static str {
        match self {
            ResampleQuality::Linear2 => "2-point linear",
            ResampleQuality::Sinc12 => "12-point sinc",
            ResampleQuality::Sinc24 => "24-point sinc",
            ResampleQuality::Sinc48 => "48-point sinc",
            ResampleQuality::Sinc96 => "96-point sinc",
            ResampleQuality::Sinc192 => "192-point sinc",
            ResampleQuality::Sinc512 => "512-point sinc",
        }
    }
}

impl fmt::Display for ResampleQuality {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.label())
    }
}