HephAudio v3.1.0
A cross-platform C++ library for recording, playing, and processing audio on Windows, Android, Linux, iOS, and macOS.
Loading...
Searching...
No Matches
HephAudio::Flanger Class Reference

delays the audio data and mixes the result with the input signal. The amount of delay applied changes periodically. More...

#include <Flanger.h>

Inheritance diagram for HephAudio::Flanger:
HephAudio::ModulationEffect HephAudio::DoubleBufferedAudioEffect HephAudio::AudioEffect HephAudio::Chorus

Public Member Functions

 Flanger ()
 
 Flanger (double depth, double constantDelay, double variableDelay, const Oscillator &lfo)
 
virtual ~Flanger ()=default
 
virtual std::string Name () const override
 
virtual void ResetInternalState () override
 
virtual void Process (AudioBuffer &buffer, size_t startIndex, size_t frameCount) override
 
virtual double GetConstantDelay () const
 
virtual void SetConstantDelay (double constantDelay)
 
virtual double GetVariableDelay () const
 
virtual void SetVariableDelay (double variableDelay)
 
- Public Member Functions inherited from HephAudio::ModulationEffect
virtual ~ModulationEffect ()=default
 
virtual void SetOscillator (const Oscillator &lfo)
 
virtual double GetDepth () const
 
virtual void SetDepth (double depth)
 
virtual void Process (AudioBuffer &buffer)
 
virtual void Process (AudioBuffer &buffer, size_t startIndex)
 
- Public Member Functions inherited from HephAudio::DoubleBufferedAudioEffect
virtual ~DoubleBufferedAudioEffect ()=default
 
- Public Member Functions inherited from HephAudio::AudioEffect
virtual ~AudioEffect ()=default
 
virtual bool HasMTSupport () const
 
virtual bool HasRTSupport () const
 
virtual size_t GetThreadCount () const
 
virtual void SetThreadCount (size_t threadCount)
 
virtual size_t CalculateRequiredFrameCount (size_t outputFrameCount, const AudioFormatInfo &formatInfo) const
 
virtual size_t CalculateOutputFrameCount (size_t inputFrameCount, const AudioFormatInfo &formatInfo) const
 
virtual size_t CalculateAdvanceSize (size_t renderFrameCount, const AudioFormatInfo &formatInfo) const
 

Protected Member Functions

virtual void ProcessST (const AudioBuffer &inputBuffer, AudioBuffer &outputBuffer, size_t startIndex, size_t frameCount) override
 
virtual size_t CalculatePastSamplesSize (const AudioBuffer &inputBuffer) const
 
- Protected Member Functions inherited from HephAudio::ModulationEffect
 ModulationEffect ()
 
 ModulationEffect (double depth, const Oscillator &lfo)
 
- Protected Member Functions inherited from HephAudio::DoubleBufferedAudioEffect
 DoubleBufferedAudioEffect ()
 
virtual AudioBuffer CreateOutputBuffer (const AudioBuffer &inputBuffer, size_t startIndex, size_t frameCount) const
 
virtual void InitializeOutputBuffer (const AudioBuffer &inputBuffer, AudioBuffer &outputBuffer, size_t startIndex, size_t frameCount) const
 
- Protected Member Functions inherited from HephAudio::AudioEffect
 AudioEffect ()
 
virtual void ProcessMT (const AudioBuffer &inputBuffer, AudioBuffer &outputBuffer, size_t startIndex, size_t frameCount)
 

Protected Attributes

double constantDelay
 
double variableDelay
 
AudioBuffer pastSamples
 
- Protected Attributes inherited from HephAudio::ModulationEffect
Heph::DoubleBuffer lfoBuffer
 
double depth
 
size_t lfoIndex
 
- Protected Attributes inherited from HephAudio::AudioEffect
size_t threadCount
 

Detailed Description

delays the audio data and mixes the result with the input signal. The amount of delay applied changes periodically.

Constructor & Destructor Documentation

◆ Flanger() [1/2]

HephAudio::Flanger::Flanger ( )

creates a new instance and initializes it with default values.

◆ Flanger() [2/2]

HephAudio::Flanger::Flanger ( double depth,
double constantDelay,
double variableDelay,
const Oscillator & lfo )

creates a new instance and initializes it with the provided values.

Parameters
depthcontrols the dry/wet mix ratio. Ranges between 0 and 1.
lfolow-frequency oscillator.
constantDelayconstant delay in milliseconds.
variableDelaymaximum value of the variable delay in milliseconds.

◆ ~Flanger()

virtual HephAudio::Flanger::~Flanger ( )
virtualdefault

releases the resources and destroys the instance.

Member Function Documentation

◆ Name()

virtual std::string HephAudio::Flanger::Name ( ) const
overridevirtual

gets the name of the audio effect.

Implements HephAudio::AudioEffect.

Reimplemented in HephAudio::Chorus.

◆ ResetInternalState()

virtual void HephAudio::Flanger::ResetInternalState ( )
overridevirtual

resets the variables internally used for processing.

Reimplemented from HephAudio::ModulationEffect.

◆ Process()

virtual void HephAudio::Flanger::Process ( AudioBuffer & buffer,
size_t startIndex,
size_t frameCount )
overridevirtual

Applies the effect.

Parameters
buffercontains the audio data which will be processed.
startIndexindex of the first audio frame to process.
frameCountnumber of frames to process.

Reimplemented from HephAudio::ModulationEffect.

◆ GetConstantDelay()

virtual double HephAudio::Flanger::GetConstantDelay ( ) const
virtual

gets the constant delay in milliseconds.

◆ SetConstantDelay()

virtual void HephAudio::Flanger::SetConstantDelay ( double constantDelay)
virtual

sets the constant delay in milliseconds.

Parameters
constantDelayconstant delay in milliseconds.

◆ GetVariableDelay()

virtual double HephAudio::Flanger::GetVariableDelay ( ) const
virtual

gets the variable delay in milliseconds.

◆ SetVariableDelay()

virtual void HephAudio::Flanger::SetVariableDelay ( double variableDelay)
virtual

sets the variable delay in milliseconds.

Parameters
variableDelaymaximum value of the variable delay in milliseconds.

◆ ProcessST()

virtual void HephAudio::Flanger::ProcessST ( const AudioBuffer & inputBuffer,
AudioBuffer & outputBuffer,
size_t startIndex,
size_t frameCount )
overrideprotectedvirtual

applies the effect using single thread.

Parameters
inputBuffercontains the audio data which will be processed.
outputBuffercontains the processed audio data.
startIndexindex of the first sample to process.
frameCountnumber of frames to process.

Implements HephAudio::AudioEffect.

Reimplemented in HephAudio::Chorus.

◆ CalculatePastSamplesSize()

virtual size_t HephAudio::Flanger::CalculatePastSamplesSize ( const AudioBuffer & inputBuffer) const
protectedvirtual

calculates the number of past samples required.

Parameters
inputBuffercontains the dry data.

Reimplemented in HephAudio::Chorus.

Member Data Documentation

◆ constantDelay

double HephAudio::Flanger::constantDelay
protected

constant delay in milliseconds.

◆ variableDelay

double HephAudio::Flanger::variableDelay
protected

maximum value of the variable delay in milliseconds.

◆ pastSamples

AudioBuffer HephAudio::Flanger::pastSamples
protected

past samples required for real-time processing.