1 /*****************************************************************************
2 * set: h264 encoder (SPS and PPS init and write)
3 *****************************************************************************
4 * Copyright (C) 2003-2008 x264 project
6 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
7 * Loren Merritt <lorenm@u.washington.edu>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111, USA.
22 *****************************************************************************/
26 #include "common/common.h"
32 #define bs_write_ue bs_write_ue_big
34 static void transpose( uint8_t *buf, int w )
37 for( i = 0; i < w; i++ )
38 for( j = 0; j < i; j++ )
39 XCHG( uint8_t, buf[w*i+j], buf[w*j+i] );
42 static void scaling_list_write( bs_t *s, x264_pps_t *pps, int idx )
44 const int len = idx<4 ? 16 : 64;
45 const uint8_t *zigzag = idx<4 ? x264_zigzag_scan4[0] : x264_zigzag_scan8[0];
46 const uint8_t *list = pps->scaling_list[idx];
47 const uint8_t *def_list = (idx==CQM_4IC) ? pps->scaling_list[CQM_4IY]
48 : (idx==CQM_4PC) ? pps->scaling_list[CQM_4PY]
50 if( !memcmp( list, def_list, len ) )
51 bs_write( s, 1, 0 ); // scaling_list_present_flag
52 else if( !memcmp( list, x264_cqm_jvt[idx], len ) )
54 bs_write( s, 1, 1 ); // scaling_list_present_flag
55 bs_write_se( s, -8 ); // use jvt list
60 bs_write( s, 1, 1 ); // scaling_list_present_flag
62 // try run-length compression of trailing values
63 for( run = len; run > 1; run-- )
64 if( list[zigzag[run-1]] != list[zigzag[run-2]] )
66 if( run < len && len - run < bs_size_se( (int8_t)-list[zigzag[run]] ) )
69 for( j = 0; j < run; j++ )
70 bs_write_se( s, (int8_t)(list[zigzag[j]] - (j>0 ? list[zigzag[j-1]] : 8)) ); // delta
73 bs_write_se( s, (int8_t)-list[zigzag[run]] );
77 void x264_sps_init( x264_sps_t *sps, int i_id, x264_param_t *param )
81 sps->b_qpprime_y_zero_transform_bypass = param->rc.i_rc_method == X264_RC_CQP && param->rc.i_qp_constant == 0;
82 if( sps->b_qpprime_y_zero_transform_bypass )
83 sps->i_profile_idc = PROFILE_HIGH444_PREDICTIVE;
84 else if( param->analyse.b_transform_8x8 || param->i_cqm_preset != X264_CQM_FLAT )
85 sps->i_profile_idc = PROFILE_HIGH;
86 else if( param->b_cabac || param->i_bframe > 0 || param->b_interlaced )
87 sps->i_profile_idc = PROFILE_MAIN;
89 sps->i_profile_idc = PROFILE_BASELINE;
90 sps->i_level_idc = param->i_level_idc;
92 sps->b_constraint_set0 = sps->i_profile_idc == PROFILE_BASELINE;
93 /* x264 doesn't support the features that are in Baseline and not in Main,
94 * namely arbitrary_slice_order and slice_groups. */
95 sps->b_constraint_set1 = sps->i_profile_idc <= PROFILE_MAIN;
96 /* Never set constraint_set2, it is not necessary and not used in real world. */
97 sps->b_constraint_set2 = 0;
99 sps->i_log2_max_frame_num = 4; /* at least 4 */
100 while( (1 << sps->i_log2_max_frame_num) <= param->i_keyint_max )
102 sps->i_log2_max_frame_num++;
104 sps->i_log2_max_frame_num++; /* just in case */
107 if( sps->i_poc_type == 0 )
109 sps->i_log2_max_poc_lsb = sps->i_log2_max_frame_num + 1; /* max poc = 2*frame_num */
111 else if( sps->i_poc_type == 1 )
116 sps->b_delta_pic_order_always_zero = 1;
117 sps->i_offset_for_non_ref_pic = 0;
118 sps->i_offset_for_top_to_bottom_field = 0;
119 sps->i_num_ref_frames_in_poc_cycle = 0;
121 for( i = 0; i < sps->i_num_ref_frames_in_poc_cycle; i++ )
123 sps->i_offset_for_ref_frame[i] = 0;
129 sps->b_gaps_in_frame_num_value_allowed = 0;
130 sps->i_mb_width = ( param->i_width + 15 ) / 16;
131 sps->i_mb_height= ( param->i_height + 15 ) / 16;
132 if( param->b_interlaced )
133 sps->i_mb_height = ( sps->i_mb_height + 1 ) & ~1;
134 sps->b_frame_mbs_only = ! param->b_interlaced;
135 sps->b_mb_adaptive_frame_field = param->b_interlaced;
136 sps->b_direct8x8_inference = 1;
138 sps->crop.i_left = 0;
140 sps->crop.i_right = sps->i_mb_width*16 - param->i_width;
141 sps->crop.i_bottom = (sps->i_mb_height*16 - param->i_height) >> param->b_interlaced;
142 sps->b_crop = sps->crop.i_left || sps->crop.i_top ||
143 sps->crop.i_right || sps->crop.i_bottom;
145 sps->vui.b_aspect_ratio_info_present = 0;
146 if( param->vui.i_sar_width > 0 && param->vui.i_sar_height > 0 )
148 sps->vui.b_aspect_ratio_info_present = 1;
149 sps->vui.i_sar_width = param->vui.i_sar_width;
150 sps->vui.i_sar_height= param->vui.i_sar_height;
153 sps->vui.b_overscan_info_present = ( param->vui.i_overscan ? 1 : 0 );
154 if( sps->vui.b_overscan_info_present )
155 sps->vui.b_overscan_info = ( param->vui.i_overscan == 2 ? 1 : 0 );
157 sps->vui.b_signal_type_present = 0;
158 sps->vui.i_vidformat = ( param->vui.i_vidformat <= 5 ? param->vui.i_vidformat : 5 );
159 sps->vui.b_fullrange = ( param->vui.b_fullrange ? 1 : 0 );
160 sps->vui.b_color_description_present = 0;
162 sps->vui.i_colorprim = ( param->vui.i_colorprim <= 9 ? param->vui.i_colorprim : 2 );
163 sps->vui.i_transfer = ( param->vui.i_transfer <= 11 ? param->vui.i_transfer : 2 );
164 sps->vui.i_colmatrix = ( param->vui.i_colmatrix <= 9 ? param->vui.i_colmatrix : 2 );
165 if( sps->vui.i_colorprim != 2 ||
166 sps->vui.i_transfer != 2 ||
167 sps->vui.i_colmatrix != 2 )
169 sps->vui.b_color_description_present = 1;
172 if( sps->vui.i_vidformat != 5 ||
173 sps->vui.b_fullrange ||
174 sps->vui.b_color_description_present )
176 sps->vui.b_signal_type_present = 1;
179 /* FIXME: not sufficient for interlaced video */
180 sps->vui.b_chroma_loc_info_present = ( param->vui.i_chroma_loc ? 1 : 0 );
181 if( sps->vui.b_chroma_loc_info_present )
183 sps->vui.i_chroma_loc_top = param->vui.i_chroma_loc;
184 sps->vui.i_chroma_loc_bottom = param->vui.i_chroma_loc;
187 sps->vui.b_timing_info_present = 0;
188 if( param->i_fps_num > 0 && param->i_fps_den > 0)
190 sps->vui.b_timing_info_present = 1;
191 sps->vui.i_num_units_in_tick = param->i_fps_den;
192 sps->vui.i_time_scale = param->i_fps_num * 2;
193 sps->vui.b_fixed_frame_rate = 1;
196 sps->vui.i_num_reorder_frames = param->b_bframe_pyramid ? 2 : param->i_bframe ? 1 : 0;
197 /* extra slot with pyramid so that we don't have to override the
198 * order of forgetting old pictures */
199 sps->vui.i_max_dec_frame_buffering =
200 sps->i_num_ref_frames = X264_MIN(16, X264_MAX(param->i_frame_reference, 1 + sps->vui.i_num_reorder_frames));
202 sps->vui.b_bitstream_restriction = 1;
203 if( sps->vui.b_bitstream_restriction )
205 sps->vui.b_motion_vectors_over_pic_boundaries = 1;
206 sps->vui.i_max_bytes_per_pic_denom = 0;
207 sps->vui.i_max_bits_per_mb_denom = 0;
208 sps->vui.i_log2_max_mv_length_horizontal =
209 sps->vui.i_log2_max_mv_length_vertical = (int)(log(param->analyse.i_mv_range*4-1)/log(2)) + 1;
214 void x264_sps_write( bs_t *s, x264_sps_t *sps )
216 bs_write( s, 8, sps->i_profile_idc );
217 bs_write( s, 1, sps->b_constraint_set0 );
218 bs_write( s, 1, sps->b_constraint_set1 );
219 bs_write( s, 1, sps->b_constraint_set2 );
221 bs_write( s, 5, 0 ); /* reserved */
223 bs_write( s, 8, sps->i_level_idc );
225 bs_write_ue( s, sps->i_id );
227 if( sps->i_profile_idc >= PROFILE_HIGH )
229 bs_write_ue( s, 1 ); // chroma_format_idc = 4:2:0
230 bs_write_ue( s, 0 ); // bit_depth_luma_minus8
231 bs_write_ue( s, 0 ); // bit_depth_chroma_minus8
232 bs_write( s, 1, sps->b_qpprime_y_zero_transform_bypass );
233 bs_write( s, 1, 0 ); // seq_scaling_matrix_present_flag
236 bs_write_ue( s, sps->i_log2_max_frame_num - 4 );
237 bs_write_ue( s, sps->i_poc_type );
238 if( sps->i_poc_type == 0 )
240 bs_write_ue( s, sps->i_log2_max_poc_lsb - 4 );
242 else if( sps->i_poc_type == 1 )
246 bs_write( s, 1, sps->b_delta_pic_order_always_zero );
247 bs_write_se( s, sps->i_offset_for_non_ref_pic );
248 bs_write_se( s, sps->i_offset_for_top_to_bottom_field );
249 bs_write_ue( s, sps->i_num_ref_frames_in_poc_cycle );
251 for( i = 0; i < sps->i_num_ref_frames_in_poc_cycle; i++ )
253 bs_write_se( s, sps->i_offset_for_ref_frame[i] );
256 bs_write_ue( s, sps->i_num_ref_frames );
257 bs_write( s, 1, sps->b_gaps_in_frame_num_value_allowed );
258 bs_write_ue( s, sps->i_mb_width - 1 );
259 if (sps->b_frame_mbs_only)
261 bs_write_ue( s, sps->i_mb_height - 1);
265 bs_write_ue( s, sps->i_mb_height/2 - 1);
267 bs_write( s, 1, sps->b_frame_mbs_only );
268 if( !sps->b_frame_mbs_only )
270 bs_write( s, 1, sps->b_mb_adaptive_frame_field );
272 bs_write( s, 1, sps->b_direct8x8_inference );
274 bs_write( s, 1, sps->b_crop );
277 bs_write_ue( s, sps->crop.i_left / 2 );
278 bs_write_ue( s, sps->crop.i_right / 2 );
279 bs_write_ue( s, sps->crop.i_top / 2 );
280 bs_write_ue( s, sps->crop.i_bottom / 2 );
283 bs_write( s, 1, sps->b_vui );
286 bs_write1( s, sps->vui.b_aspect_ratio_info_present );
287 if( sps->vui.b_aspect_ratio_info_present )
290 static const struct { int w, h; int sar; } sar[] =
292 { 1, 1, 1 }, { 12, 11, 2 }, { 10, 11, 3 }, { 16, 11, 4 },
293 { 40, 33, 5 }, { 24, 11, 6 }, { 20, 11, 7 }, { 32, 11, 8 },
294 { 80, 33, 9 }, { 18, 11, 10}, { 15, 11, 11}, { 64, 33, 12},
295 { 160,99, 13}, { 0, 0, -1 }
297 for( i = 0; sar[i].sar != -1; i++ )
299 if( sar[i].w == sps->vui.i_sar_width &&
300 sar[i].h == sps->vui.i_sar_height )
303 if( sar[i].sar != -1 )
305 bs_write( s, 8, sar[i].sar );
309 bs_write( s, 8, 255); /* aspect_ratio_idc (extended) */
310 bs_write( s, 16, sps->vui.i_sar_width );
311 bs_write( s, 16, sps->vui.i_sar_height );
315 bs_write1( s, sps->vui.b_overscan_info_present );
316 if( sps->vui.b_overscan_info_present )
317 bs_write1( s, sps->vui.b_overscan_info );
319 bs_write1( s, sps->vui.b_signal_type_present );
320 if( sps->vui.b_signal_type_present )
322 bs_write( s, 3, sps->vui.i_vidformat );
323 bs_write1( s, sps->vui.b_fullrange );
324 bs_write1( s, sps->vui.b_color_description_present );
325 if( sps->vui.b_color_description_present )
327 bs_write( s, 8, sps->vui.i_colorprim );
328 bs_write( s, 8, sps->vui.i_transfer );
329 bs_write( s, 8, sps->vui.i_colmatrix );
333 bs_write1( s, sps->vui.b_chroma_loc_info_present );
334 if( sps->vui.b_chroma_loc_info_present )
336 bs_write_ue( s, sps->vui.i_chroma_loc_top );
337 bs_write_ue( s, sps->vui.i_chroma_loc_bottom );
340 bs_write1( s, sps->vui.b_timing_info_present );
341 if( sps->vui.b_timing_info_present )
343 bs_write32( s, sps->vui.i_num_units_in_tick );
344 bs_write32( s, sps->vui.i_time_scale );
345 bs_write1( s, sps->vui.b_fixed_frame_rate );
348 bs_write1( s, 0 ); /* nal_hrd_parameters_present_flag */
349 bs_write1( s, 0 ); /* vcl_hrd_parameters_present_flag */
350 bs_write1( s, 0 ); /* pic_struct_present_flag */
351 bs_write1( s, sps->vui.b_bitstream_restriction );
352 if( sps->vui.b_bitstream_restriction )
354 bs_write1( s, sps->vui.b_motion_vectors_over_pic_boundaries );
355 bs_write_ue( s, sps->vui.i_max_bytes_per_pic_denom );
356 bs_write_ue( s, sps->vui.i_max_bits_per_mb_denom );
357 bs_write_ue( s, sps->vui.i_log2_max_mv_length_horizontal );
358 bs_write_ue( s, sps->vui.i_log2_max_mv_length_vertical );
359 bs_write_ue( s, sps->vui.i_num_reorder_frames );
360 bs_write_ue( s, sps->vui.i_max_dec_frame_buffering );
364 bs_rbsp_trailing( s );
367 void x264_pps_init( x264_pps_t *pps, int i_id, x264_param_t *param, x264_sps_t *sps )
372 pps->i_sps_id = sps->i_id;
373 pps->b_cabac = param->b_cabac;
375 pps->b_pic_order = 0;
376 pps->i_num_slice_groups = 1;
378 pps->i_num_ref_idx_l0_active = 1;
379 pps->i_num_ref_idx_l1_active = 1;
381 pps->b_weighted_pred = 0;
382 pps->b_weighted_bipred = param->analyse.b_weighted_bipred ? 2 : 0;
384 pps->i_pic_init_qp = param->rc.i_rc_method == X264_RC_ABR ? 26 : param->rc.i_qp_constant;
385 pps->i_pic_init_qs = 26;
387 pps->i_chroma_qp_index_offset = param->analyse.i_chroma_qp_offset;
388 pps->b_deblocking_filter_control = 1;
389 pps->b_constrained_intra_pred = 0;
390 pps->b_redundant_pic_cnt = 0;
392 pps->b_transform_8x8_mode = param->analyse.b_transform_8x8 ? 1 : 0;
394 pps->i_cqm_preset = param->i_cqm_preset;
395 switch( pps->i_cqm_preset )
398 for( i = 0; i < 6; i++ )
399 pps->scaling_list[i] = x264_cqm_flat16;
402 for( i = 0; i < 6; i++ )
403 pps->scaling_list[i] = x264_cqm_jvt[i];
405 case X264_CQM_CUSTOM:
406 /* match the transposed DCT & zigzag */
407 transpose( param->cqm_4iy, 4 );
408 transpose( param->cqm_4ic, 4 );
409 transpose( param->cqm_4py, 4 );
410 transpose( param->cqm_4pc, 4 );
411 transpose( param->cqm_8iy, 8 );
412 transpose( param->cqm_8py, 8 );
413 pps->scaling_list[CQM_4IY] = param->cqm_4iy;
414 pps->scaling_list[CQM_4IC] = param->cqm_4ic;
415 pps->scaling_list[CQM_4PY] = param->cqm_4py;
416 pps->scaling_list[CQM_4PC] = param->cqm_4pc;
417 pps->scaling_list[CQM_8IY+4] = param->cqm_8iy;
418 pps->scaling_list[CQM_8PY+4] = param->cqm_8py;
419 for( i = 0; i < 6; i++ )
420 for( j = 0; j < (i<4?16:64); j++ )
421 if( pps->scaling_list[i][j] == 0 )
422 pps->scaling_list[i] = x264_cqm_jvt[i];
427 void x264_pps_write( bs_t *s, x264_pps_t *pps )
429 bs_write_ue( s, pps->i_id );
430 bs_write_ue( s, pps->i_sps_id );
432 bs_write( s, 1, pps->b_cabac );
433 bs_write( s, 1, pps->b_pic_order );
434 bs_write_ue( s, pps->i_num_slice_groups - 1 );
436 bs_write_ue( s, pps->i_num_ref_idx_l0_active - 1 );
437 bs_write_ue( s, pps->i_num_ref_idx_l1_active - 1 );
438 bs_write( s, 1, pps->b_weighted_pred );
439 bs_write( s, 2, pps->b_weighted_bipred );
441 bs_write_se( s, pps->i_pic_init_qp - 26 );
442 bs_write_se( s, pps->i_pic_init_qs - 26 );
443 bs_write_se( s, pps->i_chroma_qp_index_offset );
445 bs_write( s, 1, pps->b_deblocking_filter_control );
446 bs_write( s, 1, pps->b_constrained_intra_pred );
447 bs_write( s, 1, pps->b_redundant_pic_cnt );
449 if( pps->b_transform_8x8_mode || pps->i_cqm_preset != X264_CQM_FLAT )
451 bs_write( s, 1, pps->b_transform_8x8_mode );
452 bs_write( s, 1, (pps->i_cqm_preset != X264_CQM_FLAT) );
453 if( pps->i_cqm_preset != X264_CQM_FLAT )
455 scaling_list_write( s, pps, CQM_4IY );
456 scaling_list_write( s, pps, CQM_4IC );
457 bs_write( s, 1, 0 ); // Cr = Cb
458 scaling_list_write( s, pps, CQM_4PY );
459 scaling_list_write( s, pps, CQM_4PC );
460 bs_write( s, 1, 0 ); // Cr = Cb
461 if( pps->b_transform_8x8_mode )
463 scaling_list_write( s, pps, CQM_8IY+4 );
464 scaling_list_write( s, pps, CQM_8PY+4 );
467 bs_write_se( s, pps->i_chroma_qp_index_offset );
470 bs_rbsp_trailing( s );
473 void x264_sei_version_write( x264_t *h, bs_t *s )
476 // random ID number generated according to ISO-11578
477 const uint8_t uuid[16] = {
478 0xdc, 0x45, 0xe9, 0xbd, 0xe6, 0xd9, 0x48, 0xb7,
479 0x96, 0x2c, 0xd8, 0x20, 0xd9, 0x23, 0xee, 0xef
481 char *opts = x264_param2string( &h->param, 0 );
482 char *version = x264_malloc( 200 + strlen(opts) );
485 sprintf( version, "x264 - core %d%s - H.264/MPEG-4 AVC codec - "
486 "Copyleft 2003-2009 - http://www.videolan.org/x264.html - options: %s",
487 X264_BUILD, X264_VERSION, opts );
488 length = strlen(version)+1+16;
490 bs_write( s, 8, 0x5 ); // payload_type = user_data_unregistered
492 for( i = 0; i <= length-255; i += 255 )
493 bs_write( s, 8, 255 );
494 bs_write( s, 8, length-i );
496 for( i = 0; i < 16; i++ )
497 bs_write( s, 8, uuid[i] );
498 for( i = 0; i < length-16; i++ )
499 bs_write( s, 8, version[i] );
501 bs_rbsp_trailing( s );
504 x264_free( version );
507 const x264_level_t x264_levels[] =
509 { 10, 1485, 99, 152064, 64, 175, 64, 64, 0, 0, 0, 1 },
510 // {"1b", 1485, 99, 152064, 128, 350, 64, 64, 0, 0, 0, 1 },
511 { 11, 3000, 396, 345600, 192, 500, 128, 64, 0, 0, 0, 1 },
512 { 12, 6000, 396, 912384, 384, 1000, 128, 64, 0, 0, 0, 1 },
513 { 13, 11880, 396, 912384, 768, 2000, 128, 64, 0, 0, 0, 1 },
514 { 20, 11880, 396, 912384, 2000, 2000, 128, 64, 0, 0, 0, 1 },
515 { 21, 19800, 792, 1824768, 4000, 4000, 256, 64, 0, 0, 0, 0 },
516 { 22, 20250, 1620, 3110400, 4000, 4000, 256, 64, 0, 0, 0, 0 },
517 { 30, 40500, 1620, 3110400, 10000, 10000, 256, 32, 22, 0, 1, 0 },
518 { 31, 108000, 3600, 6912000, 14000, 14000, 512, 16, 60, 1, 1, 0 },
519 { 32, 216000, 5120, 7864320, 20000, 20000, 512, 16, 60, 1, 1, 0 },
520 { 40, 245760, 8192, 12582912, 20000, 25000, 512, 16, 60, 1, 1, 0 },
521 { 41, 245760, 8192, 12582912, 50000, 62500, 512, 16, 24, 1, 1, 0 },
522 { 42, 522240, 8704, 13369344, 50000, 62500, 512, 16, 24, 1, 1, 1 },
523 { 50, 589824, 22080, 42393600, 135000, 135000, 512, 16, 24, 1, 1, 1 },
524 { 51, 983040, 36864, 70778880, 240000, 240000, 512, 16, 24, 1, 1, 1 },
531 x264_log( h, X264_LOG_WARNING, __VA_ARGS__ );\
535 int x264_validate_levels( x264_t *h, int verbose )
538 int mbs = h->sps->i_mb_width * h->sps->i_mb_height;
539 int dpb = mbs * 384 * h->sps->i_num_ref_frames;
540 int cbp_factor = h->sps->i_profile_idc==PROFILE_HIGH ? 5 : 4;
542 const x264_level_t *l = x264_levels;
543 while( l->level_idc != 0 && l->level_idc != h->param.i_level_idc )
546 if( l->frame_size < mbs
547 || l->frame_size*8 < h->sps->i_mb_width * h->sps->i_mb_width
548 || l->frame_size*8 < h->sps->i_mb_height * h->sps->i_mb_height )
549 ERROR( "frame MB size (%dx%d) > level limit (%d)\n",
550 h->sps->i_mb_width, h->sps->i_mb_height, l->frame_size );
552 ERROR( "DPB size (%d frames, %d bytes) > level limit (%d frames, %d bytes)\n",
553 h->sps->i_num_ref_frames, dpb, (int)(l->dpb / (384*mbs)), l->dpb );
555 #define CHECK( name, limit, val ) \
556 if( (val) > (limit) ) \
557 ERROR( name " (%d) > level limit (%d)\n", (int)(val), (limit) );
559 CHECK( "VBV bitrate", (l->bitrate * cbp_factor) / 4, h->param.rc.i_vbv_max_bitrate );
560 CHECK( "VBV buffer", (l->cpb * cbp_factor) / 4, h->param.rc.i_vbv_buffer_size );
561 CHECK( "MV range", l->mv_range, h->param.analyse.i_mv_range );
562 CHECK( "interlaced", !l->frame_only, h->param.b_interlaced );
564 if( h->param.i_fps_den > 0 )
565 CHECK( "MB rate", l->mbps, (int64_t)mbs * h->param.i_fps_num / h->param.i_fps_den );
567 /* TODO check the rest of the limits */