JUCE
|
A subclass of AudioProcessorParameter that provides an easy way to create a parameter which maps onto a given NormalisableRange. More...
Public Member Functions | |
AudioParameterFloat (const String ¶meterID, const String &name, NormalisableRange< float > normalisableRange, float defaultValue, const String &label=String(), Category category=AudioProcessorParameter::genericParameter, std::function< String(float value, int maximumStringLength)> stringFromValue=nullptr, std::function< float(const String &text)> valueFromString=nullptr) | |
Creates a AudioParameterFloat with the specified parameters. More... | |
AudioParameterFloat (String parameterID, String name, float minValue, float maxValue, float defaultValue) | |
Creates a AudioParameterFloat with an ID, name, and range. More... | |
~AudioParameterFloat () | |
Destructor. More... | |
float | get () const noexcept |
Returns the parameter's current value. More... | |
operator float () const noexcept | |
Returns the parameter's current value. More... | |
AudioParameterFloat & | operator= (float newValue) |
Changes the parameter's current value. More... | |
![]() | |
AudioProcessorParameterWithID (const String ¶meterID, const String &name, const String &label=String(), Category category=AudioProcessorParameter::genericParameter) | |
Creation of this object requires providing a name and ID which will be constant for its lifetime. More... | |
~AudioProcessorParameterWithID () | |
Destructor. More... | |
![]() | |
AudioProcessorParameter () noexcept | |
virtual | ~AudioProcessorParameter () |
Destructor. More... | |
void | setValueNotifyingHost (float newValue) |
A processor should call this when it needs to change one of its parameters. More... | |
void | beginChangeGesture () |
Sends a signal to the host to tell it that the user is about to start changing this parameter. More... | |
void | endChangeGesture () |
Tells the host that the user has finished changing this parameter. More... | |
virtual bool | isDiscrete () const |
Returns whether the parameter uses discrete values, based on the result of getNumSteps, or allows the host to select values continuously. More... | |
virtual bool | isBoolean () const |
Returns whether the parameter represents a boolean switch, typically with "On" and "Off" states. More... | |
virtual bool | isOrientationInverted () const |
This can be overridden to tell the host that this parameter operates in the reverse direction. More... | |
virtual bool | isAutomatable () const |
Returns true if the host can automate this parameter. More... | |
virtual bool | isMetaParameter () const |
Should return true if this parameter is a "meta" parameter. More... | |
int | getParameterIndex () const noexcept |
Returns the index of this parameter in its parent processor's parameter list. More... | |
virtual String | getCurrentValueAsText () const |
Returns the current value of the parameter as a String. More... | |
virtual StringArray | getAllValueStrings () const |
Returns the set of strings which represent the possible states a parameter can be in. More... | |
void | addListener (Listener *newListener) |
Registers a listener to receive events when the parameter's state changes. More... | |
void | removeListener (Listener *listener) |
Removes a previously registered parameter listener. More... | |
void | sendValueChangedMessageToListeners (float newValue) |
Public Attributes | |
NormalisableRange< float > | range |
Provides access to the parameter's range. More... | |
![]() | |
const String | paramID |
Provides access to the parameter's ID string. More... | |
const String | name |
Provides access to the parameter's name. More... | |
const String | label |
Provides access to the parameter's label. More... | |
const Category | category |
Provides access to the parameter's category. More... | |
Protected Member Functions | |
virtual void | valueChanged (float newValue) |
Override this method if you are interested in receiving callbacks when the parameter value changes. More... | |
Additional Inherited Members | |
![]() | |
enum | Category { genericParameter = (0 << 16) | 0, inputGain = (1 << 16) | 0, outputGain = (1 << 16) | 1, inputMeter = (2 << 16) | 0, outputMeter = (2 << 16) | 1, compressorLimiterGainReductionMeter = (2 << 16) | 2, expanderGateGainReductionMeter = (2 << 16) | 3, analysisMeter = (2 << 16) | 4, otherMeter = (2 << 16) | 5 } |
A subclass of AudioProcessorParameter that provides an easy way to create a parameter which maps onto a given NormalisableRange.
{Audio}
AudioParameterFloat::AudioParameterFloat | ( | const String & | parameterID, |
const String & | name, | ||
NormalisableRange< float > | normalisableRange, | ||
float | defaultValue, | ||
const String & | label = String() , |
||
Category | category = AudioProcessorParameter::genericParameter , |
||
std::function< String(float value, int maximumStringLength)> | stringFromValue = nullptr , |
||
std::function< float(const String &text)> | valueFromString = nullptr |
||
) |
Creates a AudioParameterFloat with the specified parameters.
parameterID | The parameter ID to use |
name | The parameter name to use |
normalisableRange | The NormalisableRange to use |
defaultValue | The non-normalised default value |
label | An optional label for the parameter's value |
category | An optional parameter category |
stringFromValue | An optional lambda function that converts a non-normalised value to a string with a maximum length. This may be used by hosts to display the parameter's value. |
valueFromString | An optional lambda function that parses a string and converts it into a non-normalised value. Some hosts use this to allow users to type in parameter values. |
AudioParameterFloat::AudioParameterFloat | ( | String | parameterID, |
String | name, | ||
float | minValue, | ||
float | maxValue, | ||
float | defaultValue | ||
) |
Creates a AudioParameterFloat with an ID, name, and range.
On creation, its value is set to the default value. For control over skew factors, you can use the other constructor and provide a NormalisableRange.
AudioParameterFloat::~AudioParameterFloat | ( | ) |
Destructor.
|
noexcept |
Returns the parameter's current value.
|
noexcept |
Returns the parameter's current value.
AudioParameterFloat& AudioParameterFloat::operator= | ( | float | newValue | ) |
Changes the parameter's current value.
|
protectedvirtual |
Override this method if you are interested in receiving callbacks when the parameter value changes.
NormalisableRange<float> AudioParameterFloat::range |
Provides access to the parameter's range.