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
144
145
146
147
148
149
150
151
152
153
use crate::dsp::{
DspNode, GraphFun, LedPhaseVals, NodeContext, NodeGlobalRef, NodeId, ProcBuf, SAtom,
};
use crate::nodes::{NodeAudioContext, NodeExecContext};
#[macro_export]
macro_rules! fa_map_clip {
($formatter: expr, $v: expr, $denorm_v: expr) => {{
let s = match ($v.round() as usize) {
0 => "Off",
1 => "Clip",
_ => "?",
};
write!($formatter, "{}", s)
}};
}
#[derive(Debug, Clone)]
pub struct Map {}
impl Map {
pub fn new(_nid: &NodeId, _node_global: &NodeGlobalRef) -> Self {
Self {}
}
pub const inp: &'static str = "Signal input";
pub const atv: &'static str =
"Input signal attenuverter, to attenuate or invert the input signal.";
pub const offs: &'static str = "Input signal offset after ~~atv~~ has been applied.";
pub const imin: &'static str = "Minimum of the input signal range, \
it's mapped to the ~~min~~ output signal range.";
pub const imax: &'static str = "Maximum of the input signal range, \
it's mapped to the ~~max~~ output signal range.";
pub const min: &'static str = "Minimum of the output signal range.";
pub const max: &'static str = "Maximum of the output signal range.";
pub const clip: &'static str = "The ~~clip~~ mode allows you to limit the output \
exactly to the ~~min~~/~~max~~ range. If this is off, the output \
may be outside the output signal range if the input signal is \
outside the input signal range.";
pub const sig: &'static str = "Mapped signal output";
pub const DESC: &'static str = r#"Range Mapper
This node allows to map an input signal range to a precise output signal range.
It's mostly useful to map control signals to modulate inputs.
See also the `SMap` node, which is a simplified version of this node.
"#;
pub const HELP: &'static str = r#"Range Mapper
This node allows to map an input signal range to a precise output signal
range. It's main use is for precise control of an input of another node.
It processes the input signal as follows. First the input is attenuverted
using the ~~atv~~ parameter and then the ~~offs~~ offset parameter is added:
```text
inp * atv + offs
```
The resulting signal is then processed by the mapping, that maps
the input signal range ~~imin~~/~~imax~~ to the ouput signal range ~~min~~/~~max~~.
The ~~clip~~ mode allows you to limit the output exactly to the ~~min~~/~~max~~
range. If this is off, the output may be outside the output signal
range if the input signal is outside the input signal range.
This can also be used to invert the signal.
For a more simplified version of this node see also `SMap`.
"#;
pub fn graph_fun() -> Option<GraphFun> {
None
}
}
impl DspNode for Map {
fn set_sample_rate(&mut self, _srate: f32) {}
fn reset(&mut self) {}
#[inline]
fn process(
&mut self,
ctx: &mut dyn NodeAudioContext,
_ectx: &mut NodeExecContext,
_nctx: &NodeContext,
atoms: &[SAtom],
inputs: &[ProcBuf],
outputs: &mut [ProcBuf],
ctx_vals: LedPhaseVals,
) {
use crate::dsp::{at, inp, out};
let inp = inp::Map::inp(inputs);
let atv = inp::Map::atv(inputs);
let offs = inp::Map::offs(inputs);
let imin = inp::Map::imin(inputs);
let imax = inp::Map::imax(inputs);
let min = inp::Map::min(inputs);
let max = inp::Map::max(inputs);
let out = out::Map::sig(outputs);
let clip = at::Map::clip(atoms);
let mut last_val = 0.0;
if clip.i() == 0 {
for frame in 0..ctx.nframes() {
let s = (inp.read(frame) * atv.read(frame)) + offs.read(frame);
let imin = imin.read(frame);
let imax = imax.read(frame);
let min = min.read(frame);
let max = max.read(frame);
let x = if (imax - imin).abs() < std::f32::EPSILON {
1.0
} else {
((s - imin) / (imax - imin)).abs()
};
last_val = x;
let s = min + (max - min) * x;
out.write(frame, s);
}
} else {
for frame in 0..ctx.nframes() {
let s = (inp.read(frame) * atv.read(frame)) + offs.read(frame);
let imin = imin.read(frame);
let imax = imax.read(frame);
let min = min.read(frame);
let max = max.read(frame);
let x = if (imax - imin).abs() < std::f32::EPSILON {
1.0
} else {
((s - imin) / (imax - imin)).abs()
};
last_val = x;
let s = min + (max - min) * x;
out.write(frame, if min < max { s.clamp(min, max) } else { s.clamp(max, min) });
}
}
ctx_vals[0].set(last_val);
}
}
