/* ============================================================================== This file is part of the JUCE 6 technical preview. Copyright (c) 2020 - Raw Material Software Limited You may use this code under the terms of the GPL v3 (see www.gnu.org/licenses). For this technical preview, this file is not subject to commercial licensing. JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE DISCLAIMED. ============================================================================== */ namespace juce { /** Provides a class of AudioProcessorParameter that can be used as a boolean value. @see AudioParameterFloat, AudioParameterInt, AudioParameterChoice @tags{Audio} */ class JUCE_API AudioParameterBool : public RangedAudioParameter { public: /** Creates a AudioParameterBool with the specified parameters. @param parameterID The parameter ID to use @param parameterName The parameter name to use @param defaultValue The default value @param parameterLabel An optional label for the parameter's value @param stringFromBool An optional lambda function that converts a bool value to a string with a maximum length. This may be used by hosts to display the parameter's value. @param boolFromString An optional lambda function that parses a string and converts it into a bool value. Some hosts use this to allow users to type in parameter values. */ AudioParameterBool (const String& parameterID, const String& parameterName, bool defaultValue, const String& parameterLabel = String(), std::function stringFromBool = nullptr, std::function boolFromString = nullptr); /** Destructor. */ ~AudioParameterBool() override; /** Returns the parameter's current boolean value. */ bool get() const noexcept { return value >= 0.5f; } /** Returns the parameter's current boolean value. */ operator bool() const noexcept { return get(); } /** Changes the parameter's current value to a new boolean. */ AudioParameterBool& operator= (bool newValue); /** Returns the range of values that the parameter can take. */ const NormalisableRange& getNormalisableRange() const override { return range; } protected: /** Override this method if you are interested in receiving callbacks when the parameter value changes. */ virtual void valueChanged (bool newValue); private: //============================================================================== float getValue() const override; void setValue (float newValue) override; float getDefaultValue() const override; int getNumSteps() const override; bool isDiscrete() const override; bool isBoolean() const override; String getText (float, int) const override; float getValueForText (const String&) const override; const NormalisableRange range { 0.0f, 1.0f, 1.0f }; std::atomic value; const float defaultValue; std::function stringFromBoolFunction; std::function boolFromStringFunction; JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (AudioParameterBool) }; } // namespace juce