tracktion_AbletonLink.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.
*/
 
#if TRACKTION_ENABLE_ABLETON_LINK && JUCE_IOS
 struct ABLLink;
#endif
 
namespace tracktion { inline namespace engine
{
 
class AbletonLink
{
public:
    AbletonLink (TransportControl&);
 
    ~AbletonLink();
 
   #if TRACKTION_ENABLE_ABLETON_LINK && JUCE_IOS
    ABLLink* getLinkInstanceForIOS();
   #endif
 
    void setEnabled (bool isEnabled);
 
    bool isEnabled() const;
 
    bool isConnected() const;
 
    size_t getNumPeers() const;
 
    bool isPlaying() const;
 
    void enableStartStopSync (bool enable);
 
    bool isStartStopSyncEnabled() const;
 
    double getSessionTempo() const;
 
    double getBeatsUntilNextCycle (double quantum) const;
 
    void setCustomOffset (int offsetMs);
 
    void setTempoConstraint (juce::Range<double> minMaxTempo);
 
    double getBarPhase() const;
 
    double getChaseProportion() const;
 
    //==========================================================================
    void requestStartStopChange (bool isPlaying);
 
    void requestTempoChange (double newBpm);
 
    //==========================================================================
    struct Listener
    {
        virtual ~Listener() = default;
 
        virtual void linkRequestedStartStopChange (bool isPlaying) = 0;
 
        virtual void linkRequestedTempoChange (double newBpm) = 0;
 
        virtual void linkConnectionChanged() = 0;
 
        virtual void linkRequestedPositionChange (BeatDuration adjustment) = 0;
    };
 
    void addListener (Listener*);
 
    void removeListener (Listener*);
 
    //==========================================================================
    void syncronise (TimePosition);
 
private:
    struct ImplBase;
    friend struct LinkImpl;
    std::unique_ptr<ImplBase> implementation;
};
 
}} // namespace tracktion { inline namespace engine