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
23 * @file libavcodec/h264_ps.c
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(sps->num_reorder_frames > 16U /*max_dec_frame_buffering || max_dec_frame_buffering > 16*/){
209 av_log(h->s.avctx, AV_LOG_ERROR, "illegal num_reorder_frames %d\n", sps->num_reorder_frames);
217 static void decode_scaling_list(H264Context *h, uint8_t *factors, int size,
218 const uint8_t *jvt_list, const uint8_t *fallback_list){
219 MpegEncContext * const s = &h->s;
220 int i, last = 8, next = 8;
221 const uint8_t *scan = size == 16 ? zigzag_scan : ff_zigzag_direct;
222 if(!get_bits1(&s->gb)) /* matrix not written, we use the predicted one */
223 memcpy(factors, fallback_list, size*sizeof(uint8_t));
227 next = (last + get_se_golomb(&s->gb)) & 0xff;
228 if(!i && !next){ /* matrix not written, we use the preset one */
229 memcpy(factors, jvt_list, size*sizeof(uint8_t));
232 last = factors[scan[i]] = next ? next : last;
236 static void decode_scaling_matrices(H264Context *h, SPS *sps, PPS *pps, int is_sps,
237 uint8_t (*scaling_matrix4)[16], uint8_t (*scaling_matrix8)[64]){
238 MpegEncContext * const s = &h->s;
239 int fallback_sps = !is_sps && sps->scaling_matrix_present;
240 const uint8_t *fallback[4] = {
241 fallback_sps ? sps->scaling_matrix4[0] : default_scaling4[0],
242 fallback_sps ? sps->scaling_matrix4[3] : default_scaling4[1],
243 fallback_sps ? sps->scaling_matrix8[0] : default_scaling8[0],
244 fallback_sps ? sps->scaling_matrix8[1] : default_scaling8[1]
246 if(get_bits1(&s->gb)){
247 sps->scaling_matrix_present |= is_sps;
248 decode_scaling_list(h,scaling_matrix4[0],16,default_scaling4[0],fallback[0]); // Intra, Y
249 decode_scaling_list(h,scaling_matrix4[1],16,default_scaling4[0],scaling_matrix4[0]); // Intra, Cr
250 decode_scaling_list(h,scaling_matrix4[2],16,default_scaling4[0],scaling_matrix4[1]); // Intra, Cb
251 decode_scaling_list(h,scaling_matrix4[3],16,default_scaling4[1],fallback[1]); // Inter, Y
252 decode_scaling_list(h,scaling_matrix4[4],16,default_scaling4[1],scaling_matrix4[3]); // Inter, Cr
253 decode_scaling_list(h,scaling_matrix4[5],16,default_scaling4[1],scaling_matrix4[4]); // Inter, Cb
254 if(is_sps || pps->transform_8x8_mode){
255 decode_scaling_list(h,scaling_matrix8[0],64,default_scaling8[0],fallback[2]); // Intra, Y
256 decode_scaling_list(h,scaling_matrix8[1],64,default_scaling8[1],fallback[3]); // Inter, Y
261 int ff_h264_decode_seq_parameter_set(H264Context *h){
262 MpegEncContext * const s = &h->s;
263 int profile_idc, level_idc;
268 profile_idc= get_bits(&s->gb, 8);
269 get_bits1(&s->gb); //constraint_set0_flag
270 get_bits1(&s->gb); //constraint_set1_flag
271 get_bits1(&s->gb); //constraint_set2_flag
272 get_bits1(&s->gb); //constraint_set3_flag
273 get_bits(&s->gb, 4); // reserved
274 level_idc= get_bits(&s->gb, 8);
275 sps_id= get_ue_golomb_31(&s->gb);
277 if(sps_id >= MAX_SPS_COUNT) {
278 av_log(h->s.avctx, AV_LOG_ERROR, "sps_id (%d) out of range\n", sps_id);
281 sps= av_mallocz(sizeof(SPS));
285 sps->profile_idc= profile_idc;
286 sps->level_idc= level_idc;
288 memset(sps->scaling_matrix4, 16, sizeof(sps->scaling_matrix4));
289 memset(sps->scaling_matrix8, 16, sizeof(sps->scaling_matrix8));
290 sps->scaling_matrix_present = 0;
292 if(sps->profile_idc >= 100){ //high profile
293 sps->chroma_format_idc= get_ue_golomb_31(&s->gb);
294 if(sps->chroma_format_idc == 3)
295 sps->residual_color_transform_flag = get_bits1(&s->gb);
296 sps->bit_depth_luma = get_ue_golomb(&s->gb) + 8;
297 sps->bit_depth_chroma = get_ue_golomb(&s->gb) + 8;
298 sps->transform_bypass = get_bits1(&s->gb);
299 decode_scaling_matrices(h, sps, NULL, 1, sps->scaling_matrix4, sps->scaling_matrix8);
301 sps->chroma_format_idc= 1;
302 sps->bit_depth_luma = 8;
303 sps->bit_depth_chroma = 8;
306 sps->log2_max_frame_num= get_ue_golomb(&s->gb) + 4;
307 sps->poc_type= get_ue_golomb_31(&s->gb);
309 if(sps->poc_type == 0){ //FIXME #define
310 sps->log2_max_poc_lsb= get_ue_golomb(&s->gb) + 4;
311 } else if(sps->poc_type == 1){//FIXME #define
312 sps->delta_pic_order_always_zero_flag= get_bits1(&s->gb);
313 sps->offset_for_non_ref_pic= get_se_golomb(&s->gb);
314 sps->offset_for_top_to_bottom_field= get_se_golomb(&s->gb);
315 sps->poc_cycle_length = get_ue_golomb(&s->gb);
317 if((unsigned)sps->poc_cycle_length >= FF_ARRAY_ELEMS(sps->offset_for_ref_frame)){
318 av_log(h->s.avctx, AV_LOG_ERROR, "poc_cycle_length overflow %u\n", sps->poc_cycle_length);
322 for(i=0; i<sps->poc_cycle_length; i++)
323 sps->offset_for_ref_frame[i]= get_se_golomb(&s->gb);
324 }else if(sps->poc_type != 2){
325 av_log(h->s.avctx, AV_LOG_ERROR, "illegal POC type %d\n", sps->poc_type);
329 sps->ref_frame_count= get_ue_golomb_31(&s->gb);
330 if(sps->ref_frame_count > MAX_PICTURE_COUNT-2 || sps->ref_frame_count >= 32U){
331 av_log(h->s.avctx, AV_LOG_ERROR, "too many reference frames\n");
334 sps->gaps_in_frame_num_allowed_flag= get_bits1(&s->gb);
335 sps->mb_width = get_ue_golomb(&s->gb) + 1;
336 sps->mb_height= get_ue_golomb(&s->gb) + 1;
337 if((unsigned)sps->mb_width >= INT_MAX/16 || (unsigned)sps->mb_height >= INT_MAX/16 ||
338 avcodec_check_dimensions(NULL, 16*sps->mb_width, 16*sps->mb_height)){
339 av_log(h->s.avctx, AV_LOG_ERROR, "mb_width/height overflow\n");
343 sps->frame_mbs_only_flag= get_bits1(&s->gb);
344 if(!sps->frame_mbs_only_flag)
345 sps->mb_aff= get_bits1(&s->gb);
349 sps->direct_8x8_inference_flag= get_bits1(&s->gb);
350 if(!sps->frame_mbs_only_flag && !sps->direct_8x8_inference_flag){
351 av_log(h->s.avctx, AV_LOG_ERROR, "This stream was generated by a broken encoder, invalid 8x8 inference\n");
355 #ifndef ALLOW_INTERLACE
357 av_log(h->s.avctx, AV_LOG_ERROR, "MBAFF support not included; enable it at compile-time.\n");
359 sps->crop= get_bits1(&s->gb);
361 sps->crop_left = get_ue_golomb(&s->gb);
362 sps->crop_right = get_ue_golomb(&s->gb);
363 sps->crop_top = get_ue_golomb(&s->gb);
364 sps->crop_bottom= get_ue_golomb(&s->gb);
365 if(sps->crop_left || sps->crop_top){
366 av_log(h->s.avctx, AV_LOG_ERROR, "insane cropping not completely supported, this could look slightly wrong ...\n");
368 if(sps->crop_right >= 8 || sps->crop_bottom >= (8>> !sps->frame_mbs_only_flag)){
369 av_log(h->s.avctx, AV_LOG_ERROR, "brainfart cropping not supported, this could look slightly wrong ...\n");
378 sps->vui_parameters_present_flag= get_bits1(&s->gb);
379 if( sps->vui_parameters_present_flag )
380 if (decode_vui_parameters(h, sps) < 0)
383 if(s->avctx->debug&FF_DEBUG_PICT_INFO){
384 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",
385 sps_id, sps->profile_idc, sps->level_idc,
387 sps->ref_frame_count,
388 sps->mb_width, sps->mb_height,
389 sps->frame_mbs_only_flag ? "FRM" : (sps->mb_aff ? "MB-AFF" : "PIC-AFF"),
390 sps->direct_8x8_inference_flag ? "8B8" : "",
391 sps->crop_left, sps->crop_right,
392 sps->crop_top, sps->crop_bottom,
393 sps->vui_parameters_present_flag ? "VUI" : "",
394 ((const char*[]){"Gray","420","422","444"})[sps->chroma_format_idc],
395 sps->timing_info_present_flag ? sps->num_units_in_tick : 0,
396 sps->timing_info_present_flag ? sps->time_scale : 0
400 av_free(h->sps_buffers[sps_id]);
401 h->sps_buffers[sps_id]= sps;
410 build_qp_table(PPS *pps, int t, int index)
413 for(i = 0; i < 52; i++)
414 pps->chroma_qp_table[t][i] = ff_h264_chroma_qp[av_clip(i + index, 0, 51)];
417 int ff_h264_decode_picture_parameter_set(H264Context *h, int bit_length){
418 MpegEncContext * const s = &h->s;
419 unsigned int pps_id= get_ue_golomb(&s->gb);
422 if(pps_id >= MAX_PPS_COUNT) {
423 av_log(h->s.avctx, AV_LOG_ERROR, "pps_id (%d) out of range\n", pps_id);
427 pps= av_mallocz(sizeof(PPS));
430 pps->sps_id= get_ue_golomb_31(&s->gb);
431 if((unsigned)pps->sps_id>=MAX_SPS_COUNT || h->sps_buffers[pps->sps_id] == NULL){
432 av_log(h->s.avctx, AV_LOG_ERROR, "sps_id out of range\n");
436 pps->cabac= get_bits1(&s->gb);
437 pps->pic_order_present= get_bits1(&s->gb);
438 pps->slice_group_count= get_ue_golomb(&s->gb) + 1;
439 if(pps->slice_group_count > 1 ){
440 pps->mb_slice_group_map_type= get_ue_golomb(&s->gb);
441 av_log(h->s.avctx, AV_LOG_ERROR, "FMO not supported\n");
442 switch(pps->mb_slice_group_map_type){
445 | for( i = 0; i <= num_slice_groups_minus1; i++ ) | | |
446 | run_length[ i ] |1 |ue(v) |
451 | for( i = 0; i < num_slice_groups_minus1; i++ ) | | |
453 | top_left_mb[ i ] |1 |ue(v) |
454 | bottom_right_mb[ i ] |1 |ue(v) |
462 | slice_group_change_direction_flag |1 |u(1) |
463 | slice_group_change_rate_minus1 |1 |ue(v) |
468 | slice_group_id_cnt_minus1 |1 |ue(v) |
469 | for( i = 0; i <= slice_group_id_cnt_minus1; i++ | | |
471 | slice_group_id[ i ] |1 |u(v) |
476 pps->ref_count[0]= get_ue_golomb(&s->gb) + 1;
477 pps->ref_count[1]= get_ue_golomb(&s->gb) + 1;
478 if(pps->ref_count[0]-1 > 32-1 || pps->ref_count[1]-1 > 32-1){
479 av_log(h->s.avctx, AV_LOG_ERROR, "reference overflow (pps)\n");
483 pps->weighted_pred= get_bits1(&s->gb);
484 pps->weighted_bipred_idc= get_bits(&s->gb, 2);
485 pps->init_qp= get_se_golomb(&s->gb) + 26;
486 pps->init_qs= get_se_golomb(&s->gb) + 26;
487 pps->chroma_qp_index_offset[0]= get_se_golomb(&s->gb);
488 pps->deblocking_filter_parameters_present= get_bits1(&s->gb);
489 pps->constrained_intra_pred= get_bits1(&s->gb);
490 pps->redundant_pic_cnt_present = get_bits1(&s->gb);
492 pps->transform_8x8_mode= 0;
493 h->dequant_coeff_pps= -1; //contents of sps/pps can change even if id doesn't, so reinit
494 memcpy(pps->scaling_matrix4, h->sps_buffers[pps->sps_id]->scaling_matrix4, sizeof(pps->scaling_matrix4));
495 memcpy(pps->scaling_matrix8, h->sps_buffers[pps->sps_id]->scaling_matrix8, sizeof(pps->scaling_matrix8));
497 if(get_bits_count(&s->gb) < bit_length){
498 pps->transform_8x8_mode= get_bits1(&s->gb);
499 decode_scaling_matrices(h, h->sps_buffers[pps->sps_id], pps, 0, pps->scaling_matrix4, pps->scaling_matrix8);
500 pps->chroma_qp_index_offset[1]= get_se_golomb(&s->gb); //second_chroma_qp_index_offset
502 pps->chroma_qp_index_offset[1]= pps->chroma_qp_index_offset[0];
505 build_qp_table(pps, 0, pps->chroma_qp_index_offset[0]);
506 build_qp_table(pps, 1, pps->chroma_qp_index_offset[1]);
507 if(pps->chroma_qp_index_offset[0] != pps->chroma_qp_index_offset[1])
508 pps->chroma_qp_diff= 1;
510 if(s->avctx->debug&FF_DEBUG_PICT_INFO){
511 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",
513 pps->cabac ? "CABAC" : "CAVLC",
514 pps->slice_group_count,
515 pps->ref_count[0], pps->ref_count[1],
516 pps->weighted_pred ? "weighted" : "",
517 pps->init_qp, pps->init_qs, pps->chroma_qp_index_offset[0], pps->chroma_qp_index_offset[1],
518 pps->deblocking_filter_parameters_present ? "LPAR" : "",
519 pps->constrained_intra_pred ? "CONSTR" : "",
520 pps->redundant_pic_cnt_present ? "REDU" : "",
521 pps->transform_8x8_mode ? "8x8DCT" : ""
525 av_free(h->pps_buffers[pps_id]);
526 h->pps_buffers[pps_id]= pps;