2 Copyright (C) 2006 Paul Davis
4 This program is free software; you can redistribute it and/or modify it
5 under the terms of the GNU General Public License as published by the Free
6 Software Foundation; either version 2 of the License, or (at your option)
9 This program is distributed in the hope that it will be useful, but WITHOUT
10 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 You should have received a copy of the GNU General Public License along
15 with this program; if not, write to the Free Software Foundation, Inc.,
16 675 Mass Ave, Cambridge, MA 02139, USA.
23 #include "evoral/Curve.hpp"
25 #include "ardour/amp.h"
26 #include "ardour/audio_buffer.h"
27 #include "ardour/buffer_set.h"
28 #include "ardour/gain_control.h"
29 #include "ardour/midi_buffer.h"
30 #include "ardour/rc_configuration.h"
31 #include "ardour/session.h"
35 using namespace ARDOUR;
38 #define GAIN_COEFF_DELTA (1e-5)
40 Amp::Amp (Session& s, const std::string& name, boost::shared_ptr<GainControl> gc, bool control_midi_also)
42 , _apply_gain_automation(false)
43 , _current_gain(GAIN_COEFF_ZERO)
44 , _current_automation_sample (INT64_MAX)
46 , _gain_automation_buffer(0)
47 , _midi_amp (control_midi_also)
49 set_display_name (name);
50 add_control (_gain_control);
54 Amp::can_support_io_configuration (const ChanCount& in, ChanCount& out)
61 Amp::configure_io (ChanCount in, ChanCount out)
63 if (out != in) { // always 1:1
67 return Processor::configure_io (in, out);
71 scale_midi_velocity(Evoral::Event<MidiBuffer::TimeType>& ev, float factor)
73 factor = std::max(factor, 0.0f);
74 ev.set_velocity(std::min(127L, lrintf(ev.velocity() * factor)));
78 Amp::run (BufferSet& bufs, samplepos_t /*start_sample*/, samplepos_t /*end_sample*/, double /*speed*/, pframes_t nframes, bool)
80 if (!_active && !_pending_active) {
81 /* disregard potentially prepared gain-automation. */
82 _apply_gain_automation = false;
86 if (_apply_gain_automation) {
88 gain_t* gab = _gain_automation_buffer;
91 /* see note in PluginInsert::connect_and_run -- effectively emit Changed signal */
92 _gain_control->set_value_unchecked (gab[0]);
95 for (BufferSet::midi_iterator i = bufs.midi_begin(); i != bufs.midi_end(); ++i) {
97 for (MidiBuffer::iterator m = mb.begin(); m != mb.end(); ++m) {
98 Evoral::Event<MidiBuffer::TimeType> ev = *m;
99 if (ev.is_note_on()) {
100 assert(ev.time() >= 0 && ev.time() < nframes);
101 scale_midi_velocity (ev, fabsf (gab[ev.time()]));
107 const gain_t a = 156.825f / (gain_t)_session.nominal_sample_rate(); // 25 Hz LPF; see Amp::apply_gain for details
108 gain_t lpf = _current_gain;
110 for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i) {
111 Sample* const sp = i->data();
113 for (pframes_t nx = 0; nx < nframes; ++nx) {
115 lpf += a * (gab[nx] - lpf);
119 if (fabsf (lpf) < GAIN_COEFF_SMALL) {
120 _current_gain = GAIN_COEFF_ZERO;
125 /* used it, don't do it again until setup_gain_automation() is
126 * called successfully.
128 _apply_gain_automation = false;
130 } else { /* manual (scalar) gain */
132 gain_t const target_gain = _gain_control->get_value();
134 if (fabsf (_current_gain - target_gain) >= GAIN_COEFF_DELTA) {
136 _current_gain = Amp::apply_gain (bufs, _session.nominal_sample_rate(), nframes, _current_gain, target_gain, _midi_amp);
138 /* see note in PluginInsert::connect_and_run ()
139 * set_value_unchecked() won't emit a signal since the value is effectively unchanged
141 _gain_control->Changed (false, PBD::Controllable::NoGroup);
143 } else if (target_gain != GAIN_COEFF_UNITY) {
145 _current_gain = target_gain;
148 /* don't Trim midi velocity -- only relevant for Midi on Audio tracks */
149 for (BufferSet::midi_iterator i = bufs.midi_begin(); i != bufs.midi_end(); ++i) {
153 for (MidiBuffer::iterator m = mb.begin(); m != mb.end(); ++m) {
154 Evoral::Event<MidiBuffer::TimeType> ev = *m;
155 if (ev.is_note_on()) {
156 scale_midi_velocity (ev, fabsf (_current_gain));
162 for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i) {
163 apply_gain_to_buffer (i->data(), nframes, _current_gain);
166 /* unity target gain */
167 _current_gain = target_gain;
171 _active = _pending_active;
175 Amp::apply_gain (BufferSet& bufs, samplecnt_t sample_rate, samplecnt_t nframes, gain_t initial, gain_t target, bool midi_amp)
177 /** Apply a (potentially) declicked gain to the buffers of @a bufs */
180 if (nframes == 0 || bufs.count().n_total() == 0) {
184 // if we don't need to declick, defer to apply_simple_gain
185 if (initial == target) {
186 apply_simple_gain (bufs, nframes, target);
192 /* don't Trim midi velocity -- only relevant for Midi on Audio tracks */
193 for (BufferSet::midi_iterator i = bufs.midi_begin(); i != bufs.midi_end(); ++i) {
196 if (target < initial) {
197 /* fade out: remove more and more of delta from initial */
198 delta = -(initial - target);
200 /* fade in: add more and more of delta from initial */
201 delta = target - initial;
206 for (MidiBuffer::iterator m = mb.begin(); m != mb.end(); ++m) {
207 Evoral::Event<MidiBuffer::TimeType> ev = *m;
209 if (ev.is_note_on()) {
210 const gain_t scale = delta * (ev.time()/(double) nframes);
211 scale_midi_velocity (ev, fabsf (initial + scale));
219 /* Low pass filter coefficient: 1.0 - e^(-2.0 * π * f / 48000) f in Hz.
220 * for f << SR, approx a ~= 6.2 * f / SR;
222 const gain_t a = 156.825f / (gain_t)sample_rate; // 25 Hz LPF
224 for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i) {
225 Sample* const buffer = i->data();
226 double lpf = initial;
228 for (pframes_t nx = 0; nx < nframes; ++nx) {
230 lpf += a * (target - lpf);
232 if (i == bufs.audio_begin()) {
236 if (fabsf (rv - target) < GAIN_COEFF_DELTA) return target;
241 Amp::apply_gain (AudioBuffer& buf, samplecnt_t sample_rate, samplecnt_t nframes, gain_t initial, gain_t target, sampleoffset_t offset)
243 /* Apply a (potentially) declicked gain to the contents of @a buf
244 * -- used by MonitorProcessor::run()
251 // if we don't need to declick, defer to apply_simple_gain
252 if (initial == target) {
253 apply_simple_gain (buf, nframes, target, offset);
257 Sample* const buffer = buf.data (offset);
258 const gain_t a = 156.825f / (gain_t)sample_rate; // 25 Hz LPF, see [other] Amp::apply_gain() above for details
260 gain_t lpf = initial;
261 for (pframes_t nx = 0; nx < nframes; ++nx) {
263 lpf += a * (target - lpf);
266 if (fabsf (lpf - target) < GAIN_COEFF_DELTA) return target;
271 Amp::apply_simple_gain (BufferSet& bufs, samplecnt_t nframes, gain_t target, bool midi_amp)
273 if (fabsf (target) < GAIN_COEFF_SMALL) {
276 /* don't Trim midi velocity -- only relevant for Midi on Audio tracks */
277 for (BufferSet::midi_iterator i = bufs.midi_begin(); i != bufs.midi_end(); ++i) {
280 for (MidiBuffer::iterator m = mb.begin(); m != mb.end(); ++m) {
281 Evoral::Event<MidiBuffer::TimeType> ev = *m;
282 if (ev.is_note_on()) {
289 for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i) {
290 memset (i->data(), 0, sizeof (Sample) * nframes);
293 } else if (target != GAIN_COEFF_UNITY) {
296 /* don't Trim midi velocity -- only relevant for Midi on Audio tracks */
297 for (BufferSet::midi_iterator i = bufs.midi_begin(); i != bufs.midi_end(); ++i) {
300 for (MidiBuffer::iterator m = mb.begin(); m != mb.end(); ++m) {
301 Evoral::Event<MidiBuffer::TimeType> ev = *m;
302 if (ev.is_note_on()) {
303 scale_midi_velocity(ev, fabsf (target));
309 for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i) {
310 apply_gain_to_buffer (i->data(), nframes, target);
316 Amp::apply_simple_gain (AudioBuffer& buf, samplecnt_t nframes, gain_t target, sampleoffset_t offset)
318 if (fabsf (target) < GAIN_COEFF_SMALL) {
319 memset (buf.data (offset), 0, sizeof (Sample) * nframes);
320 } else if (target != GAIN_COEFF_UNITY) {
321 apply_gain_to_buffer (buf.data(offset), nframes, target);
328 XMLNode& node (Processor::state ());
329 node.set_property("type", _gain_control->parameter().type() == GainAutomation ? "amp" : "trim");
330 node.add_child_nocopy (_gain_control->get_state());
336 Amp::set_state (const XMLNode& node, int version)
340 Processor::set_state (node, version);
342 if ((gain_node = node.child (Controllable::xml_node_name.c_str ())) != 0) {
343 _gain_control->set_state (*gain_node, version);
349 /** Write gain automation for this cycle into the buffer previously passed in to
350 * set_gain_automation_buffer (if we are in automation playback mode and the
351 * transport is rolling).
353 * After calling this, the gain-automation buffer is valid for the next run.
354 * so make sure to call ::run() which invalidates the buffer again.
357 Amp::setup_gain_automation (samplepos_t start_sample, samplepos_t end_sample, samplecnt_t nframes)
359 Glib::Threads::Mutex::Lock am (control_lock(), Glib::Threads::TRY_LOCK);
362 && (_session.transport_rolling() || _session.bounce_processing())
363 && _gain_control->automation_playback())
365 assert (_gain_automation_buffer);
367 _apply_gain_automation = _gain_control->get_masters_curve ( start_sample, end_sample, _gain_automation_buffer, nframes);
369 if (start_sample != _current_automation_sample && _session.bounce_processing ()) {
370 _current_gain = _gain_automation_buffer[0];
372 _current_automation_sample = end_sample;
374 _apply_gain_automation = false;
375 _current_automation_sample = INT64_MAX;
385 /** Sets up the buffer that setup_gain_automation and ::run will use for
386 * gain automationc curves. Must be called before setup_gain_automation,
387 * and must be called with process lock held.
390 Amp::set_gain_automation_buffer (gain_t* g)
392 _gain_automation_buffer = g;