rtpmediaclock.h

Go to the documentation of this file.

 
#pragma once
 
 
#include <promeki/config.h>
#if PROMEKI_ENABLE_NETWORK
#include <cstdint>
#include <promeki/clockdomain.h>
#include <promeki/duration.h>
#include <promeki/framerate.h>
#include <promeki/namespace.h>
 
PROMEKI_NAMESPACE_BEGIN
 
class RtpMediaClock {
        public:
                RtpMediaClock() = default;
 
                static RtpMediaClock frameZeroAnchored(uint32_t mediaClockHz, const FrameRate &rate);
 
                static RtpMediaClock ptpAnchored(uint32_t mediaClockHz, const FrameRate &rate,
                                                 int64_t anchorUtcNs);
 
                bool isValid() const { return _mediaClockHz > 0 && _frameRate.isValid(); }
 
                uint32_t mediaClockHz() const { return _mediaClockHz; }
 
                const FrameRate &frameRate() const { return _frameRate; }
 
                int64_t anchorUtcNs() const { return _anchorUtcNs; }
 
                uint32_t anchorRtpTs() const { return _anchorRtpTs; }
 
                int64_t anchorFrameIndex() const { return _anchorFrameIndex; }
 
                bool hasPtpAnchor() const { return _anchorUtcNs > 0; }
 
                const Duration &trOffset() const { return _trOffset; }
 
                void setTrOffset(const Duration &d) { _trOffset = d; }
 
                uint32_t rtpTsForFrame(int64_t frameIndex) const;
 
                int64_t tvdUtcNs(int64_t frameIndex) const;
 
                int64_t tvdUtcNsForRtpTs(uint32_t rtpTs) const;
 
                uint32_t mediaClkDirectOffset() const;
 
        private:
                explicit RtpMediaClock(uint32_t mediaClockHz, const FrameRate &rate)
                    : _mediaClockHz(mediaClockHz), _frameRate(rate) {}
 
                uint32_t  _mediaClockHz = 0;
                FrameRate _frameRate;
                int64_t   _anchorFrameIndex = 0;
                int64_t   _anchorUtcNs = 0;
                uint32_t  _anchorRtpTs = 0;
                // Default-constructed Duration is Invalid (INT64_MIN);
                // explicit zero is the documented "no offset" value
                // for ST 2110-10 §7.4 — every reader treats Invalid
                // as zero as a belt-and-braces guard but the in-class
                // initialiser is the primary fix.
                Duration  _trOffset = Duration::zero();
};
 
PROMEKI_NAMESPACE_END
 
#endif // PROMEKI_ENABLE_NETWORK