FFmpeg
hevc_ps.h
Go to the documentation of this file.
1 /*
2  * HEVC parameter set parsing
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #ifndef AVCODEC_HEVC_PS_H
22 #define AVCODEC_HEVC_PS_H
23 
24 #include <stdint.h>
25 
26 #include "libavutil/buffer.h"
27 #include "libavutil/pixfmt.h"
28 #include "libavutil/rational.h"
29 
30 #include "avcodec.h"
31 #include "get_bits.h"
32 #include "hevc.h"
33 
34 typedef struct ShortTermRPS {
35  unsigned int num_negative_pics;
40 } ShortTermRPS;
41 
42 typedef struct HEVCWindow {
43  unsigned int left_offset;
44  unsigned int right_offset;
45  unsigned int top_offset;
46  unsigned int bottom_offset;
47 } HEVCWindow;
48 
49 typedef struct VUI {
51 
54 
62 
67 
70 
73 
76  uint32_t vui_time_scale;
80 
90 } VUI;
91 
92 typedef struct PTLCommon {
96  uint8_t profile_compatibility_flag[32];
113 } PTLCommon;
114 
115 typedef struct PTL {
118 
119  uint8_t sub_layer_profile_present_flag[HEVC_MAX_SUB_LAYERS];
120  uint8_t sub_layer_level_present_flag[HEVC_MAX_SUB_LAYERS];
121 } PTL;
122 
123 typedef struct HEVCVPS {
126  int vps_max_sub_layers; ///< vps_max_temporal_layers_minus1 + 1
127 
130  unsigned int vps_max_dec_pic_buffering[HEVC_MAX_SUB_LAYERS];
131  unsigned int vps_num_reorder_pics[HEVC_MAX_SUB_LAYERS];
132  unsigned int vps_max_latency_increase[HEVC_MAX_SUB_LAYERS];
134  int vps_num_layer_sets; ///< vps_num_layer_sets_minus1 + 1
137  uint32_t vps_time_scale;
139  int vps_num_ticks_poc_diff_one; ///< vps_num_ticks_poc_diff_one_minus1 + 1
141 
142  uint8_t data[4096];
144 } HEVCVPS;
145 
146 typedef struct ScalingList {
147  /* This is a little wasteful, since sizeID 0 only needs 8 coeffs,
148  * and size ID 3 only has 2 arrays, not 6. */
149  uint8_t sl[4][6][64];
150  uint8_t sl_dc[2][6];
151 } ScalingList;
152 
153 typedef struct HEVCSPS {
154  unsigned vps_id;
157 
159 
161 
166 
167  unsigned int log2_max_poc_lsb;
169 
171  struct {
175  } temporal_layer[HEVC_MAX_SUB_LAYERS];
177 
180 
183 
184  unsigned int nb_st_rps;
186 
189 
191  uint16_t lt_ref_pic_poc_lsb_sps[HEVC_MAX_LONG_TERM_REF_PICS];
192  uint8_t used_by_curr_pic_lt_sps_flag[HEVC_MAX_LONG_TERM_REF_PICS];
194 
195  struct {
198  unsigned int log2_min_pcm_cb_size;
199  unsigned int log2_max_pcm_cb_size;
201  } pcm;
204 
205  unsigned int log2_min_cb_size;
207  unsigned int log2_min_tb_size;
208  unsigned int log2_max_trafo_size;
209  unsigned int log2_ctb_size;
210  unsigned int log2_min_pu_size;
211 
214 
225 
226  ///< coded frame dimension in various units
227  int width;
228  int height;
231  int ctb_size;
238  int tb_mask;
239 
240  int hshift[3];
241  int vshift[3];
242 
244 
245  uint8_t data[4096];
247 } HEVCSPS;
248 
249 typedef struct HEVCPPS {
250  unsigned int sps_id; ///< seq_parameter_set_id
251 
253 
255 
256  int num_ref_idx_l0_default_active; ///< num_ref_idx_l0_default_active_minus1 + 1
257  int num_ref_idx_l1_default_active; ///< num_ref_idx_l1_default_active_minus1 + 1
259 
262 
265 
273 
277 
278  uint16_t num_tile_columns; ///< num_tile_columns_minus1 + 1
279  uint16_t num_tile_rows; ///< num_tile_rows_minus1 + 1
282 
284 
288  int beta_offset; ///< beta_offset_div2 * 2
289  int tc_offset; ///< tc_offset_div2 * 2
290 
293 
295  int log2_parallel_merge_level; ///< log2_parallel_merge_level_minus2 + 2
304  int8_t cb_qp_offset_list[6];
305  int8_t cr_qp_offset_list[6];
308 
309  // Inferred parameters
310  unsigned int *column_width; ///< ColumnWidth
311  unsigned int *row_height; ///< RowHeight
312  unsigned int *col_bd; ///< ColBd
313  unsigned int *row_bd; ///< RowBd
314  int *col_idxX;
315 
316  int *ctb_addr_rs_to_ts; ///< CtbAddrRSToTS
317  int *ctb_addr_ts_to_rs; ///< CtbAddrTSToRS
318  int *tile_id; ///< TileId
319  int *tile_pos_rs; ///< TilePosRS
320  int *min_tb_addr_zs; ///< MinTbAddrZS
321  int *min_tb_addr_zs_tab;///< MinTbAddrZS
322 
323  uint8_t data[4096];
325 } HEVCPPS;
326 
327 typedef struct HEVCParamSets {
331 
332  /* currently active parameter sets */
333  const HEVCVPS *vps;
334  const HEVCSPS *sps;
335  const HEVCPPS *pps;
336 } HEVCParamSets;
337 
338 /**
339  * Parse the SPS from the bitstream into the provided HEVCSPS struct.
340  *
341  * @param sps_id the SPS id will be written here
342  * @param apply_defdispwin if set 1, the default display window from the VUI
343  * will be applied to the video dimensions
344  * @param vps_list if non-NULL, this function will validate that the SPS refers
345  * to an existing VPS
346  */
347 int ff_hevc_parse_sps(HEVCSPS *sps, GetBitContext *gb, unsigned int *sps_id,
348  int apply_defdispwin, AVBufferRef **vps_list, AVCodecContext *avctx);
349 
351  HEVCParamSets *ps);
353  HEVCParamSets *ps, int apply_defdispwin);
355  HEVCParamSets *ps);
356 
358 
360  ShortTermRPS *rps, const HEVCSPS *sps, int is_slice_header);
361 
362 int ff_hevc_encode_nal_vps(HEVCVPS *vps, unsigned int id,
363  uint8_t *buf, int buf_size);
364 
365 /**
366  * Compute POC of the current frame and return it.
367  */
368 int ff_hevc_compute_poc(const HEVCSPS *sps, int pocTid0, int poc_lsb, int nal_unit_type);
369 
370 #endif /* AVCODEC_HEVC_PS_H */
const HEVCPPS * pps
Definition: hevc_ps.h:335
unsigned int log2_min_cb_size
Definition: hevc_ps.h:205
int extended_precision_processing_flag
Definition: hevc_ps.h:220
uint8_t log2_sao_offset_scale_luma
Definition: hevc_ps.h:306
int min_spatial_segmentation_idc
Definition: hevc_ps.h:85
static enum AVPixelFormat pix_fmt
int ctb_height
Definition: hevc_ps.h:230
uint8_t max_12bit_constraint_flag
Definition: hevc_ps.h:101
ptrdiff_t const GLvoid * data
Definition: opengl_enc.c:100
uint8_t diff_cu_chroma_qp_offset_depth
Definition: hevc_ps.h:302
int vui_num_ticks_poc_diff_one_minus1
Definition: hevc_ps.h:78
int max_dec_pic_buffering
Definition: hevc_ps.h:172
int transform_skip_rotation_enabled_flag
Definition: hevc_ps.h:216
unsigned int * row_height
RowHeight.
Definition: hevc_ps.h:311
int vps_num_ticks_poc_diff_one
vps_num_ticks_poc_diff_one_minus1 + 1
Definition: hevc_ps.h:139
uint8_t max_monochrome_constraint_flag
Definition: hevc_ps.h:106
int pic_init_qp_minus26
Definition: hevc_ps.h:258
VUI vui
Definition: hevc_ps.h:178
uint32_t vui_time_scale
Definition: hevc_ps.h:76
int ff_hevc_encode_nal_vps(HEVCVPS *vps, unsigned int id, uint8_t *buf, int buf_size)
Definition: hevc_ps_enc.c:66
uint8_t weighted_bipred_flag
Definition: hevc_ps.h:270
unsigned int left_offset
Definition: hevc_ps.h:43
Definition: hevc_ps.h:115
uint8_t seq_loop_filter_across_slices_enabled_flag
Definition: hevc_ps.h:283
uint8_t cabac_init_present_flag
Definition: hevc_ps.h:254
int chroma_loc_info_present_flag
Definition: hevc_ps.h:63
int max_latency_increase
Definition: hevc_ps.h:174
int min_cb_height
Definition: hevc_ps.h:233
int * ctb_addr_ts_to_rs
CtbAddrTSToRS.
Definition: hevc_ps.h:317
int explicit_rdpcm_enabled_flag
Definition: hevc_ps.h:219
int num_ref_idx_l0_default_active
num_ref_idx_l0_default_active_minus1 + 1
Definition: hevc_ps.h:256
uint8_t bit_depth
Definition: hevc_ps.h:196
uint8_t max_420chroma_constraint_flag
Definition: hevc_ps.h:105
uint8_t one_picture_only_constraint_flag
Definition: hevc_ps.h:108
int chroma_sample_loc_type_top_field
Definition: hevc_ps.h:64
int width
Definition: hevc_ps.h:227
int qp_bd_offset
Definition: hevc_ps.h:243
int pixel_shift
Definition: hevc_ps.h:164
uint8_t entropy_coding_sync_enabled_flag
Definition: hevc_ps.h:276
HEVCWindow output_window
Definition: hevc_ps.h:158
int log2_parallel_merge_level
log2_parallel_merge_level_minus2 + 2
Definition: hevc_ps.h:295
uint8_t log2_sao_offset_scale_chroma
Definition: hevc_ps.h:307
int restricted_ref_pic_lists_flag
Definition: hevc_ps.h:84
int chroma_format_idc
Definition: hevc_ps.h:155
uint8_t disable_dbf
Definition: hevc_ps.h:287
unsigned int log2_max_trafo_size
Definition: hevc_ps.h:208
Definition: hevc_ps.h:49
unsigned int num_negative_pics
Definition: hevc_ps.h:35
uint8_t
HEVCWindow pic_conf_win
Definition: hevc_ps.h:160
uint8_t log2_max_transform_skip_block_size
Definition: hevc_ps.h:298
int overscan_info_present_flag
Definition: hevc_ps.h:52
uint8_t vps_timing_info_present_flag
Definition: hevc_ps.h:135
uint8_t matrix_coeffs
Definition: hevc_ps.h:61
int min_tb_width
Definition: hevc_ps.h:234
const HEVCVPS * vps
Definition: hevc_ps.h:333
int num_ref_idx_l1_default_active
num_ref_idx_l1_default_active_minus1 + 1
Definition: hevc_ps.h:257
unsigned int log2_min_pcm_cb_size
Definition: hevc_ps.h:198
int min_cb_width
Definition: hevc_ps.h:232
int vps_max_sub_layers
vps_max_temporal_layers_minus1 + 1
Definition: hevc_ps.h:126
int frame_field_info_present_flag
Definition: hevc_ps.h:69
uint8_t tier_flag
Definition: hevc_ps.h:94
uint8_t scaling_list_data_present_flag
Definition: hevc_ps.h:291
uint8_t bit_depth_chroma
Definition: hevc_ps.h:197
int high_precision_offsets_enabled_flag
Definition: hevc_ps.h:222
bitstream reader API header.
uint8_t loop_filter_disable_flag
Definition: hevc_ps.h:200
int bitstream_restriction_flag
Definition: hevc_ps.h:81
uint8_t transquant_bypass_enable_flag
Definition: hevc_ps.h:272
uint8_t intra_constraint_flag
Definition: hevc_ps.h:107
int bit_depth_chroma
Definition: hevc_ps.h:163
int vps_max_layer_id
Definition: hevc_ps.h:133
uint8_t frame_only_constraint_flag
Definition: hevc_ps.h:100
unsigned int log2_max_poc_lsb
Definition: hevc_ps.h:167
void ff_hevc_ps_uninit(HEVCParamSets *ps)
Definition: hevc_ps.c:1743
int vps_max_layers
Definition: hevc_ps.h:125
int min_pu_height
Definition: hevc_ps.h:237
int persistent_rice_adaptation_enabled_flag
Definition: hevc_ps.h:223
uint8_t temporal_id_nesting_flag
Definition: hevc_ps.h:176
int data_size
Definition: hevc_ps.h:324
int vui_timing_info_present_flag
Definition: hevc_ps.h:74
uint8_t amp_enabled_flag
Definition: hevc_ps.h:187
unsigned int log2_ctb_size
Definition: hevc_ps.h:209
int vui_poc_proportional_to_timing_flag
Definition: hevc_ps.h:77
uint8_t lower_bit_rate_constraint_flag
Definition: hevc_ps.h:109
uint8_t vps_temporal_id_nesting_flag
Definition: hevc_ps.h:124
uint8_t pps_range_extensions_flag
Definition: hevc_ps.h:299
uint8_t colour_primaries
Definition: hevc_ps.h:59
uint8_t used[32]
Definition: hevc_ps.h:39
int motion_vectors_over_pic_boundaries_flag
Definition: hevc_ps.h:83
uint8_t tiles_enabled_flag
Definition: hevc_ps.h:275
uint32_t vps_num_units_in_tick
Definition: hevc_ps.h:136
int * col_idxX
Definition: hevc_ps.h:314
const HEVCSPS * sps
Definition: hevc_ps.h:334
int vps_num_layer_sets
vps_num_layer_sets_minus1 + 1
Definition: hevc_ps.h:134
uint8_t lists_modification_present_flag
Definition: hevc_ps.h:294
int * min_tb_addr_zs_tab
MinTbAddrZS.
Definition: hevc_ps.h:321
uint8_t profile_idc
Definition: hevc_ps.h:95
int max_transform_hierarchy_depth_inter
Definition: hevc_ps.h:212
uint8_t vps_poc_proportional_to_timing_flag
Definition: hevc_ps.h:138
int ff_hevc_decode_nal_vps(GetBitContext *gb, AVCodecContext *avctx, HEVCParamSets *ps)
Definition: hevc_ps.c:458
unsigned int top_offset
Definition: hevc_ps.h:45
int32_t
int max_bits_per_min_cu_denom
Definition: hevc_ps.h:87
uint8_t cu_qp_delta_enabled_flag
Definition: hevc_ps.h:263
int ctb_width
Definition: hevc_ps.h:229
int32_t delta_poc[32]
Definition: hevc_ps.h:38
uint8_t sign_data_hiding_flag
Definition: hevc_ps.h:252
int height
Definition: hevc_ps.h:228
uint8_t output_flag_present_flag
Definition: hevc_ps.h:271
int log2_max_mv_length_vertical
Definition: hevc_ps.h:89
int data_size
Definition: hevc_ps.h:143
PTLCommon general_ptl
Definition: hevc_ps.h:116
int max_bytes_per_pic_denom
Definition: hevc_ps.h:86
int overscan_appropriate_flag
Definition: hevc_ps.h:53
int implicit_rdpcm_enabled_flag
Definition: hevc_ps.h:218
unsigned vps_id
Definition: hevc_ps.h:154
uint8_t constrained_intra_pred_flag
Definition: hevc_ps.h:260
int tb_mask
Definition: hevc_ps.h:238
PTL ptl
Definition: hevc_ps.h:128
uint8_t pic_slice_level_chroma_qp_offsets_present_flag
Definition: hevc_ps.h:268
uint32_t vps_time_scale
Definition: hevc_ps.h:137
int colour_description_present_flag
Definition: hevc_ps.h:58
int ff_hevc_compute_poc(const HEVCSPS *sps, int pocTid0, int poc_lsb, int nal_unit_type)
Compute POC of the current frame and return it.
Definition: hevc_ps.c:1759
uint8_t transform_skip_enabled_flag
Definition: hevc_ps.h:261
uint16_t num_tile_columns
num_tile_columns_minus1 + 1
Definition: hevc_ps.h:278
Libavcodec external API header.
uint8_t uniform_spacing_flag
Definition: hevc_ps.h:280
int ctb_size
Definition: hevc_ps.h:231
int * ctb_addr_rs_to_ts
CtbAddrRSToTS.
Definition: hevc_ps.h:316
PTL ptl
Definition: hevc_ps.h:179
int max_sub_layers
Definition: hevc_ps.h:170
unsigned int log2_min_pu_size
Definition: hevc_ps.h:210
unsigned int sps_id
seq_parameter_set_id
Definition: hevc_ps.h:250
ScalingList scaling_list
Definition: hevc_ps.h:292
main external API structure.
Definition: avcodec.h:526
int log2_max_mv_length_horizontal
Definition: hevc_ps.h:88
uint8_t sao_enabled
Definition: hevc_ps.h:188
int num_extra_slice_header_bits
Definition: hevc_ps.h:296
uint8_t loop_filter_across_tiles_enabled_flag
Definition: hevc_ps.h:281
uint8_t max_10bit_constraint_flag
Definition: hevc_ps.h:102
uint8_t num_long_term_ref_pics_sps
Definition: hevc_ps.h:193
uint8_t cross_component_prediction_enabled_flag
Definition: hevc_ps.h:300
int ff_hevc_decode_nal_pps(GetBitContext *gb, AVCodecContext *avctx, HEVCParamSets *ps)
Definition: hevc_ps.c:1495
uint32_t vui_num_units_in_tick
Definition: hevc_ps.h:75
int ff_hevc_parse_sps(HEVCSPS *sps, GetBitContext *gb, unsigned int *sps_id, int apply_defdispwin, AVBufferRef **vps_list, AVCodecContext *avctx)
Parse the SPS from the bitstream into the provided HEVCSPS struct.
Definition: hevc_ps.c:904
uint8_t deblocking_filter_control_present_flag
Definition: hevc_ps.h:285
int transform_skip_context_enabled_flag
Definition: hevc_ps.h:217
uint8_t sps_temporal_mvp_enabled_flag
Definition: hevc_ps.h:202
unsigned int nb_st_rps
Definition: hevc_ps.h:184
int chroma_sample_loc_type_bottom_field
Definition: hevc_ps.h:65
uint8_t chroma_qp_offset_list_enabled_flag
Definition: hevc_ps.h:301
Rational number (pair of numerator and denominator).
Definition: rational.h:58
int vps_num_hrd_parameters
Definition: hevc_ps.h:140
int ff_hevc_decode_short_term_rps(GetBitContext *gb, AVCodecContext *avctx, ShortTermRPS *rps, const HEVCSPS *sps, int is_slice_header)
Definition: hevc_ps.c:119
unsigned int log2_min_tb_size
Definition: hevc_ps.h:207
refcounted data buffer API
static int FUNC() sps(CodedBitstreamContext *ctx, RWContext *rw, H264RawSPS *current)
uint8_t scaling_list_enable_flag
Definition: hevc_ps.h:181
int * tile_id
TileId.
Definition: hevc_ps.h:318
int tc_offset
tc_offset_div2 * 2
Definition: hevc_ps.h:289
uint8_t transfer_characteristic
Definition: hevc_ps.h:60
int default_display_window_flag
Definition: hevc_ps.h:71
static int FUNC() vps(CodedBitstreamContext *ctx, RWContext *rw, H265RawVPS *current)
HEVCWindow def_disp_win
Definition: hevc_ps.h:72
int cr_qp_offset
Definition: hevc_ps.h:267
ScalingList scaling_list
Definition: hevc_ps.h:182
unsigned int log2_diff_max_min_coding_block_size
Definition: hevc_ps.h:206
unsigned int log2_max_pcm_cb_size
Definition: hevc_ps.h:199
uint8_t level_idc
Definition: hevc_ps.h:112
int ff_hevc_decode_nal_sps(GetBitContext *gb, AVCodecContext *avctx, HEVCParamSets *ps, int apply_defdispwin)
Definition: hevc_ps.c:1246
int neutra_chroma_indication_flag
Definition: hevc_ps.h:66
int * tile_pos_rs
TilePosRS.
Definition: hevc_ps.h:319
int data_size
Definition: hevc_ps.h:246
A reference to a data buffer.
Definition: buffer.h:81
int max_transform_hierarchy_depth_intra
Definition: hevc_ps.h:213
uint8_t profile_space
Definition: hevc_ps.h:93
unsigned int * row_bd
RowBd.
Definition: hevc_ps.h:313
int video_format
Definition: hevc_ps.h:56
Utilties for rational number calculation.
uint8_t weighted_pred_flag
Definition: hevc_ps.h:269
uint16_t num_tile_rows
num_tile_rows_minus1 + 1
Definition: hevc_ps.h:279
unsigned int * col_bd
ColBd.
Definition: hevc_ps.h:312
unsigned int * column_width
ColumnWidth.
Definition: hevc_ps.h:310
uint8_t slice_header_extension_present_flag
Definition: hevc_ps.h:297
int video_full_range_flag
Definition: hevc_ps.h:57
int cabac_bypass_alignment_enabled_flag
coded frame dimension in various units
Definition: hevc_ps.h:224
AVRational sar
Definition: hevc_ps.h:50
uint8_t chroma_qp_offset_list_len_minus1
Definition: hevc_ps.h:303
int num_delta_pocs
Definition: hevc_ps.h:36
uint8_t sps_strong_intra_smoothing_enable_flag
Definition: hevc_ps.h:203
pixel format definitions
int rps_idx_num_delta_pocs
Definition: hevc_ps.h:37
int min_pu_width
Definition: hevc_ps.h:236
uint8_t max_422chroma_constraint_flag
Definition: hevc_ps.h:104
int sps_range_extension_flag
Definition: hevc_ps.h:215
uint8_t max_8bit_constraint_flag
Definition: hevc_ps.h:103
uint8_t long_term_ref_pics_present_flag
Definition: hevc_ps.h:190
uint8_t max_14bit_constraint_flag
Definition: hevc_ps.h:110
int vui_hrd_parameters_present_flag
Definition: hevc_ps.h:79
unsigned int right_offset
Definition: hevc_ps.h:44
int diff_cu_qp_delta_depth
Definition: hevc_ps.h:264
int num_reorder_pics
Definition: hevc_ps.h:173
uint8_t progressive_source_flag
Definition: hevc_ps.h:97
int cb_qp_offset
Definition: hevc_ps.h:266
int video_signal_type_present_flag
Definition: hevc_ps.h:55
uint8_t deblocking_filter_override_enabled_flag
Definition: hevc_ps.h:286
int bit_depth
Definition: hevc_ps.h:162
int beta_offset
beta_offset_div2 * 2
Definition: hevc_ps.h:288
int min_tb_height
Definition: hevc_ps.h:235
int * min_tb_addr_zs
MinTbAddrZS.
Definition: hevc_ps.h:320
uint8_t inbld_flag
Definition: hevc_ps.h:111
uint8_t non_packed_constraint_flag
Definition: hevc_ps.h:99
int intra_smoothing_disabled_flag
Definition: hevc_ps.h:221
int pcm_enabled_flag
Definition: hevc_ps.h:168
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
int tiles_fixed_structure_flag
Definition: hevc_ps.h:82
uint8_t interlaced_source_flag
Definition: hevc_ps.h:98
int field_seq_flag
Definition: hevc_ps.h:68
uint8_t separate_colour_plane_flag
Definition: hevc_ps.h:156
unsigned int bottom_offset
Definition: hevc_ps.h:46
int vps_sub_layer_ordering_info_present_flag
Definition: hevc_ps.h:129
uint8_t dependent_slice_segments_enabled_flag
Definition: hevc_ps.h:274