sctedescriptors.h

Go to the documentation of this file.

// -*- Mode: c++ -*-
#ifndef SCTE_TABLES_H
#define SCTE_TABLES_H
 
// Qt headers
#include <QString>
 
// MythTV
#include "mpegdescriptors.h"
 
// SCTE 57 p 83
class FrameRateDescriptor : public MPEGDescriptor
{
  public:
    FrameRateDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_frame_rate, 1) { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x82
    // descriptor_length        8   1.0
    // multiple_frame_rate_flag 1   2.0
    bool MultipleFrameRates(void) const { return ( m_data[2] & 0x80 ) != 0; }
    // frame_rate_code          4   2.1
    uint FrameRateCode(void) const { return (m_data[2] >> 3) & 0xF; }
    double FrameRate(void) const
    {
        switch (FrameRateCode())
        {
            case 0x1 :
                return 24.0 / 1.001;
            case 0x2 :
                return 24.0;
            case 0x3 :
                return 25.0;
            case 0x4 :
                return 30.0 / 1.001;
            case 0x5:
                return 30.0;
            case 0x6:
                return 50.0;
            case 0x7:
                return 60.0 / 1.001;
            case 0x8:
                return 60.0;
            default:
                //invalid
                return 0.0;
        }
    }
    // reserved                 3   2.5
 
    QString toString(void) const override // MPEGDescriptor
    {
        return QString("FrameRateDescriptor: "
                       "MultipleFrameRates(%1) MaximumFrameRate(%2)")
            .arg(static_cast<int>(MultipleFrameRates()))
            .arg(FrameRate());
    }
};
 
// SCTE 57 p 84
class ExtendedVideoDescriptor : public MPEGDescriptor
{
  public:
    ExtendedVideoDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_extended_video, 1) { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x83
    // descriptor_length        8   1.0
    // catalog_mode_flag        1   2.0
    bool CatalogModeFlag(void) const { return ( m_data[2] & 0x80 ) != 0; }
    // video_includes_setup     1   2.1
    bool VideoIncludesSetup(void) const { return ( m_data[2] & 0x40 ) != 0; }
    // reserved                 6   2.2
 
    QString toString(void) const override // MPEGDescriptor
    {
        return QString("ExtendedVideoDescriptor: "
                       "CatalogModeFlag(%1) VideoIncludesSetup(%2)")
            .arg(static_cast<int>(CatalogModeFlag()))
            .arg(static_cast<int>(VideoIncludesSetup()));
    }
};
 
// SCTE 57 p 85
class SCTEComponentNameDescriptor : public MPEGDescriptor
{
  public:
    SCTEComponentNameDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_component_name)
    {
        // TODO make sure descriptor is long enough.. set _data NULL otherwise
    }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x84
    // descriptor_length        8   1.0
    // reserved                 2   2.0
    // string_count             6   2.2
    uint StringCount(void) const { return m_data[2] & 0x3F; }
 
    // for (i = 0; i < string_count; i++)
    // {
    // ISO_639_language_code   24  loc(i)
    int LanguageKey(uint i) const
        { return iso639_str3_to_key(&m_data[loc(i)]); }
    QString LanguageString(uint i) const
        { return iso639_key_to_str3(LanguageKey(loc(i))); }
    int CanonicalLanguageKey(uint i) const
        { return iso639_key_to_canonical_key(LanguageKey(loc(i))); }
    QString CanonicalLanguageString(uint i) const
        { return iso639_key_to_str3(CanonicalLanguageKey(loc(i))); }
    // string_length            8  loc(i)+3
    uint StringLength(uint i) const
        { return m_data[loc(i) + 3]; }
    // name_string              *  loc(i)+4
    QString NameString(uint i) const;
    // }
 
    QString toString(void) const override; // MPEGDescriptor
 
  private:
    uint loc(uint number) const
    {
        uint place = 3;
        for (uint i = 0; i < number; ++i)
            place += 4 + m_data[place + 3];
        return place;
    }
};
 
class CueIdentifierDescriptor : public MPEGDescriptor
{
  public:
    CueIdentifierDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_cue_identifier, 1) { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x8A
    // descriptor_length        8   1.0       0x01
    // cue_stream_type          8   2.0
    enum : std::uint8_t // Table 6.3 Cue Stream Types
    {
        kLimited        = 0x0, 
        kAllCommands    = 0x1, 
        kSegmentation   = 0x2, 
        kTieredSplicing = 0x3, 
        kTieredSegmentation = 0x4, 
        // 0x05-0x7f are reserved for future use
        // 0x80-0xff user defined range
    };
    uint CueStreamType(void) const { return m_data[2]; }
    QString CueStreamTypeString(void) const;
    QString toString(void) const override; // MPEGDescriptor
};
 
// See SCTE 57 p 80
class FrequencySpecificationDescriptor : public MPEGDescriptor
{
  public:
    FrequencySpecificationDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_frequency_spec, 2)
    { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x90
    // descriptor_length        8   1.0
    // frequency_unit           1   2.0
    bool FrequencyUnit(void) const { return ( m_data[2] & 0x80 ) != 0; }
    uint FrequencyUnitHz(void) const
        { return FrequencyUnit() ? 10000 : 125000; }
    // carrier_frequency       15   2.1
    uint CarrierFrequency(void) const
        { return ((m_data[2] << 8) | m_data[3]) & 0x7fff; }
    unsigned long long CarrierFrequnecyHz(void) const
    {
        return FrequencyUnitHz() * ((unsigned long long) CarrierFrequency());
    }
 
    QString toString(void) const override // MPEGDescriptor
    {
        return QString("FrequencySpecificationDescriptor: %2 Hz")
            .arg(CarrierFrequnecyHz());
    }
};
 
// SCTE 57 p 81
class ModulationParamsDescriptor : public MPEGDescriptor
{
  public:
    ModulationParamsDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_modulation_params, 6) { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x91
    // descriptor_length        8   1.0
    // transmissionSystem       4   2.0
    uint TransmissionSystem(void) const { return m_data[2] >> 4; }
    // inner_coding_mode        4   2.4
    uint InnerCodingMode(void) const { return m_data[2] & 0x0f; }
    // split_bitstream_mode     1   3.0
    bool SplitBitstreamMode(void) const { return (m_data[3] >> 7) != 0; }
    //reserved                  2   3.1
    //modulation_format         5   3.3
    uint ModulationFormat(void) const { return m_data[3] & 0x1F; }
    // reserved                 4   4.0
    // symbol_rate             28   4.4
    uint SymbolRate(void) const
    {
        return ((m_data[4] << 24) | (m_data[5] << 16) |
                (m_data[6] << 8) | m_data[7]) & 0x7FFF;
    }
};
 
// SCTE 57 p 82
class TransportStreamIdDescriptor : public MPEGDescriptor
{
  public:
    TransportStreamIdDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_transport_stream_id, 2) { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x92
    // descriptor_length        8   1.0
    // target_transport_stream_id 16 2.0
    uint TargetTransportStreamId(void) const
        { return (m_data[2] << 8) | m_data[3]; }
 
    QString toString(void) const override // MPEGDescriptor
    {
        return QString("TransportStreamIdDescriptor: 0x%1")
            .arg(TargetTransportStreamId(),0,16);
    }
};
 
// See SCTE 65 p 55 -- optional descriptor
class RevisionDetectionDescriptor : public MPEGDescriptor
{
  public:
    RevisionDetectionDescriptor(const unsigned char *data, uint len) :
        MPEGDescriptor(data, len, DescriptorID::scte_revision_detection, 3) { }
    //       Name             bits  loc  expected value
    // descriptor_tag           8   0.0       0x93
    // descriptor_length        8   1.0       0x01
    // reserved                 3   2.0
    // table_version_number     5   2.3
    uint TableVersionNumber(void) const { return m_data[2] & 0x1f; }
    // section_number           8   3.0
    uint SectionNumber(void) const { return m_data[3]; }
    // last_section_number      8   4.0
    uint LastSectionNumber(void) const { return m_data[4]; }
 
    QString toString(void) const override; // MPEGDescriptor
};
 
#endif // SCTE_TABLES_H