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>
32 #include "h264data.h" //FIXME FIXME FIXME (just for zigzag_scan)
39 static const AVRational pixel_aspect[17]={
59 const uint8_t ff_h264_chroma_qp[52]={
60 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,10,11,
61 12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,
62 28,29,29,30,31,32,32,33,34,34,35,35,36,36,37,37,
63 37,38,38,38,39,39,39,39
66 static const uint8_t default_scaling4[2][16]={
78 static const uint8_t default_scaling8[2][64]={
79 { 6,10,13,16,18,23,25,27,
80 10,11,16,18,23,25,27,29,
81 13,16,18,23,25,27,29,31,
82 16,18,23,25,27,29,31,33,
83 18,23,25,27,29,31,33,36,
84 23,25,27,29,31,33,36,38,
85 25,27,29,31,33,36,38,40,
86 27,29,31,33,36,38,40,42
88 9,13,15,17,19,21,22,24,
89 13,13,17,19,21,22,24,25,
90 15,17,19,21,22,24,25,27,
91 17,19,21,22,24,25,27,28,
92 19,21,22,24,25,27,28,30,
93 21,22,24,25,27,28,30,32,
94 22,24,25,27,28,30,32,33,
95 24,25,27,28,30,32,33,35
98 static inline int decode_hrd_parameters(H264Context *h, SPS *sps){
99 MpegEncContext * const s = &h->s;
101 cpb_count = get_ue_golomb_31(&s->gb) + 1;
104 av_log(h->s.avctx, AV_LOG_ERROR, "cpb_count %d invalid\n", cpb_count);
108 get_bits(&s->gb, 4); /* bit_rate_scale */
109 get_bits(&s->gb, 4); /* cpb_size_scale */
110 for(i=0; i<cpb_count; i++){
111 get_ue_golomb(&s->gb); /* bit_rate_value_minus1 */
112 get_ue_golomb(&s->gb); /* cpb_size_value_minus1 */
113 get_bits1(&s->gb); /* cbr_flag */
115 sps->initial_cpb_removal_delay_length = get_bits(&s->gb, 5) + 1;
116 sps->cpb_removal_delay_length = get_bits(&s->gb, 5) + 1;
117 sps->dpb_output_delay_length = get_bits(&s->gb, 5) + 1;
118 sps->time_offset_length = get_bits(&s->gb, 5);
119 sps->cpb_cnt = cpb_count;
123 static inline int decode_vui_parameters(H264Context *h, SPS *sps){
124 MpegEncContext * const s = &h->s;
125 int aspect_ratio_info_present_flag;
126 unsigned int aspect_ratio_idc;
128 aspect_ratio_info_present_flag= get_bits1(&s->gb);
130 if( aspect_ratio_info_present_flag ) {
131 aspect_ratio_idc= get_bits(&s->gb, 8);
132 if( aspect_ratio_idc == EXTENDED_SAR ) {
133 sps->sar.num= get_bits(&s->gb, 16);
134 sps->sar.den= get_bits(&s->gb, 16);
135 }else if(aspect_ratio_idc < FF_ARRAY_ELEMS(pixel_aspect)){
136 sps->sar= pixel_aspect[aspect_ratio_idc];
138 av_log(h->s.avctx, AV_LOG_ERROR, "illegal aspect ratio\n");
145 // s->avctx->aspect_ratio= sar_width*s->width / (float)(s->height*sar_height);
147 if(get_bits1(&s->gb)){ /* overscan_info_present_flag */
148 get_bits1(&s->gb); /* overscan_appropriate_flag */
151 sps->video_signal_type_present_flag = get_bits1(&s->gb);
152 if(sps->video_signal_type_present_flag){
153 get_bits(&s->gb, 3); /* video_format */
154 sps->full_range = get_bits1(&s->gb); /* video_full_range_flag */
156 sps->colour_description_present_flag = get_bits1(&s->gb);
157 if(sps->colour_description_present_flag){
158 sps->color_primaries = get_bits(&s->gb, 8); /* colour_primaries */
159 sps->color_trc = get_bits(&s->gb, 8); /* transfer_characteristics */
160 sps->colorspace = get_bits(&s->gb, 8); /* matrix_coefficients */
161 if (sps->color_primaries >= AVCOL_PRI_NB)
162 sps->color_primaries = AVCOL_PRI_UNSPECIFIED;
163 if (sps->color_trc >= AVCOL_TRC_NB)
164 sps->color_trc = AVCOL_TRC_UNSPECIFIED;
165 if (sps->colorspace >= AVCOL_SPC_NB)
166 sps->colorspace = AVCOL_SPC_UNSPECIFIED;
170 if(get_bits1(&s->gb)){ /* chroma_location_info_present_flag */
171 s->avctx->chroma_sample_location = get_ue_golomb(&s->gb)+1; /* chroma_sample_location_type_top_field */
172 get_ue_golomb(&s->gb); /* chroma_sample_location_type_bottom_field */
175 sps->timing_info_present_flag = get_bits1(&s->gb);
176 if(sps->timing_info_present_flag){
177 sps->num_units_in_tick = get_bits_long(&s->gb, 32);
178 sps->time_scale = get_bits_long(&s->gb, 32);
179 if(!sps->num_units_in_tick || !sps->time_scale){
180 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);
183 sps->fixed_frame_rate_flag = get_bits1(&s->gb);
186 sps->nal_hrd_parameters_present_flag = get_bits1(&s->gb);
187 if(sps->nal_hrd_parameters_present_flag)
188 if(decode_hrd_parameters(h, sps) < 0)
190 sps->vcl_hrd_parameters_present_flag = get_bits1(&s->gb);
191 if(sps->vcl_hrd_parameters_present_flag)
192 if(decode_hrd_parameters(h, sps) < 0)
194 if(sps->nal_hrd_parameters_present_flag || sps->vcl_hrd_parameters_present_flag)
195 get_bits1(&s->gb); /* low_delay_hrd_flag */
196 sps->pic_struct_present_flag = get_bits1(&s->gb);
198 sps->bitstream_restriction_flag = get_bits1(&s->gb);
199 if(sps->bitstream_restriction_flag){
200 get_bits1(&s->gb); /* motion_vectors_over_pic_boundaries_flag */
201 get_ue_golomb(&s->gb); /* max_bytes_per_pic_denom */
202 get_ue_golomb(&s->gb); /* max_bits_per_mb_denom */
203 get_ue_golomb(&s->gb); /* log2_max_mv_length_horizontal */
204 get_ue_golomb(&s->gb); /* log2_max_mv_length_vertical */
205 sps->num_reorder_frames= get_ue_golomb(&s->gb);
206 get_ue_golomb(&s->gb); /*max_dec_frame_buffering*/
208 if(s->gb.size_in_bits < get_bits_count(&s->gb)){
209 av_log(h->s.avctx, AV_LOG_ERROR, "Overread VUI by %d bits\n", get_bits_count(&s->gb) - s->gb.size_in_bits);
210 sps->num_reorder_frames=0;
211 sps->bitstream_restriction_flag= 0;
214 if(sps->num_reorder_frames > 16U /*max_dec_frame_buffering || max_dec_frame_buffering > 16*/){
215 av_log(h->s.avctx, AV_LOG_ERROR, "illegal num_reorder_frames %d\n", sps->num_reorder_frames);
223 static void decode_scaling_list(H264Context *h, uint8_t *factors, int size,
224 const uint8_t *jvt_list, const uint8_t *fallback_list){
225 MpegEncContext * const s = &h->s;
226 int i, last = 8, next = 8;
227 const uint8_t *scan = size == 16 ? zigzag_scan : ff_zigzag_direct;
228 if(!get_bits1(&s->gb)) /* matrix not written, we use the predicted one */
229 memcpy(factors, fallback_list, size*sizeof(uint8_t));
233 next = (last + get_se_golomb(&s->gb)) & 0xff;
234 if(!i && !next){ /* matrix not written, we use the preset one */
235 memcpy(factors, jvt_list, size*sizeof(uint8_t));
238 last = factors[scan[i]] = next ? next : last;
242 static void decode_scaling_matrices(H264Context *h, SPS *sps, PPS *pps, int is_sps,
243 uint8_t (*scaling_matrix4)[16], uint8_t (*scaling_matrix8)[64]){
244 MpegEncContext * const s = &h->s;
245 int fallback_sps = !is_sps && sps->scaling_matrix_present;
246 const uint8_t *fallback[4] = {
247 fallback_sps ? sps->scaling_matrix4[0] : default_scaling4[0],
248 fallback_sps ? sps->scaling_matrix4[3] : default_scaling4[1],
249 fallback_sps ? sps->scaling_matrix8[0] : default_scaling8[0],
250 fallback_sps ? sps->scaling_matrix8[1] : default_scaling8[1]
252 if(get_bits1(&s->gb)){
253 sps->scaling_matrix_present |= is_sps;
254 decode_scaling_list(h,scaling_matrix4[0],16,default_scaling4[0],fallback[0]); // Intra, Y
255 decode_scaling_list(h,scaling_matrix4[1],16,default_scaling4[0],scaling_matrix4[0]); // Intra, Cr
256 decode_scaling_list(h,scaling_matrix4[2],16,default_scaling4[0],scaling_matrix4[1]); // Intra, Cb
257 decode_scaling_list(h,scaling_matrix4[3],16,default_scaling4[1],fallback[1]); // Inter, Y
258 decode_scaling_list(h,scaling_matrix4[4],16,default_scaling4[1],scaling_matrix4[3]); // Inter, Cr
259 decode_scaling_list(h,scaling_matrix4[5],16,default_scaling4[1],scaling_matrix4[4]); // Inter, Cb
260 if(is_sps || pps->transform_8x8_mode){
261 decode_scaling_list(h,scaling_matrix8[0],64,default_scaling8[0],fallback[2]); // Intra, Y
262 decode_scaling_list(h,scaling_matrix8[1],64,default_scaling8[1],fallback[3]); // Inter, Y
267 int ff_h264_decode_seq_parameter_set(H264Context *h){
268 MpegEncContext * const s = &h->s;
269 int profile_idc, level_idc;
274 profile_idc= get_bits(&s->gb, 8);
275 get_bits1(&s->gb); //constraint_set0_flag
276 get_bits1(&s->gb); //constraint_set1_flag
277 get_bits1(&s->gb); //constraint_set2_flag
278 get_bits1(&s->gb); //constraint_set3_flag
279 get_bits(&s->gb, 4); // reserved
280 level_idc= get_bits(&s->gb, 8);
281 sps_id= get_ue_golomb_31(&s->gb);
283 if(sps_id >= MAX_SPS_COUNT) {
284 av_log(h->s.avctx, AV_LOG_ERROR, "sps_id (%d) out of range\n", sps_id);
287 sps= av_mallocz(sizeof(SPS));
291 sps->profile_idc= profile_idc;
292 sps->level_idc= level_idc;
294 memset(sps->scaling_matrix4, 16, sizeof(sps->scaling_matrix4));
295 memset(sps->scaling_matrix8, 16, sizeof(sps->scaling_matrix8));
296 sps->scaling_matrix_present = 0;
298 if(sps->profile_idc >= 100){ //high profile
299 sps->chroma_format_idc= get_ue_golomb_31(&s->gb);
300 if(sps->chroma_format_idc == 3)
301 sps->residual_color_transform_flag = get_bits1(&s->gb);
302 sps->bit_depth_luma = get_ue_golomb(&s->gb) + 8;
303 sps->bit_depth_chroma = get_ue_golomb(&s->gb) + 8;
304 sps->transform_bypass = get_bits1(&s->gb);
305 decode_scaling_matrices(h, sps, NULL, 1, sps->scaling_matrix4, sps->scaling_matrix8);
307 sps->chroma_format_idc= 1;
308 sps->bit_depth_luma = 8;
309 sps->bit_depth_chroma = 8;
312 sps->log2_max_frame_num= get_ue_golomb(&s->gb) + 4;
313 sps->poc_type= get_ue_golomb_31(&s->gb);
315 if(sps->poc_type == 0){ //FIXME #define
316 sps->log2_max_poc_lsb= get_ue_golomb(&s->gb) + 4;
317 } else if(sps->poc_type == 1){//FIXME #define
318 sps->delta_pic_order_always_zero_flag= get_bits1(&s->gb);
319 sps->offset_for_non_ref_pic= get_se_golomb(&s->gb);
320 sps->offset_for_top_to_bottom_field= get_se_golomb(&s->gb);
321 sps->poc_cycle_length = get_ue_golomb(&s->gb);
323 if((unsigned)sps->poc_cycle_length >= FF_ARRAY_ELEMS(sps->offset_for_ref_frame)){
324 av_log(h->s.avctx, AV_LOG_ERROR, "poc_cycle_length overflow %u\n", sps->poc_cycle_length);
328 for(i=0; i<sps->poc_cycle_length; i++)
329 sps->offset_for_ref_frame[i]= get_se_golomb(&s->gb);
330 }else if(sps->poc_type != 2){
331 av_log(h->s.avctx, AV_LOG_ERROR, "illegal POC type %d\n", sps->poc_type);
335 sps->ref_frame_count= get_ue_golomb_31(&s->gb);
336 if(sps->ref_frame_count > MAX_PICTURE_COUNT-2 || sps->ref_frame_count >= 32U){
337 av_log(h->s.avctx, AV_LOG_ERROR, "too many reference frames\n");
340 sps->gaps_in_frame_num_allowed_flag= get_bits1(&s->gb);
341 sps->mb_width = get_ue_golomb(&s->gb) + 1;
342 sps->mb_height= get_ue_golomb(&s->gb) + 1;
343 if((unsigned)sps->mb_width >= INT_MAX/16 || (unsigned)sps->mb_height >= INT_MAX/16 ||
344 avcodec_check_dimensions(NULL, 16*sps->mb_width, 16*sps->mb_height)){
345 av_log(h->s.avctx, AV_LOG_ERROR, "mb_width/height overflow\n");
349 sps->frame_mbs_only_flag= get_bits1(&s->gb);
350 if(!sps->frame_mbs_only_flag)
351 sps->mb_aff= get_bits1(&s->gb);
355 sps->direct_8x8_inference_flag= get_bits1(&s->gb);
356 if(!sps->frame_mbs_only_flag && !sps->direct_8x8_inference_flag){
357 av_log(h->s.avctx, AV_LOG_ERROR, "This stream was generated by a broken encoder, invalid 8x8 inference\n");
361 #ifndef ALLOW_INTERLACE
363 av_log(h->s.avctx, AV_LOG_ERROR, "MBAFF support not included; enable it at compile-time.\n");
365 sps->crop= get_bits1(&s->gb);
367 sps->crop_left = get_ue_golomb(&s->gb);
368 sps->crop_right = get_ue_golomb(&s->gb);
369 sps->crop_top = get_ue_golomb(&s->gb);
370 sps->crop_bottom= get_ue_golomb(&s->gb);
371 if(sps->crop_left || sps->crop_top){
372 av_log(h->s.avctx, AV_LOG_ERROR, "insane cropping not completely supported, this could look slightly wrong ...\n");
374 if(sps->crop_right >= 8 || sps->crop_bottom >= (8>> !sps->frame_mbs_only_flag)){
375 av_log(h->s.avctx, AV_LOG_ERROR, "brainfart cropping not supported, this could look slightly wrong ...\n");
384 sps->vui_parameters_present_flag= get_bits1(&s->gb);
385 if( sps->vui_parameters_present_flag )
386 if (decode_vui_parameters(h, sps) < 0)
389 if(s->avctx->debug&FF_DEBUG_PICT_INFO){
390 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",
391 sps_id, sps->profile_idc, sps->level_idc,
393 sps->ref_frame_count,
394 sps->mb_width, sps->mb_height,
395 sps->frame_mbs_only_flag ? "FRM" : (sps->mb_aff ? "MB-AFF" : "PIC-AFF"),
396 sps->direct_8x8_inference_flag ? "8B8" : "",
397 sps->crop_left, sps->crop_right,
398 sps->crop_top, sps->crop_bottom,
399 sps->vui_parameters_present_flag ? "VUI" : "",
400 ((const char*[]){"Gray","420","422","444"})[sps->chroma_format_idc],
401 sps->timing_info_present_flag ? sps->num_units_in_tick : 0,
402 sps->timing_info_present_flag ? sps->time_scale : 0
406 av_free(h->sps_buffers[sps_id]);
407 h->sps_buffers[sps_id]= sps;
416 build_qp_table(PPS *pps, int t, int index)
419 for(i = 0; i < 52; i++)
420 pps->chroma_qp_table[t][i] = ff_h264_chroma_qp[av_clip(i + index, 0, 51)];
423 int ff_h264_decode_picture_parameter_set(H264Context *h, int bit_length){
424 MpegEncContext * const s = &h->s;
425 unsigned int pps_id= get_ue_golomb(&s->gb);
428 if(pps_id >= MAX_PPS_COUNT) {
429 av_log(h->s.avctx, AV_LOG_ERROR, "pps_id (%d) out of range\n", pps_id);
433 pps= av_mallocz(sizeof(PPS));
436 pps->sps_id= get_ue_golomb_31(&s->gb);
437 if((unsigned)pps->sps_id>=MAX_SPS_COUNT || h->sps_buffers[pps->sps_id] == NULL){
438 av_log(h->s.avctx, AV_LOG_ERROR, "sps_id out of range\n");
442 pps->cabac= get_bits1(&s->gb);
443 pps->pic_order_present= get_bits1(&s->gb);
444 pps->slice_group_count= get_ue_golomb(&s->gb) + 1;
445 if(pps->slice_group_count > 1 ){
446 pps->mb_slice_group_map_type= get_ue_golomb(&s->gb);
447 av_log(h->s.avctx, AV_LOG_ERROR, "FMO not supported\n");
448 switch(pps->mb_slice_group_map_type){
451 | for( i = 0; i <= num_slice_groups_minus1; i++ ) | | |
452 | run_length[ i ] |1 |ue(v) |
457 | for( i = 0; i < num_slice_groups_minus1; i++ ) | | |
459 | top_left_mb[ i ] |1 |ue(v) |
460 | bottom_right_mb[ i ] |1 |ue(v) |
468 | slice_group_change_direction_flag |1 |u(1) |
469 | slice_group_change_rate_minus1 |1 |ue(v) |
474 | slice_group_id_cnt_minus1 |1 |ue(v) |
475 | for( i = 0; i <= slice_group_id_cnt_minus1; i++ | | |
477 | slice_group_id[ i ] |1 |u(v) |
482 pps->ref_count[0]= get_ue_golomb(&s->gb) + 1;
483 pps->ref_count[1]= get_ue_golomb(&s->gb) + 1;
484 if(pps->ref_count[0]-1 > 32-1 || pps->ref_count[1]-1 > 32-1){
485 av_log(h->s.avctx, AV_LOG_ERROR, "reference overflow (pps)\n");
489 pps->weighted_pred= get_bits1(&s->gb);
490 pps->weighted_bipred_idc= get_bits(&s->gb, 2);
491 pps->init_qp= get_se_golomb(&s->gb) + 26;
492 pps->init_qs= get_se_golomb(&s->gb) + 26;
493 pps->chroma_qp_index_offset[0]= get_se_golomb(&s->gb);
494 pps->deblocking_filter_parameters_present= get_bits1(&s->gb);
495 pps->constrained_intra_pred= get_bits1(&s->gb);
496 pps->redundant_pic_cnt_present = get_bits1(&s->gb);
498 pps->transform_8x8_mode= 0;
499 h->dequant_coeff_pps= -1; //contents of sps/pps can change even if id doesn't, so reinit
500 memcpy(pps->scaling_matrix4, h->sps_buffers[pps->sps_id]->scaling_matrix4, sizeof(pps->scaling_matrix4));
501 memcpy(pps->scaling_matrix8, h->sps_buffers[pps->sps_id]->scaling_matrix8, sizeof(pps->scaling_matrix8));
503 if(get_bits_count(&s->gb) < bit_length){
504 pps->transform_8x8_mode= get_bits1(&s->gb);
505 decode_scaling_matrices(h, h->sps_buffers[pps->sps_id], pps, 0, pps->scaling_matrix4, pps->scaling_matrix8);
506 pps->chroma_qp_index_offset[1]= get_se_golomb(&s->gb); //second_chroma_qp_index_offset
508 pps->chroma_qp_index_offset[1]= pps->chroma_qp_index_offset[0];
511 build_qp_table(pps, 0, pps->chroma_qp_index_offset[0]);
512 build_qp_table(pps, 1, pps->chroma_qp_index_offset[1]);
513 if(pps->chroma_qp_index_offset[0] != pps->chroma_qp_index_offset[1])
514 pps->chroma_qp_diff= 1;
516 if(s->avctx->debug&FF_DEBUG_PICT_INFO){
517 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",
519 pps->cabac ? "CABAC" : "CAVLC",
520 pps->slice_group_count,
521 pps->ref_count[0], pps->ref_count[1],
522 pps->weighted_pred ? "weighted" : "",
523 pps->init_qp, pps->init_qs, pps->chroma_qp_index_offset[0], pps->chroma_qp_index_offset[1],
524 pps->deblocking_filter_parameters_present ? "LPAR" : "",
525 pps->constrained_intra_pred ? "CONSTR" : "",
526 pps->redundant_pic_cnt_present ? "REDU" : "",
527 pps->transform_8x8_mode ? "8x8DCT" : ""
531 av_free(h->pps_buffers[pps_id]);
532 h->pps_buffers[pps_id]= pps;