tracktion_PlayHeadState.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.
*/
 
#pragma once
 
 
namespace tracktion { inline namespace graph
{
 
//==============================================================================
//==============================================================================
class PlayHeadState
{
public:
    PlayHeadState (PlayHead& ph)
        : playHead (ph)
    {
    }
 
    void update (juce::Range<int64_t> referenceSampleRange);
 
    inline bool isContiguousWithPreviousBlock() noexcept    { return ! (didPlayheadJump() || isFirstBlockOfLoop()); }
 
    inline bool didPlayheadJump() noexcept                  { return playheadJumped; }
 
    inline bool isFirstBlockOfLoop() noexcept               { return firstBlockOfLoop; }
 
    inline bool isLastBlockOfLoop() noexcept                { return lastBlockOfLoop; }
 
    PlayHead& playHead;
 
    bool isPlayHeadRunning = false, playheadJumped = false, lastBlockOfLoop = false, firstBlockOfLoop = false;
 
private:
    std::chrono::system_clock::time_point lastUserInteractionTime;
};
 
 
//==============================================================================
inline void PlayHeadState::update (juce::Range<int64_t> referenceSampleRange)
{
    const bool isPlayingNow = playHead.isPlaying();
    bool jumped = false;
 
    if (lastUserInteractionTime != playHead.getLastUserInteractionTime())
    {
        lastUserInteractionTime = playHead.getLastUserInteractionTime();
        jumped = true;
    }
 
    if (isPlayingNow != isPlayHeadRunning)
    {
        isPlayHeadRunning = isPlayingNow;
        jumped = jumped || isPlayHeadRunning;
    }
 
    playheadJumped = jumped;
 
    // Next check if this is the start or end of a loop range
    if (playHead.isLooping())
    {
        const auto timelineLoopRange = playHead.getLoopRange();
        const auto startTimelinePos = playHead.referenceSamplePositionToTimelinePosition (referenceSampleRange.getStart());
        const auto endTimelinePos = playHead.referenceSamplePositionToTimelinePosition (referenceSampleRange.getEnd() - 1) + 1;
        // The -1/+1 is here to avoid the last sample being wrapped to the beginning of the loop range
 
        if (playHead.isRollingIntoLoop())
            firstBlockOfLoop = false;
        else
            firstBlockOfLoop = startTimelinePos == timelineLoopRange.getStart();
 
        lastBlockOfLoop = endTimelinePos == timelineLoopRange.getEnd();
    }
    else
    {
        firstBlockOfLoop = false;
        lastBlockOfLoop = false;
    }
}
 
}}