KParameter.h

Go to the documentation of this file.

namespace krotos
{
    //==============================================================================
    class KParameter : public RangedAudioParameter, public AudioProcessorParameter::Listener
    {
      public:
        struct AudioListenerObject : public AudioProcessorParameter::Listener
        {
 
            AudioListenerObject(std::shared_ptr<KParameter> parameterToListenTo,
                                std::function<void(float)> onChangeFunction);
            ~AudioListenerObject() override;
 
            std::weak_ptr<KParameter> const parameter;
 
            const std::function<void(float)> onChange;
 
            void parameterValueChanged(int, float newValue) override;
            void parameterGestureChanged(int, bool) override {}
        };
 
        struct AsyncListenerObject : public AudioProcessorParameter::Listener, public AsyncUpdater
        {
            AsyncListenerObject(std::shared_ptr<KParameter> parameterToListenTo,
                                std::function<void(float)> onChangeFunction);
            ~AsyncListenerObject() override;
 
            std::weak_ptr<KParameter> const parameter;
            const std::function<void(float)> onChange;
 
            WeakReference<AsyncListenerObject>::Master masterReference;
            friend class WeakReference<AsyncListenerObject>;
 
            void parameterValueChanged(int, float newValue) override;
            void parameterGestureChanged(int, bool) override {}
            void handleAsyncUpdate() override;
 
            std::atomic<float> lastValue{0.0f};
        };
 
        KParameter(const String& parameterID, const String& parameterName,
                   const NormalisableRange<float>& normalisableRange, float defaultValue,
                   const String& parameterLabel = String(),
                   std::function<String(float value, int maximumStringLength)> stringFromValue = nullptr,
                   std::function<float(const String& text)> valueFromString = nullptr);
 
        float get() const;
 
        float getValue() const override;
 
        bool isOn() const;
 
        void set(float newValue);
 
        void notifyListeners();
 
        void attach(GenericParameter* p);
 
        void detach();
 
        GenericParameter* getAttachedParameter();
 
        const NormalisableRange<float>& getNormalisableRange() const override;
 
        void parameterValueChanged(int /*parameterIndex*/, float newValue) override;
        void parameterGestureChanged(int /*parameterIndex*/, bool /*gestureIsStarting*/) override {}
 
      private:
        friend class GenericParameter;
 
        void setValue(float newValue) override;
        float getDefaultValue() const override;
        String getText(float value, int length) const override;
        float getValueForText(const String& text) const override;
 
        NormalisableRange<float> m_range;
        std::atomic<float> m_value;
        std::atomic<float> m_normalisedValue;
        const float m_defaultValue;
 
        GenericParameter* m_attachedParameter{nullptr};
 
        std::function<String(float, int)> m_stringFromValueFunction;
        std::function<float(const String&)> m_valueFromStringFunction;
 
        JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR(KParameter)
    };
} // namespace krotos