/* * DspEffectLibrary.h - library with template-based inline-effects * * Copyright (c) 2006-2014 Tobias Doerffel * * This file is part of Linux MultiMedia Studio - http://lmms.sourceforge.net * * 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 _DSP_EFFECT_LIBRARY_H #define _DSP_EFFECT_LIBRARY_H #include #include "templates.h" #include "lmms_constants.h" #include "lmms_basics.h" namespace DspEffectLibrary { template class MonoBase { public: typedef class MonoBypass bypassType; static void process( sample_t * * _buf, const f_cnt_t _frames ) { for( f_cnt_t f = 0; f < _frames; ++f ) { _buf[f][0] = T::nextSample( _buf[f][0] ); } } } ; template class StereoBase { public: typedef class StereoBypass bypassType; static void process( sample_t * * _buf, const f_cnt_t _frames ) { for( f_cnt_t f = 0; f < _frames; ++f ) { T::nextSample( _buf[f][0], _buf[f][1] ); } } } ; template class MonoToStereoAdaptor : public StereoBase > { public: MonoToStereoAdaptor( const FXL& monoFX ) : m_leftFX( monoFX ), m_rightFX( monoFX ) { } MonoToStereoAdaptor( const FXL& leftFX, const FXR& rightFX ) : m_leftFX( leftFX ), m_rightFX( rightFX ) { } void nextSample( sample_t& inLeft, sample_t& inRight ) { inLeft = m_leftFX.nextSample( inLeft ); inRight = m_rightFX.nextSample( inRight ); } FXL& leftFX() { return( m_leftFX ); } FXR& rightFX() { return( m_rightFX ); } private: FXL m_leftFX; FXR m_rightFX; } ; template class StereoToMonoAdaptor : public MonoBase > { public: StereoToMonoAdaptor( const FX& fx ) : m_FX( fx ) { } sample_t nextSample( sample_t in ) { sample_t s[2] = { in, in }; m_FX.nextSample( s[0], s[1] ); return ( s[0] + s[1] ) / 2.0f; } private: FX m_FX; } ; class MonoBypass : public MonoBase { public: sample_t nextSample( sample_t in ) { return in; } } ; class StereoBypass : public StereoBase { public: void nextSample( sample_t&, sample_t& ) { } } ; /* convenient class to build up static FX chains, for example using namespace DspEffectLib; chain >, chain, MonoToStereoAdaptor > > > fxchain( bassBoost<>( 60.0, 1.0, 4.0f ), chain, MonoToStereoAdaptor > >( StereoEnhancer<>( 1.0 ), FoldbackDistortion<>( 1.0f, 1.0f ) ) ); // now you can do simple calls such as which will process a bass-boost-, // stereo enhancer- and foldback distortion effect on your buffer fx_chain.process( (sample_t * *) buf, frames ); */ template class Chain : public FX0::bypassType { public: typedef typename FX0::sample_t sample_t; Chain( const FX0& fx0, const FX1& fx1 = FX1() ) : m_FX0( fx0 ), m_FX1( fx1 ) { } void process( sample_t** buf, const f_cnt_t frames ) { m_FX0.process( buf, frames ); m_FX1.process( buf, frames ); } private: FX0 m_FX0; FX1 m_FX1; } ; template inline sample_t saturate( sample_t x ) { return qMin( qMax( -1.0f, x ), 1.0f ); } class FastBassBoost : public MonoBase { public: FastBassBoost( const sample_t _frequency, const sample_t _gain, const sample_t _ratio, const FastBassBoost & _orig = FastBassBoost() ) : m_frequency( qMax( _frequency, 10.0 ) ), m_gain1( 1.0 / ( m_frequency + 1.0 ) ), m_gain2( _gain ), m_ratio( _ratio ), m_cap( _orig.m_cap ) { } inline sample_t nextSample( sample_t _in ) { // TODO: somehow remove these horrible aliases... m_cap = ( _in + m_cap*m_frequency ) * m_gain1; return( /*saturate(*/ ( _in + m_cap*m_ratio ) * m_gain2/* )*/ ); } void setFrequency( const sample_t _frequency ) { m_frequency = _frequency; m_gain1 = 1.0 / ( m_frequency + 1.0 ); } void setGain( const sample_t _gain ) { m_gain2 = _gain; } void setRatio( const sample_t _ratio ) { m_ratio = _ratio; } private: FastBassBoost() : m_cap( 0.0 ) { } sample_t m_frequency; sample_t m_gain1; sample_t m_gain2; sample_t m_ratio; sample_t m_cap; } ; class FoldbackDistortion : public MonoBase { public: FoldbackDistortion( float threshold, float gain ) : m_threshold( threshold ), m_gain( gain ) { } sample_t nextSample( sample_t in ) { if( in >= m_threshold || in < -m_threshold ) { return ( fabsf( fabsf( fmodf( in - m_threshold, m_threshold*4 ) ) - m_threshold*2 ) - m_threshold ) * m_gain; } return in * m_gain; } void setThreshold( float threshold ) { m_threshold = threshold; } void setGain( float gain ) { m_gain = gain; } private: float m_threshold; float m_gain; } ; class Distortion : public MonoBase { public: Distortion( float threshold, float gain ) : m_threshold( threshold ), m_gain( gain ) { } sample_t nextSample( sample_t in ) { return m_gain * ( in * ( fabsf( in )+m_threshold ) / ( in*in +( m_threshold-1 )* fabsf( in ) + 1 ) ); } void setThreshold( float threshold ) { m_threshold = threshold; } void setGain( float gain ) { m_gain = gain; } private: float m_threshold; float m_gain; } ; class StereoEnhancer : public StereoBase { public: StereoEnhancer( float wideCoeff ) : m_wideCoeff( wideCoeff ) { } void setWideCoeff( float wideCoeff ) { m_wideCoeff = wideCoeff; } float wideCoeff() { return m_wideCoeff; } void nextSample( sample_t& inLeft, sample_t& inRight ) { const float toRad = 3.141592 / 180; inLeft += inRight * sinf( m_wideCoeff * .5 * toRad); inRight -= inLeft * sinf( m_wideCoeff * .5 * toRad); } private: float m_wideCoeff; } ; } ; #endif