tracktion_GrooveTemplate.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 GrooveTemplate
{
public:
    GrooveTemplate();
    GrooveTemplate (const juce::XmlElement*);
    GrooveTemplate (const GrooveTemplate&);
    ~GrooveTemplate();
 
    const GrooveTemplate& operator= (const GrooveTemplate&);
    bool operator== (const GrooveTemplate&) const;
 
    //==============================================================================
    bool isEmpty() const;
    bool isParameterized() const;
    void setParameterized (bool p)                          { parameterized = p; }
 
    //==============================================================================
    BeatPosition beatsTimeToGroovyTime (BeatPosition beatsTime, float strength) const;
 
    TimePosition editTimeToGroovyTime (TimePosition editTime, float strength, Edit& edit) const;
 
    //==============================================================================
    const juce::String& getName() const                     { return name; }
    void setName (const juce::String&);
 
    // all indexes are in quarter-notes
    int getNumberOfNotes() const                            { return numNotes; }
    void setNumberOfNotes (int notes);
 
    int getNotesPerBeat() const                             { return notesPerBeat; }
    void setNotesPerBeat (int notes);
 
    // value is 0 to 1.0 of the length of a note
    float getLatenessProportion (int noteNumber, float strength) const;
    void setLatenessProportion (int noteNumber, float p, float strength);
    void clearLatenesses();
 
    //==============================================================================
    static const char* grooveXmlTag;
    juce::XmlElement* createXml() const;
 
private:
    //==============================================================================
    juce::Array<float> latenesses;
    int numNotes, notesPerBeat;
    juce::String name;
    bool parameterized = false;
 
    //==============================================================================
    JUCE_LEAK_DETECTOR (GrooveTemplate)
};
 
//==============================================================================
class GrooveTemplateManager
{
public:
    //==============================================================================
    GrooveTemplateManager (Engine&);
 
    void useParameterizedGrooves (bool b);
 
    //==============================================================================
    int getNumTemplates() const;
    juce::String getTemplateName (int index) const;
 
    juce::StringArray getTemplateNames() const;
 
    const GrooveTemplate* getTemplate (int index);
    const GrooveTemplate* getTemplateByName (const juce::String& name);
 
    void updateTemplate (int index, const GrooveTemplate&);
    void deleteTemplate (int index);
 
    void reload();
 
    Engine& engine;
 
private:
    //==============================================================================
    juce::OwnedArray<GrooveTemplate> knownGrooves;
    juce::Array<GrooveTemplate*> activeGrooves;
 
    //==============================================================================
    void save();
    void reload (const juce::XmlElement*);
 
    bool useParameterized = false;
    //==============================================================================
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (GrooveTemplateManager)
};
 
}} // namespace tracktion { inline namespace engine