mirror of
https://github.com/LMMS/lmms.git
synced 2026-05-14 01:36:21 -04:00
5916a0b477
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>
102 lines
3.9 KiB
C++
102 lines
3.9 KiB
C++
/*
|
|
* MixHelpers.h - helper functions for mixing buffers
|
|
*
|
|
* Copyright (c) 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.
|
|
*
|
|
*/
|
|
|
|
#ifndef LMMS_MIX_HELPERS_H
|
|
#define LMMS_MIX_HELPERS_H
|
|
|
|
#include "AudioBufferView.h"
|
|
|
|
namespace lmms
|
|
{
|
|
|
|
class ValueBuffer;
|
|
class SampleFrame;
|
|
|
|
namespace MixHelpers
|
|
{
|
|
|
|
bool isSilent( const SampleFrame* src, int frames );
|
|
|
|
bool isSilent(std::span<sample_t> buffer);
|
|
|
|
bool useNaNHandler();
|
|
|
|
void setNaNHandler( bool use );
|
|
|
|
/**
|
|
* @brief Sanitizes a buffer of infs/NaNs, zeroing the entire buffer if
|
|
* any is detected.
|
|
*
|
|
* Only performs sanitization when the NaN handler is active.
|
|
*
|
|
* @returns true if inf or NaN was detected
|
|
*/
|
|
bool sanitize(std::span<sample_t> buffer);
|
|
|
|
/*! \brief Add samples from src to dst */
|
|
void add( SampleFrame* dst, const SampleFrame* src, int frames );
|
|
|
|
/*! \brief Add samples from src to dst */
|
|
void add(PlanarBufferView<sample_t> dst, PlanarBufferView<const sample_t> src);
|
|
|
|
/*! \brief Multiply samples from `dst` by `coeff` */
|
|
void multiply(SampleFrame* dst, float coeff, int frames);
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrc to dst */
|
|
void addMultiplied( SampleFrame* dst, const SampleFrame* src, float coeffSrc, int frames );
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrc to dst, swap inputs */
|
|
void addSwappedMultiplied( SampleFrame* dst, const SampleFrame* src, float coeffSrc, int frames );
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrc and coeffSrcBuf to dst */
|
|
void addMultipliedByBuffer( SampleFrame* dst, const SampleFrame* src, float coeffSrc, ValueBuffer * coeffSrcBuf, int frames );
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrc and coeffSrcBuf to dst */
|
|
void addMultipliedByBuffers( SampleFrame* dst, const SampleFrame* src, ValueBuffer * coeffSrcBuf1, ValueBuffer * coeffSrcBuf2, int frames );
|
|
|
|
/*! \brief Same as addMultiplied, but sanitize output (strip out infs/nans) */
|
|
void addSanitizedMultiplied( SampleFrame* dst, const SampleFrame* src, float coeffSrc, int frames );
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrc and coeffSrcBuf to dst - sanitized version */
|
|
void addSanitizedMultipliedByBuffer( SampleFrame* dst, const SampleFrame* src, float coeffSrc, ValueBuffer * coeffSrcBuf, int frames );
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrc and coeffSrcBuf to dst - sanitized version */
|
|
void addSanitizedMultipliedByBuffers( SampleFrame* dst, const SampleFrame* src, ValueBuffer * coeffSrcBuf1, ValueBuffer * coeffSrcBuf2, int frames );
|
|
|
|
/*! \brief Add samples from src multiplied by coeffSrcLeft/coeffSrcRight to dst */
|
|
void addMultipliedStereo( SampleFrame* dst, const SampleFrame* src, float coeffSrcLeft, float coeffSrcRight, int frames );
|
|
|
|
/*! \brief Multiply dst by coeffDst and add samples from src multiplied by coeffSrc */
|
|
void multiplyAndAddMultiplied( SampleFrame* dst, const SampleFrame* src, float coeffDst, float coeffSrc, int frames );
|
|
|
|
/*! \brief Multiply dst by coeffDst and add samples from srcLeft/srcRight multiplied by coeffSrc */
|
|
void multiplyAndAddMultipliedJoined( SampleFrame* dst, const sample_t* srcLeft, const sample_t* srcRight, float coeffDst, float coeffSrc, int frames );
|
|
|
|
} // namespace MixHelpers
|
|
|
|
|
|
} // namespace lmms
|
|
|
|
#endif // LMMS_MIX_HELPERS_H
|