2 * H.26L/H.264/AVC/JVT/14496-10/... parameter set decoding
3 * Copyright (c) 2003 Michael Niedermayer <michaelni@gmx.at>
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * H.264 / AVC / MPEG4 part10 parameter set decoding.
25 * @author Michael Niedermayer <michaelni@gmx.at>
28 #include "libavcore/imgutils.h"
33 #include "h264data.h" //FIXME FIXME FIXME (just for zigzag_scan)
40 static const AVRational pixel_aspect[17]={
60 const uint8_t ff_h264_chroma_qp[52]={
61 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,10,11,
62 12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,
63 28,29,29,30,31,32,32,33,34,34,35,35,36,36,37,37,
64 37,38,38,38,39,39,39,39
67 static const uint8_t default_scaling4[2][16]={
79 static const uint8_t default_scaling8[2][64]={
80 { 6,10,13,16,18,23,25,27,
81 10,11,16,18,23,25,27,29,
82 13,16,18,23,25,27,29,31,
83 16,18,23,25,27,29,31,33,
84 18,23,25,27,29,31,33,36,
85 23,25,27,29,31,33,36,38,
86 25,27,29,31,33,36,38,40,
87 27,29,31,33,36,38,40,42
89 9,13,15,17,19,21,22,24,
90 13,13,17,19,21,22,24,25,
91 15,17,19,21,22,24,25,27,
92 17,19,21,22,24,25,27,28,
93 19,21,22,24,25,27,28,30,
94 21,22,24,25,27,28,30,32,
95 22,24,25,27,28,30,32,33,
96 24,25,27,28,30,32,33,35
99 static inline int decode_hrd_parameters(H264Context *h, SPS *sps){
100 MpegEncContext * const s = &h->s;
102 cpb_count = get_ue_golomb_31(&s->gb) + 1;
105 av_log(h->s.avctx, AV_LOG_ERROR, "cpb_count %d invalid\n", cpb_count);
109 get_bits(&s->gb, 4); /* bit_rate_scale */
110 get_bits(&s->gb, 4); /* cpb_size_scale */
111 for(i=0; i<cpb_count; i++){
112 get_ue_golomb(&s->gb); /* bit_rate_value_minus1 */
113 get_ue_golomb(&s->gb); /* cpb_size_value_minus1 */
114 get_bits1(&s->gb); /* cbr_flag */
116 sps->initial_cpb_removal_delay_length = get_bits(&s->gb, 5) + 1;
117 sps->cpb_removal_delay_length = get_bits(&s->gb, 5) + 1;
118 sps->dpb_output_delay_length = get_bits(&s->gb, 5) + 1;
119 sps->time_offset_length = get_bits(&s->gb, 5);
120 sps->cpb_cnt = cpb_count;
124 static inline int decode_vui_parameters(H264Context *h, SPS *sps){
125 MpegEncContext * const s = &h->s;
126 int aspect_ratio_info_present_flag;
127 unsigned int aspect_ratio_idc;
129 aspect_ratio_info_present_flag= get_bits1(&s->gb);
131 if( aspect_ratio_info_present_flag ) {
132 aspect_ratio_idc= get_bits(&s->gb, 8);
133 if( aspect_ratio_idc == EXTENDED_SAR ) {
134 sps->sar.num= get_bits(&s->gb, 16);
135 sps->sar.den= get_bits(&s->gb, 16);
136 }else if(aspect_ratio_idc < FF_ARRAY_ELEMS(pixel_aspect)){
137 sps->sar= pixel_aspect[aspect_ratio_idc];
139 av_log(h->s.avctx, AV_LOG_ERROR, "illegal aspect ratio\n");
146 // s->avctx->aspect_ratio= sar_width*s->width / (float)(s->height*sar_height);
148 if(get_bits1(&s->gb)){ /* overscan_info_present_flag */
149 get_bits1(&s->gb); /* overscan_appropriate_flag */
152 sps->video_signal_type_present_flag = get_bits1(&s->gb);
153 if(sps->video_signal_type_present_flag){
154 get_bits(&s->gb, 3); /* video_format */
155 sps->full_range = get_bits1(&s->gb); /* video_full_range_flag */
157 sps->colour_description_present_flag = get_bits1(&s->gb);
158 if(sps->colour_description_present_flag){
159 sps->color_primaries = get_bits(&s->gb, 8); /* colour_primaries */
160 sps->color_trc = get_bits(&s->gb, 8); /* transfer_characteristics */
161 sps->colorspace = get_bits(&s->gb, 8); /* matrix_coefficients */
162 if (sps->color_primaries >= AVCOL_PRI_NB)
163 sps->color_primaries = AVCOL_PRI_UNSPECIFIED;
164 if (sps->color_trc >= AVCOL_TRC_NB)
165 sps->color_trc = AVCOL_TRC_UNSPECIFIED;
166 if (sps->colorspace >= AVCOL_SPC_NB)
167 sps->colorspace = AVCOL_SPC_UNSPECIFIED;
171 if(get_bits1(&s->gb)){ /* chroma_location_info_present_flag */
172 s->avctx->chroma_sample_location = get_ue_golomb(&s->gb)+1; /* chroma_sample_location_type_top_field */
173 get_ue_golomb(&s->gb); /* chroma_sample_location_type_bottom_field */
176 sps->timing_info_present_flag = get_bits1(&s->gb);
177 if(sps->timing_info_present_flag){
178 sps->num_units_in_tick = get_bits_long(&s->gb, 32);
179 sps->time_scale = get_bits_long(&s->gb, 32);
180 if(!sps->num_units_in_tick || !sps->time_scale){
181 av_log(h->s.avctx, AV_LOG_ERROR, "time_scale/num_units_in_tick invalid or unsupported (%d/%d)\n", sps->time_scale, sps->num_units_in_tick);
184 sps->fixed_frame_rate_flag = get_bits1(&s->gb);
187 sps->nal_hrd_parameters_present_flag = get_bits1(&s->gb);
188 if(sps->nal_hrd_parameters_present_flag)
189 if(decode_hrd_parameters(h, sps) < 0)
191 sps->vcl_hrd_parameters_present_flag = get_bits1(&s->gb);
192 if(sps->vcl_hrd_parameters_present_flag)
193 if(decode_hrd_parameters(h, sps) < 0)
195 if(sps->nal_hrd_parameters_present_flag || sps->vcl_hrd_parameters_present_flag)
196 get_bits1(&s->gb); /* low_delay_hrd_flag */
197 sps->pic_struct_present_flag = get_bits1(&s->gb);
199 sps->bitstream_restriction_flag = get_bits1(&s->gb);
200 if(sps->bitstream_restriction_flag){
201 get_bits1(&s->gb); /* motion_vectors_over_pic_boundaries_flag */
202 get_ue_golomb(&s->gb); /* max_bytes_per_pic_denom */
203 get_ue_golomb(&s->gb); /* max_bits_per_mb_denom */
204 get_ue_golomb(&s->gb); /* log2_max_mv_length_horizontal */
205 get_ue_golomb(&s->gb); /* log2_max_mv_length_vertical */
206 sps->num_reorder_frames= get_ue_golomb(&s->gb);
207 get_ue_golomb(&s->gb); /*max_dec_frame_buffering*/
209 if(s->gb.size_in_bits < get_bits_count(&s->gb)){
210 av_log(h->s.avctx, AV_LOG_ERROR, "Overread VUI by %d bits\n", get_bits_count(&s->gb) - s->gb.size_in_bits);
211 sps->num_reorder_frames=0;
212 sps->bitstream_restriction_flag= 0;
215 if(sps->num_reorder_frames > 16U /*max_dec_frame_buffering || max_dec_frame_buffering > 16*/){
216 av_log(h->s.avctx, AV_LOG_ERROR, "illegal num_reorder_frames %d\n", sps->num_reorder_frames);
224 static void decode_scaling_list(H264Context *h, uint8_t *factors, int size,
225 const uint8_t *jvt_list, const uint8_t *fallback_list){
226 MpegEncContext * const s = &h->s;
227 int i, last = 8, next = 8;
228 const uint8_t *scan = size == 16 ? zigzag_scan : ff_zigzag_direct;
229 if(!get_bits1(&s->gb)) /* matrix not written, we use the predicted one */
230 memcpy(factors, fallback_list, size*sizeof(uint8_t));
234 next = (last + get_se_golomb(&s->gb)) & 0xff;
235 if(!i && !next){ /* matrix not written, we use the preset one */
236 memcpy(factors, jvt_list, size*sizeof(uint8_t));
239 last = factors[scan[i]] = next ? next : last;
243 static void decode_scaling_matrices(H264Context *h, SPS *sps, PPS *pps, int is_sps,
244 uint8_t (*scaling_matrix4)[16], uint8_t (*scaling_matrix8)[64]){
245 MpegEncContext * const s = &h->s;
246 int fallback_sps = !is_sps && sps->scaling_matrix_present;
247 const uint8_t *fallback[4] = {
248 fallback_sps ? sps->scaling_matrix4[0] : default_scaling4[0],
249 fallback_sps ? sps->scaling_matrix4[3] : default_scaling4[1],
250 fallback_sps ? sps->scaling_matrix8[0] : default_scaling8[0],
251 fallback_sps ? sps->scaling_matrix8[1] : default_scaling8[1]
253 if(get_bits1(&s->gb)){
254 sps->scaling_matrix_present |= is_sps;
255 decode_scaling_list(h,scaling_matrix4[0],16,default_scaling4[0],fallback[0]); // Intra, Y
256 decode_scaling_list(h,scaling_matrix4[1],16,default_scaling4[0],scaling_matrix4[0]); // Intra, Cr
257 decode_scaling_list(h,scaling_matrix4[2],16,default_scaling4[0],scaling_matrix4[1]); // Intra, Cb
258 decode_scaling_list(h,scaling_matrix4[3],16,default_scaling4[1],fallback[1]); // Inter, Y
259 decode_scaling_list(h,scaling_matrix4[4],16,default_scaling4[1],scaling_matrix4[3]); // Inter, Cr
260 decode_scaling_list(h,scaling_matrix4[5],16,default_scaling4[1],scaling_matrix4[4]); // Inter, Cb
261 if(is_sps || pps->transform_8x8_mode){
262 decode_scaling_list(h,scaling_matrix8[0],64,default_scaling8[0],fallback[2]); // Intra, Y
263 decode_scaling_list(h,scaling_matrix8[1],64,default_scaling8[1],fallback[3]); // Inter, Y
268 int ff_h264_decode_seq_parameter_set(H264Context *h){
269 MpegEncContext * const s = &h->s;
270 int profile_idc, level_idc;
275 profile_idc= get_bits(&s->gb, 8);
276 get_bits1(&s->gb); //constraint_set0_flag
277 get_bits1(&s->gb); //constraint_set1_flag
278 get_bits1(&s->gb); //constraint_set2_flag
279 get_bits1(&s->gb); //constraint_set3_flag
280 get_bits(&s->gb, 4); // reserved
281 level_idc= get_bits(&s->gb, 8);
282 sps_id= get_ue_golomb_31(&s->gb);
284 if(sps_id >= MAX_SPS_COUNT) {
285 av_log(h->s.avctx, AV_LOG_ERROR, "sps_id (%d) out of range\n", sps_id);
288 sps= av_mallocz(sizeof(SPS));
292 sps->time_offset_length = 24;
293 sps->profile_idc= profile_idc;
294 sps->level_idc= level_idc;
296 memset(sps->scaling_matrix4, 16, sizeof(sps->scaling_matrix4));
297 memset(sps->scaling_matrix8, 16, sizeof(sps->scaling_matrix8));
298 sps->scaling_matrix_present = 0;
300 if(sps->profile_idc >= 100){ //high profile
301 sps->chroma_format_idc= get_ue_golomb_31(&s->gb);
302 if(sps->chroma_format_idc == 3)
303 sps->residual_color_transform_flag = get_bits1(&s->gb);
304 sps->bit_depth_luma = get_ue_golomb(&s->gb) + 8;
305 sps->bit_depth_chroma = get_ue_golomb(&s->gb) + 8;
306 sps->transform_bypass = get_bits1(&s->gb);
307 decode_scaling_matrices(h, sps, NULL, 1, sps->scaling_matrix4, sps->scaling_matrix8);
309 sps->chroma_format_idc= 1;
310 sps->bit_depth_luma = 8;
311 sps->bit_depth_chroma = 8;
314 sps->log2_max_frame_num= get_ue_golomb(&s->gb) + 4;
315 sps->poc_type= get_ue_golomb_31(&s->gb);
317 if(sps->poc_type == 0){ //FIXME #define
318 sps->log2_max_poc_lsb= get_ue_golomb(&s->gb) + 4;
319 } else if(sps->poc_type == 1){//FIXME #define
320 sps->delta_pic_order_always_zero_flag= get_bits1(&s->gb);
321 sps->offset_for_non_ref_pic= get_se_golomb(&s->gb);
322 sps->offset_for_top_to_bottom_field= get_se_golomb(&s->gb);
323 sps->poc_cycle_length = get_ue_golomb(&s->gb);
325 if((unsigned)sps->poc_cycle_length >= FF_ARRAY_ELEMS(sps->offset_for_ref_frame)){
326 av_log(h->s.avctx, AV_LOG_ERROR, "poc_cycle_length overflow %u\n", sps->poc_cycle_length);
330 for(i=0; i<sps->poc_cycle_length; i++)
331 sps->offset_for_ref_frame[i]= get_se_golomb(&s->gb);
332 }else if(sps->poc_type != 2){
333 av_log(h->s.avctx, AV_LOG_ERROR, "illegal POC type %d\n", sps->poc_type);
337 sps->ref_frame_count= get_ue_golomb_31(&s->gb);
338 if(sps->ref_frame_count > MAX_PICTURE_COUNT-2 || sps->ref_frame_count >= 32U){
339 av_log(h->s.avctx, AV_LOG_ERROR, "too many reference frames\n");
342 sps->gaps_in_frame_num_allowed_flag= get_bits1(&s->gb);
343 sps->mb_width = get_ue_golomb(&s->gb) + 1;
344 sps->mb_height= get_ue_golomb(&s->gb) + 1;
345 if((unsigned)sps->mb_width >= INT_MAX/16 || (unsigned)sps->mb_height >= INT_MAX/16 ||
346 av_image_check_size(16*sps->mb_width, 16*sps->mb_height, 0, h->s.avctx)){
347 av_log(h->s.avctx, AV_LOG_ERROR, "mb_width/height overflow\n");
351 sps->frame_mbs_only_flag= get_bits1(&s->gb);
352 if(!sps->frame_mbs_only_flag)
353 sps->mb_aff= get_bits1(&s->gb);
357 sps->direct_8x8_inference_flag= get_bits1(&s->gb);
358 if(!sps->frame_mbs_only_flag && !sps->direct_8x8_inference_flag){
359 av_log(h->s.avctx, AV_LOG_ERROR, "This stream was generated by a broken encoder, invalid 8x8 inference\n");
363 #ifndef ALLOW_INTERLACE
365 av_log(h->s.avctx, AV_LOG_ERROR, "MBAFF support not included; enable it at compile-time.\n");
367 sps->crop= get_bits1(&s->gb);
369 sps->crop_left = get_ue_golomb(&s->gb);
370 sps->crop_right = get_ue_golomb(&s->gb);
371 sps->crop_top = get_ue_golomb(&s->gb);
372 sps->crop_bottom= get_ue_golomb(&s->gb);
373 if(sps->crop_left || sps->crop_top){
374 av_log(h->s.avctx, AV_LOG_ERROR, "insane cropping not completely supported, this could look slightly wrong ...\n");
376 if(sps->crop_right >= 8 || sps->crop_bottom >= 8){
377 av_log(h->s.avctx, AV_LOG_ERROR, "brainfart cropping not supported, this could look slightly wrong ...\n");
386 sps->vui_parameters_present_flag= get_bits1(&s->gb);
387 if( sps->vui_parameters_present_flag )
388 if (decode_vui_parameters(h, sps) < 0)
394 if(s->avctx->debug&FF_DEBUG_PICT_INFO){
395 av_log(h->s.avctx, AV_LOG_DEBUG, "sps:%u profile:%d/%d poc:%d ref:%d %dx%d %s %s crop:%d/%d/%d/%d %s %s %d/%d\n",
396 sps_id, sps->profile_idc, sps->level_idc,
398 sps->ref_frame_count,
399 sps->mb_width, sps->mb_height,
400 sps->frame_mbs_only_flag ? "FRM" : (sps->mb_aff ? "MB-AFF" : "PIC-AFF"),
401 sps->direct_8x8_inference_flag ? "8B8" : "",
402 sps->crop_left, sps->crop_right,
403 sps->crop_top, sps->crop_bottom,
404 sps->vui_parameters_present_flag ? "VUI" : "",
405 ((const char*[]){"Gray","420","422","444"})[sps->chroma_format_idc],
406 sps->timing_info_present_flag ? sps->num_units_in_tick : 0,
407 sps->timing_info_present_flag ? sps->time_scale : 0
411 av_free(h->sps_buffers[sps_id]);
412 h->sps_buffers[sps_id]= sps;
421 build_qp_table(PPS *pps, int t, int index)
424 for(i = 0; i < 52; i++)
425 pps->chroma_qp_table[t][i] = ff_h264_chroma_qp[av_clip(i + index, 0, 51)];
428 int ff_h264_decode_picture_parameter_set(H264Context *h, int bit_length){
429 MpegEncContext * const s = &h->s;
430 unsigned int pps_id= get_ue_golomb(&s->gb);
433 if(pps_id >= MAX_PPS_COUNT) {
434 av_log(h->s.avctx, AV_LOG_ERROR, "pps_id (%d) out of range\n", pps_id);
438 pps= av_mallocz(sizeof(PPS));
441 pps->sps_id= get_ue_golomb_31(&s->gb);
442 if((unsigned)pps->sps_id>=MAX_SPS_COUNT || h->sps_buffers[pps->sps_id] == NULL){
443 av_log(h->s.avctx, AV_LOG_ERROR, "sps_id out of range\n");
447 pps->cabac= get_bits1(&s->gb);
448 pps->pic_order_present= get_bits1(&s->gb);
449 pps->slice_group_count= get_ue_golomb(&s->gb) + 1;
450 if(pps->slice_group_count > 1 ){
451 pps->mb_slice_group_map_type= get_ue_golomb(&s->gb);
452 av_log(h->s.avctx, AV_LOG_ERROR, "FMO not supported\n");
453 switch(pps->mb_slice_group_map_type){
456 | for( i = 0; i <= num_slice_groups_minus1; i++ ) | | |
457 | run_length[ i ] |1 |ue(v) |
462 | for( i = 0; i < num_slice_groups_minus1; i++ ) | | |
464 | top_left_mb[ i ] |1 |ue(v) |
465 | bottom_right_mb[ i ] |1 |ue(v) |
473 | slice_group_change_direction_flag |1 |u(1) |
474 | slice_group_change_rate_minus1 |1 |ue(v) |
479 | slice_group_id_cnt_minus1 |1 |ue(v) |
480 | for( i = 0; i <= slice_group_id_cnt_minus1; i++ | | |
482 | slice_group_id[ i ] |1 |u(v) |
487 pps->ref_count[0]= get_ue_golomb(&s->gb) + 1;
488 pps->ref_count[1]= get_ue_golomb(&s->gb) + 1;
489 if(pps->ref_count[0]-1 > 32-1 || pps->ref_count[1]-1 > 32-1){
490 av_log(h->s.avctx, AV_LOG_ERROR, "reference overflow (pps)\n");
494 pps->weighted_pred= get_bits1(&s->gb);
495 pps->weighted_bipred_idc= get_bits(&s->gb, 2);
496 pps->init_qp= get_se_golomb(&s->gb) + 26;
497 pps->init_qs= get_se_golomb(&s->gb) + 26;
498 pps->chroma_qp_index_offset[0]= get_se_golomb(&s->gb);
499 pps->deblocking_filter_parameters_present= get_bits1(&s->gb);
500 pps->constrained_intra_pred= get_bits1(&s->gb);
501 pps->redundant_pic_cnt_present = get_bits1(&s->gb);
503 pps->transform_8x8_mode= 0;
504 h->dequant_coeff_pps= -1; //contents of sps/pps can change even if id doesn't, so reinit
505 memcpy(pps->scaling_matrix4, h->sps_buffers[pps->sps_id]->scaling_matrix4, sizeof(pps->scaling_matrix4));
506 memcpy(pps->scaling_matrix8, h->sps_buffers[pps->sps_id]->scaling_matrix8, sizeof(pps->scaling_matrix8));
508 if(get_bits_count(&s->gb) < bit_length){
509 pps->transform_8x8_mode= get_bits1(&s->gb);
510 decode_scaling_matrices(h, h->sps_buffers[pps->sps_id], pps, 0, pps->scaling_matrix4, pps->scaling_matrix8);
511 pps->chroma_qp_index_offset[1]= get_se_golomb(&s->gb); //second_chroma_qp_index_offset
513 pps->chroma_qp_index_offset[1]= pps->chroma_qp_index_offset[0];
516 build_qp_table(pps, 0, pps->chroma_qp_index_offset[0]);
517 build_qp_table(pps, 1, pps->chroma_qp_index_offset[1]);
518 if(pps->chroma_qp_index_offset[0] != pps->chroma_qp_index_offset[1])
519 pps->chroma_qp_diff= 1;
521 if(s->avctx->debug&FF_DEBUG_PICT_INFO){
522 av_log(h->s.avctx, AV_LOG_DEBUG, "pps:%u sps:%u %s slice_groups:%d ref:%d/%d %s qp:%d/%d/%d/%d %s %s %s %s\n",
524 pps->cabac ? "CABAC" : "CAVLC",
525 pps->slice_group_count,
526 pps->ref_count[0], pps->ref_count[1],
527 pps->weighted_pred ? "weighted" : "",
528 pps->init_qp, pps->init_qs, pps->chroma_qp_index_offset[0], pps->chroma_qp_index_offset[1],
529 pps->deblocking_filter_parameters_present ? "LPAR" : "",
530 pps->constrained_intra_pred ? "CONSTR" : "",
531 pps->redundant_pic_cnt_present ? "REDU" : "",
532 pps->transform_8x8_mode ? "8x8DCT" : ""
536 av_free(h->pps_buffers[pps_id]);
537 h->pps_buffers[pps_id]= pps;