FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
h264_ps.h
Go to the documentation of this file.
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 
40 /**
41  * Sequence parameter set
42  */
43 typedef struct SPS {
44  unsigned int sps_id;
46  int level_idc;
48  int transform_bypass; ///< qpprime_y_zero_transform_bypass_flag
49  int log2_max_frame_num; ///< log2_max_frame_num_minus4 + 4
50  int poc_type; ///< pic_order_cnt_type
51  int log2_max_poc_lsb; ///< log2_max_pic_order_cnt_lsb_minus4
55  int poc_cycle_length; ///< num_ref_frames_in_pic_order_cnt_cycle
56  int ref_frame_count; ///< num_ref_frames
58  int mb_width; ///< pic_width_in_mbs_minus1 + 1
59  int mb_height; ///< pic_height_in_map_units_minus1 + 1
61  int mb_aff; ///< mb_adaptive_frame_field_flag
63  int crop; ///< frame_cropping_flag
64 
65  /* those 4 are already in luma samples */
66  unsigned int crop_left; ///< frame_cropping_rect_left_offset
67  unsigned int crop_right; ///< frame_cropping_rect_right_offset
68  unsigned int crop_top; ///< frame_cropping_rect_top_offset
69  unsigned int crop_bottom; ///< frame_cropping_rect_bottom_offset
80  uint32_t time_scale;
82  short offset_for_ref_frame[256]; // FIXME dyn aloc?
92  int cpb_cnt; ///< See H.264 E.1.2
93  int initial_cpb_removal_delay_length; ///< initial_cpb_removal_delay_length_minus1 + 1
94  int cpb_removal_delay_length; ///< cpb_removal_delay_length_minus1 + 1
95  int dpb_output_delay_length; ///< dpb_output_delay_length_minus1 + 1
96  int bit_depth_luma; ///< bit_depth_luma_minus8 + 8
97  int bit_depth_chroma; ///< bit_depth_chroma_minus8 + 8
98  int residual_color_transform_flag; ///< residual_colour_transform_flag
99  int constraint_set_flags; ///< constraint_set[0-3]_flag
100  uint8_t data[4096];
101  size_t data_size;
102 } SPS;
103 
104 /**
105  * Picture parameter set
106  */
107 typedef struct PPS {
108  unsigned int sps_id;
109  int cabac; ///< entropy_coding_mode_flag
110  int pic_order_present; ///< pic_order_present_flag
111  int slice_group_count; ///< num_slice_groups_minus1 + 1
113  unsigned int ref_count[2]; ///< num_ref_idx_l0/1_active_minus1 + 1
114  int weighted_pred; ///< weighted_pred_flag
116  int init_qp; ///< pic_init_qp_minus26 + 26
117  int init_qs; ///< pic_init_qs_minus26 + 26
119  int deblocking_filter_parameters_present; ///< deblocking_filter_parameters_present_flag
120  int constrained_intra_pred; ///< constrained_intra_pred_flag
121  int redundant_pic_cnt_present; ///< redundant_pic_cnt_present_flag
122  int transform_8x8_mode; ///< transform_8x8_mode_flag
125  uint8_t chroma_qp_table[2][QP_MAX_NUM+1]; ///< pre-scaled (with chroma_qp_index_offset) version of qp_table
127  uint8_t data[4096];
128  size_t data_size;
129 
130  uint32_t dequant4_buffer[6][QP_MAX_NUM + 1][16];
131  uint32_t dequant8_buffer[6][QP_MAX_NUM + 1][64];
132  uint32_t(*dequant4_coeff[6])[16];
133  uint32_t(*dequant8_coeff[6])[64];
134 } PPS;
135 
136 typedef struct H264ParamSets {
139 
142  /* currently active parameters sets */
143  const PPS *pps;
144  const SPS *sps;
145 } H264ParamSets;
146 
147 /**
148  * Decode SPS
149  */
151  H264ParamSets *ps, int ignore_truncation);
152 
153 /**
154  * Decode PPS
155  */
157  H264ParamSets *ps, int bit_length);
158 
159 /**
160  * Uninit H264 param sets structure.
161  */
163 
164 #endif /* AVCODEC_H264_PS_H */
int chroma_format_idc
Definition: h264_ps.h:47
int video_signal_type_present_flag
Definition: h264_ps.h:72
#define MAX_SPS_COUNT
Definition: h264_ps.h:37
ptrdiff_t const GLvoid * data
Definition: opengl_enc.c:101
int weighted_bipred_idc
Definition: h264_ps.h:115
int chroma_qp_index_offset[2]
Definition: h264_ps.h:118
AVBufferRef * sps_list[MAX_SPS_COUNT]
Definition: h264_ps.h:137
int scaling_matrix_present
Definition: h264_ps.h:85
uint8_t scaling_matrix4[6][16]
Definition: h264_ps.h:86
Sequence parameter set.
Definition: h264_ps.h:43
int bitstream_restriction_flag
Definition: h264_ps.h:83
unsigned int ref_count[2]
num_ref_idx_l0/1_active_minus1 + 1
Definition: h264_ps.h:113
Picture parameter set.
Definition: h264_ps.h:107
int frame_mbs_only_flag
Definition: h264_ps.h:60
int chroma_qp_diff
Definition: h264_ps.h:126
uint32_t num_units_in_tick
Definition: h264_ps.h:79
int profile_idc
Definition: h264_ps.h:45
AVColorTransferCharacteristic
Color Transfer Characteristic.
Definition: pixfmt.h:410
unsigned int crop_top
frame_cropping_rect_top_offset
Definition: h264_ps.h:68
int fixed_frame_rate_flag
Definition: h264_ps.h:81
uint8_t scaling_matrix4[6][16]
Definition: h264_ps.h:123
int deblocking_filter_parameters_present
deblocking_filter_parameters_present_flag
Definition: h264_ps.h:119
const PPS * pps
Definition: h264_ps.h:143
uint8_t
int full_range
Definition: h264_ps.h:73
unsigned int crop_left
frame_cropping_rect_left_offset
Definition: h264_ps.h:66
int offset_for_non_ref_pic
Definition: h264_ps.h:53
int gaps_in_frame_num_allowed_flag
Definition: h264_ps.h:57
int bit_depth_chroma
bit_depth_chroma_minus8 + 8
Definition: h264_ps.h:97
AVColorSpace
YUV colorspace type.
Definition: pixfmt.h:436
enum AVColorPrimaries color_primaries
Definition: h264_ps.h:75
int cabac
entropy_coding_mode_flag
Definition: h264_ps.h:109
unsigned int crop_right
frame_cropping_rect_right_offset
Definition: h264_ps.h:67
uint32_t(*[6] dequant4_coeff)[16]
Definition: h264_ps.h:132
#define MAX_PPS_COUNT
Definition: h264_ps.h:38
int transform_bypass
qpprime_y_zero_transform_bypass_flag
Definition: h264_ps.h:48
uint32_t(*[6] dequant8_coeff)[64]
Definition: h264_ps.h:133
int redundant_pic_cnt_present
redundant_pic_cnt_present_flag
Definition: h264_ps.h:121
bitstream reader API header.
AVColorPrimaries
Chromaticity coordinates of the source primaries.
Definition: pixfmt.h:389
H.264 common definitions.
enum AVColorTransferCharacteristic color_trc
Definition: h264_ps.h:76
int mb_aff
mb_adaptive_frame_field_flag
Definition: h264_ps.h:61
AVBufferRef * sps_ref
Definition: h264_ps.h:141
int poc_type
pic_order_cnt_type
Definition: h264_ps.h:50
int constrained_intra_pred
constrained_intra_pred_flag
Definition: h264_ps.h:120
int num_reorder_frames
Definition: h264_ps.h:84
int time_offset_length
Definition: h264_ps.h:91
int weighted_pred
weighted_pred_flag
Definition: h264_ps.h:114
int residual_color_transform_flag
residual_colour_transform_flag
Definition: h264_ps.h:98
int delta_pic_order_always_zero_flag
Definition: h264_ps.h:52
int offset_for_top_to_bottom_field
Definition: h264_ps.h:54
int crop
frame_cropping_flag
Definition: h264_ps.h:63
uint8_t scaling_matrix8[6][64]
Definition: h264_ps.h:124
size_t data_size
Definition: h264_ps.h:101
int ref_frame_count
num_ref_frames
Definition: h264_ps.h:56
int initial_cpb_removal_delay_length
initial_cpb_removal_delay_length_minus1 + 1
Definition: h264_ps.h:93
int poc_cycle_length
num_ref_frames_in_pic_order_cnt_cycle
Definition: h264_ps.h:55
int colour_description_present_flag
Definition: h264_ps.h:74
AVRational sar
Definition: h264_ps.h:71
uint8_t chroma_qp_table[2][QP_MAX_NUM+1]
pre-scaled (with chroma_qp_index_offset) version of qp_table
Definition: h264_ps.h:125
int init_qp
pic_init_qp_minus26 + 26
Definition: h264_ps.h:116
int direct_8x8_inference_flag
Definition: h264_ps.h:62
uint8_t scaling_matrix8[6][64]
Definition: h264_ps.h:87
unsigned int sps_id
Definition: h264_ps.h:44
int pic_order_present
pic_order_present_flag
Definition: h264_ps.h:110
short offset_for_ref_frame[256]
Definition: h264_ps.h:82
int timing_info_present_flag
Definition: h264_ps.h:78
int vcl_hrd_parameters_present_flag
Definition: h264_ps.h:89
Libavcodec external API header.
AVBufferRef * pps_list[MAX_PPS_COUNT]
Definition: h264_ps.h:138
main external API structure.
Definition: avcodec.h:1676
int dpb_output_delay_length
dpb_output_delay_length_minus1 + 1
Definition: h264_ps.h:95
int vui_parameters_present_flag
Definition: h264_ps.h:70
#define QP_MAX_NUM
Definition: h264.h:27
int constraint_set_flags
constraint_set[0-3]_flag
Definition: h264_ps.h:99
Rational number (pair of numerator and denominator).
Definition: rational.h:58
refcounted data buffer API
const SPS * sps
Definition: h264_ps.h:144
unsigned int sps_id
Definition: h264_ps.h:108
int log2_max_poc_lsb
log2_max_pic_order_cnt_lsb_minus4
Definition: h264_ps.h:51
int ff_h264_decode_seq_parameter_set(GetBitContext *gb, AVCodecContext *avctx, H264ParamSets *ps, int ignore_truncation)
Decode SPS.
Definition: h264_ps.c:324
uint32_t time_scale
Definition: h264_ps.h:80
int transform_8x8_mode
transform_8x8_mode_flag
Definition: h264_ps.h:122
int pic_struct_present_flag
Definition: h264_ps.h:90
A reference to a data buffer.
Definition: buffer.h:81
int mb_height
pic_height_in_map_units_minus1 + 1
Definition: h264_ps.h:59
int init_qs
pic_init_qs_minus26 + 26
Definition: h264_ps.h:117
Utilties for rational number calculation.
AVBufferRef * pps_ref
Definition: h264_ps.h:140
int nal_hrd_parameters_present_flag
Definition: h264_ps.h:88
size_t data_size
Definition: h264_ps.h:128
int log2_max_frame_num
log2_max_frame_num_minus4 + 4
Definition: h264_ps.h:49
int bit_depth_luma
bit_depth_luma_minus8 + 8
Definition: h264_ps.h:96
pixel format definitions
int mb_width
pic_width_in_mbs_minus1 + 1
Definition: h264_ps.h:58
int slice_group_count
num_slice_groups_minus1 + 1
Definition: h264_ps.h:111
int cpb_cnt
See H.264 E.1.2.
Definition: h264_ps.h:92
uint32_t dequant4_buffer[6][QP_MAX_NUM+1][16]
Definition: h264_ps.h:130
uint32_t dequant8_buffer[6][QP_MAX_NUM+1][64]
Definition: h264_ps.h:131
int cpb_removal_delay_length
cpb_removal_delay_length_minus1 + 1
Definition: h264_ps.h:94
int ff_h264_decode_picture_parameter_set(GetBitContext *gb, AVCodecContext *avctx, H264ParamSets *ps, int bit_length)
Decode PPS.
Definition: h264_ps.c:713
unsigned int crop_bottom
frame_cropping_rect_bottom_offset
Definition: h264_ps.h:69
int level_idc
Definition: h264_ps.h:46
void ff_h264_ps_uninit(H264ParamSets *ps)
Uninit H264 param sets structure.
Definition: h264_ps.c:307
int mb_slice_group_map_type
Definition: h264_ps.h:112
enum AVColorSpace colorspace
Definition: h264_ps.h:77