GstH264Parser

gst_h264_create_sei_memory

GstMemory *
gst_h264_create_sei_memory (guint8 start_code_prefix_length,
                            GArray * messages)

Creates raw byte-stream format (a.k.a Annex B type) SEI nal unit data from messages

Since : 1.18

gst_h264_create_sei_memory_avc

GstMemory *
gst_h264_create_sei_memory_avc (guint8 nal_length_size,
                                GArray * messages)

Creates raw packetized format SEI nal unit data from messages

Since : 1.18

gst_h264_decoder_config_record_free

void 
gst_h264_decoder_config_record_free (GstH264DecoderConfigRecord * config)

Free config data

Since : 1.22

gst_h264_nal_parser_free

void 
gst_h264_nal_parser_free (GstH264NalParser * nalparser)

Frees nalparser and sets it to NULL

gst_h264_nal_parser_new

GstH264NalParser *
gst_h264_nal_parser_new ()

Creates a new GstH264NalParser. It should be freed with gst_h264_nal_parser_free after use.

gst_h264_parse_pps

GstH264ParserResult
gst_h264_parse_pps (GstH264NalParser * nalparser,
                    GstH264NalUnit * nalu,
                    GstH264PPS * pps)

Parses data, and fills the pps structure.

The resulting pps data structure shall be deallocated with the gst_h264_pps_clear function when it is no longer needed, or prior to parsing a new PPS NAL unit.

gst_h264_parse_sps

GstH264ParserResult
gst_h264_parse_sps (GstH264NalUnit * nalu,
                    GstH264SPS * sps)

Parses data, and fills the sps structure.

gst_h264_parse_subset_sps

GstH264ParserResult
gst_h264_parse_subset_sps (GstH264NalUnit * nalu,
                           GstH264SPS * sps)

Parses data, and fills in the sps structure.

This function fully parses data and allocates all the necessary data structures needed for MVC extensions. The resulting sps structure shall be deallocated with gst_h264_sps_clear when it is no longer needed.

Note: if the caller doesn't need any of the MVC-specific data, then gst_h264_parser_parse_sps is more efficient because those extra syntax elements are not parsed and no extra memory is allocated.

Since : 1.6

gst_h264_parser_identify_and_split_nalu_avc

GstH264ParserResult
gst_h264_parser_identify_and_split_nalu_avc (GstH264NalParser * nalparser,
                                             const guint8 * data,
                                             guint offset,
                                             gsize size,
                                             guint8 nal_length_size,
                                             GArray * nalus,
                                             gsize * consumed)

Parses data for packetized (e.g., avc/avc3) bitstream and sets nalus. In addition to nal identifying process, this method scans start-code prefix to split malformed packet into actual nal chunks.

Since : 1.22.9

gst_h264_parser_identify_nalu

GstH264ParserResult
gst_h264_parser_identify_nalu (GstH264NalParser * nalparser,
                               const guint8 * data,
                               guint offset,
                               gsize size,
                               GstH264NalUnit * nalu)

Parses the headers of an Annex B coded NAL unit from data and puts the result into nalu.

gst_h264_parser_identify_nalu_avc

GstH264ParserResult
gst_h264_parser_identify_nalu_avc (GstH264NalParser * nalparser,
                                   const guint8 * data,
                                   guint offset,
                                   gsize size,
                                   guint8 nal_length_size,
                                   GstH264NalUnit * nalu)

Parses the headers of an AVC coded NAL unit from data and puts the result into nalu.

gst_h264_parser_identify_nalu_unchecked

GstH264ParserResult
gst_h264_parser_identify_nalu_unchecked (GstH264NalParser * nalparser,
                                         const guint8 * data,
                                         guint offset,
                                         gsize size,
                                         GstH264NalUnit * nalu)

Parses data and fills nalu from the next nalu data from data.

This differs from gst_h264_parser_identify_nalu in that it doesn't check whether the packet is complete or not.

Note: Only use this function if you already know the provided data is a complete NALU, else use gst_h264_parser_identify_nalu.

gst_h264_parser_insert_sei

GstBuffer *
gst_h264_parser_insert_sei (GstH264NalParser * nalparser,
                            GstBuffer * au,
                            GstMemory * sei)

Copy au into new GstBuffer and insert sei into the GstBuffer. The validation for completeness of au and sei is caller's responsibility. Both au and sei must be byte-stream formatted

Since : 1.18

gst_h264_parser_insert_sei_avc

GstBuffer *
gst_h264_parser_insert_sei_avc (GstH264NalParser * nalparser,
                                guint8 nal_length_size,
                                GstBuffer * au,
                                GstMemory * sei)

Copy au into new GstBuffer and insert sei into the GstBuffer. The validation for completeness of au and sei is caller's responsibility. Nal prefix type of both au and sei must be packetized, and also the size of nal length field must be identical to nal_length_size

Since : 1.18

gst_h264_parser_parse_decoder_config_record

GstH264ParserResult
gst_h264_parser_parse_decoder_config_record (GstH264NalParser * nalparser,
                                             const guint8 * data,
                                             gsize size,
                                             GstH264DecoderConfigRecord ** config)

Parses AVCDecoderConfigurationRecord data and fill into config. The caller must free config via gst_h264_decoder_config_record_free

This method does not parse SPS and PPS and therefore the caller needs to parse each NAL unit via appropriate parsing method.

Since : 1.22

gst_h264_parser_parse_nal

GstH264ParserResult
gst_h264_parser_parse_nal (GstH264NalParser * nalparser,
                           GstH264NalUnit * nalu)

This function should be called in the case one doesn't need to parse a specific structure. It is necessary to do so to make sure nalparser is up to date.

gst_h264_parser_parse_pps

GstH264ParserResult
gst_h264_parser_parse_pps (GstH264NalParser * nalparser,
                           GstH264NalUnit * nalu,
                           GstH264PPS * pps)

Parses nalu containing a Picture Parameter Set, and fills pps.

The resulting pps data structure must be deallocated by the caller using gst_h264_pps_clear.

gst_h264_parser_parse_sei

GstH264ParserResult
gst_h264_parser_parse_sei (GstH264NalParser * nalparser,
                           GstH264NalUnit * nalu,
                           GArray ** messages)

Parses nalu containing one or more Supplementary Enhancement Information messages, and allocates and fills the messages array.

gst_h264_parser_parse_slice_hdr

GstH264ParserResult
gst_h264_parser_parse_slice_hdr (GstH264NalParser * nalparser,
                                 GstH264NalUnit * nalu,
                                 GstH264SliceHdr * slice,
                                 gboolean parse_pred_weight_table,
                                 gboolean parse_dec_ref_pic_marking)

Parses nalu containing a coded slice, and fills slice.

gst_h264_parser_parse_sps

GstH264ParserResult
gst_h264_parser_parse_sps (GstH264NalParser * nalparser,
                           GstH264NalUnit * nalu,
                           GstH264SPS * sps)

Parses nalu containing a Sequence Parameter Set, and fills sps.

gst_h264_parser_parse_subset_sps

GstH264ParserResult
gst_h264_parser_parse_subset_sps (GstH264NalParser * nalparser,
                                  GstH264NalUnit * nalu,
                                  GstH264SPS * sps)

Parses data, and fills in the sps structure.

This function fully parses data and allocates all the necessary data structures needed for MVC extensions. The resulting sps structure shall be deallocated with gst_h264_sps_clear when it is no longer needed.

Note: if the caller doesn't need any of the MVC-specific data, then gst_h264_parser_parse_sps is more efficient because those extra syntax elements are not parsed and no extra memory is allocated.

Since : 1.6

gst_h264_parser_update_pps

GstH264ParserResult
gst_h264_parser_update_pps (GstH264NalParser * nalparser,
                            GstH264PPS * pps)

Replace internal Picture Parameter Set struct corresponding to id of pps with pps. nalparser will mark pps as last parsed pps.

Since : 1.18

gst_h264_parser_update_sps

GstH264ParserResult
gst_h264_parser_update_sps (GstH264NalParser * nalparser,
                            GstH264SPS * sps)

Replace internal Sequence Parameter Set struct corresponding to id of sps with sps. nalparser will mark sps as last parsed sps.

Since : 1.18

gst_h264_pps_clear

void 
gst_h264_pps_clear (GstH264PPS * pps)

Clears all pps internal resources.

Since : 1.4

gst_h264_profile_from_string

GstH264Profile
gst_h264_profile_from_string (const gchar * profile)

Returns a GstH264Profile for the string.

Since : 1.24

gst_h264_quant_matrix_4x4_get_raster_from_zigzag

void 
gst_h264_quant_matrix_4x4_get_raster_from_zigzag (guint8 [16]  out_quant,
                                                  const guint8 [16]  quant)

Converts quantization matrix quant from zigzag scan order to raster scan order and store the resulting factors into out_quant.

Note: it is an error to pass the same table in both quant and out_quant arguments.

Since : 1.4

gst_h264_quant_matrix_4x4_get_zigzag_from_raster

void 
gst_h264_quant_matrix_4x4_get_zigzag_from_raster (guint8 [16]  out_quant,
                                                  const guint8 [16]  quant)

Converts quantization matrix quant from raster scan order to zigzag scan order and store the resulting factors into out_quant.

Note: it is an error to pass the same table in both quant and out_quant arguments.

Since : 1.4

gst_h264_quant_matrix_8x8_get_raster_from_zigzag

void 
gst_h264_quant_matrix_8x8_get_raster_from_zigzag (guint8 [64]  out_quant,
                                                  const guint8 [64]  quant)

Converts quantization matrix quant from zigzag scan order to raster scan order and store the resulting factors into out_quant.

Note: it is an error to pass the same table in both quant and out_quant arguments.

Since : 1.4

gst_h264_quant_matrix_8x8_get_zigzag_from_raster

void 
gst_h264_quant_matrix_8x8_get_zigzag_from_raster (guint8 [64]  out_quant,
                                                  const guint8 [64]  quant)

Converts quantization matrix quant from raster scan order to zigzag scan order and store the resulting factors into out_quant.

Note: it is an error to pass the same table in both quant and out_quant arguments.

Since : 1.4

gst_h264_sei_clear

void 
gst_h264_sei_clear (GstH264SEIMessage * sei)

sei: The GstH264SEIMessage to clear

gst_h264_slice_type_to_string

const gchar *
gst_h264_slice_type_to_string (GstH264SliceType slice_type)

Returns the descriptive name for the GstH264SliceType.

Since : 1.24

gst_h264_sps_clear

void 
gst_h264_sps_clear (GstH264SPS * sps)

Clears all sps internal resources.

Since : 1.6

gst_h264_video_calculate_framerate

void 
gst_h264_video_calculate_framerate (const GstH264SPS * sps,
                                    guint field_pic_flag,
                                    guint pic_struct,
                                    gint * fps_num,
                                    gint * fps_den)

Calculate framerate of a video sequence using sps VUI information, field_pic_flag from a slice header and pic_struct from GstH264PicTiming SEI message.

If framerate is variable or can't be determined, fps_num will be set to 0 and fps_den to 1.

GstH264BufferingPeriod

struct _GstH264BufferingPeriod
{
  GstH264SPS *sps;

  /* seq->vui_parameters->nal_hrd_parameters_present_flag */
  guint32 nal_initial_cpb_removal_delay[32];
  guint32 nal_initial_cpb_removal_delay_offset[32];

  /* seq->vui_parameters->vcl_hrd_parameters_present_flag */
  guint32 vcl_initial_cpb_removal_delay[32];
  guint32 vcl_initial_cpb_removal_delay_offset[32];
};

GstH264ClockTimestamp

struct _GstH264ClockTimestamp
{
  guint8 ct_type;
  guint8 nuit_field_based_flag;
  guint8 counting_type;
  guint8 full_timestamp_flag;
  guint8 discontinuity_flag;
  guint8 cnt_dropped_flag;
  guint8 n_frames;

  guint8 seconds_flag;
  guint8 seconds_value;

  guint8 minutes_flag;
  guint8 minutes_value;

  guint8 hours_flag;
  guint8 hours_value;

  guint32 time_offset;
};

GstH264ContentLightLevel

struct _GstH264ContentLightLevel
{
  guint16 max_content_light_level;
  guint16 max_pic_average_light_level;
};

The upper bounds for the nominal target brightness light level as specified in CEA-861.3

GstH264DecRefPicMarking

struct _GstH264DecRefPicMarking
{
  /* if slice->nal_unit.IdrPicFlag */
  guint8 no_output_of_prior_pics_flag;
  guint8 long_term_reference_flag;

  guint8 adaptive_ref_pic_marking_mode_flag;
  GstH264RefPicMarking ref_pic_marking[10];
  guint8 n_ref_pic_marking;

  /* Size of the dec_ref_pic_marking() syntax element in bits (Since: 1.18) */
  guint bit_size;
};

GstH264DecoderConfigRecord

struct _GstH264DecoderConfigRecord
{
  /**
   * GstH264DecoderConfigRecord.configuration_version:
   *
   * Indicates configurationVersion, must be 1
   */
  guint8 configuration_version;

  /**
   * GstH264DecoderConfigRecord.profile_indication:
   *
   * H.264 profile indication
   */
  guint8 profile_indication;

  /**
   * GstH264DecoderConfigRecord.profile_compatibility:
   *
   * H.264 profile compatibility
   */
  guint8 profile_compatibility;

  /**
   * GstH264DecoderConfigRecord.level_indication:
   *
   * H.264 level indiction
   */
  guint8 level_indication;

  /**
   * GstH264DecoderConfigRecord.length_size_minus_one:
   *
   * Indicates the length in bytes of the NAL unit length field
   */
  guint8 length_size_minus_one;

  /**
   * GstH264DecoderConfigRecord.sps
   *
   * Array of identified #GstH264NalUnit from sequenceParameterSetNALUnit.
   * This array may contain non-SPS nal units such as SEI message
   */
  GArray *sps;

  /**
   * GstH264DecoderConfigRecord.pps
   *
   * Array of identified #GstH264NalUnit from pictureParameterSetNALUnit.
   * This array may contain non-PPS nal units such as SEI message
   */
  GArray *pps;

  /**
   * GstH264DecoderConfigRecord.chroma_format_present
   *
   * %TRUE if chroma information is present. Otherwise below values
   * have no meaning
   */
  gboolean chroma_format_present;

  /**
   * GstH264DecoderConfigRecord.chroma_format
   *
   * chroma_format_idc defined in ISO/IEC 14496-10
   */
  guint8 chroma_format;

  /**
   * GstH264DecoderConfigRecord.bit_depth_luma_minus8
   *
   * Indicates bit depth of luma component
   */
  guint8 bit_depth_luma_minus8;

  /**
   * GstH264DecoderConfigRecord.bit_depth_chroma_minus8
   *
   * Indicates bit depth of chroma component
   */
  guint8 bit_depth_chroma_minus8;

  /**
   * GstH264DecoderConfigRecord.sps_ext
   *
   * Array of identified #GstH264NalUnit from sequenceParameterSetExtNALUnit.
   */
  GArray *sps_ext;

};

Contains AVCDecoderConfigurationRecord data as defined in ISO/IEC 14496-15

Since : 1.22

GstH264FramePacking

struct _GstH264FramePacking
{
  guint32 frame_packing_id;
  guint8 frame_packing_cancel_flag;
  guint8 frame_packing_type; /* GstH264FramePackingType */
  guint8 quincunx_sampling_flag;
  guint8 content_interpretation_type;
  guint8 spatial_flipping_flag;
  guint8 frame0_flipped_flag;
  guint8 field_views_flag;
  guint8 current_frame_is_frame0_flag;
  guint8 frame0_self_contained_flag;
  guint8 frame1_self_contained_flag;
  guint8 frame0_grid_position_x;
  guint8 frame0_grid_position_y;
  guint8 frame1_grid_position_x;
  guint8 frame1_grid_position_y;
  guint16 frame_packing_repetition_period;
};

Since : 1.6

GstH264HRDParams

struct _GstH264HRDParams
{
  guint8 cpb_cnt_minus1;
  guint8 bit_rate_scale;
  guint8 cpb_size_scale;

  guint32 bit_rate_value_minus1[32];
  guint32 cpb_size_value_minus1[32];
  guint8 cbr_flag[32];

  guint8 initial_cpb_removal_delay_length_minus1;
  guint8 cpb_removal_delay_length_minus1;
  guint8 dpb_output_delay_length_minus1;
  guint8 time_offset_length;
};

Defines the HRD parameters

GstH264MasteringDisplayColourVolume

struct _GstH264MasteringDisplayColourVolume
{
  guint16 display_primaries_x[3];
  guint16 display_primaries_y[3];
  guint16 white_point_x;
  guint16 white_point_y;
  guint32 max_display_mastering_luminance;
  guint32 min_display_mastering_luminance;
};

The colour volume (primaries, white point and luminance range) of display defined by SMPTE ST 2086.

GstH264NalParser

H264 NAL Parser (opaque structure).

GstH264NalUnit

struct _GstH264NalUnit
{
  guint16 ref_idc;
  guint16 type;

  /* calculated values */
  guint8 idr_pic_flag;
  guint size;
  guint offset;
  guint sc_offset;
  gboolean valid;

  guint8 *data;

  guint8 header_bytes;
  guint8 extension_type;
  union {
    GstH264NalUnitExtensionMVC mvc;
  } extension;
};

Structure defining the NAL unit headers

GstH264NalUnitExtensionMVC

struct _GstH264NalUnitExtensionMVC
{
  guint8 non_idr_flag;
  guint8 priority_id;
  guint16 view_id;
  guint8 temporal_id;
  guint8 anchor_pic_flag;
  guint8 inter_view_flag;
};

Since : 1.6

GstH264PPS

struct _GstH264PPS
{
  gint id;

  GstH264SPS *sequence;

  guint8 entropy_coding_mode_flag;
  guint8 pic_order_present_flag;

  guint32 num_slice_groups_minus1;

  /* if num_slice_groups_minus1 > 0 */
  guint8 slice_group_map_type;
  /* and if slice_group_map_type == 0 */
  guint32 run_length_minus1[8];
  /* or if slice_group_map_type == 2 */
  guint32 top_left[8];
  guint32 bottom_right[8];
  /* or if slice_group_map_type == (3, 4, 5) */
  guint8 slice_group_change_direction_flag;
  guint32 slice_group_change_rate_minus1;
  /* or if slice_group_map_type == 6 */
  guint32 pic_size_in_map_units_minus1;
  guint8 *slice_group_id;

  /* FIXME rename to num_ref_idx_l{0,1}_default_active_minus1 */
  guint8 num_ref_idx_l0_active_minus1;
  guint8 num_ref_idx_l1_active_minus1;
  guint8 weighted_pred_flag;
  guint8 weighted_bipred_idc;
  gint8 pic_init_qp_minus26;
  gint8 pic_init_qs_minus26;
  gint8 chroma_qp_index_offset;
  guint8 deblocking_filter_control_present_flag;
  guint8 constrained_intra_pred_flag;
  guint8 redundant_pic_cnt_present_flag;

  guint8 transform_8x8_mode_flag;

  guint8 scaling_lists_4x4[6][16];
  guint8 scaling_lists_8x8[6][64];

  gint8 second_chroma_qp_index_offset;

  gboolean valid;

  /* Since: 1.18 */
  guint8 pic_scaling_matrix_present_flag;
};

H264 Picture Parameter Set

GstH264PicTiming

struct _GstH264PicTiming
{
  /* from vui */
  guint8 CpbDpbDelaysPresentFlag;
  /* if CpbDpbDelaysPresentFlag */
  guint8 cpb_removal_delay_length_minus1;
  guint8 dpb_output_delay_length_minus1;
  guint32 cpb_removal_delay;
  guint32 dpb_output_delay;

  guint8 pic_struct_present_flag;
  /* if pic_struct_present_flag */
  guint8 pic_struct;

  guint8 clock_timestamp_flag[3];
  GstH264ClockTimestamp clock_timestamp[3];
  guint8 time_offset_length;
};

GstH264PredWeightTable

struct _GstH264PredWeightTable
{
  guint8 luma_log2_weight_denom;
  guint8 chroma_log2_weight_denom;

  gint16 luma_weight_l0[32];
  gint8 luma_offset_l0[32];

  /* if seq->ChromaArrayType != 0 */
  gint16 chroma_weight_l0[32][2];
  gint8 chroma_offset_l0[32][2];

  /* if slice->slice_type % 5 == 1 */
  gint16 luma_weight_l1[32];
  gint8 luma_offset_l1[32];

  /* and if seq->ChromaArrayType != 0 */
  gint16 chroma_weight_l1[32][2];
  gint8 chroma_offset_l1[32][2];
};

GstH264RecoveryPoint

struct _GstH264RecoveryPoint
{
  guint32 recovery_frame_cnt;
  guint8 exact_match_flag;
  guint8 broken_link_flag;
  guint8 changing_slice_group_idc;
};

GstH264RefPicListModification

struct _GstH264RefPicListModification
{
  guint8 modification_of_pic_nums_idc;
  union
  {
    /* if modification_of_pic_nums_idc == 0 || 1 */
    guint32 abs_diff_pic_num_minus1;
    /* if modification_of_pic_nums_idc == 2 */
    guint32 long_term_pic_num;
    /* if modification_of_pic_nums_idc == 4 || 5 */
    guint32 abs_diff_view_idx_minus1;
  } value;
};

GstH264RefPicMarking

struct _GstH264RefPicMarking
{
  guint8 memory_management_control_operation;

  guint32 difference_of_pic_nums_minus1;
  guint32 long_term_pic_num;
  guint32 long_term_frame_idx;
  guint32 max_long_term_frame_idx_plus1;
};

GstH264RegisteredUserData

struct _GstH264RegisteredUserData
{
  guint8 country_code;
  guint8 country_code_extension;
  const guint8 *data;
  guint size;
};

The User data registered by Rec. ITU-T T.35 SEI messag. country_code: an itu_t_t35_country_code. country_code_extension: an itu_t_t35_country_code_extension_byte. Should be ignored when country_code is not 0xff data: the data of itu_t_t35_payload_byte excluding country_code and country_code_extension size: the size of data in bytes

GstH264SEIMessage

struct _GstH264SEIMessage
{
  GstH264SEIPayloadType payloadType;

  union {
    GstH264BufferingPeriod buffering_period;
    GstH264PicTiming pic_timing;
    GstH264RegisteredUserData registered_user_data;
    GstH264RecoveryPoint recovery_point;
    GstH264StereoVideoInfo stereo_video_info;
    GstH264FramePacking frame_packing;
    GstH264MasteringDisplayColourVolume mastering_display_colour_volume;
    GstH264ContentLightLevel content_light_level;
    GstH264SEIUnhandledPayload unhandled_payload;
    GstH264UserDataUnregistered user_data_unregistered;
    /* ... could implement more */
  } payload;
};

GstH264SEIUnhandledPayload

struct _GstH264SEIUnhandledPayload
{
  guint payloadType;

  guint8 *data;
  guint size;
};

Contains unhandled SEI payload data. This SEI may or may not be defined by spec

Since : 1.18

GstH264SPS

struct _GstH264SPS
{
  gint id;

  guint8 profile_idc;
  guint8 constraint_set0_flag;
  guint8 constraint_set1_flag;
  guint8 constraint_set2_flag;
  guint8 constraint_set3_flag;
  guint8 constraint_set4_flag;
  guint8 constraint_set5_flag;
  guint8 level_idc;

  guint8 chroma_format_idc;
  guint8 separate_colour_plane_flag;
  guint8 bit_depth_luma_minus8;
  guint8 bit_depth_chroma_minus8;
  guint8 qpprime_y_zero_transform_bypass_flag;

  guint8 scaling_matrix_present_flag;
  guint8 scaling_lists_4x4[6][16];
  guint8 scaling_lists_8x8[6][64];

  guint8 log2_max_frame_num_minus4;
  guint8 pic_order_cnt_type;

  /* if pic_order_cnt_type == 0 */
  guint8 log2_max_pic_order_cnt_lsb_minus4;

  /* else if pic_order_cnt_type == 1 */
  guint8 delta_pic_order_always_zero_flag;
  gint32 offset_for_non_ref_pic;
  gint32 offset_for_top_to_bottom_field;
  guint8 num_ref_frames_in_pic_order_cnt_cycle;
  gint32 offset_for_ref_frame[255];

  /* FIXME rename according to spec, max_num_ref_frames */
  guint32 num_ref_frames;
  guint8 gaps_in_frame_num_value_allowed_flag;
  guint32 pic_width_in_mbs_minus1;
  guint32 pic_height_in_map_units_minus1;
  guint8 frame_mbs_only_flag;

  guint8 mb_adaptive_frame_field_flag;

  guint8 direct_8x8_inference_flag;

  guint8 frame_cropping_flag;

  /* if frame_cropping_flag */
  guint32 frame_crop_left_offset;
  guint32 frame_crop_right_offset;
  guint32 frame_crop_top_offset;
  guint32 frame_crop_bottom_offset;

  guint8 vui_parameters_present_flag;
  /* if vui_parameters_present_flag */
  GstH264VUIParams vui_parameters;

  /* calculated values */
  guint8 chroma_array_type;
  guint32 max_frame_num;
  gint width, height;
  gint crop_rect_width, crop_rect_height;
  gint crop_rect_x, crop_rect_y;
  gint fps_num_removed, fps_den_removed; /* FIXME: remove */
  gboolean valid;

  /* Subset SPS extensions */
  guint8 extension_type;
  union {
    GstH264SPSExtMVC mvc;
  } extension;
};

H264 Sequence Parameter Set (SPS)

GstH264SPSExtMVC

struct _GstH264SPSExtMVC
{
  guint16 num_views_minus1;
  GstH264SPSExtMVCView *view;
  guint8 num_level_values_signalled_minus1;
  GstH264SPSExtMVCLevelValue *level_value;
};

Represents the parsed seq_parameter_set_mvc_extension().

Since : 1.6

GstH264SPSExtMVCLevelValue

struct _GstH264SPSExtMVCLevelValue
{
  guint8 level_idc;
  guint16 num_applicable_ops_minus1;
  GstH264SPSExtMVCLevelValueOp *applicable_op;
};

Represents level values for a subset of the operation points for the coded video sequence.

Since : 1.6

GstH264SPSExtMVCLevelValueOp

struct _GstH264SPSExtMVCLevelValueOp
{
  guint8 temporal_id;
  guint16 num_target_views_minus1;
  guint16 *target_view_id;
  guint16 num_views_minus1;
};

Represents an operation point for the coded video sequence.

Since : 1.6

GstH264SPSExtMVCView

struct _GstH264SPSExtMVCView
{
  guint16 view_id;
  guint8 num_anchor_refs_l0;
  guint16 anchor_ref_l0[15];
  guint8 num_anchor_refs_l1;
  guint16 anchor_ref_l1[15];
  guint8 num_non_anchor_refs_l0;
  guint16 non_anchor_ref_l0[15];
  guint8 num_non_anchor_refs_l1;
  guint16 non_anchor_ref_l1[15];
};

Represents inter-view dependency relationships for the coded video sequence.

Since : 1.6

GstH264SliceHdr

struct _GstH264SliceHdr
{
  guint32 first_mb_in_slice;
  guint32 type;
  GstH264PPS *pps;

  /* if seq->separate_colour_plane_flag */
  guint8 colour_plane_id;

  guint16 frame_num;

  guint8 field_pic_flag;
  guint8 bottom_field_flag;

  /* if nal_unit.type == 5 */
  guint16 idr_pic_id;

  /* if seq->pic_order_cnt_type == 0 */
  guint16 pic_order_cnt_lsb;
  /* if seq->pic_order_present_flag && !field_pic_flag */
  gint32 delta_pic_order_cnt_bottom;

  gint32 delta_pic_order_cnt[2];
  guint8 redundant_pic_cnt;

  /* if slice_type == B_SLICE */
  guint8 direct_spatial_mv_pred_flag;

  guint8 num_ref_idx_l0_active_minus1;
  guint8 num_ref_idx_l1_active_minus1;

  guint8 ref_pic_list_modification_flag_l0;
  guint8 n_ref_pic_list_modification_l0;
  GstH264RefPicListModification ref_pic_list_modification_l0[32];
  guint8 ref_pic_list_modification_flag_l1;
  guint8 n_ref_pic_list_modification_l1;
  GstH264RefPicListModification ref_pic_list_modification_l1[32];

  GstH264PredWeightTable pred_weight_table;
  /* if nal_unit.ref_idc != 0 */
  GstH264DecRefPicMarking dec_ref_pic_marking;

  guint8 cabac_init_idc;
  gint8 slice_qp_delta;
  gint8 slice_qs_delta;

  guint8 disable_deblocking_filter_idc;
  gint8 slice_alpha_c0_offset_div2;
  gint8 slice_beta_offset_div2;

  guint16 slice_group_change_cycle;

  /* calculated values */
  guint32 max_pic_num;
  gboolean valid;

  /* Size of the slice_header() in bits */
  guint header_size;

  /* Number of emulation prevention bytes (EPB) in this slice_header() */
  guint n_emulation_prevention_bytes;

  /* Since: 1.18 */
  guint8 num_ref_idx_active_override_flag;
  guint8 sp_for_switch_flag;

  /*
   * Size of the pic_order_cnt related syntax elements pic_order_cnt_lsb,
   * delta_pic_order_cnt_bottom, delta_pic_order_cnt[0], and
   * delta_pic_order_cnt[1]. (Since: 1.18)
   */
  guint pic_order_cnt_bit_size;
};

GstH264StereoVideoInfo

struct _GstH264StereoVideoInfo
{
  guint8 field_views_flag;
  guint8 top_field_is_left_view_flag;
  guint8 current_frame_is_left_view_flag;
  guint8 next_frame_is_second_view_flag;
  guint8 left_view_self_contained_flag;
  guint8 right_view_self_contained_flag;
};

Since : 1.6

GstH264UserDataUnregistered

struct _GstH264UserDataUnregistered
{
  guint8 uuid[16];
  const guint8 *data;
  guint size;
};

The User data unregistered SEI message syntax.

Since : 1.22

GstH264VUIParams

struct _GstH264VUIParams
{
  guint8 aspect_ratio_info_present_flag;
  guint8 aspect_ratio_idc;
  /* if aspect_ratio_idc == 255 */
  guint16 sar_width;
  guint16 sar_height;

  guint8 overscan_info_present_flag;
  /* if overscan_info_present_flag */
  guint8 overscan_appropriate_flag;

  guint8 video_signal_type_present_flag;
  guint8 video_format;
  guint8 video_full_range_flag;
  guint8 colour_description_present_flag;
  guint8 colour_primaries;
  guint8 transfer_characteristics;
  guint8 matrix_coefficients;

  guint8 chroma_loc_info_present_flag;
  guint8 chroma_sample_loc_type_top_field;
  guint8 chroma_sample_loc_type_bottom_field;

  guint8 timing_info_present_flag;
  /* if timing_info_present_flag */
  guint32 num_units_in_tick;
  guint32 time_scale;
  guint8 fixed_frame_rate_flag;

  guint8 nal_hrd_parameters_present_flag;
  /* if nal_hrd_parameters_present_flag */
  GstH264HRDParams nal_hrd_parameters;

  guint8 vcl_hrd_parameters_present_flag;
  /* if vcl_hrd_parameters_present_flag */
  GstH264HRDParams vcl_hrd_parameters;

  guint8 low_delay_hrd_flag;
  guint8 pic_struct_present_flag;

  guint8 bitstream_restriction_flag;
  /*  if bitstream_restriction_flag */
  guint8 motion_vectors_over_pic_boundaries_flag;
  guint32 max_bytes_per_pic_denom;
  guint32 max_bits_per_mb_denom;
  guint32 log2_max_mv_length_horizontal;
  guint32 log2_max_mv_length_vertical;
  guint32 num_reorder_frames;
  guint32 max_dec_frame_buffering;

  /* calculated values */
  guint par_n;
  guint par_d;
};

The structure representing the VUI parameters.

GstCtType

typedef enum
{
  GST_H264_CT_TYPE_PROGRESSIVE = 0,
  GST_H264_CT_TYPE_INTERLACED = 1,
  GST_H264_CT_TYPE_UNKNOWN = 2,
} GstCtType;

GstH264FramePackingType

typedef enum
{
  GST_H264_FRAME_PACKING_NONE                           = 6,
  GST_H264_FRAME_PACKING_CHECKERBOARD_INTERLEAVING      = 0,
  GST_H264_FRAME_PACKING_COLUMN_INTERLEAVING            = 1,
  GST_H264_FRAME_PACKING_ROW_INTERLEAVING               = 2,
  GST_H264_FRAME_PACKING_SIDE_BY_SIDE                   = 3,
  GST_H264_FRMAE_PACKING_TOP_BOTTOM                     = 4,

  /**
   * GST_H264_FRAME_PACKING_TOP_BOTTOM:
   *
   * Top-Bottom packing
   *
   * Since: 1.22
   */
  GST_H264_FRAME_PACKING_TOP_BOTTOM                     = 4,
  GST_H264_FRAME_PACKING_TEMPORAL_INTERLEAVING          = 5
} GstH264FramePackingType;

Frame packing arrangement types.

Since : 1.6

GstH264Level

typedef enum
{
  GST_H264_LEVEL_L1 = 10,
  GST_H264_LEVEL_L1B = 9,
  GST_H264_LEVEL_L1_1 = 11,
  GST_H264_LEVEL_L1_2 = 12,
  GST_H264_LEVEL_L1_3 = 13,
  GST_H264_LEVEL_L2 = 20,
  GST_H264_LEVEL_L2_1 = 21,
  GST_H264_LEVEL_L2_2 = 22,
  GST_H264_LEVEL_L3 = 30,
  GST_H264_LEVEL_L3_1 = 31,
  GST_H264_LEVEL_L3_2 = 32,
  GST_H264_LEVEL_L4 = 40,
  GST_H264_LEVEL_L4_1 = 41,
  GST_H264_LEVEL_L4_2 = 42,
  GST_H264_LEVEL_L5 = 50,
  GST_H264_LEVEL_L5_1 = 51,
  GST_H264_LEVEL_L5_2 = 52,
  GST_H264_LEVEL_L6 = 60,
  GST_H264_LEVEL_L6_1 = 61,
  GST_H264_LEVEL_L6_2 = 62,
} GstH264Level;

H.264 level

Since : 1.24

GstH264NalUnitExtensionType

typedef enum
{
  GST_H264_NAL_EXTENSION_NONE = 0,
  GST_H264_NAL_EXTENSION_SVC,
  GST_H264_NAL_EXTENSION_MVC,
} GstH264NalUnitExtensionType;

Indicates the type of H.264 NAL unit extension.

Since : 1.6

GstH264NalUnitType

typedef enum
{
  GST_H264_NAL_UNKNOWN      = 0,
  GST_H264_NAL_SLICE        = 1,
  GST_H264_NAL_SLICE_DPA    = 2,
  GST_H264_NAL_SLICE_DPB    = 3,
  GST_H264_NAL_SLICE_DPC    = 4,
  GST_H264_NAL_SLICE_IDR    = 5,
  GST_H264_NAL_SEI          = 6,
  GST_H264_NAL_SPS          = 7,
  GST_H264_NAL_PPS          = 8,
  GST_H264_NAL_AU_DELIMITER = 9,
  GST_H264_NAL_SEQ_END      = 10,
  GST_H264_NAL_STREAM_END   = 11,
  GST_H264_NAL_FILLER_DATA  = 12,
  GST_H264_NAL_SPS_EXT      = 13,
  GST_H264_NAL_PREFIX_UNIT  = 14,
  GST_H264_NAL_SUBSET_SPS   = 15,
  GST_H264_NAL_DEPTH_SPS    = 16,

  /**
   * GST_H264_NAL_RSV_1:
   *
   * First reserved parameter
   *
   * Since: 1.24
   */
  GST_H264_NAL_RSV_1        = 17,

  /**
   * GST_H264_NAL_RSV_2:
   *
   * Second reserved parameter
   *
   * Since: 1.24
   */
  GST_H264_NAL_RSV_2        = 18,
  GST_H264_NAL_SLICE_AUX    = 19,
  GST_H264_NAL_SLICE_EXT    = 20,
  GST_H264_NAL_SLICE_DEPTH  = 21
} GstH264NalUnitType;

Indicates the type of H264 Nal Units

GstH264ParserResult

typedef enum
{
  GST_H264_PARSER_OK,
  GST_H264_PARSER_BROKEN_DATA,
  GST_H264_PARSER_BROKEN_LINK,
  GST_H264_PARSER_ERROR,
  GST_H264_PARSER_NO_NAL,
  GST_H264_PARSER_NO_NAL_END
} GstH264ParserResult;

The result of parsing H264 data.

GstH264Profile

typedef enum {
  GST_H264_PROFILE_BASELINE             = 66,
  GST_H264_PROFILE_MAIN                 = 77,
  GST_H264_PROFILE_EXTENDED             = 88,
  GST_H264_PROFILE_HIGH                 = 100,
  GST_H264_PROFILE_HIGH10               = 110,
  GST_H264_PROFILE_HIGH_422             = 122,
  GST_H264_PROFILE_HIGH_444             = 244,
  GST_H264_PROFILE_MULTIVIEW_HIGH       = 118,
  GST_H264_PROFILE_STEREO_HIGH          = 128,
  GST_H264_PROFILE_SCALABLE_BASELINE    = 83,
  GST_H264_PROFILE_SCALABLE_HIGH        = 86,
  /**
   * GST_H264_PROFILE_INVALID:
   *
   * Invalid H264 profile
   *
   * Since: 1.24
   */
  GST_H264_PROFILE_INVALID              = -1
} GstH264Profile;

H.264 Profiles.

Since : 1.2

GstH264SEIPayloadType

typedef enum
{
  GST_H264_SEI_BUF_PERIOD = 0,
  GST_H264_SEI_PIC_TIMING = 1,
  GST_H264_SEI_REGISTERED_USER_DATA = 4,
  GST_H264_SEI_USER_DATA_UNREGISTERED = 5,
  GST_H264_SEI_RECOVERY_POINT = 6,
  GST_H264_SEI_STEREO_VIDEO_INFO = 21,
  GST_H264_SEI_FRAME_PACKING = 45,
  GST_H264_SEI_MASTERING_DISPLAY_COLOUR_VOLUME = 137,
  GST_H264_SEI_CONTENT_LIGHT_LEVEL = 144,
      /* and more...  */

  /* Unhandled SEI type */
  GST_H264_SEI_UNHANDLED_PAYLOAD = -1
} GstH264SEIPayloadType;

The type of SEI message.

GstH264SEIPicStructType

typedef enum
{
  GST_H264_SEI_PIC_STRUCT_FRAME             = 0,
  GST_H264_SEI_PIC_STRUCT_TOP_FIELD         = 1,
  GST_H264_SEI_PIC_STRUCT_BOTTOM_FIELD      = 2,
  GST_H264_SEI_PIC_STRUCT_TOP_BOTTOM        = 3,
  GST_H264_SEI_PIC_STRUCT_BOTTOM_TOP        = 4,
  GST_H264_SEI_PIC_STRUCT_TOP_BOTTOM_TOP    = 5,
  GST_H264_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM = 6,
  GST_H264_SEI_PIC_STRUCT_FRAME_DOUBLING    = 7,
  GST_H264_SEI_PIC_STRUCT_FRAME_TRIPLING    = 8
} GstH264SEIPicStructType;

SEI pic_struct type

GstH264SliceType

typedef enum
{
  GST_H264_P_SLICE    = 0,
  GST_H264_B_SLICE    = 1,
  GST_H264_I_SLICE    = 2,
  GST_H264_SP_SLICE   = 3,
  GST_H264_SI_SLICE   = 4,
  GST_H264_S_P_SLICE  = 5,
  GST_H264_S_B_SLICE  = 6,
  GST_H264_S_I_SLICE  = 7,
  GST_H264_S_SP_SLICE = 8,
  GST_H264_S_SI_SLICE = 9
} GstH264SliceType;

Type of Picture slice