NeuralAmpModeler-rs 3.0.2

An opinionated, high-performance Neural Amp Modeler (NAM) client and core implementation in Rust for Linux/PipeWire and CLAP plugins.
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

// SPDX-License-Identifier: Apache-2.0
// Copyright (c) 2026 Fábio Henrique de Lima Silva (fhl.bsb@gmail.com) All rights reserved.

use super::super::NamClapProcessor;
use std::sync::atomic::Ordering;

impl<'a> NamClapProcessor<'a> {
    #[inline(always)]
    #[expect(
        dead_code,
        reason = "Code path retained for future feature integration but not yet wired"
    )]
    pub(super) fn apply_input_gain_sub_block(&mut self, offset: usize, n_samples: usize) {
        let mut input_has_clipped = false;
        #[cfg(feature = "stereo")]
        {
            let start = self.smoother_in.peek();
            let target = self.smoother_in.target_value();
            if (start - target).abs() < 1e-9 {
                input_has_clipped = unsafe {
                    crate::math::dsp::gain::apply_gain_and_detect_clipping_stereo(
                        &mut self.buf_host_l[offset..offset + n_samples],
                        &mut self.buf_host_r[offset..offset + n_samples],
                        start,
                    )
                };
            } else {
                let step = (target - start) / n_samples as f32;
                unsafe {
                    crate::math::dsp::gain::apply_ramp_stereo(
                        &mut self.buf_host_l[offset..offset + n_samples],
                        &mut self.buf_host_r[offset..offset + n_samples],
                        start,
                        step,
                    );
                }
                self.smoother_in.set(target);
                let (peak_l, peak_r) = unsafe {
                    crate::math::dsp::stereo::compute_peak_abs_stereo(
                        &self.buf_host_l[offset..offset + n_samples],
                        &self.buf_host_r[offset..offset + n_samples],
                    )
                };
                if peak_l > 1.0 || peak_r > 1.0 {
                    input_has_clipped = true;
                }
            }
        }
        #[cfg(not(feature = "stereo"))]
        {
            let start = self.smoother_in.peek();
            let target = self.smoother_in.target_value();
            if (start - target).abs() < 1e-9 {
                input_has_clipped = unsafe {
                    crate::math::dsp::gain::apply_gain_and_detect_clipping_mono(
                        &mut self.buf_host_l[offset..offset + n_samples],
                        start,
                    )
                };
            } else {
                let step = (target - start) / n_samples as f32;
                crate::math::dsp::gain::apply_ramp_simd(
                    &mut self.buf_host_l[offset..offset + n_samples],
                    start,
                    step,
                );
                self.smoother_in.set(target);
                for &sample in &self.buf_host_l[offset..offset + n_samples] {
                    if sample.abs() > 1.0 {
                        input_has_clipped = true;
                        break;
                    }
                }
            }
        }
        if input_has_clipped {
            self.shared
                .rt_to_ui
                .ui_clipped
                .store(true, Ordering::Relaxed);
        }
    }

    #[inline(always)]
    #[expect(
        dead_code,
        reason = "Code path retained for future feature integration but not yet wired"
    )]
    pub(super) fn apply_output_gain_sub_block(&mut self, n_out: usize) {
        #[cfg(feature = "stereo")]
        {
            let start = self.smoother_out.peek();
            let target = self.smoother_out.target_value();
            if (start - target).abs() < 1e-9 {
                unsafe {
                    crate::math::dsp::gain::apply_gain_stereo(
                        &mut self.buf_out_l[..n_out],
                        &mut self.buf_out_r[..n_out],
                        start,
                    );
                }
            } else {
                let step = (target - start) / n_out as f32;
                unsafe {
                    crate::math::dsp::gain::apply_ramp_stereo(
                        &mut self.buf_out_l[..n_out],
                        &mut self.buf_out_r[..n_out],
                        start,
                        step,
                    );
                }
                self.smoother_out.set(target);
            }
        }
        #[cfg(not(feature = "stereo"))]
        {
            let start = self.smoother_out.peek();
            let target = self.smoother_out.target_value();
            if (start - target).abs() < 1e-9 {
                crate::math::dsp::gain::apply_gain_simd(&mut self.buf_out_l[..n_out], start);
            } else {
                let step = (target - start) / n_out as f32;
                crate::math::dsp::gain::apply_ramp_simd(&mut self.buf_out_l[..n_out], start, step);
                self.smoother_out.set(target);
            }
        }
    }
}