cea608.h

Go to the documentation of this file.

 
#pragma once
 
 
#include <promeki/config.h>
#if PROMEKI_ENABLE_PROAV
#include <cstdint>
#include <promeki/color.h>
#include <promeki/namespace.h>
 
PROMEKI_NAMESPACE_BEGIN
 
struct Cea608 {
                // -- Odd parity ---------------------------------------------
 
                static constexpr uint8_t withOddParity(uint8_t c) {
                        uint8_t v = static_cast<uint8_t>(c & 0x7F);
                        unsigned ones = 0;
                        for (int i = 0; i < 7; ++i) {
                                if (v & (1u << i)) ++ones;
                        }
                        if ((ones & 1u) == 0u) v = static_cast<uint8_t>(v | 0x80);
                        return v;
                }
 
                static constexpr bool checkOddParity(uint8_t c) {
                        unsigned ones = 0;
                        for (int i = 0; i < 8; ++i) {
                                if (c & (1u << i)) ++ones;
                        }
                        return (ones & 1u) != 0u;
                }
 
                static constexpr uint8_t stripParity(uint8_t c) { return static_cast<uint8_t>(c & 0x7F); }
 
                // -- Channel selectors (pre-parity first-byte values) -------
 
                static constexpr uint8_t Cc1MiscFirstByte = 0x14;
 
                // -- Misc control codes (second-byte values) ----------------
 
                static constexpr uint8_t MiscRCL = 0x20; 
                static constexpr uint8_t MiscBS  = 0x21; 
                static constexpr uint8_t MiscDER = 0x24; 
                static constexpr uint8_t MiscRU2 = 0x25; 
                static constexpr uint8_t MiscRU3 = 0x26; 
                static constexpr uint8_t MiscRU4 = 0x27; 
                static constexpr uint8_t MiscFON = 0x28; 
                static constexpr uint8_t MiscRDC = 0x29; 
                static constexpr uint8_t MiscTR  = 0x2A; 
                static constexpr uint8_t MiscRTD = 0x2B; 
                static constexpr uint8_t MiscEDM = 0x2C; 
                static constexpr uint8_t MiscCR  = 0x2D; 
                static constexpr uint8_t MiscENM = 0x2E; 
                static constexpr uint8_t MiscEOC = 0x2F; 
 
                // -- Convenience: pre-parity (b1, b2) for CC1 control pairs --
 
                static constexpr uint8_t RclB1 = Cc1MiscFirstByte;
                static constexpr uint8_t RclB2 = MiscRCL;
 
                static constexpr uint8_t EocB1 = Cc1MiscFirstByte;
                static constexpr uint8_t EocB2 = MiscEOC;
 
                static constexpr uint8_t EdmB1 = Cc1MiscFirstByte;
                static constexpr uint8_t EdmB2 = MiscEDM;
 
                static constexpr uint8_t EnmB1 = Cc1MiscFirstByte;
                static constexpr uint8_t EnmB2 = MiscENM;
 
                // -- PAC (Preamble Address Code) ----------------------------
 
                static constexpr uint8_t PacRow15Col0WhiteB1 = 0x14;
                static constexpr uint8_t PacRow15Col0WhiteB2 = 0x70;
 
                // -- CEA-608 colour palette ---------------------------------
 
                enum class CaptionColor : uint8_t {
                        White   = 0,
                        Green   = 1,
                        Blue    = 2,
                        Cyan    = 3,
                        Red     = 4,
                        Yellow  = 5,
                        Magenta = 6,
                        Black   = 7, 
                };
 
                static constexpr size_t CaptionColorCount = 8;
 
                static constexpr size_t FgCaptionColorCount = 7;
 
                static Color::List palette();
 
                struct PacAttr {
                                int row = 15;
                                int indentCol = 0;
                                CaptionColor color = CaptionColor::White;
                                bool italic = false;
                                bool underline = false;
                };
 
                static void encodePac(const PacAttr &attr, uint8_t &b1, uint8_t &b2);
 
                static bool isPac(uint8_t b1, uint8_t b2);
 
                static bool decodePac(uint8_t b1, uint8_t b2, PacAttr &out);
 
                // -- Mid-row codes ------------------------------------------
 
                static void encodeMidRow(CaptionColor color, bool italic, bool underline, uint8_t &b1,
                                         uint8_t &b2);
 
                static bool isMidRow(uint8_t b1, uint8_t b2);
 
                static bool decodeMidRow(uint8_t b1, uint8_t b2, CaptionColor &outColor, bool &outItalic,
                                         bool &outUnderline);
 
                // -- Background attribute codes -----------------------------
                //
                // CEA-608-B background attribute codes (EIA-608-B §7.6) live
                // at @c b1=0x10 (CC1 channel 1) with @c b2 in @c [0x20, 0x2F].
                // They set the background colour and opacity for subsequent
                // characters on the row.  Doubled per spec like other
                // control codes.  This is a *post-EIA-608* extension —
                // older 608 decoders that don't recognise them treat the
                // bytes as no-ops, so emitting them is safe.
 
                static void encodeBgAttribute(CaptionColor color, bool semiTransparent, uint8_t &b1,
                                              uint8_t &b2);
 
                static bool isBgAttribute(uint8_t b1, uint8_t b2);
 
                static bool decodeBgAttribute(uint8_t b1, uint8_t b2, CaptionColor &outColor,
                                              bool &outSemiTransparent);
 
                // -- Tab Offset codes (EIA-608-B §7.6) ---------------------
                //
                // Tab Offset codes nudge the pen position 1, 2, or 3
                // columns to the right of where a PAC just landed it.
                // They're the fine-grained complement to PAC's
                // multiples-of-4 indent slots: PAC indent 8 + Tab
                // Offset T2 places a row at column 10 (8 + 2).  The
                // encoder uses them to honour @ref SubtitleAnchor's
                // horizontal half (Center / Right) when the cue's
                // computed start column isn't already a multiple of 4.
 
                static constexpr uint8_t TabOffsetB1 = 0x17;
 
                static constexpr uint8_t TabOffsetT1 = 0x21;
                static constexpr uint8_t TabOffsetT2 = 0x22;
                static constexpr uint8_t TabOffsetT3 = 0x23;
 
                static void encodeTabOffset(int columns, uint8_t &b1, uint8_t &b2);
 
                static bool isTabOffset(uint8_t b1, uint8_t b2);
 
                static bool decodeTabOffset(uint8_t b1, uint8_t b2, int &outColumns);
 
                // -- Null pair (no-op filler) -------------------------------
 
                static constexpr uint8_t NullB1 = 0x00;
                static constexpr uint8_t NullB2 = 0x00;
 
                // -- Predicates ---------------------------------------------
 
                static constexpr bool isBasicChar(uint8_t c) {
                        const uint8_t v = stripParity(c);
                        return v >= 0x20 && v <= 0x7F;
                }
 
                Cea608() = delete;
};
 
PROMEKI_NAMESPACE_END
 
#endif // PROMEKI_ENABLE_PROAV