advance_frame()

void FrameAccessProcessor::advance_frame ( uint64_t  frames_to_advance )

private

Advance the frame cursor, respecting loop boundaries.

Parameters

frames_to_advance

Number of frames to step forward.

Definition at line 247 of file FrameAccessProcessor.cpp.

{
    uint64_t new_frame = m_current_frame + frames_to_advance;
 
    if (new_frame >= m_total_frames) {
        if (m_looping_enabled) {
            uint64_t loop_start = 0;
            uint64_t loop_end = m_total_frames - 1;
 
            if (!m_loop_region.start_coordinates.empty()) {
                loop_start = m_loop_region.start_coordinates[0];
            }
            if (!m_loop_region.end_coordinates.empty()) {
                loop_end = m_loop_region.end_coordinates[0];
            }
 
            if (loop_end > loop_start) {
                uint64_t loop_length = loop_end - loop_start + 1;
                uint64_t overflow = new_frame - m_total_frames;
                new_frame = loop_start + (overflow % loop_length);
            } else {
                new_frame = loop_start;
            }
        } else {
            new_frame = m_total_frames > 0 ? m_total_frames - 1 : 0;
        }
    }
 
    m_current_frame = new_frame;
 
    if (auto stream = std::dynamic_pointer_cast<StreamContainer>(m_source_container_weak.lock())) {
        stream->update_read_position_for_channel(0, m_current_frame);
    }
}

References MayaFlux::Kakshya::Region::end_coordinates, m_current_frame, m_loop_region, m_looping_enabled, m_source_container_weak, m_total_frames, and MayaFlux::Kakshya::Region::start_coordinates.

Referenced by process().

Here is the caller graph for this function: