ATSC variants of MPEG-TS sections

ATSC variants of MPEG-TS sections — Sections for the various ATSC specifications

Synopsis

#include <gst/mpegts/mpegts.h>

enum                GstMpegtsSectionATSCTableID;
struct              GstMpegtsAtscVCTSource;
struct              GstMpegtsAtscVCT;
const GstMpegtsAtscVCT * gst_mpegts_section_get_atsc_tvct
                                                        (GstMpegtsSection *section);
const GstMpegtsAtscVCT * gst_mpegts_section_get_atsc_cvct
                                                        (GstMpegtsSection *section);
enum                GstMpegtsAtscMGTTableType;
struct              GstMpegtsAtscMGTTable;
struct              GstMpegtsAtscMGT;
const GstMpegtsAtscMGT * gst_mpegts_section_get_atsc_mgt
                                                        (GstMpegtsSection *section);
const gchar *       gst_mpegts_atsc_string_segment_get_string
                                                        (GstMpegtsAtscStringSegment *seg);
struct              GstMpegtsAtscMultString;
struct              GstMpegtsAtscEITEvent;
struct              GstMpegtsAtscEIT;
const GstMpegtsAtscEIT * gst_mpegts_section_get_atsc_eit
                                                        (GstMpegtsSection *section);
struct              GstMpegtsAtscETT;
const GstMpegtsAtscETT * gst_mpegts_section_get_atsc_ett
                                                        (GstMpegtsSection *section);
struct              GstMpegtsAtscSTT;
const GstMpegtsAtscSTT * gst_mpegts_section_get_atsc_stt
                                                        (GstMpegtsSection *section);
GstDateTime *       gst_mpegts_atsc_stt_get_datetime_utc
                                                        (GstMpegtsAtscSTT *stt);

Description

Details

enum GstMpegtsSectionATSCTableID

typedef enum {
  /* ATSC (A/65) */
  GST_MTS_TABLE_ID_ATSC_MASTER_GUIDE                    = 0xC7,
  GST_MTS_TABLE_ID_ATSC_TERRESTRIAL_VIRTUAL_CHANNEL     = 0xC8,
  GST_MTS_TABLE_ID_ATSC_CABLE_VIRTUAL_CHANNEL           = 0xC9,
  GST_MTS_TABLE_ID_ATSC_RATING_REGION                   = 0xCA,
  GST_MTS_TABLE_ID_ATSC_EVENT_INFORMATION               = 0xCB,
  GST_MTS_TABLE_ID_ATSC_CHANNEL_OR_EVENT_EXTENDED_TEXT  = 0xCC,
  GST_MTS_TABLE_ID_ATSC_SYSTEM_TIME                     = 0xCD,
  /* ATSC (A/90) */
  GST_MTS_TABLE_ID_ATSC_DATA_EVENT                      = 0xCE,
  GST_MTS_TABLE_ID_ATSC_DATA_SERVICE                    = 0xCF,
  /* 0xD0 ?? */
  GST_MTS_TABLE_ID_ATSC_NETWORK_RESOURCE                = 0xD1,
  GST_MTS_TABLE_ID_ATSC_LONG_TERM_SERVICE               = 0xD2,
  GST_MTS_TABLE_ID_ATSC_DIRECTED_CHANNEL_CHANGE         = 0xD3,
  GST_MTS_TABLE_ID_ATSC_DIRECTED_CHANNEL_CHANGE_SECTION_CODE = 0xD4,
  /* 0xD5 ?? */
  GST_MTS_TABLE_ID_ATSC_AGGREGATE_EVENT_INFORMATION     = 0xD6,
  GST_MTS_TABLE_ID_ATSC_AGGREGATE_EXTENDED_TEXT         = 0xD7,
  /* 0xD8 ?? */
  GST_MTS_TABLE_ID_ATSC_AGGREGATE_DATA_EVENT            = 0xD9,
  GST_MTS_TABLE_ID_ATSC_SATELLITE_VIRTUAL_CHANNEL       = 0xDA,
} GstMpegtsSectionATSCTableID;

Values for a GstMpegtsSection table_id.

These are the registered ATSC table_id variants.

see also: GstMpegtsSectionTableID

GST_MTS_TABLE_ID_ATSC_MASTER_GUIDE

GST_MTS_TABLE_ID_ATSC_TERRESTRIAL_VIRTUAL_CHANNEL

GST_MTS_TABLE_ID_ATSC_CABLE_VIRTUAL_CHANNEL

GST_MTS_TABLE_ID_ATSC_RATING_REGION

GST_MTS_TABLE_ID_ATSC_EVENT_INFORMATION

GST_MTS_TABLE_ID_ATSC_CHANNEL_OR_EVENT_EXTENDED_TEXT

GST_MTS_TABLE_ID_ATSC_SYSTEM_TIME

GST_MTS_TABLE_ID_ATSC_DATA_EVENT

GST_MTS_TABLE_ID_ATSC_DATA_SERVICE

GST_MTS_TABLE_ID_ATSC_NETWORK_RESOURCE

GST_MTS_TABLE_ID_ATSC_LONG_TERM_SERVICE

GST_MTS_TABLE_ID_ATSC_DIRECTED_CHANNEL_CHANGE

GST_MTS_TABLE_ID_ATSC_DIRECTED_CHANNEL_CHANGE_SECTION_CODE

GST_MTS_TABLE_ID_ATSC_AGGREGATE_EVENT_INFORMATION

GST_MTS_TABLE_ID_ATSC_AGGREGATE_EXTENDED_TEXT

GST_MTS_TABLE_ID_ATSC_AGGREGATE_DATA_EVENT

GST_MTS_TABLE_ID_ATSC_SATELLITE_VIRTUAL_CHANNEL


struct GstMpegtsAtscVCTSource

struct GstMpegtsAtscVCTSource {
  gchar    *short_name;
  guint16   major_channel_number;
  guint16   minor_channel_number;
  guint8    modulation_mode;
  guint32   carrier_frequency;
  guint16   channel_TSID;
  guint16   program_number;
  /* FIXME: */
  guint8    ETM_location;
  gboolean  access_controlled;
  gboolean  hidden;
  gboolean  path_select; /* CVCT only - reserved bit in TVCT */
  gboolean  out_of_band; /* CVCT only - reserved bit in TVCT */
  gboolean  hide_guide;
  /* FIXME: */
  guint8    service_type;
  guint16   source_id;
  GPtrArray *descriptors;
};

Source from a GstMpegtsAtscVCT, can be used both for TVCT and CVCT tables

gchar *short_name;

guint16 major_channel_number;

guint16 minor_channel_number;

guint8 modulation_mode;

guint32 carrier_frequency;

guint16 channel_TSID;

guint16 program_number;

guint8 ETM_location;

gboolean access_controlled;

gboolean hidden;

gboolean path_select;

gboolean out_of_band;

gboolean hide_guide;

guint8 service_type;

guint16 source_id;

GPtrArray *descriptors;

descriptors. [element-type GstMpegtsDescriptor]

struct GstMpegtsAtscVCT

struct GstMpegtsAtscVCT {
  guint16   transport_stream_id;
  guint8    protocol_version;
  GPtrArray *sources;
  GPtrArray *descriptors;
};

Represents both: Terrestrial Virtual Channel Table (A65) Cable Virtual Channel Table (A65)

guint16 transport_stream_id;

guint8 protocol_version;

GPtrArray *sources;

sources. [element-type GstMpegtsAtscVCTSource]

GPtrArray *descriptors;

descriptors. [element-type GstMpegtsDescriptor]

gst_mpegts_section_get_atsc_tvct ()

const GstMpegtsAtscVCT * gst_mpegts_section_get_atsc_tvct
                                                        (GstMpegtsSection *section);

Returns the GstMpegtsAtscVCT contained in the section

section :

a GstMpegtsSection of type GST_MPEGTS_SECTION_ATSC_TVCT

Returns :

The GstMpegtsAtscVCT contained in the section, or NULL if an error happened.

gst_mpegts_section_get_atsc_cvct ()

const GstMpegtsAtscVCT * gst_mpegts_section_get_atsc_cvct
                                                        (GstMpegtsSection *section);

Returns the GstMpegtsAtscVCT contained in the section

section :

a GstMpegtsSection of type GST_MPEGTS_SECTION_ATSC_CVCT

Returns :

The GstMpegtsAtscVCT contained in the section, or NULL if an error happened.

enum GstMpegtsAtscMGTTableType

typedef enum {
  GST_MPEGTS_ATSC_MGT_TABLE_TYPE_EIT0 = 0x0100,
  GST_MPEGTS_ATSC_MGT_TABLE_TYPE_EIT127 = 0x017F,
  GST_MPEGTS_ATSC_MGT_TABLE_TYPE_ETT0 = 0x0200,
  GST_MPEGTS_ATSC_MGT_TABLE_TYPE_ETT127 = 0x027F
} GstMpegtsAtscMGTTableType;

GST_MPEGTS_ATSC_MGT_TABLE_TYPE_EIT0

GST_MPEGTS_ATSC_MGT_TABLE_TYPE_EIT127

GST_MPEGTS_ATSC_MGT_TABLE_TYPE_ETT0

GST_MPEGTS_ATSC_MGT_TABLE_TYPE_ETT127


struct GstMpegtsAtscMGTTable

struct GstMpegtsAtscMGTTable {
  guint16 table_type;
  guint16 pid;
  guint8  version_number;
  guint32 number_bytes;
  GPtrArray *descriptors;
};

Source from a GstMpegtsAtscMGT

guint16 table_type;

guint16 pid;

guint8 version_number;

guint32 number_bytes;

GPtrArray *descriptors;

descriptors. [element-type GstMpegtsDescriptor]

struct GstMpegtsAtscMGT

struct GstMpegtsAtscMGT {
  guint8  protocol_version;
  guint16 tables_defined;
  GPtrArray *tables;
  GPtrArray *descriptors;
};

Master Guide Table (A65)

guint8 protocol_version;

guint16 tables_defined;

GPtrArray *tables;

the tables. [element-type GstMpegtsAtscMGTTable]

GPtrArray *descriptors;

descriptors. [element-type GstMpegtsDescriptor]

gst_mpegts_section_get_atsc_mgt ()

const GstMpegtsAtscMGT * gst_mpegts_section_get_atsc_mgt
                                                        (GstMpegtsSection *section);

Returns the GstMpegtsAtscMGT contained in the section.

section :

a GstMpegtsSection of type GST_MPEGTS_SECTION_ATSC_MGT

Returns :

The GstMpegtsAtscMGT contained in the section, or NULL if an error happened.

gst_mpegts_atsc_string_segment_get_string ()

const gchar *       gst_mpegts_atsc_string_segment_get_string
                                                        (GstMpegtsAtscStringSegment *seg);

struct GstMpegtsAtscMultString

struct GstMpegtsAtscMultString {
  gchar      iso_639_langcode[4];
  GPtrArray *segments;
};

gchar iso_639_langcode[4];

GPtrArray *segments;

(element-type GstMpegtsAtscStringSegment)

struct GstMpegtsAtscEITEvent

struct GstMpegtsAtscEITEvent {
  guint16        event_id;
  guint32        start_time;
  guint8         etm_location;
  guint32        length_in_seconds;
  GPtrArray     *titles;

  GPtrArray *descriptors;
};

An ATSC EIT Event

guint16 event_id;

guint32 start_time;

guint8 etm_location;

guint32 length_in_seconds;

GPtrArray *titles;

the titles. [element-type GstMpegtsAtscMultString]

GPtrArray *descriptors;

descriptors. [element-type GstMpegtsDescriptor]

struct GstMpegtsAtscEIT

struct GstMpegtsAtscEIT {
  guint16        source_id;
  guint8         protocol_version;

  GPtrArray     *events;
};

Event Information Table (ATSC)

guint16 source_id;

guint8 protocol_version;

GPtrArray *events;

Events. [element-type GstMpegtsAtscEITEvent]

gst_mpegts_section_get_atsc_eit ()

const GstMpegtsAtscEIT * gst_mpegts_section_get_atsc_eit
                                                        (GstMpegtsSection *section);

Returns the GstMpegtsAtscEIT contained in the section.

section :

a GstMpegtsSection of type GST_MPEGTS_SECTION_ATSC_EIT

Returns :

The GstMpegtsAtscEIT contained in the section, or NULL if an error happened.

struct GstMpegtsAtscETT

struct GstMpegtsAtscETT {
  guint16        ett_table_id_extension;
  guint16        protocol_version;
  guint32        etm_id;

  GPtrArray     *messages;
};

Extended Text Table (ATSC)

guint16 ett_table_id_extension;

guint16 protocol_version;

guint32 etm_id;

GPtrArray *messages;

List of texts. [element-type GstMpegtsAtscMultString]

gst_mpegts_section_get_atsc_ett ()

const GstMpegtsAtscETT * gst_mpegts_section_get_atsc_ett
                                                        (GstMpegtsSection *section);

Returns the GstMpegtsAtscETT contained in the section.

section :

a GstMpegtsSection of type GST_MPEGTS_SECTION_ATSC_ETT

Returns :

The GstMpegtsAtscETT contained in the section, or NULL if an error happened.

struct GstMpegtsAtscSTT

struct GstMpegtsAtscSTT {
  guint8     protocol_version;
  guint32    system_time;
  guint8     gps_utc_offset;
  gboolean   ds_status;
  guint8     ds_dayofmonth;
  guint8     ds_hour;
  GPtrArray *descriptors;

  GstDateTime *utc_datetime;
};

System Time Table (A65)

guint8 protocol_version;

guint32 system_time;

guint8 gps_utc_offset;

gboolean ds_status;

guint8 ds_dayofmonth;

guint8 ds_hour;

GPtrArray *descriptors;

descriptors. [element-type GstMpegtsDescriptor]

GstDateTime *utc_datetime;


gst_mpegts_section_get_atsc_stt ()

const GstMpegtsAtscSTT * gst_mpegts_section_get_atsc_stt
                                                        (GstMpegtsSection *section);

Returns the GstMpegtsAtscSTT contained in the section.

section :

a GstMpegtsSection of type GST_MPEGTS_SECTION_ATSC_STT

Returns :

The GstMpegtsAtscSTT contained in the section, or NULL if an error happened.

gst_mpegts_atsc_stt_get_datetime_utc ()

GstDateTime *       gst_mpegts_atsc_stt_get_datetime_utc
                                                        (GstMpegtsAtscSTT *stt);