tracktion_MacroParameter.h

Go to the documentation of this file.

 /*
    ,--.                     ,--.     ,--.  ,--.
  ,-'  '-.,--.--.,--,--.,---.|  |,-.,-'  '-.`--' ,---. ,--,--,      Copyright 2024
  '-.  .-'|  .--' ,-.  | .--'|     /'-.  .-',--.| .-. ||      \   Tracktion Software
    |  |  |  |  \ '-'  \ `--.|  \  \  |  |  |  |' '-' '|  ||  |       Corporation
    `---' `--'   `--`--'`---'`--'`--' `---' `--' `---' `--''--'    www.tracktion.com
 
    Tracktion Engine uses a GPL/commercial licence - see LICENCE.md for details.
*/
 
namespace tracktion { inline namespace engine
{
 
class MacroParameter : public AutomatableParameter,
                       public AutomatableParameter::ModifierSource
{
public:
    //==============================================================================
    struct Assignment  : public AutomatableParameter::ModifierAssignment
    {
        Assignment (const juce::ValueTree&, const MacroParameter&);
 
        using Ptr = juce::ReferenceCountedObjectPtr<Assignment>;
 
        bool isForModifierSource (const AutomatableParameter::ModifierSource&) const override;
 
        const EditItemID macroParamID;
 
        JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (Assignment)
    };
 
    //==============================================================================
    MacroParameter (AutomatableEditItem&, Edit&, const juce::ValueTree&);
    ~MacroParameter() override;
 
    using Ptr = juce::ReferenceCountedObjectPtr<MacroParameter>;
 
    void initialise();
 
    juce::String getParameterName() const override         { return macroName; }
    std::optional<float> getDefaultValue() const override;
 
    Edit& edit;
    juce::ValueTree state;
    juce::CachedValue<float> value, defaultValue;
    juce::CachedValue<juce::String> macroName;
 
private:
    virtual void parameterChanged (float, bool byAutomation) override;
};
 
MacroParameter::Ptr getMacroParameterForID (Edit&, EditItemID);
 
//==============================================================================
class MacroParameterList    : public AutomatableEditItem,
                              public juce::ChangeBroadcaster
{
public:
    MacroParameterList (Edit&, const juce::ValueTree&);
    ~MacroParameterList() override;
 
    MacroParameter* createMacroParameter();
    void removeMacroParameter (MacroParameter&);
    void hideMacroParametersFromTracks() const;
 
    juce::ReferenceCountedArray<MacroParameter> getMacroParameters() const;
    void visitMacroParameters (const std::function<void(AutomatableParameter&)>& visit) const;
 
    juce::String getName() const override     { return {}; }
    Track* getTrack() const;
 
    //==============================================================================
    void restorePluginStateFromValueTree (const juce::ValueTree&) override {}
 
    juce::ValueTree state;
 
private:
    struct List;
    juce::ValueTree parent;
    std::unique_ptr<List> list;
};
 
juce::ReferenceCountedObjectPtr<Plugin> getOwnerPlugin (MacroParameterList*);
 
//==============================================================================
class MacroParameterElement
{
public:
    MacroParameterElement (Edit&, const juce::ValueTree&);
 
    virtual ~MacroParameterElement() = default;
 
    MacroParameterList* getMacroParameterList();
 
    MacroParameterList& getMacroParameterListForWriting();
 
    juce::ReferenceCountedArray<MacroParameter> getMacroParameters() const;
 
    Edit& ownerEdit;
    juce::ValueTree parentStateForList;
 
private:
    std::unique_ptr<MacroParameterList> macroParameterList;
};
 
}} // namespace tracktion { inline namespace engine