st2110video.h

Go to the documentation of this file.

 
#pragma once
 
 
#include <promeki/config.h>
#if PROMEKI_ENABLE_NETWORK
#include <cstddef>
#include <cstdint>
#include <promeki/config.h>
#if PROMEKI_ENABLE_PROAV
#include <promeki/pixelformat.h>
#endif
#include <promeki/enums_st2110.h>
#include <promeki/enums_video.h>
#include <promeki/framerate.h>
#include <promeki/map.h>
#include <promeki/namespace.h>
#include <promeki/pixelaspect.h>
#include <promeki/string.h>
 
PROMEKI_NAMESPACE_BEGIN
 
class St2110Video {
        public:
                struct Pgroup {
                                size_t octets = 0;
                                size_t pixels = 0;
                                size_t samples = 0;
                };
 
                static constexpr size_t MaxSamplesPerPgroup = 12;
 
                static Pgroup pgroup(const St2110Sampling &sampling, const St2110Depth &depth);
 
                static bool isSupported(const St2110Sampling &sampling, const St2110Depth &depth);
 
                static int bitsPerSample(const St2110Depth &depth);
 
                static bool isFloatDepth(const St2110Depth &depth);
 
                static size_t packSamplesBE(uint8_t *dst, size_t dstCap,
                                            const uint16_t *samples, size_t nSamples,
                                            int depthBits);
 
                static size_t unpackSamplesBE(const uint8_t *src, size_t srcSize,
                                              uint16_t *samples, size_t nSamples,
                                              int depthBits);
 
                static size_t packRow(const St2110Sampling &sampling, const St2110Depth &depth,
                                      size_t nPixels, const uint16_t *samples,
                                      uint8_t *dst, size_t dstCap);
 
                static size_t unpackRow(const St2110Sampling &sampling, const St2110Depth &depth,
                                        size_t nPixels, const uint8_t *src, size_t srcSize,
                                        uint16_t *samples);
 
                static size_t rowOctets(const St2110Sampling &sampling, const St2110Depth &depth,
                                        size_t nPixels);
 
                static size_t rowSamples(const St2110Sampling &sampling, const St2110Depth &depth,
                                         size_t nPixels);
 
                // -----------------------------------------------------
                // Wire-form ↔ project-form conversion for the §7 SDP
                // fmtp parameter values.  The wire form is what the
                // standard's tables spell (e.g. @c YCbCr-4:2:2,
                // @c ST2065-1, @c BT2100LINPQ, @c 2110GPM,
                // @c FULLPROTECT); the project form uses CamelCase
                // identifiers per the [[feedback-enum-naming-camelcase]]
                // convention (e.g. @c YCbCr422, @c St2065_1,
                // @c Bt2100LinPq, @c Gpm, @c FullProtect).  These
                // helpers are the single mapping point — the SDP
                // builder / parser only ever calls into here.
                // -----------------------------------------------------
 
                static String samplingWire(const St2110Sampling &sampling);
                static String depthWire(const St2110Depth &depth);
                static String colorimetryWire(const St2110Colorimetry &c);
                static String tcsWire(const St2110Tcs &t);
                static String rangeWire(const St2110Range &r);
                static String packingModeWire(const St2110PackingMode &p);
 
                static St2110Sampling samplingFromWire(const String &s);
                static St2110Depth depthFromWire(const String &s);
                static St2110Colorimetry colorimetryFromWire(const String &s);
                static St2110Tcs tcsFromWire(const String &s);
                static St2110Range rangeFromWire(const String &s);
                static St2110PackingMode packingModeFromWire(const String &s);
 
                static String ssnFor(const St2110Colorimetry &colorimetry, const St2110Tcs &tcs);
 
                struct Fmtp {
                                // §7.2 Required Media Type Parameters.
                                St2110Sampling     sampling;                              
                                St2110Depth        depth;                                 
                                uint32_t           width = 0;                             
                                uint32_t           height = 0;                            
                                FrameRate          exactFrameRate;                        
                                St2110Colorimetry  colorimetry;                           
                                St2110PackingMode  pm{St2110PackingMode::Gpm};            
 
                                // §7.3 Media Type Parameters with default values.
                                bool               interlace = false;                    
                                bool               segmented = false;                    
                                St2110Tcs          tcs{St2110Tcs::Sdr};                  
                                St2110Range        range{St2110Range::Narrow};           
                                uint32_t           maxUdp = 0;                            
                                PixelAspect        par;                                   
                                String             ssnOverride;                           
                };
 
                static String frameRateToWire(const FrameRate &fr);
 
                static String toFmtp(const Fmtp &fmtp);
 
                static Fmtp fromFmtp(const Map<String, String> &params);
 
                static VideoScanMode fmtpScanMode(const Fmtp &fmtp);
 
                static void setFmtpScanMode(Fmtp &fmtp, VideoScanMode mode);
 
#if PROMEKI_ENABLE_PROAV
                struct PixelFormatBridge {
                                St2110Sampling    sampling;                              
                                St2110Depth       depth;                                 
                                St2110Colorimetry colorimetry;                           
                                St2110Tcs         tcs{St2110Tcs::Sdr};                   
                                St2110Range       range{St2110Range::Narrow};            
                };
 
                static PixelFormatBridge bridgeForPixelFormat(const PixelFormat &pd);
 
                static PixelFormat wirePixelFormatFor(const St2110Sampling   &sampling,
                                                     const St2110Depth      &depth,
                                                     const St2110Colorimetry &colorimetry,
                                                     const St2110Range       &range);
#endif // PROMEKI_ENABLE_PROAV
};
 
PROMEKI_NAMESPACE_END
 
#endif // PROMEKI_ENABLE_NETWORK