• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 */
173