tracktion_LauncherClipPlaybackHandle.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 LauncherClipPlaybackHandle
{
public:
    //==============================================================================
    static LauncherClipPlaybackHandle forLooping (BeatRange loopRange,
                                                  BeatDuration offset);
 
    static LauncherClipPlaybackHandle forOneShot (BeatRange clipRange);
 
    //==============================================================================
    void start (BeatPosition);
 
    void stop();
 
    std::optional<BeatPosition> getStart() const;
 
    struct SplitBeatRange
    {
        BeatRange range1, range2;
        bool playing1 = false, playing2 = false;
    };
 
    SplitBeatRange timelineRangeToClipSourceRange (BeatRange) const;
 
    std::optional<float> getProgress (BeatPosition) const;
 
private:
    //==============================================================================
    BeatRange clipRange, loopRange;
    BeatDuration offset;
    bool isLooping = false;
 
    std::optional<BeatPosition> playStartPosition;
 
    LauncherClipPlaybackHandle() = default;
};
 
}} // namespace tracktion { inline namespace engine