mirror of
https://github.com/LMMS/lmms.git
synced 2026-03-25 09:24:00 -04:00
This reworks the auto-quit feature by introducing a new AudioBuffer class which keeps track of which channels are currently silent as audio flows through the effects chain. When track channels going into an effect's input are not marked as quiet, it is assumed a signal is present and the plugin needs to wake up if it is asleep due to auto-quit. After a plugin processes a buffer, the silence status is updated. When the auto-quit setting is disabled (that is, when effects are always kept running), effects are always assumed to have input noise (a non-quiet signal present at the plugin inputs), which should result in the same behavior as before. Benefits: - The auto-quit system now closely follows how it is supposed to function by only waking plugins which have non-zero input rather than waking all plugins at once whenever an instrument plays a note or a sample track plays. This granularity better fits multi-channel plugins and pin connector routing where not all plugin inputs are connected to the same track channels. This means a sleeping plugin whose inputs are connected to channels 3/4 would not need to wake up if a signal is only present on channels 1/2. - Silencing channels that are already known to be silent is a no-op - Calculating the absolute peak sample value for a channel already known to be silent is a no-op - The silence flags also could be useful for other purposes, such as adding visual indicators to represent how audio signals flow in and out of each plugin - With a little more work, auto-quit could be enabled/disabled for plugins on an individual basis - With a little more work, auto-quit could be implemented for instrument plugins - AudioBuffer can be used with SharedMemory - AudioBuffer could be used in plugins for their buffers This new system works so long as the silence flags for each channel remain valid at each point along the effect chain. Modifying the buffers without an accompanying update of the silence flags could violate assumptions. Through unit tests, the correct functioning of AudioBuffer itself can be validated, but its usage in AudioBusHandle, Mixer, and a few other places where track channels are handled will need to be done with care. --------- Co-authored-by: Sotonye Atemie <sakertooth@gmail.com>
170 lines
3.6 KiB
C++
170 lines
3.6 KiB
C++
/*
|
|
* StereoEnhancer.cpp - stereo-enhancer-effect-plugin
|
|
*
|
|
* Copyright (c) 2006-2014 Tobias Doerffel <tobydox/at/users.sourceforge.net>
|
|
*
|
|
* This file is part of LMMS - https://lmms.io
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public
|
|
* License along with this program (see COPYING); if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
*/
|
|
|
|
|
|
#include "StereoEnhancer.h"
|
|
|
|
#include "embed.h"
|
|
#include "plugin_export.h"
|
|
|
|
namespace lmms
|
|
{
|
|
|
|
|
|
extern "C"
|
|
{
|
|
|
|
Plugin::Descriptor PLUGIN_EXPORT stereoenhancer_plugin_descriptor =
|
|
{
|
|
LMMS_STRINGIFY( PLUGIN_NAME ),
|
|
"StereoEnhancer Effect",
|
|
QT_TRANSLATE_NOOP( "PluginBrowser",
|
|
"Plugin for enhancing stereo separation of a stereo input file" ),
|
|
"Lou Herard <lherard/at/gmail.com>",
|
|
0x0100,
|
|
Plugin::Type::Effect,
|
|
new PixmapLoader("lmms-plugin-logo"),
|
|
nullptr,
|
|
nullptr,
|
|
} ;
|
|
|
|
}
|
|
|
|
|
|
|
|
StereoEnhancerEffect::StereoEnhancerEffect(
|
|
Model * _parent,
|
|
const Descriptor::SubPluginFeatures::Key * _key ) :
|
|
Effect( &stereoenhancer_plugin_descriptor, _parent, _key ),
|
|
m_seFX( DspEffectLibrary::StereoEnhancer( 0.0f ) ),
|
|
m_delayBuffer( new SampleFrame[DEFAULT_BUFFER_SIZE] ),
|
|
m_currFrame( 0 ),
|
|
m_bbControls( this )
|
|
{
|
|
// TODO: Make m_delayBuffer customizable?
|
|
clearMyBuffer();
|
|
}
|
|
|
|
|
|
|
|
|
|
StereoEnhancerEffect::~StereoEnhancerEffect()
|
|
{
|
|
if( m_delayBuffer )
|
|
{
|
|
delete [] m_delayBuffer;
|
|
}
|
|
|
|
m_currFrame = 0;
|
|
}
|
|
|
|
|
|
|
|
|
|
Effect::ProcessStatus StereoEnhancerEffect::processImpl(SampleFrame* buf, const fpp_t frames)
|
|
{
|
|
m_delayBufferCleared = false;
|
|
const float d = dryLevel();
|
|
const float w = wetLevel();
|
|
|
|
for (fpp_t f = 0; f < frames; ++f)
|
|
{
|
|
|
|
// copy samples into the delay buffer
|
|
m_delayBuffer[m_currFrame][0] = buf[f][0];
|
|
m_delayBuffer[m_currFrame][1] = buf[f][1];
|
|
|
|
// Get the width knob value from the Stereo Enhancer effect
|
|
float width = m_seFX.wideCoeff();
|
|
|
|
// Calculate the correct sample frame for processing
|
|
int frameIndex = m_currFrame - width;
|
|
|
|
if( frameIndex < 0 )
|
|
{
|
|
// e.g. difference = -10, frameIndex = DBS - 10
|
|
frameIndex += DEFAULT_BUFFER_SIZE;
|
|
}
|
|
|
|
//sample_t s[2] = { buf[f][0], buf[f][1] }; //Vanilla
|
|
auto s = std::array{buf[f][0], m_delayBuffer[frameIndex][1]}; //Chocolate
|
|
|
|
m_seFX.nextSample( s[0], s[1] );
|
|
|
|
buf[f][0] = d * buf[f][0] + w * s[0];
|
|
buf[f][1] = d * buf[f][1] + w * s[1];
|
|
|
|
// Update currFrame
|
|
m_currFrame += 1;
|
|
m_currFrame %= DEFAULT_BUFFER_SIZE;
|
|
}
|
|
|
|
return ProcessStatus::ContinueIfNotQuiet;
|
|
}
|
|
|
|
|
|
|
|
|
|
void StereoEnhancerEffect::processBypassedImpl()
|
|
{
|
|
clearMyBuffer();
|
|
}
|
|
|
|
|
|
|
|
|
|
void StereoEnhancerEffect::clearMyBuffer()
|
|
{
|
|
if (m_delayBufferCleared) { return; }
|
|
|
|
for (auto i = std::size_t{0}; i < DEFAULT_BUFFER_SIZE; i++)
|
|
{
|
|
m_delayBuffer[i][0] = 0.0f;
|
|
m_delayBuffer[i][1] = 0.0f;
|
|
}
|
|
|
|
m_currFrame = 0;
|
|
m_delayBufferCleared = true;
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
extern "C"
|
|
{
|
|
|
|
// necessary for getting instance out of shared lib
|
|
PLUGIN_EXPORT Plugin * lmms_plugin_main( Model * _parent, void * _data )
|
|
{
|
|
return( new StereoEnhancerEffect( _parent,
|
|
static_cast<const Plugin::Descriptor::SubPluginFeatures::Key *>(
|
|
_data ) ) );
|
|
}
|
|
|
|
}
|
|
|
|
|
|
} // namespace lmms
|