mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-23 18:21:04 +00:00
364 lines
14 KiB
C
364 lines
14 KiB
C
/*
|
|
* mpegtspacketizer.h -
|
|
* Copyright (C) 2013 Edward Hervey
|
|
*
|
|
* Authors:
|
|
* Edward Hervey <edward@collabora.com>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef GST_MPEGTS_SECTION_H
|
|
#define GST_MPEGTS_SECTION_H
|
|
|
|
#include <gst/gst.h>
|
|
#include <gst/mpegts/gstmpegtsdescriptor.h>
|
|
|
|
typedef struct _GstMpegTsSection GstMpegTsSection;
|
|
|
|
#define GST_TYPE_MPEGTS_SECTION (gst_mpegts_section_get_type())
|
|
#define GST_MPEGTS_SECTION(section) ((GstMpegTsSection*) section)
|
|
|
|
#define GST_MPEGTS_SECTION_TYPE(section) (GST_MPEGTS_SECTION (section)->section_type)
|
|
|
|
GType gst_mpegts_section_get_type (void);
|
|
|
|
/**
|
|
* GstMpegTsSectionType:
|
|
* @GST_MPEGTS_SECTION_UNKNOWN: Unknown section type
|
|
* @GST_MPEGTS_SECTION_PAT: Program Association Table (ISO/IEC 13818-1)
|
|
* @GST_MPEGTS_SECTION_PMT: Program Map Table (ISO/IEC 13818-1)
|
|
* @GST_MPEGTS_SECTION_CAT: Conditional Access Table (ISO/IEC 13818-1)
|
|
* @GST_MPEGTS_SECTION_TSDT: Transport Stream Description Table (ISO/IEC 13818-1)
|
|
* @GST_MPEGTS_SECTION_EIT: Event Information Table (EN 300 468)
|
|
* @GST_MPEGTS_SECTION_NIT: Network Information Table (ISO/IEC 13818-1 / EN 300 468)
|
|
* @GST_MPEGTS_SECTION_BAT: Bouquet Association Table ((EN 300 468)
|
|
* @GST_MPEGTS_SECTION_SDT: Service Description Table (EN 300 468)
|
|
* @GST_MPEGTS_SECTION_TDT: Time and Date Table (EN 300 468)
|
|
* @GST_MPEGTS_SECTION_TOT: Time Offset Table (EN 300 468)
|
|
*
|
|
* Types of #GstMpegTsSection that the library handles.
|
|
*/
|
|
typedef enum {
|
|
GST_MPEGTS_SECTION_UNKNOWN = 0,
|
|
GST_MPEGTS_SECTION_PAT,
|
|
GST_MPEGTS_SECTION_PMT,
|
|
GST_MPEGTS_SECTION_CAT,
|
|
GST_MPEGTS_SECTION_TSDT,
|
|
GST_MPEGTS_SECTION_EIT,
|
|
GST_MPEGTS_SECTION_NIT,
|
|
GST_MPEGTS_SECTION_BAT,
|
|
GST_MPEGTS_SECTION_SDT,
|
|
GST_MPEGTS_SECTION_TDT,
|
|
GST_MPEGTS_SECTION_TOT
|
|
} GstMpegTsSectionType;
|
|
|
|
/**
|
|
* GstMpegTsSectionTableID:
|
|
*
|
|
* Values for a #GstMpegTsSection table_id
|
|
*
|
|
* These are the registered ITU H.222.0 | ISO/IEC 13818-1 table_id variants.
|
|
*
|
|
* see also #GstMpegTsSectionATSCTableID, #GstMpegTsSectionDVBTableID, and
|
|
* #GstMpegTsSectionSCTETableID
|
|
*/
|
|
typedef enum {
|
|
/* ITU H.222.0 / IEC 13818-1 */
|
|
GST_MTS_TABLE_ID_PROGRAM_ASSOCIATION = 0x00,
|
|
GST_MTS_TABLE_ID_CONDITIONAL_ACCESS = 0x01,
|
|
GST_MTS_TABLE_ID_TS_PROGRAM_MAP = 0x02,
|
|
GST_MTS_TABLE_ID_TS_DESCRIPTION = 0x03,
|
|
GST_MTS_TABLE_ID_14496_SCENE_DESCRIPTION = 0x04,
|
|
GST_MTS_TABLE_ID_14496_OBJET_DESCRIPTOR = 0x05,
|
|
GST_MTS_TABLE_ID_METADATA = 0x06,
|
|
GST_MTS_TABLE_ID_IPMP_CONTROL_INFORMATION = 0x07,
|
|
|
|
/* 0x08 - 0x39 : ITU H.222.0 | ISO/IEC 13818-1 reserved */
|
|
|
|
/* IEC 13818-6 (DSM-CC) */
|
|
GST_MTS_TABLE_ID_DSM_CC_MULTIPROTO_ENCAPSULATED_DATA = 0x3A,
|
|
GST_MTS_TABLE_ID_DSM_CC_U_N_MESSAGES = 0x3B,
|
|
GST_MTS_TABLE_ID_DSM_CC_DOWNLOAD_DATA_MESSAGES = 0x3C,
|
|
GST_MTS_TABLE_ID_DSM_CC_STREAM_DESCRIPTORS = 0x3D,
|
|
GST_MTS_TABLE_ID_DSM_CC_PRIVATE_DATA = 0x3E,
|
|
GST_MTS_TABLE_ID_DSM_CC_ADDRESSABLE_SECTIONS = 0x3F,
|
|
|
|
/* Unset */
|
|
GST_MTS_TABLE_ID_UNSET = 0xFF
|
|
|
|
} GstMpegTsSectionTableID;
|
|
|
|
/**
|
|
* GstMpegTsSection:
|
|
* @section_type: The type of section
|
|
* @pid: The pid on which this section was found
|
|
* @table_id: The table id of this section
|
|
* @subtable_extension: This meaning differs per section. See the documentation
|
|
* of the parsed section type for the meaning of this field
|
|
* @version_number: Version of the section.
|
|
* @current_next_indicator: Applies to current/next stream or not
|
|
* @section_number: Number of the section (if multiple)
|
|
* @last_section_number: Number of the last expected section (if multiple)
|
|
* @crc: CRC
|
|
*
|
|
* Mpeg-TS Section Information (SI) (ISO/IEC 13818-1)
|
|
*/
|
|
struct _GstMpegTsSection
|
|
{
|
|
/*< private >*/
|
|
GstMiniObject parent;
|
|
|
|
/*< public >*/
|
|
GstMpegTsSectionType section_type;
|
|
|
|
guint16 pid;
|
|
guint8 table_id;
|
|
|
|
guint16 subtable_extension;
|
|
guint8 version_number;
|
|
|
|
gboolean current_next_indicator;
|
|
|
|
guint8 section_number;
|
|
guint8 last_section_number;
|
|
|
|
guint32 crc;
|
|
|
|
/*< private >*/
|
|
/* data: Points to beginning of section data
|
|
* i.e. the first byte is the table_id field */
|
|
guint8 *data;
|
|
/* section_length: length of data (including final CRC if present) */
|
|
guint section_length;
|
|
/* cached_parsed: cached copy of parsed section */
|
|
gpointer *cached_parsed;
|
|
/* destroy_parsed: function to clear cached_parsed */
|
|
GDestroyNotify destroy_parsed;
|
|
/* offset: offset of the section within the container stream */
|
|
guint64 offset;
|
|
/* short_section: TRUE if section_syntax_indicator == 0
|
|
* FIXME : Maybe make public later on when allowing creation of
|
|
* sections to that people can create private short sections ? */
|
|
gboolean short_section;
|
|
};
|
|
|
|
|
|
/* PAT */
|
|
#define GST_TYPE_MPEGTS_PAT_PROGRAM (gst_mpegts_pat_program_get_type())
|
|
|
|
typedef struct _GstMpegTsPatProgram GstMpegTsPatProgram;
|
|
/**
|
|
* GstMpegTsPatProgram:
|
|
* @program_number: the program number
|
|
* @network_or_program_map_PID: the network of program map PID
|
|
*
|
|
* A program entry from a Program Association Table (ITU H.222.0, ISO/IEC 13818-1).
|
|
*/
|
|
struct _GstMpegTsPatProgram
|
|
{
|
|
guint16 program_number;
|
|
guint16 network_or_program_map_PID;
|
|
};
|
|
|
|
GPtrArray *gst_mpegts_section_get_pat (GstMpegTsSection *section);
|
|
GType gst_mpegts_pat_program_get_type (void);
|
|
|
|
/* CAT */
|
|
|
|
GPtrArray *gst_mpegts_section_get_cat (GstMpegTsSection *section);
|
|
|
|
/* PMT */
|
|
typedef struct _GstMpegTsPMTStream GstMpegTsPMTStream;
|
|
typedef struct _GstMpegTsPMT GstMpegTsPMT;
|
|
#define GST_TYPE_MPEGTS_PMT (gst_mpegts_pmt_get_type())
|
|
#define GST_TYPE_MPEGTS_PMT_STREAM (gst_mpegts_pmt_stream_get_type())
|
|
|
|
/**
|
|
* GstMpegTsStreamType:
|
|
* @GST_MPEG_TS_STREAM_TYPE_RESERVED_00: ITU-T | ISO/IEC Reserved
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG1: ISO/IEC 11172-2 Video
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG2: Rec. ITU-T H.262 | ISO/IEC 13818-2
|
|
* Video or ISO/IEC 11172-2 constrained parameter video stream
|
|
* @GST_MPEG_TS_STREAM_TYPE_AUDIO_MPEG1: ISO/IEC 11172-3 Audio
|
|
* @GST_MPEG_TS_STREAM_TYPE_AUDIO_MPEG2: ISO/IEC 13818-3 Audio
|
|
* @GST_MPEG_TS_STREAM_TYPE_PRIVATE_SECTIONS: private sections
|
|
* @GST_MPEG_TS_STREAM_TYPE_PRIVATE_PES_PACKETS: PES packets containing private data
|
|
* @GST_MPEG_TS_STREAM_TYPE_MHEG: ISO/IEC 13522 MHEG
|
|
* @GST_MPEG_TS_STREAM_TYPE_DSM_CC: Annex A DSM-CC
|
|
* @GST_MPEG_TS_STREAM_TYPE_H_222_1: Rec. ITU-T H.222.1
|
|
* @GST_MPEG_TS_STREAM_TYPE_DSMCC_A: ISO/IEC 13818-6 type A
|
|
* @GST_MPEG_TS_STREAM_TYPE_DSMCC_B: ISO/IEC 13818-6 type B
|
|
* @GST_MPEG_TS_STREAM_TYPE_DSMCC_C: ISO/IEC 13818-6 type C
|
|
* @GST_MPEG_TS_STREAM_TYPE_DSMCC_D: ISO/IEC 13818-6 type D
|
|
* @GST_MPEG_TS_STREAM_TYPE_AUXILIARY: auxiliary streams
|
|
* @GST_MPEG_TS_STREAM_TYPE_AUDIO_AAC_ADTS: ISO/IEC 13818-7 Audio with ADTS
|
|
* transport syntax
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG4: ISO/IEC 14496-2 Visual
|
|
* @GST_MPEG_TS_STREAM_TYPE_AUDIO_AAC_LATM: ISO/IEC 14496-3 Audio with the LATM
|
|
* transport syntax as defined in ISO/IEC 14496-3
|
|
* @GST_MPEG_TS_STREAM_TYPE_SL_FLEXMUX_PES_PACKETS: ISO/IEC 14496-1
|
|
* SL-packetized stream or FlexMux stream carried in PES packets
|
|
* @GST_MPEG_TS_STREAM_TYPE_SL_FLEXMUX_SECTIONS: ISO/IEC 14496-1 SL-packetized
|
|
* stream or FlexMux stream carried in ISO/IEC 14496_sections
|
|
* @GST_MPEG_TS_STREAM_TYPE_SYNCHRONIZED_DOWNLOAD: ISO/IEC 13818-6 Synchronized
|
|
* Download Protocol
|
|
* @GST_MPEG_TS_STREAM_TYPE_METADATA_PES_PACKETS: Metadata carried in PES packets
|
|
* @GST_MPEG_TS_STREAM_TYPE_METADATA_SECTIONS: Metadata carried in metadata_sections
|
|
* @GST_MPEG_TS_STREAM_TYPE_METADATA_DATA_CAROUSEL: Metadata carried in ISO/IEC
|
|
* 13818-6 Data Carousel
|
|
* @GST_MPEG_TS_STREAM_TYPE_METADATA_OBJECT_CAROUSEL: Metadata carried in
|
|
* ISO/IEC 13818-6 Object Carousel
|
|
* @GST_MPEG_TS_STREAM_TYPE_METADATA_SYNCHRONIZED_DOWNLOAD: Metadata carried in
|
|
* ISO/IEC 13818-6 Synchronized Download Protocol
|
|
* @GST_MPEG_TS_STREAM_TYPE_MPEG2_IPMP: IPMP stream (defined in ISO/IEC 13818-11,
|
|
* MPEG-2 IPMP)
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_H264: AVC video stream conforming to one or
|
|
* more profiles defined in Annex A of Rec. ITU-T H.264 | ISO/IEC 14496-10 or
|
|
* AVC video sub-bitstream of SVC as defined in 2.1.78 or MVC base view
|
|
* sub-bitstream, as defined in 2.1.85, or AVC video sub-bitstream of MVC, as
|
|
* defined in 2.1.88
|
|
* @GST_MPEG_TS_STREAM_TYPE_AUDIO_AAC_CLEAN: ISO/IEC 14496-3 Audio, without
|
|
* using any additional transport syntax, such as DST, ALS and SLS
|
|
* @GST_MPEG_TS_STREAM_TYPE_MPEG4_TIMED_TEXT: ISO/IEC 14496-17 Text
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_RVC: Auxiliary video stream as defined in
|
|
* ISO/IEC 23002-3
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_H264_SVC_SUB_BITSTREAM: SVC video sub-bitstream
|
|
* of an AVC video stream conforming to one or more profiles defined in Annex G
|
|
* of Rec. ITU-T H.264 | ISO/IEC 14496-10
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_H264_MVC_SUB_BITSTREAM: MVC video sub-bitstream
|
|
* of an AVC video stream conforming to one or more profiles defined in Annex H
|
|
* of Rec. ITU-T H.264 | ISO/IEC 14496-10
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_JP2K: Video stream conforming to one or more
|
|
* profiles as defined in Rec. ITU-T T.800 | ISO/IEC 15444-1
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG2_STEREO_ADDITIONAL_VIEW: Additional view
|
|
* Rec. ITU-T H.262 | ISO/IEC 13818-2 video stream for service-compatible
|
|
* stereoscopic 3D services
|
|
* @GST_MPEG_TS_STREAM_TYPE_VIDEO_H264_STEREO_ADDITIONAL_VIEW: Additional view
|
|
* Rec. ITU-T H.264 | ISO/IEC 14496-10 video stream conforming to one or more
|
|
* profiles defined in Annex A for service-compatible stereoscopic 3D services
|
|
* @GST_MPEG_TS_STREAM_TYPE_IPMP_STREAM: IPMP stream
|
|
*
|
|
* Type of mpeg-ts stream type.
|
|
*
|
|
* These values correspond to the base standard registered types. Depending
|
|
* on the variant of mpeg-ts being used (Bluray, ATSC, DVB, ...), other
|
|
* types might also be used, but will not conflict with these.
|
|
*
|
|
* Corresponds to table 2-34 of ITU H.222.0 | ISO/IEC 13818-1
|
|
*/
|
|
typedef enum {
|
|
GST_MPEG_TS_STREAM_TYPE_RESERVED_00 = 0x00,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG1 = 0x01,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG2 = 0x02,
|
|
GST_MPEG_TS_STREAM_TYPE_AUDIO_MPEG1 = 0x03,
|
|
GST_MPEG_TS_STREAM_TYPE_AUDIO_MPEG2 = 0x04,
|
|
GST_MPEG_TS_STREAM_TYPE_PRIVATE_SECTIONS = 0x05,
|
|
GST_MPEG_TS_STREAM_TYPE_PRIVATE_PES_PACKETS = 0x06,
|
|
GST_MPEG_TS_STREAM_TYPE_MHEG = 0x07,
|
|
GST_MPEG_TS_STREAM_TYPE_DSM_CC = 0x08,
|
|
GST_MPEG_TS_STREAM_TYPE_H_222_1 = 0x09,
|
|
GST_MPEG_TS_STREAM_TYPE_DSMCC_A = 0x0a,
|
|
GST_MPEG_TS_STREAM_TYPE_DSMCC_B = 0x0b,
|
|
GST_MPEG_TS_STREAM_TYPE_DSMCC_C = 0x0c,
|
|
GST_MPEG_TS_STREAM_TYPE_DSMCC_D = 0x0d,
|
|
GST_MPEG_TS_STREAM_TYPE_AUXILIARY = 0x0e,
|
|
GST_MPEG_TS_STREAM_TYPE_AUDIO_AAC_ADTS = 0x0f,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG4 = 0x10,
|
|
GST_MPEG_TS_STREAM_TYPE_AUDIO_AAC_LATM = 0x11,
|
|
GST_MPEG_TS_STREAM_TYPE_SL_FLEXMUX_PES_PACKETS = 0x12,
|
|
GST_MPEG_TS_STREAM_TYPE_SL_FLEXMUX_SECTIONS = 0x13,
|
|
GST_MPEG_TS_STREAM_TYPE_SYNCHRONIZED_DOWNLOAD = 0x14,
|
|
GST_MPEG_TS_STREAM_TYPE_METADATA_PES_PACKETS = 0x15,
|
|
GST_MPEG_TS_STREAM_TYPE_METADATA_SECTIONS = 0x16,
|
|
GST_MPEG_TS_STREAM_TYPE_METADATA_DATA_CAROUSEL = 0x17,
|
|
GST_MPEG_TS_STREAM_TYPE_METADATA_OBJECT_CAROUSEL = 0x18,
|
|
GST_MPEG_TS_STREAM_TYPE_METADATA_SYNCHRONIZED_DOWNLOAD = 0x19,
|
|
GST_MPEG_TS_STREAM_TYPE_MPEG2_IPMP = 0x1a,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_H264 = 0x1b,
|
|
GST_MPEG_TS_STREAM_TYPE_AUDIO_AAC_CLEAN = 0x1c,
|
|
GST_MPEG_TS_STREAM_TYPE_MPEG4_TIMED_TEXT = 0x1d,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_RVC = 0x1e,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_H264_SVC_SUB_BITSTREAM = 0x1f,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_H264_MVC_SUB_BITSTREAM = 0x20,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_JP2K = 0x21,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_MPEG2_STEREO_ADDITIONAL_VIEW = 0x22,
|
|
GST_MPEG_TS_STREAM_TYPE_VIDEO_H264_STEREO_ADDITIONAL_VIEW = 0x23,
|
|
/* 0x24 - 0x7e : Rec. ITU-T H.222.0 | ISO/IEC 13818-1 Reserved */
|
|
GST_MPEG_TS_STREAM_TYPE_IPMP_STREAM = 0x7f
|
|
/* 0x80 - 0xff : User Private (or defined in other specs) */
|
|
} GstMpegTsStreamType;
|
|
|
|
/**
|
|
* GstMpegTsPMTStream:
|
|
* @stream_type: the type of stream. See #GstMpegTsStreamType
|
|
* @pid: the PID of the stream
|
|
* @descriptors: (element-type GstMpegTsDescriptor): the descriptors of the
|
|
* stream
|
|
*
|
|
* An individual stream definition.
|
|
*/
|
|
struct _GstMpegTsPMTStream
|
|
{
|
|
guint8 stream_type;
|
|
guint16 pid;
|
|
|
|
GPtrArray *descriptors;
|
|
};
|
|
|
|
/**
|
|
* GstMpegTsPMT:
|
|
* @pcr_pid: PID of the stream containing PCR
|
|
* @descriptors: (element-type GstMpegTsDescriptor): array of #GstMpegTsDescriptor
|
|
* @streams: (element-type GstMpegTsPMTStream): Array of #GstMpegTsPMTStream
|
|
*
|
|
* Program Map Table (ISO/IEC 13818-1).
|
|
*
|
|
* The program_number is contained in the subtable_extension field of the
|
|
* container #GstMpegTsSection.
|
|
*/
|
|
struct _GstMpegTsPMT
|
|
{
|
|
guint16 pcr_pid;
|
|
|
|
GPtrArray *descriptors;
|
|
GPtrArray *streams;
|
|
};
|
|
|
|
GType gst_mpegts_pmt_get_type (void);
|
|
GType gst_mpegts_pmt_stream_get_type (void);
|
|
|
|
const GstMpegTsPMT *gst_mpegts_section_get_pmt (GstMpegTsSection *section);
|
|
|
|
/* TSDT */
|
|
|
|
GPtrArray *gst_mpegts_section_get_tsdt (GstMpegTsSection *section);
|
|
|
|
|
|
/* generic */
|
|
|
|
#define gst_mpegts_section_ref(section) ((GstMpegTsSection*) gst_mini_object_ref (GST_MINI_OBJECT_CAST (section)))
|
|
#define gst_mpegts_section_unref(section) (gst_mini_object_unref (GST_MINI_OBJECT_CAST (section)))
|
|
|
|
GstMessage *gst_message_new_mpegts_section (GstObject *parent, GstMpegTsSection *section);
|
|
|
|
GstMpegTsSection *gst_message_parse_mpegts_section (GstMessage *message);
|
|
|
|
GstMpegTsSection *gst_mpegts_section_new (guint16 pid,
|
|
guint8 * data,
|
|
gsize data_size);
|
|
|
|
#endif /* GST_MPEGTS_SECTION_H */
|