tracktion_TempoSetting.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 TempoSetting   : public juce::ReferenceCountedObject,
                       public CurveEditorPoint
{
public:
    //==============================================================================
    TempoSetting (TempoSequence&, const juce::ValueTree&);
 
    ~TempoSetting() override;
 
    using Ptr = juce::ReferenceCountedObjectPtr<TempoSetting>;
 
    Edit& getEdit() const;
 
    static juce::ValueTree create (BeatPosition startBeat, double bpm, float curve);
 
    static constexpr double minBPM = 20.0;
 
    static constexpr double maxBPM = 300.0;
 
    //==============================================================================
    juce::String getSelectableDescription() override;
 
    //==============================================================================
    BeatPosition getStartBeat() const     { return startBeatNumber; }
 
    double getBpm() const           { return bpm; }
 
    float getCurve() const          { return curve; }
 
    TimePosition getStartTime() const;
 
    void set (BeatPosition, double newBpm, float newCurve, bool remapEditPositions);
 
    void setBpm (double newBpm);
 
    void setCurve (float curve);
 
    void setStartBeat (BeatPosition);
 
    void removeFromEdit();
 
    //==============================================================================
    TimeDuration getApproxBeatLength() const; // doesn't take into account ramping, etc
 
    TempoSetting* getPreviousTempo() const;
 
    TimeSigSetting& getMatchingTimeSig() const;
 
    HashCode getHash() const noexcept;
 
    TempoSequence& ownerSequence;
    juce::ValueTree state;
 
    juce::CachedValue<BeatPosition> startBeatNumber;
    juce::CachedValue<double> bpm;
    juce::CachedValue<float> curve;
 
    TimePosition startTime; // (updated by TempoSequence)
};
 
}} // namespace tracktion { inline namespace engine