2 * H.264 encoding using the x264 library
3 * Copyright (C) 2005 Mans Rullgard <mans@mansr.com>
5 * This file is part of Libav.
7 * Libav 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 * Libav 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 Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "libavutil/internal.h"
23 #include "libavutil/opt.h"
24 #include "libavutil/mem.h"
25 #include "libavutil/pixdesc.h"
26 #include "libavutil/stereo3d.h"
31 #define X264_API_IMPORTS 1
41 typedef struct X264Context {
84 int scenechange_threshold;
90 static void X264_log(void *p, int level, const char *fmt, va_list args)
92 static const int level_map[] = {
93 [X264_LOG_ERROR] = AV_LOG_ERROR,
94 [X264_LOG_WARNING] = AV_LOG_WARNING,
95 [X264_LOG_INFO] = AV_LOG_INFO,
96 [X264_LOG_DEBUG] = AV_LOG_DEBUG
99 if (level < 0 || level > X264_LOG_DEBUG)
102 av_vlog(p, level_map[level], fmt, args);
106 static int encode_nals(AVCodecContext *ctx, AVPacket *pkt,
107 x264_nal_t *nals, int nnal)
109 X264Context *x4 = ctx->priv_data;
111 int i, size = x4->sei_size, ret;
116 for (i = 0; i < nnal; i++)
117 size += nals[i].i_payload;
119 if ((ret = ff_alloc_packet(pkt, size)) < 0)
124 /* Write the SEI as part of the first frame. */
125 if (x4->sei_size > 0 && nnal > 0) {
126 memcpy(p, x4->sei, x4->sei_size);
131 for (i = 0; i < nnal; i++){
132 memcpy(p, nals[i].p_payload, nals[i].i_payload);
133 p += nals[i].i_payload;
139 static void reconfig_encoder(AVCodecContext *ctx, const AVFrame *frame)
141 X264Context *x4 = ctx->priv_data;
142 AVFrameSideData *side_data;
145 if (x4->params.b_tff != frame->top_field_first) {
146 x4->params.b_tff = frame->top_field_first;
147 x264_encoder_reconfig(x4->enc, &x4->params);
149 if (x4->params.vui.i_sar_height != ctx->sample_aspect_ratio.den ||
150 x4->params.vui.i_sar_width != ctx->sample_aspect_ratio.num) {
151 x4->params.vui.i_sar_height = ctx->sample_aspect_ratio.den;
152 x4->params.vui.i_sar_width = ctx->sample_aspect_ratio.num;
153 x264_encoder_reconfig(x4->enc, &x4->params);
156 if (x4->params.rc.i_vbv_buffer_size != ctx->rc_buffer_size / 1000 ||
157 x4->params.rc.i_vbv_max_bitrate != ctx->rc_max_rate / 1000) {
158 x4->params.rc.i_vbv_buffer_size = ctx->rc_buffer_size / 1000;
159 x4->params.rc.i_vbv_max_bitrate = ctx->rc_max_rate / 1000;
160 x264_encoder_reconfig(x4->enc, &x4->params);
163 if (x4->params.rc.i_rc_method == X264_RC_ABR &&
164 x4->params.rc.i_bitrate != ctx->bit_rate / 1000) {
165 x4->params.rc.i_bitrate = ctx->bit_rate / 1000;
166 x264_encoder_reconfig(x4->enc, &x4->params);
170 x4->params.rc.i_rc_method == X264_RC_CRF &&
171 x4->params.rc.f_rf_constant != x4->crf) {
172 x4->params.rc.f_rf_constant = x4->crf;
173 x264_encoder_reconfig(x4->enc, &x4->params);
176 if (x4->params.rc.i_rc_method == X264_RC_CQP &&
177 x4->params.rc.i_qp_constant != x4->cqp) {
178 x4->params.rc.i_qp_constant = x4->cqp;
179 x264_encoder_reconfig(x4->enc, &x4->params);
182 if (x4->crf_max >= 0 &&
183 x4->params.rc.f_rf_constant_max != x4->crf_max) {
184 x4->params.rc.f_rf_constant_max = x4->crf_max;
185 x264_encoder_reconfig(x4->enc, &x4->params);
188 side_data = av_frame_get_side_data(frame, AV_FRAME_DATA_STEREO3D);
190 AVStereo3D *stereo = (AVStereo3D *)side_data->data;
193 switch (stereo->type) {
194 case AV_STEREO3D_CHECKERBOARD:
197 case AV_STEREO3D_COLUMNS:
200 case AV_STEREO3D_LINES:
203 case AV_STEREO3D_SIDEBYSIDE:
206 case AV_STEREO3D_TOPBOTTOM:
209 case AV_STEREO3D_FRAMESEQUENCE:
212 #if X264_BUILD >= 145
222 /* Inverted mode is not supported by x264 */
223 if (stereo->flags & AV_STEREO3D_FLAG_INVERT) {
224 av_log(ctx, AV_LOG_WARNING,
225 "Ignoring unsupported inverted stereo value %d\n", fpa_type);
229 if (fpa_type != x4->params.i_frame_packing) {
230 x4->params.i_frame_packing = fpa_type;
231 x264_encoder_reconfig(x4->enc, &x4->params);
236 static int X264_frame(AVCodecContext *ctx, AVPacket *pkt, const AVFrame *frame,
239 X264Context *x4 = ctx->priv_data;
242 x264_picture_t pic_out;
244 x264_picture_init( &x4->pic );
245 x4->pic.img.i_csp = x4->params.i_csp;
246 if (x264_bit_depth > 8)
247 x4->pic.img.i_csp |= X264_CSP_HIGH_DEPTH;
248 x4->pic.img.i_plane = 3;
251 for (i = 0; i < 3; i++) {
252 x4->pic.img.plane[i] = frame->data[i];
253 x4->pic.img.i_stride[i] = frame->linesize[i];
256 x4->pic.i_pts = frame->pts;
258 switch (frame->pict_type) {
259 case AV_PICTURE_TYPE_I:
260 x4->pic.i_type = x4->forced_idr ? X264_TYPE_IDR
261 : X264_TYPE_KEYFRAME;
263 case AV_PICTURE_TYPE_P:
264 x4->pic.i_type = X264_TYPE_P;
266 case AV_PICTURE_TYPE_B:
267 x4->pic.i_type = X264_TYPE_B;
270 x4->pic.i_type = X264_TYPE_AUTO;
273 reconfig_encoder(ctx, frame);
276 if (x264_encoder_encode(x4->enc, &nal, &nnal, frame? &x4->pic: NULL, &pic_out) < 0)
277 return AVERROR_UNKNOWN;
279 ret = encode_nals(ctx, pkt, nal, nnal);
282 } while (!ret && !frame && x264_encoder_delayed_frames(x4->enc));
284 pkt->pts = pic_out.i_pts;
285 pkt->dts = pic_out.i_dts;
287 #if FF_API_CODED_FRAME
288 FF_DISABLE_DEPRECATION_WARNINGS
289 switch (pic_out.i_type) {
292 ctx->coded_frame->pict_type = AV_PICTURE_TYPE_I;
295 ctx->coded_frame->pict_type = AV_PICTURE_TYPE_P;
299 ctx->coded_frame->pict_type = AV_PICTURE_TYPE_B;
302 FF_ENABLE_DEPRECATION_WARNINGS
305 pkt->flags |= AV_PKT_FLAG_KEY*pic_out.b_keyframe;
307 uint8_t *sd = av_packet_new_side_data(pkt, AV_PKT_DATA_QUALITY_FACTOR,
310 return AVERROR(ENOMEM);
311 *(int *)sd = (pic_out.i_qpplus1 - 1) * FF_QP2LAMBDA;
313 #if FF_API_CODED_FRAME
314 FF_DISABLE_DEPRECATION_WARNINGS
315 ctx->coded_frame->quality = (pic_out.i_qpplus1 - 1) * FF_QP2LAMBDA;
316 FF_ENABLE_DEPRECATION_WARNINGS
324 static av_cold int X264_close(AVCodecContext *avctx)
326 X264Context *x4 = avctx->priv_data;
328 av_freep(&avctx->extradata);
332 x264_encoder_close(x4->enc);
339 static int convert_pix_fmt(enum AVPixelFormat pix_fmt)
342 case AV_PIX_FMT_YUV420P:
343 case AV_PIX_FMT_YUVJ420P:
344 case AV_PIX_FMT_YUV420P9:
345 case AV_PIX_FMT_YUV420P10: return X264_CSP_I420;
346 case AV_PIX_FMT_YUV422P:
347 case AV_PIX_FMT_YUVJ422P:
348 case AV_PIX_FMT_YUV422P10: return X264_CSP_I422;
349 case AV_PIX_FMT_YUV444P:
350 case AV_PIX_FMT_YUVJ444P:
351 case AV_PIX_FMT_YUV444P9:
352 case AV_PIX_FMT_YUV444P10: return X264_CSP_I444;
353 case AV_PIX_FMT_NV12: return X264_CSP_NV12;
354 case AV_PIX_FMT_NV16:
355 case AV_PIX_FMT_NV20: return X264_CSP_NV16;
357 case AV_PIX_FMT_NV21: return X264_CSP_NV21;
363 #define PARSE_X264_OPT(name, var)\
364 if (x4->var && x264_param_parse(&x4->params, name, x4->var) < 0) {\
365 av_log(avctx, AV_LOG_ERROR, "Error parsing option '%s' with value '%s'.\n", name, x4->var);\
366 return AVERROR(EINVAL);\
369 static av_cold int X264_init(AVCodecContext *avctx)
371 X264Context *x4 = avctx->priv_data;
372 AVCPBProperties *cpb_props;
374 #if CONFIG_LIBX262_ENCODER
375 if (avctx->codec_id == AV_CODEC_ID_MPEG2VIDEO) {
376 x4->params.b_mpeg2 = 1;
377 x264_param_default_mpeg2(&x4->params);
380 x264_param_default(&x4->params);
383 x4->params.b_deblocking_filter = avctx->flags & AV_CODEC_FLAG_LOOP_FILTER;
385 if (x4->preset || x4->tune)
386 if (x264_param_default_preset(&x4->params, x4->preset, x4->tune) < 0) {
387 av_log(avctx, AV_LOG_ERROR, "Error setting preset/tune %s/%s.\n", x4->preset, x4->tune);
388 return AVERROR(EINVAL);
391 if (avctx->level > 0)
392 x4->params.i_level_idc = avctx->level;
394 x4->params.pf_log = X264_log;
395 x4->params.p_log_private = avctx;
396 x4->params.i_log_level = X264_LOG_DEBUG;
397 x4->params.i_csp = convert_pix_fmt(avctx->pix_fmt);
399 if (avctx->bit_rate) {
400 x4->params.rc.i_bitrate = avctx->bit_rate / 1000;
401 x4->params.rc.i_rc_method = X264_RC_ABR;
403 x4->params.rc.i_vbv_buffer_size = avctx->rc_buffer_size / 1000;
404 x4->params.rc.i_vbv_max_bitrate = avctx->rc_max_rate / 1000;
405 x4->params.rc.b_stat_write = avctx->flags & AV_CODEC_FLAG_PASS1;
406 if (avctx->flags & AV_CODEC_FLAG_PASS2) {
407 x4->params.rc.b_stat_read = 1;
410 x4->params.rc.i_rc_method = X264_RC_CRF;
411 x4->params.rc.f_rf_constant = x4->crf;
412 } else if (x4->cqp >= 0) {
413 x4->params.rc.i_rc_method = X264_RC_CQP;
414 x4->params.rc.i_qp_constant = x4->cqp;
417 if (x4->crf_max >= 0)
418 x4->params.rc.f_rf_constant_max = x4->crf_max;
421 if (avctx->rc_buffer_size && avctx->rc_initial_buffer_occupancy > 0 &&
422 (avctx->rc_initial_buffer_occupancy <= avctx->rc_buffer_size)) {
423 x4->params.rc.f_vbv_buffer_init =
424 (float)avctx->rc_initial_buffer_occupancy / avctx->rc_buffer_size;
427 if (avctx->i_quant_factor > 0)
428 x4->params.rc.f_ip_factor = 1 / fabs(avctx->i_quant_factor);
429 x4->params.rc.f_pb_factor = avctx->b_quant_factor;
431 #if FF_API_PRIVATE_OPT
432 FF_DISABLE_DEPRECATION_WARNINGS
433 if (avctx->chromaoffset >= 0)
434 x4->chroma_offset = avctx->chromaoffset;
435 FF_ENABLE_DEPRECATION_WARNINGS
437 if (x4->chroma_offset >= 0)
438 x4->params.analyse.i_chroma_qp_offset = x4->chroma_offset;
440 if (avctx->gop_size >= 0)
441 x4->params.i_keyint_max = avctx->gop_size;
442 if (avctx->max_b_frames >= 0)
443 x4->params.i_bframe = avctx->max_b_frames;
445 #if FF_API_PRIVATE_OPT
446 FF_DISABLE_DEPRECATION_WARNINGS
447 if (avctx->scenechange_threshold >= 0)
448 x4->scenechange_threshold = avctx->scenechange_threshold;
449 FF_ENABLE_DEPRECATION_WARNINGS
451 if (x4->scenechange_threshold >= 0)
452 x4->params.i_scenecut_threshold = x4->scenechange_threshold;
454 if (avctx->qmin >= 0)
455 x4->params.rc.i_qp_min = avctx->qmin;
456 if (avctx->qmax >= 0)
457 x4->params.rc.i_qp_max = avctx->qmax;
458 if (avctx->max_qdiff >= 0)
459 x4->params.rc.i_qp_step = avctx->max_qdiff;
460 if (avctx->qblur >= 0)
461 x4->params.rc.f_qblur = avctx->qblur; /* temporally blur quants */
462 if (avctx->qcompress >= 0)
463 x4->params.rc.f_qcompress = avctx->qcompress; /* 0.0 => cbr, 1.0 => constant qp */
464 if (avctx->refs >= 0)
465 x4->params.i_frame_reference = avctx->refs;
466 if (avctx->trellis >= 0)
467 x4->params.analyse.i_trellis = avctx->trellis;
468 if (avctx->me_range >= 0)
469 x4->params.analyse.i_me_range = avctx->me_range;
470 #if FF_API_PRIVATE_OPT
471 FF_DISABLE_DEPRECATION_WARNINGS
472 if (avctx->noise_reduction >= 0)
473 x4->noise_reduction = avctx->noise_reduction;
474 FF_ENABLE_DEPRECATION_WARNINGS
476 if (x4->noise_reduction >= 0)
477 x4->params.analyse.i_noise_reduction = x4->noise_reduction;
478 if (avctx->me_subpel_quality >= 0)
479 x4->params.analyse.i_subpel_refine = avctx->me_subpel_quality;
480 #if FF_API_PRIVATE_OPT
481 FF_DISABLE_DEPRECATION_WARNINGS
482 if (avctx->b_frame_strategy >= 0)
483 x4->b_frame_strategy = avctx->b_frame_strategy;
484 FF_ENABLE_DEPRECATION_WARNINGS
486 if (avctx->keyint_min >= 0)
487 x4->params.i_keyint_min = avctx->keyint_min;
488 #if FF_API_CODER_TYPE
489 FF_DISABLE_DEPRECATION_WARNINGS
490 if (avctx->coder_type >= 0)
491 x4->coder = avctx->coder_type == FF_CODER_TYPE_AC;
492 FF_ENABLE_DEPRECATION_WARNINGS
494 if (avctx->me_cmp >= 0)
495 x4->params.analyse.b_chroma_me = avctx->me_cmp & FF_CMP_CHROMA;
497 if (x4->aq_mode >= 0)
498 x4->params.rc.i_aq_mode = x4->aq_mode;
499 if (x4->aq_strength >= 0)
500 x4->params.rc.f_aq_strength = x4->aq_strength;
501 PARSE_X264_OPT("psy-rd", psy_rd);
502 PARSE_X264_OPT("deblock", deblock);
503 PARSE_X264_OPT("partitions", partitions);
504 PARSE_X264_OPT("stats", stats);
506 x4->params.analyse.b_psy = x4->psy;
507 if (x4->rc_lookahead >= 0)
508 x4->params.rc.i_lookahead = x4->rc_lookahead;
509 if (x4->weightp >= 0)
510 x4->params.analyse.i_weighted_pred = x4->weightp;
511 if (x4->weightb >= 0)
512 x4->params.analyse.b_weighted_bipred = x4->weightb;
513 if (x4->cplxblur >= 0)
514 x4->params.rc.f_complexity_blur = x4->cplxblur;
517 x4->params.analyse.b_ssim = x4->ssim;
518 if (x4->intra_refresh >= 0)
519 x4->params.b_intra_refresh = x4->intra_refresh;
520 if (x4->bluray_compat >= 0) {
521 x4->params.b_bluray_compat = x4->bluray_compat;
522 x4->params.b_vfr_input = 0;
524 if (x4->b_bias != INT_MIN)
525 x4->params.i_bframe_bias = x4->b_bias;
526 if (x4->b_pyramid >= 0)
527 x4->params.i_bframe_pyramid = x4->b_pyramid;
528 if (x4->mixed_refs >= 0)
529 x4->params.analyse.b_mixed_references = x4->mixed_refs;
531 x4->params.analyse.b_transform_8x8 = x4->dct8x8;
532 if (x4->fast_pskip >= 0)
533 x4->params.analyse.b_fast_pskip = x4->fast_pskip;
535 x4->params.b_aud = x4->aud;
537 x4->params.rc.b_mb_tree = x4->mbtree;
538 if (x4->direct_pred >= 0)
539 x4->params.analyse.i_direct_mv_pred = x4->direct_pred;
541 if (x4->slice_max_size >= 0)
542 x4->params.i_slice_max_size = x4->slice_max_size;
544 if (x4->fastfirstpass)
545 x264_param_apply_fastfirstpass(&x4->params);
547 if (x4->nal_hrd >= 0)
548 x4->params.i_nal_hrd = x4->nal_hrd;
550 if (x4->motion_est >= 0) {
551 x4->params.analyse.i_me_method = x4->motion_est;
552 #if FF_API_MOTION_EST
553 FF_DISABLE_DEPRECATION_WARNINGS
555 if (avctx->me_method == ME_EPZS)
556 x4->params.analyse.i_me_method = X264_ME_DIA;
557 else if (avctx->me_method == ME_HEX)
558 x4->params.analyse.i_me_method = X264_ME_HEX;
559 else if (avctx->me_method == ME_UMH)
560 x4->params.analyse.i_me_method = X264_ME_UMH;
561 else if (avctx->me_method == ME_FULL)
562 x4->params.analyse.i_me_method = X264_ME_ESA;
563 else if (avctx->me_method == ME_TESA)
564 x4->params.analyse.i_me_method = X264_ME_TESA;
565 FF_ENABLE_DEPRECATION_WARNINGS
570 x4->params.b_cabac = x4->coder;
572 if (x4->b_frame_strategy >= 0)
573 x4->params.i_bframe_adaptive = x4->b_frame_strategy;
576 if (x264_param_apply_profile(&x4->params, x4->profile) < 0) {
577 av_log(avctx, AV_LOG_ERROR, "Error setting profile %s.\n", x4->profile);
578 return AVERROR(EINVAL);
581 x4->params.i_width = avctx->width;
582 x4->params.i_height = avctx->height;
583 x4->params.vui.i_sar_width = avctx->sample_aspect_ratio.num;
584 x4->params.vui.i_sar_height = avctx->sample_aspect_ratio.den;
585 x4->params.i_fps_num = x4->params.i_timebase_den = avctx->time_base.den;
586 x4->params.i_fps_den = x4->params.i_timebase_num = avctx->time_base.num;
588 x4->params.analyse.b_psnr = avctx->flags & AV_CODEC_FLAG_PSNR;
590 x4->params.i_threads = avctx->thread_count;
591 if (avctx->thread_type)
592 x4->params.b_sliced_threads = avctx->thread_type == FF_THREAD_SLICE;
594 x4->params.b_interlaced = avctx->flags & AV_CODEC_FLAG_INTERLACED_DCT;
596 x4->params.b_open_gop = !(avctx->flags & AV_CODEC_FLAG_CLOSED_GOP);
598 x4->params.i_slice_count = avctx->slices;
600 x4->params.vui.b_fullrange = avctx->pix_fmt == AV_PIX_FMT_YUVJ420P ||
601 avctx->pix_fmt == AV_PIX_FMT_YUVJ422P ||
602 avctx->pix_fmt == AV_PIX_FMT_YUVJ444P ||
603 avctx->color_range == AVCOL_RANGE_JPEG;
605 // x264 validates the values internally
606 x4->params.vui.i_colorprim = avctx->color_primaries;
607 x4->params.vui.i_transfer = avctx->color_trc;
608 x4->params.vui.i_colmatrix = avctx->colorspace;
610 if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER)
611 x4->params.b_repeat_headers = 0;
613 if (x4->x264_params) {
614 AVDictionary *dict = NULL;
615 AVDictionaryEntry *en = NULL;
617 if (!av_dict_parse_string(&dict, x4->x264_params, "=", ":", 0)) {
618 while ((en = av_dict_get(dict, "", en, AV_DICT_IGNORE_SUFFIX))) {
619 if (x264_param_parse(&x4->params, en->key, en->value) < 0)
620 av_log(avctx, AV_LOG_WARNING,
621 "Error parsing option '%s = %s'.\n",
629 // update AVCodecContext with x264 parameters
630 avctx->has_b_frames = x4->params.i_bframe ?
631 x4->params.i_bframe_pyramid ? 2 : 1 : 0;
632 if (avctx->max_b_frames < 0)
633 avctx->max_b_frames = 0;
635 avctx->bit_rate = x4->params.rc.i_bitrate*1000;
637 x4->enc = x264_encoder_open(&x4->params);
639 return AVERROR_UNKNOWN;
641 if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
646 s = x264_encoder_headers(x4->enc, &nal, &nnal);
647 avctx->extradata = p = av_mallocz(s + AV_INPUT_BUFFER_PADDING_SIZE);
649 return AVERROR(ENOMEM);
651 for (i = 0; i < nnal; i++) {
652 /* Don't put the SEI in extradata. */
653 if (nal[i].i_type == NAL_SEI) {
654 av_log(avctx, AV_LOG_INFO, "%s\n", nal[i].p_payload+25);
655 x4->sei_size = nal[i].i_payload;
656 x4->sei = av_malloc(x4->sei_size);
658 return AVERROR(ENOMEM);
659 memcpy(x4->sei, nal[i].p_payload, nal[i].i_payload);
662 memcpy(p, nal[i].p_payload, nal[i].i_payload);
663 p += nal[i].i_payload;
665 avctx->extradata_size = p - avctx->extradata;
668 cpb_props = ff_add_cpb_side_data(avctx);
670 return AVERROR(ENOMEM);
671 cpb_props->buffer_size = x4->params.rc.i_vbv_buffer_size * 1000;
672 cpb_props->max_bitrate = x4->params.rc.i_vbv_max_bitrate * 1000;
673 cpb_props->avg_bitrate = x4->params.rc.i_bitrate * 1000;
678 static const enum AVPixelFormat pix_fmts_8bit[] = {
692 static const enum AVPixelFormat pix_fmts_9bit[] = {
697 static const enum AVPixelFormat pix_fmts_10bit[] = {
698 AV_PIX_FMT_YUV420P10,
699 AV_PIX_FMT_YUV422P10,
700 AV_PIX_FMT_YUV444P10,
705 static av_cold void X264_init_static(AVCodec *codec)
707 if (x264_bit_depth == 8)
708 codec->pix_fmts = pix_fmts_8bit;
709 else if (x264_bit_depth == 9)
710 codec->pix_fmts = pix_fmts_9bit;
711 else if (x264_bit_depth == 10)
712 codec->pix_fmts = pix_fmts_10bit;
715 #define OFFSET(x) offsetof(X264Context, x)
716 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
717 static const AVOption options[] = {
718 { "preset", "Set the encoding preset (cf. x264 --fullhelp)", OFFSET(preset), AV_OPT_TYPE_STRING, { .str = "medium" }, 0, 0, VE},
719 { "tune", "Tune the encoding params (cf. x264 --fullhelp)", OFFSET(tune), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
720 { "profile", "Set profile restrictions (cf. x264 --fullhelp) ", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
721 { "fastfirstpass", "Use fast settings when encoding first pass", OFFSET(fastfirstpass), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, VE},
722 { "crf", "Select the quality for constant quality mode", OFFSET(crf), AV_OPT_TYPE_FLOAT, {.dbl = -1 }, -1, FLT_MAX, VE },
723 { "crf_max", "In CRF mode, prevents VBV from lowering quality beyond this point.",OFFSET(crf_max), AV_OPT_TYPE_FLOAT, {.dbl = -1 }, -1, FLT_MAX, VE },
724 { "qp", "Constant quantization parameter rate control method",OFFSET(cqp), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE },
725 { "aq-mode", "AQ method", OFFSET(aq_mode), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE, "aq_mode"},
726 { "none", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_AQ_NONE}, INT_MIN, INT_MAX, VE, "aq_mode" },
727 { "variance", "Variance AQ (complexity mask)", 0, AV_OPT_TYPE_CONST, {.i64 = X264_AQ_VARIANCE}, INT_MIN, INT_MAX, VE, "aq_mode" },
728 { "autovariance", "Auto-variance AQ (experimental)", 0, AV_OPT_TYPE_CONST, {.i64 = X264_AQ_AUTOVARIANCE}, INT_MIN, INT_MAX, VE, "aq_mode" },
729 { "aq-strength", "AQ strength. Reduces blocking and blurring in flat and textured areas.", OFFSET(aq_strength), AV_OPT_TYPE_FLOAT, {.dbl = -1}, -1, FLT_MAX, VE},
730 { "psy", "Use psychovisual optimizations.", OFFSET(psy), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
731 { "psy-rd", "Strength of psychovisual optimization, in <psy-rd>:<psy-trellis> format.", OFFSET(psy_rd), AV_OPT_TYPE_STRING, {0 }, 0, 0, VE},
732 { "rc-lookahead", "Number of frames to look ahead for frametype and ratecontrol", OFFSET(rc_lookahead), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE },
733 { "weightb", "Weighted prediction for B-frames.", OFFSET(weightb), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
734 { "weightp", "Weighted prediction analysis method.", OFFSET(weightp), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE, "weightp" },
735 { "none", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_WEIGHTP_NONE}, INT_MIN, INT_MAX, VE, "weightp" },
736 { "simple", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_WEIGHTP_SIMPLE}, INT_MIN, INT_MAX, VE, "weightp" },
737 { "smart", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_WEIGHTP_SMART}, INT_MIN, INT_MAX, VE, "weightp" },
738 { "ssim", "Calculate and print SSIM stats.", OFFSET(ssim), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
739 { "intra-refresh", "Use Periodic Intra Refresh instead of IDR frames.",OFFSET(intra_refresh),AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
740 { "bluray-compat", "Bluray compatibility workarounds.", OFFSET(bluray_compat) ,AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
741 { "b-bias", "Influences how often B-frames are used", OFFSET(b_bias), AV_OPT_TYPE_INT, { .i64 = INT_MIN}, INT_MIN, INT_MAX, VE },
742 { "b-pyramid", "Keep some B-frames as references.", OFFSET(b_pyramid), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE, "b_pyramid" },
743 { "none", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_B_PYRAMID_NONE}, INT_MIN, INT_MAX, VE, "b_pyramid" },
744 { "strict", "Strictly hierarchical pyramid", 0, AV_OPT_TYPE_CONST, {.i64 = X264_B_PYRAMID_STRICT}, INT_MIN, INT_MAX, VE, "b_pyramid" },
745 { "normal", "Non-strict (not Blu-ray compatible)", 0, AV_OPT_TYPE_CONST, {.i64 = X264_B_PYRAMID_NORMAL}, INT_MIN, INT_MAX, VE, "b_pyramid" },
746 { "mixed-refs", "One reference per partition, as opposed to one reference per macroblock", OFFSET(mixed_refs), AV_OPT_TYPE_INT, { .i64 = -1}, -1, 1, VE },
747 { "8x8dct", "High profile 8x8 transform.", OFFSET(dct8x8), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE},
748 { "fast-pskip", NULL, OFFSET(fast_pskip), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE},
749 { "aud", "Use access unit delimiters.", OFFSET(aud), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE},
750 { "mbtree", "Use macroblock tree ratecontrol.", OFFSET(mbtree), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE},
751 { "deblock", "Loop filter parameters, in <alpha:beta> form.", OFFSET(deblock), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
752 { "cplxblur", "Reduce fluctuations in QP (before curve compression)", OFFSET(cplxblur), AV_OPT_TYPE_FLOAT, {.dbl = -1 }, -1, FLT_MAX, VE},
753 { "partitions", "A comma-separated list of partitions to consider. "
754 "Possible values: p8x8, p4x4, b8x8, i8x8, i4x4, none, all", OFFSET(partitions), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
755 { "direct-pred", "Direct MV prediction mode", OFFSET(direct_pred), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE, "direct-pred" },
756 { "none", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_DIRECT_PRED_NONE }, 0, 0, VE, "direct-pred" },
757 { "spatial", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_DIRECT_PRED_SPATIAL }, 0, 0, VE, "direct-pred" },
758 { "temporal", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_DIRECT_PRED_TEMPORAL }, 0, 0, VE, "direct-pred" },
759 { "auto", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_DIRECT_PRED_AUTO }, 0, 0, VE, "direct-pred" },
760 { "slice-max-size","Limit the size of each slice in bytes", OFFSET(slice_max_size),AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE },
761 { "stats", "Filename for 2 pass stats", OFFSET(stats), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
762 { "nal-hrd", "Signal HRD information (requires vbv-bufsize; "
763 "cbr not allowed in .mp4)", OFFSET(nal_hrd), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE, "nal-hrd" },
764 { "none", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_NAL_HRD_NONE}, INT_MIN, INT_MAX, VE, "nal-hrd" },
765 { "vbr", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_NAL_HRD_VBR}, INT_MIN, INT_MAX, VE, "nal-hrd" },
766 { "cbr", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = X264_NAL_HRD_CBR}, INT_MIN, INT_MAX, VE, "nal-hrd" },
767 { "motion-est", "Set motion estimation method", OFFSET(motion_est), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, X264_ME_TESA, VE, "motion-est"},
768 { "dia", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_ME_DIA }, INT_MIN, INT_MAX, VE, "motion-est" },
769 { "hex", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_ME_HEX }, INT_MIN, INT_MAX, VE, "motion-est" },
770 { "umh", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_ME_UMH }, INT_MIN, INT_MAX, VE, "motion-est" },
771 { "esa", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_ME_ESA }, INT_MIN, INT_MAX, VE, "motion-est" },
772 { "tesa", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = X264_ME_TESA }, INT_MIN, INT_MAX, VE, "motion-est" },
773 { "forced-idr", "If forwarding iframes, require them to be IDR frames.", OFFSET(forced_idr), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, VE },
774 { "coder", "Coder type", OFFSET(coder), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE, "coder" },
775 { "default", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = -1 }, INT_MIN, INT_MAX, VE, "coder" },
776 { "cavlc", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0 }, INT_MIN, INT_MAX, VE, "coder" },
777 { "cabac", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1 }, INT_MIN, INT_MAX, VE, "coder" },
778 { "b_strategy", "Strategy to choose between I/P/B-frames", OFFSET(b_frame_strategy), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 2, VE },
779 { "chromaoffset", "QP difference between chroma and luma", OFFSET(chroma_offset), AV_OPT_TYPE_INT, { .i64 = -1 }, INT_MIN, INT_MAX, VE },
780 { "sc_threshold", "Scene change threshold", OFFSET(scenechange_threshold), AV_OPT_TYPE_INT, { .i64 = -1 }, INT_MIN, INT_MAX, VE },
781 { "noise_reduction", "Noise reduction", OFFSET(noise_reduction), AV_OPT_TYPE_INT, { .i64 = -1 }, INT_MIN, INT_MAX, VE },
783 { "x264-params", "Override the x264 configuration using a :-separated list of key=value parameters", OFFSET(x264_params), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
787 static const AVCodecDefault x264_defaults[] = {
791 { "i_qfactor", "-1" },
798 #if FF_API_PRIVATE_OPT
799 { "sc_threshold", "-1" },
802 #if FF_API_PRIVATE_OPT
805 { "me_range", "-1" },
806 #if FF_API_MOTION_EST
807 { "me_method", "-1" },
810 #if FF_API_PRIVATE_OPT
811 { "b_strategy", "-1" },
813 { "keyint_min", "-1" },
814 #if FF_API_CODER_TYPE
818 { "threads", AV_STRINGIFY(X264_THREADS_AUTO) },
819 { "thread_type", "0" },
820 { "flags", "+cgop" },
821 { "rc_init_occupancy","-1" },
825 #if CONFIG_LIBX264_ENCODER
826 static const AVClass class = {
827 .class_name = "libx264",
828 .item_name = av_default_item_name,
830 .version = LIBAVUTIL_VERSION_INT,
833 AVCodec ff_libx264_encoder = {
835 .long_name = NULL_IF_CONFIG_SMALL("libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"),
836 .type = AVMEDIA_TYPE_VIDEO,
837 .id = AV_CODEC_ID_H264,
838 .priv_data_size = sizeof(X264Context),
840 .encode2 = X264_frame,
842 .capabilities = AV_CODEC_CAP_DELAY | AV_CODEC_CAP_AUTO_THREADS,
843 .priv_class = &class,
844 .defaults = x264_defaults,
845 .init_static_data = X264_init_static,
846 .caps_internal = FF_CODEC_CAP_INIT_THREADSAFE |
847 FF_CODEC_CAP_INIT_CLEANUP,
851 #if CONFIG_LIBX262_ENCODER
852 static const AVClass X262_class = {
853 .class_name = "libx262",
854 .item_name = av_default_item_name,
856 .version = LIBAVUTIL_VERSION_INT,
859 AVCodec ff_libx262_encoder = {
861 .long_name = NULL_IF_CONFIG_SMALL("libx262 MPEG2VIDEO"),
862 .type = AVMEDIA_TYPE_VIDEO,
863 .id = AV_CODEC_ID_MPEG2VIDEO,
864 .priv_data_size = sizeof(X264Context),
866 .encode2 = X264_frame,
868 .capabilities = AV_CODEC_CAP_DELAY | AV_CODEC_CAP_AUTO_THREADS,
869 .priv_class = &X262_class,
870 .defaults = x264_defaults,
871 .pix_fmts = pix_fmts_8bit,
872 .caps_internal = FF_CODEC_CAP_INIT_THREADSAFE |
873 FF_CODEC_CAP_INIT_CLEANUP,