A utility class for values that need smoothing to avoid audio glitches. More...
#include <juce_SmoothedValue.h>
Inheritance diagram for juce::SmoothedValue< FloatType, SmoothingType >:
Public Types | |
| template<typename T > | |
| using | MultiplicativeVoid = (void setValue(FloatType newValue, bool force=false) noexcept, { if(force) { this->setCurrentAndTargetValue(newValue);return;} setTargetValue(newValue);}) private typename std::enable_if< std::is_same< T, ValueSmoothingTypes::Multiplicative >::value, void >::type |
| THIS FUNCTION IS DEPRECATED. More... | |
| Public Types inherited from juce::SmoothedValueBase< SmoothedValue< FloatType, ValueSmoothingTypes::Linear > > | |
| using | FloatType = typename FloatTypeHelper< SmoothedValue< FloatType, ValueSmoothingTypes::Linear > >::Type |
Public Member Functions | |
| SmoothedValue () noexcept | |
| Constructor. | |
| SmoothedValue (FloatType initialValue) noexcept | |
| Constructor. | |
| void | reset (double sampleRate, double rampLengthInSeconds) noexcept |
| Reset to a new sample rate and ramp length. More... | |
| void | reset (int numSteps) noexcept |
| Set a new ramp length directly in samples. More... | |
| void | setTargetValue (FloatType newValue) noexcept |
| Set the next value to ramp towards. More... | |
| FloatType | getNextValue () noexcept |
| Compute the next value. More... | |
| FloatType | skip (int numSamples) noexcept |
| Skip the next numSamples samples. More... | |
| template<typename T = SmoothingType> | |
| LinearVoid< T > | setStepSize () noexcept |
| template<typename T = SmoothingType> | |
| MultiplicativeVoid< T > | setStepSize () |
| template<typename T = SmoothingType> | |
| LinearVoid< T > | setNextValue () noexcept |
| template<typename T = SmoothingType> | |
| MultiplicativeVoid< T > | setNextValue () noexcept |
| template<typename T = SmoothingType> | |
| LinearVoid< T > | skipCurrentValue (int numSamples) noexcept |
| template<typename T = SmoothingType> | |
| MultiplicativeVoid< T > | skipCurrentValue (int numSamples) |
| Public Member Functions inherited from juce::SmoothedValueBase< SmoothedValue< FloatType, ValueSmoothingTypes::Linear > > | |
| SmoothedValueBase ()=default | |
| Constructor. | |
| bool | isSmoothing () const noexcept |
| Returns true if the current value is currently being interpolated. | |
| FloatType | getCurrentValue () const noexcept |
| Returns the current value of the ramp. | |
| FloatType | getTargetValue () const noexcept |
| Returns the target value towards which the smoothed value is currently moving. | |
| void | setCurrentAndTargetValue (FloatType newValue) |
| Sets the current value and the target value. More... | |
| void | applyGain (FloatType *samples, int numSamples) noexcept |
| Applies a smoothed gain to a stream of samples S[i] *= gain. More... | |
| void | applyGain (FloatType *samplesOut, const FloatType *samplesIn, int numSamples) noexcept |
| Computes output as a smoothed gain applied to a stream of samples. More... | |
| void | applyGain (AudioBuffer< FloatType > &buffer, int numSamples) noexcept |
| Applies a smoothed gain to a buffer. | |
Public Attributes | |
| FloatType | step = FloatType() |
| int | stepsToTarget = 0 |
Additional Inherited Members | |
| Protected Attributes inherited from juce::SmoothedValueBase< SmoothedValue< FloatType, ValueSmoothingTypes::Linear > > | |
| FloatType | currentValue |
| FloatType | target |
| int | countdown |
Detailed Description
template<typename FloatType, typename SmoothingType = ValueSmoothingTypes::Linear>
class juce::SmoothedValue< FloatType, SmoothingType >
A utility class for values that need smoothing to avoid audio glitches.
A ValueSmoothingTypes::Linear template parameter selects linear smoothing, which increments the SmoothedValue linearly towards its target value.
A ValueSmoothingTypes::Multiplicative template parameter selects multiplicative smoothing increments towards the target value.
Multiplicative smoothing is useful when you are dealing with exponential/logarithmic values like volume in dB or frequency in Hz. For example a 12 step ramp from 440.0 Hz (A4) to 880.0 Hz (A5) will increase the frequency with an equal temperament tuning across the octave. A 10 step smoothing from 1.0 (0 dB) to 3.16228 (10 dB) will increase the value in increments of 1 dB.
Note that when you are using multiplicative smoothing you cannot ever reach a target value of zero!
Definition at line 232 of file juce_SmoothedValue.h.
Member Typedef Documentation
◆ MultiplicativeVoid
| using juce::SmoothedValue< FloatType, SmoothingType >::MultiplicativeVoid = (void setValue (FloatType newValue, bool force = false) noexcept, { if (force) { this->setCurrentAndTargetValue (newValue); return; } setTargetValue (newValue); }) private typename std::enable_if <std::is_same <T, ValueSmoothingTypes::Multiplicative>::value, void>::type |
THIS FUNCTION IS DEPRECATED.
Use setTargetValue (float) and setCurrentAndTargetValue() instead:
lsv.setValue (x, false); -> lsv.setTargetValue (x); lsv.setValue (x, true); -> lsv.setCurrentAndTargetValue (x);
- Parameters
-
newValue The new target value force If true, the value will be set immediately, bypassing the ramp
Definition at line 364 of file juce_SmoothedValue.h.
Member Function Documentation
◆ reset() [1/2]
|
inlinenoexcept |
Reset to a new sample rate and ramp length.
- Parameters
-
sampleRate The sample rate rampLengthInSeconds The duration of the ramp in seconds
Definition at line 258 of file juce_SmoothedValue.h.
Referenced by juce::dsp::Convolution::prepare(), juce::dsp::Oscillator< SampleType >::reset(), and juce::Reverb::setSampleRate().
◆ reset() [2/2]
|
inlinenoexcept |
Set a new ramp length directly in samples.
- Parameters
-
numSteps The number of samples over which the ramp should be active
Definition at line 267 of file juce_SmoothedValue.h.
◆ setTargetValue()
|
inlinenoexcept |
Set the next value to ramp towards.
- Parameters
-
newValue The new target value
Definition at line 277 of file juce_SmoothedValue.h.
Referenced by juce::dsp::Oscillator< SampleType >::setFrequency(), and juce::Reverb::setParameters().
◆ getNextValue()
|
inlinenoexcept |
Compute the next value.
- Returns
- Smoothed value
Definition at line 301 of file juce_SmoothedValue.h.
References juce::SmoothedValueBase< SmoothedValue< FloatType, ValueSmoothingTypes::Linear > >::isSmoothing().
Referenced by juce::dsp::Oscillator< SampleType >::process(), juce::Reverb::processMono(), juce::dsp::Oscillator< SampleType >::processSample(), and juce::Reverb::processStereo().
◆ skip()
|
inlinenoexcept |
Skip the next numSamples samples.
This is identical to calling getNextValue numSamples times. It returns the new current value.
- See also
- getNextValue
Definition at line 322 of file juce_SmoothedValue.h.
Referenced by juce::dsp::Oscillator< SampleType >::process().
The documentation for this class was generated from the following file:
