git.sesse.net Git - ffmpeg/blob - libavcodec/h264_ps.h

   1 /*
   2  * This file is part of FFmpeg.
   3  *
   4  * FFmpeg is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * FFmpeg is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with FFmpeg; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  17  */
  18
  19 /**
  20  * @file
  21  * H.264 parameter set handling
  22  */
  23
  24 #ifndef AVCODEC_H264_PS_H
  25 #define AVCODEC_H264_PS_H
  26
  27 #include <stdint.h>
  28
  29 #include "libavutil/buffer.h"
  30 #include "libavutil/pixfmt.h"
  31 #include "libavutil/rational.h"
  32
  33 #include "avcodec.h"
  34 #include "get_bits.h"
  35 #include "h264.h"
  36
  37 #define MAX_SPS_COUNT          32
  38 #define MAX_PPS_COUNT         256
  39 #define MAX_LOG2_MAX_FRAME_NUM    (12 + 4)
  40
  41 /**
  42  * Sequence parameter set
  43  */
  44 typedef struct SPS {
  45     unsigned int sps_id;
  46     int profile_idc;
  47     int level_idc;
  48     int chroma_format_idc;
  49     int transform_bypass;              ///< qpprime_y_zero_transform_bypass_flag
  50     int log2_max_frame_num;            ///< log2_max_frame_num_minus4 + 4
  51     int poc_type;                      ///< pic_order_cnt_type
  52     int log2_max_poc_lsb;              ///< log2_max_pic_order_cnt_lsb_minus4
  53     int delta_pic_order_always_zero_flag;
  54     int offset_for_non_ref_pic;
  55     int offset_for_top_to_bottom_field;
  56     int poc_cycle_length;              ///< num_ref_frames_in_pic_order_cnt_cycle
  57     int ref_frame_count;               ///< num_ref_frames
  58     int gaps_in_frame_num_allowed_flag;
  59     int mb_width;                      ///< pic_width_in_mbs_minus1 + 1
  60     ///< (pic_height_in_map_units_minus1 + 1) * (2 - frame_mbs_only_flag)
  61     int mb_height;
  62     int frame_mbs_only_flag;
  63     int mb_aff;                        ///< mb_adaptive_frame_field_flag
  64     int direct_8x8_inference_flag;
  65     int crop;                          ///< frame_cropping_flag
  66
  67     /* those 4 are already in luma samples */
  68     unsigned int crop_left;            ///< frame_cropping_rect_left_offset
  69     unsigned int crop_right;           ///< frame_cropping_rect_right_offset
  70     unsigned int crop_top;             ///< frame_cropping_rect_top_offset
  71     unsigned int crop_bottom;          ///< frame_cropping_rect_bottom_offset
  72     int vui_parameters_present_flag;
  73     AVRational sar;
  74     int video_signal_type_present_flag;
  75     int full_range;
  76     int colour_description_present_flag;
  77     enum AVColorPrimaries color_primaries;
  78     enum AVColorTransferCharacteristic color_trc;
  79     enum AVColorSpace colorspace;
  80     enum AVChromaLocation chroma_location;
  81
  82     int timing_info_present_flag;
  83     uint32_t num_units_in_tick;
  84     uint32_t time_scale;
  85     int fixed_frame_rate_flag;
  86     int32_t offset_for_ref_frame[256];
  87     int bitstream_restriction_flag;
  88     int num_reorder_frames;
  89     int scaling_matrix_present;
  90     uint8_t scaling_matrix4[6][16];
  91     uint8_t scaling_matrix8[6][64];
  92     int nal_hrd_parameters_present_flag;
  93     int vcl_hrd_parameters_present_flag;
  94     int pic_struct_present_flag;
  95     int time_offset_length;
  96     int cpb_cnt;                          ///< See H.264 E.1.2
  97     int initial_cpb_removal_delay_length; ///< initial_cpb_removal_delay_length_minus1 + 1
  98     int cpb_removal_delay_length;         ///< cpb_removal_delay_length_minus1 + 1
  99     int dpb_output_delay_length;          ///< dpb_output_delay_length_minus1 + 1
 100     int bit_depth_luma;                   ///< bit_depth_luma_minus8 + 8
 101     int bit_depth_chroma;                 ///< bit_depth_chroma_minus8 + 8
 102     int residual_color_transform_flag;    ///< residual_colour_transform_flag
 103     int constraint_set_flags;             ///< constraint_set[0-3]_flag
 104     uint8_t data[4096];
 105     size_t data_size;
 106 } SPS;
 107
 108 /**
 109  * Picture parameter set
 110  */
 111 typedef struct PPS {
 112     unsigned int sps_id;
 113     int cabac;                  ///< entropy_coding_mode_flag
 114     int pic_order_present;      ///< pic_order_present_flag
 115     int slice_group_count;      ///< num_slice_groups_minus1 + 1
 116     int mb_slice_group_map_type;
 117     unsigned int ref_count[2];  ///< num_ref_idx_l0/1_active_minus1 + 1
 118     int weighted_pred;          ///< weighted_pred_flag
 119     int weighted_bipred_idc;
 120     int init_qp;                ///< pic_init_qp_minus26 + 26
 121     int init_qs;                ///< pic_init_qs_minus26 + 26
 122     int chroma_qp_index_offset[2];
 123     int deblocking_filter_parameters_present; ///< deblocking_filter_parameters_present_flag
 124     int constrained_intra_pred;     ///< constrained_intra_pred_flag
 125     int redundant_pic_cnt_present;  ///< redundant_pic_cnt_present_flag
 126     int transform_8x8_mode;         ///< transform_8x8_mode_flag
 127     uint8_t scaling_matrix4[6][16];
 128     uint8_t scaling_matrix8[6][64];
 129     uint8_t chroma_qp_table[2][QP_MAX_NUM+1];  ///< pre-scaled (with chroma_qp_index_offset) version of qp_table
 130     int chroma_qp_diff;
 131     uint8_t data[4096];
 132     size_t data_size;
 133
 134     uint32_t dequant4_buffer[6][QP_MAX_NUM + 1][16];
 135     uint32_t dequant8_buffer[6][QP_MAX_NUM + 1][64];
 136     uint32_t(*dequant4_coeff[6])[16];
 137     uint32_t(*dequant8_coeff[6])[64];
 138
 139     AVBufferRef *sps_ref;
 140     const SPS   *sps;
 141 } PPS;
 142
 143 typedef struct H264ParamSets {
 144     AVBufferRef *sps_list[MAX_SPS_COUNT];
 145     AVBufferRef *pps_list[MAX_PPS_COUNT];
 146
 147     AVBufferRef *pps_ref;
 148     /* currently active parameters sets */
 149     const PPS *pps;
 150     const SPS *sps;
 151
 152     int overread_warning_printed[2];
 153 } H264ParamSets;
 154
 155 /**
 156  * Decode SPS
 157  */
 158 int ff_h264_decode_seq_parameter_set(GetBitContext *gb, AVCodecContext *avctx,
 159                                      H264ParamSets *ps, int ignore_truncation);
 160
 161 /**
 162  * Decode PPS
 163  */
 164 int ff_h264_decode_picture_parameter_set(GetBitContext *gb, AVCodecContext *avctx,
 165                                          H264ParamSets *ps, int bit_length);
 166
 167 /**
 168  * Uninit H264 param sets structure.
 169  */
 170 void ff_h264_ps_uninit(H264ParamSets *ps);
 171
 172 #endif /* AVCODEC_H264_PS_H */