libx264.c
Go to the documentation of this file.
1 /*
2  * H.264 encoding using the x264 library
3  * Copyright (C) 2005 Mans Rullgard <mans@mansr.com>
4  *
5  * This file is part of Libav.
6  *
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.
11  *
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.
16  *
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
20  */
21 
22 #include "libavutil/opt.h"
23 #include "libavutil/pixdesc.h"
24 #include "avcodec.h"
25 #include "internal.h"
26 #include <x264.h>
27 #include <float.h>
28 #include <math.h>
29 #include <stdio.h>
30 #include <stdlib.h>
31 #include <string.h>
32 
33 typedef struct X264Context {
34  AVClass *class;
35  x264_param_t params;
36  x264_t *enc;
37  x264_picture_t pic;
38  uint8_t *sei;
39  int sei_size;
41  char *preset;
42  char *tune;
43  char *profile;
45  float crf;
46  float crf_max;
47  int cqp;
48  int aq_mode;
49  float aq_strength;
50  char *psy_rd;
51  int psy;
53  int weightp;
54  int weightb;
55  int ssim;
57  int b_bias;
58  int b_pyramid;
60  int dct8x8;
62  int aud;
63  int mbtree;
64  char *deblock;
65  float cplxblur;
66  char *partitions;
69  char *stats;
70 } X264Context;
71 
72 static void X264_log(void *p, int level, const char *fmt, va_list args)
73 {
74  static const int level_map[] = {
75  [X264_LOG_ERROR] = AV_LOG_ERROR,
76  [X264_LOG_WARNING] = AV_LOG_WARNING,
77  [X264_LOG_INFO] = AV_LOG_INFO,
78  [X264_LOG_DEBUG] = AV_LOG_DEBUG
79  };
80 
81  if (level < 0 || level > X264_LOG_DEBUG)
82  return;
83 
84  av_vlog(p, level_map[level], fmt, args);
85 }
86 
87 
88 static int encode_nals(AVCodecContext *ctx, uint8_t *buf, int size,
89  x264_nal_t *nals, int nnal, int skip_sei)
90 {
91  X264Context *x4 = ctx->priv_data;
92  uint8_t *p = buf;
93  int i;
94 
95  /* Write the SEI as part of the first frame. */
96  if (x4->sei_size > 0 && nnal > 0) {
97  memcpy(p, x4->sei, x4->sei_size);
98  p += x4->sei_size;
99  x4->sei_size = 0;
100  }
101 
102  for (i = 0; i < nnal; i++){
103  /* Don't put the SEI in extradata. */
104  if (skip_sei && nals[i].i_type == NAL_SEI) {
105  x4->sei_size = nals[i].i_payload;
106  x4->sei = av_malloc(x4->sei_size);
107  memcpy(x4->sei, nals[i].p_payload, nals[i].i_payload);
108  continue;
109  }
110  memcpy(p, nals[i].p_payload, nals[i].i_payload);
111  p += nals[i].i_payload;
112  }
113 
114  return p - buf;
115 }
116 
117 static int X264_frame(AVCodecContext *ctx, uint8_t *buf,
118  int bufsize, void *data)
119 {
120  X264Context *x4 = ctx->priv_data;
121  AVFrame *frame = data;
122  x264_nal_t *nal;
123  int nnal, i;
124  x264_picture_t pic_out;
125 
126  x264_picture_init( &x4->pic );
127  x4->pic.img.i_csp = x4->params.i_csp;
128  if (x264_bit_depth > 8)
129  x4->pic.img.i_csp |= X264_CSP_HIGH_DEPTH;
130  x4->pic.img.i_plane = 3;
131 
132  if (frame) {
133  for (i = 0; i < 3; i++) {
134  x4->pic.img.plane[i] = frame->data[i];
135  x4->pic.img.i_stride[i] = frame->linesize[i];
136  }
137 
138  x4->pic.i_pts = frame->pts;
139  x4->pic.i_type =
140  frame->pict_type == AV_PICTURE_TYPE_I ? X264_TYPE_KEYFRAME :
141  frame->pict_type == AV_PICTURE_TYPE_P ? X264_TYPE_P :
142  frame->pict_type == AV_PICTURE_TYPE_B ? X264_TYPE_B :
143  X264_TYPE_AUTO;
144  if (x4->params.b_tff != frame->top_field_first) {
145  x4->params.b_tff = frame->top_field_first;
146  x264_encoder_reconfig(x4->enc, &x4->params);
147  }
148  }
149 
150  do {
151  if (x264_encoder_encode(x4->enc, &nal, &nnal, frame? &x4->pic: NULL, &pic_out) < 0)
152  return -1;
153 
154  bufsize = encode_nals(ctx, buf, bufsize, nal, nnal, 0);
155  if (bufsize < 0)
156  return -1;
157  } while (!bufsize && !frame && x264_encoder_delayed_frames(x4->enc));
158 
159  /* FIXME: libx264 now provides DTS, but AVFrame doesn't have a field for it. */
160  x4->out_pic.pts = pic_out.i_pts;
161 
162  switch (pic_out.i_type) {
163  case X264_TYPE_IDR:
164  case X264_TYPE_I:
166  break;
167  case X264_TYPE_P:
169  break;
170  case X264_TYPE_B:
171  case X264_TYPE_BREF:
173  break;
174  }
175 
176  x4->out_pic.key_frame = pic_out.b_keyframe;
177  if (bufsize)
178  x4->out_pic.quality = (pic_out.i_qpplus1 - 1) * FF_QP2LAMBDA;
179 
180  return bufsize;
181 }
182 
184 {
185  X264Context *x4 = avctx->priv_data;
186 
187  av_freep(&avctx->extradata);
188  av_free(x4->sei);
189 
190  if (x4->enc)
191  x264_encoder_close(x4->enc);
192 
193  return 0;
194 }
195 
197 {
198  switch (pix_fmt) {
199  case PIX_FMT_YUV420P:
200  case PIX_FMT_YUVJ420P:
201  case PIX_FMT_YUV420P9:
202  case PIX_FMT_YUV420P10: return X264_CSP_I420;
203  case PIX_FMT_YUV422P:
204  case PIX_FMT_YUV422P10: return X264_CSP_I422;
205  case PIX_FMT_YUV444P:
206  case PIX_FMT_YUV444P9:
207  case PIX_FMT_YUV444P10: return X264_CSP_I444;
208  };
209  return 0;
210 }
211 
212 #define PARSE_X264_OPT(name, var)\
213  if (x4->var && x264_param_parse(&x4->params, name, x4->var) < 0) {\
214  av_log(avctx, AV_LOG_ERROR, "Error parsing option '%s' with value '%s'.\n", name, x4->var);\
215  return AVERROR(EINVAL);\
216  }
217 
218 static av_cold int X264_init(AVCodecContext *avctx)
219 {
220  X264Context *x4 = avctx->priv_data;
221 
222  x264_param_default(&x4->params);
223 
224  x4->params.b_deblocking_filter = avctx->flags & CODEC_FLAG_LOOP_FILTER;
225 
226  if (x4->preset || x4->tune)
227  if (x264_param_default_preset(&x4->params, x4->preset, x4->tune) < 0) {
228  av_log(avctx, AV_LOG_ERROR, "Error setting preset/tune %s/%s.\n", x4->preset, x4->tune);
229  return AVERROR(EINVAL);
230  }
231 
232  if (avctx->level > 0)
233  x4->params.i_level_idc = avctx->level;
234 
235  x4->params.pf_log = X264_log;
236  x4->params.p_log_private = avctx;
237  x4->params.i_log_level = X264_LOG_DEBUG;
238  x4->params.i_csp = convert_pix_fmt(avctx->pix_fmt);
239 
240  if (avctx->bit_rate) {
241  x4->params.rc.i_bitrate = avctx->bit_rate / 1000;
242  x4->params.rc.i_rc_method = X264_RC_ABR;
243  }
244  x4->params.rc.i_vbv_buffer_size = avctx->rc_buffer_size / 1000;
245  x4->params.rc.i_vbv_max_bitrate = avctx->rc_max_rate / 1000;
246  x4->params.rc.b_stat_write = avctx->flags & CODEC_FLAG_PASS1;
247  if (avctx->flags & CODEC_FLAG_PASS2) {
248  x4->params.rc.b_stat_read = 1;
249  } else {
250 #if FF_API_X264_GLOBAL_OPTS
251  if (avctx->crf) {
252  x4->params.rc.i_rc_method = X264_RC_CRF;
253  x4->params.rc.f_rf_constant = avctx->crf;
254  x4->params.rc.f_rf_constant_max = avctx->crf_max;
255  } else if (avctx->cqp > -1) {
256  x4->params.rc.i_rc_method = X264_RC_CQP;
257  x4->params.rc.i_qp_constant = avctx->cqp;
258  }
259 #endif
260 
261  if (x4->crf >= 0) {
262  x4->params.rc.i_rc_method = X264_RC_CRF;
263  x4->params.rc.f_rf_constant = x4->crf;
264  } else if (x4->cqp >= 0) {
265  x4->params.rc.i_rc_method = X264_RC_CQP;
266  x4->params.rc.i_qp_constant = x4->cqp;
267  }
268 
269  if (x4->crf_max >= 0)
270  x4->params.rc.f_rf_constant_max = x4->crf_max;
271  }
272 
273  if (avctx->rc_buffer_size && avctx->rc_initial_buffer_occupancy &&
274  (avctx->rc_initial_buffer_occupancy <= avctx->rc_buffer_size)) {
275  x4->params.rc.f_vbv_buffer_init =
276  (float)avctx->rc_initial_buffer_occupancy / avctx->rc_buffer_size;
277  }
278 
279  x4->params.rc.f_ip_factor = 1 / fabs(avctx->i_quant_factor);
280  x4->params.rc.f_pb_factor = avctx->b_quant_factor;
281  x4->params.analyse.i_chroma_qp_offset = avctx->chromaoffset;
282 
283 #if FF_API_X264_GLOBAL_OPTS
284  if (avctx->aq_mode >= 0)
285  x4->params.rc.i_aq_mode = avctx->aq_mode;
286  if (avctx->aq_strength >= 0)
287  x4->params.rc.f_aq_strength = avctx->aq_strength;
288  if (avctx->psy_rd >= 0)
289  x4->params.analyse.f_psy_rd = avctx->psy_rd;
290  if (avctx->psy_trellis >= 0)
291  x4->params.analyse.f_psy_trellis = avctx->psy_trellis;
292  if (avctx->rc_lookahead >= 0)
293  x4->params.rc.i_lookahead = avctx->rc_lookahead;
294  if (avctx->weighted_p_pred >= 0)
295  x4->params.analyse.i_weighted_pred = avctx->weighted_p_pred;
296  if (avctx->bframebias)
297  x4->params.i_bframe_bias = avctx->bframebias;
298  if (avctx->deblockalpha)
299  x4->params.i_deblocking_filter_alphac0 = avctx->deblockalpha;
300  if (avctx->deblockbeta)
301  x4->params.i_deblocking_filter_beta = avctx->deblockbeta;
302  if (avctx->complexityblur >= 0)
303  x4->params.rc.f_complexity_blur = avctx->complexityblur;
304  if (avctx->directpred >= 0)
305  x4->params.analyse.i_direct_mv_pred = avctx->directpred;
306  if (avctx->partitions) {
307  if (avctx->partitions & X264_PART_I4X4)
308  x4->params.analyse.inter |= X264_ANALYSE_I4x4;
309  if (avctx->partitions & X264_PART_I8X8)
310  x4->params.analyse.inter |= X264_ANALYSE_I8x8;
311  if (avctx->partitions & X264_PART_P8X8)
312  x4->params.analyse.inter |= X264_ANALYSE_PSUB16x16;
313  if (avctx->partitions & X264_PART_P4X4)
314  x4->params.analyse.inter |= X264_ANALYSE_PSUB8x8;
315  if (avctx->partitions & X264_PART_B8X8)
316  x4->params.analyse.inter |= X264_ANALYSE_BSUB16x16;
317  }
318  x4->params.analyse.b_ssim = avctx->flags2 & CODEC_FLAG2_SSIM;
319  x4->params.b_intra_refresh = avctx->flags2 & CODEC_FLAG2_INTRA_REFRESH;
320  x4->params.i_bframe_pyramid = avctx->flags2 & CODEC_FLAG2_BPYRAMID ? X264_B_PYRAMID_NORMAL : X264_B_PYRAMID_NONE;
321  x4->params.analyse.b_weighted_bipred = avctx->flags2 & CODEC_FLAG2_WPRED;
322  x4->params.analyse.b_mixed_references = avctx->flags2 & CODEC_FLAG2_MIXED_REFS;
323  x4->params.analyse.b_transform_8x8 = avctx->flags2 & CODEC_FLAG2_8X8DCT;
324  x4->params.analyse.b_fast_pskip = avctx->flags2 & CODEC_FLAG2_FASTPSKIP;
325  x4->params.b_aud = avctx->flags2 & CODEC_FLAG2_AUD;
326  x4->params.analyse.b_psy = avctx->flags2 & CODEC_FLAG2_PSY;
327  x4->params.rc.b_mb_tree = !!(avctx->flags2 & CODEC_FLAG2_MBTREE);
328 #endif
329 
330  if (avctx->me_method == ME_EPZS)
331  x4->params.analyse.i_me_method = X264_ME_DIA;
332  else if (avctx->me_method == ME_HEX)
333  x4->params.analyse.i_me_method = X264_ME_HEX;
334  else if (avctx->me_method == ME_UMH)
335  x4->params.analyse.i_me_method = X264_ME_UMH;
336  else if (avctx->me_method == ME_FULL)
337  x4->params.analyse.i_me_method = X264_ME_ESA;
338  else if (avctx->me_method == ME_TESA)
339  x4->params.analyse.i_me_method = X264_ME_TESA;
340 
341  if (avctx->gop_size >= 0)
342  x4->params.i_keyint_max = avctx->gop_size;
343  if (avctx->max_b_frames >= 0)
344  x4->params.i_bframe = avctx->max_b_frames;
345  if (avctx->scenechange_threshold >= 0)
346  x4->params.i_scenecut_threshold = avctx->scenechange_threshold;
347  if (avctx->qmin >= 0)
348  x4->params.rc.i_qp_min = avctx->qmin;
349  if (avctx->qmax >= 0)
350  x4->params.rc.i_qp_max = avctx->qmax;
351  if (avctx->max_qdiff >= 0)
352  x4->params.rc.i_qp_step = avctx->max_qdiff;
353  if (avctx->qblur >= 0)
354  x4->params.rc.f_qblur = avctx->qblur; /* temporally blur quants */
355  if (avctx->qcompress >= 0)
356  x4->params.rc.f_qcompress = avctx->qcompress; /* 0.0 => cbr, 1.0 => constant qp */
357  if (avctx->refs >= 0)
358  x4->params.i_frame_reference = avctx->refs;
359  if (avctx->trellis >= 0)
360  x4->params.analyse.i_trellis = avctx->trellis;
361  if (avctx->me_range >= 0)
362  x4->params.analyse.i_me_range = avctx->me_range;
363  if (avctx->noise_reduction >= 0)
364  x4->params.analyse.i_noise_reduction = avctx->noise_reduction;
365  if (avctx->me_subpel_quality >= 0)
366  x4->params.analyse.i_subpel_refine = avctx->me_subpel_quality;
367  if (avctx->b_frame_strategy >= 0)
368  x4->params.i_bframe_adaptive = avctx->b_frame_strategy;
369  if (avctx->keyint_min >= 0)
370  x4->params.i_keyint_min = avctx->keyint_min;
371  if (avctx->coder_type >= 0)
372  x4->params.b_cabac = avctx->coder_type == FF_CODER_TYPE_AC;
373  if (avctx->me_cmp >= 0)
374  x4->params.analyse.b_chroma_me = avctx->me_cmp & FF_CMP_CHROMA;
375 
376  if (x4->aq_mode >= 0)
377  x4->params.rc.i_aq_mode = x4->aq_mode;
378  if (x4->aq_strength >= 0)
379  x4->params.rc.f_aq_strength = x4->aq_strength;
380  PARSE_X264_OPT("psy-rd", psy_rd);
381  PARSE_X264_OPT("deblock", deblock);
382  PARSE_X264_OPT("partitions", partitions);
383  PARSE_X264_OPT("stats", stats);
384  if (x4->psy >= 0)
385  x4->params.analyse.b_psy = x4->psy;
386  if (x4->rc_lookahead >= 0)
387  x4->params.rc.i_lookahead = x4->rc_lookahead;
388  if (x4->weightp >= 0)
389  x4->params.analyse.i_weighted_pred = x4->weightp;
390  if (x4->weightb >= 0)
391  x4->params.analyse.b_weighted_bipred = x4->weightb;
392  if (x4->cplxblur >= 0)
393  x4->params.rc.f_complexity_blur = x4->cplxblur;
394 
395  if (x4->ssim >= 0)
396  x4->params.analyse.b_ssim = x4->ssim;
397  if (x4->intra_refresh >= 0)
398  x4->params.b_intra_refresh = x4->intra_refresh;
399  if (x4->b_bias != INT_MIN)
400  x4->params.i_bframe_bias = x4->b_bias;
401  if (x4->b_pyramid >= 0)
402  x4->params.i_bframe_pyramid = x4->b_pyramid;
403  if (x4->mixed_refs >= 0)
404  x4->params.analyse.b_mixed_references = x4->mixed_refs;
405  if (x4->dct8x8 >= 0)
406  x4->params.analyse.b_transform_8x8 = x4->dct8x8;
407  if (x4->fast_pskip >= 0)
408  x4->params.analyse.b_fast_pskip = x4->fast_pskip;
409  if (x4->aud >= 0)
410  x4->params.b_aud = x4->aud;
411  if (x4->mbtree >= 0)
412  x4->params.rc.b_mb_tree = x4->mbtree;
413  if (x4->direct_pred >= 0)
414  x4->params.analyse.i_direct_mv_pred = x4->direct_pred;
415 
416  if (x4->slice_max_size >= 0)
417  x4->params.i_slice_max_size = x4->slice_max_size;
418 
419  if (x4->fastfirstpass)
420  x264_param_apply_fastfirstpass(&x4->params);
421 
422  if (x4->profile)
423  if (x264_param_apply_profile(&x4->params, x4->profile) < 0) {
424  av_log(avctx, AV_LOG_ERROR, "Error setting profile %s.\n", x4->profile);
425  return AVERROR(EINVAL);
426  }
427 
428  x4->params.i_width = avctx->width;
429  x4->params.i_height = avctx->height;
430  x4->params.vui.i_sar_width = avctx->sample_aspect_ratio.num;
431  x4->params.vui.i_sar_height = avctx->sample_aspect_ratio.den;
432  x4->params.i_fps_num = x4->params.i_timebase_den = avctx->time_base.den;
433  x4->params.i_fps_den = x4->params.i_timebase_num = avctx->time_base.num;
434 
435  x4->params.analyse.b_psnr = avctx->flags & CODEC_FLAG_PSNR;
436 
437  x4->params.i_threads = avctx->thread_count;
438 
439  x4->params.b_interlaced = avctx->flags & CODEC_FLAG_INTERLACED_DCT;
440 
441  x4->params.b_open_gop = !(avctx->flags & CODEC_FLAG_CLOSED_GOP);
442 
443  x4->params.i_slice_count = avctx->slices;
444 
445  x4->params.vui.b_fullrange = avctx->pix_fmt == PIX_FMT_YUVJ420P;
446 
447  if (avctx->flags & CODEC_FLAG_GLOBAL_HEADER)
448  x4->params.b_repeat_headers = 0;
449 
450  // update AVCodecContext with x264 parameters
451  avctx->has_b_frames = x4->params.i_bframe ?
452  x4->params.i_bframe_pyramid ? 2 : 1 : 0;
453  if (avctx->max_b_frames < 0)
454  avctx->max_b_frames = 0;
455 
456  avctx->bit_rate = x4->params.rc.i_bitrate*1000;
457 #if FF_API_X264_GLOBAL_OPTS
458  avctx->crf = x4->params.rc.f_rf_constant;
459 #endif
460 
461  x4->enc = x264_encoder_open(&x4->params);
462  if (!x4->enc)
463  return -1;
464 
465  avctx->coded_frame = &x4->out_pic;
466 
467  if (avctx->flags & CODEC_FLAG_GLOBAL_HEADER) {
468  x264_nal_t *nal;
469  int nnal, s, i;
470 
471  s = x264_encoder_headers(x4->enc, &nal, &nnal);
472 
473  for (i = 0; i < nnal; i++)
474  if (nal[i].i_type == NAL_SEI)
475  av_log(avctx, AV_LOG_INFO, "%s\n", nal[i].p_payload+25);
476 
477  avctx->extradata = av_malloc(s);
478  avctx->extradata_size = encode_nals(avctx, avctx->extradata, s, nal, nnal, 1);
479  }
480 
481  return 0;
482 }
483 
484 static const enum PixelFormat pix_fmts_8bit[] = {
490 };
491 static const enum PixelFormat pix_fmts_9bit[] = {
495 };
496 static const enum PixelFormat pix_fmts_10bit[] = {
501 };
502 
503 static av_cold void X264_init_static(AVCodec *codec)
504 {
505  if (x264_bit_depth == 8)
506  codec->pix_fmts = pix_fmts_8bit;
507  else if (x264_bit_depth == 9)
508  codec->pix_fmts = pix_fmts_9bit;
509  else if (x264_bit_depth == 10)
510  codec->pix_fmts = pix_fmts_10bit;
511 }
512 
513 #define OFFSET(x) offsetof(X264Context, x)
514 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
515 static const AVOption options[] = {
516  { "preset", "Set the encoding preset (cf. x264 --fullhelp)", OFFSET(preset), AV_OPT_TYPE_STRING, { .str = "medium" }, 0, 0, VE},
517  { "tune", "Tune the encoding params (cf. x264 --fullhelp)", OFFSET(tune), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
518  { "profile", "Set profile restrictions (cf. x264 --fullhelp) ", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
519  { "fastfirstpass", "Use fast settings when encoding first pass", OFFSET(fastfirstpass), AV_OPT_TYPE_INT, { 1 }, 0, 1, VE},
520  { "crf", "Select the quality for constant quality mode", OFFSET(crf), AV_OPT_TYPE_FLOAT, {-1 }, -1, FLT_MAX, VE },
521  { "crf_max", "In CRF mode, prevents VBV from lowering quality beyond this point.",OFFSET(crf_max), AV_OPT_TYPE_FLOAT, {-1 }, -1, FLT_MAX, VE },
522  { "qp", "Constant quantization parameter rate control method",OFFSET(cqp), AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE },
523  { "aq-mode", "AQ method", OFFSET(aq_mode), AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE, "aq_mode"},
524  { "none", NULL, 0, AV_OPT_TYPE_CONST, {X264_AQ_NONE}, INT_MIN, INT_MAX, VE, "aq_mode" },
525  { "variance", "Variance AQ (complexity mask)", 0, AV_OPT_TYPE_CONST, {X264_AQ_VARIANCE}, INT_MIN, INT_MAX, VE, "aq_mode" },
526  { "autovariance", "Auto-variance AQ (experimental)", 0, AV_OPT_TYPE_CONST, {X264_AQ_AUTOVARIANCE}, INT_MIN, INT_MAX, VE, "aq_mode" },
527  { "aq-strength", "AQ strength. Reduces blocking and blurring in flat and textured areas.", OFFSET(aq_strength), AV_OPT_TYPE_FLOAT, {-1}, -1, FLT_MAX, VE},
528  { "psy", "Use psychovisual optimizations.", OFFSET(psy), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE },
529  { "psy-rd", "Strength of psychovisual optimization, in <psy-rd>:<psy-trellis> format.", OFFSET(psy_rd), AV_OPT_TYPE_STRING, {0 }, 0, 0, VE},
530  { "rc-lookahead", "Number of frames to look ahead for frametype and ratecontrol", OFFSET(rc_lookahead), AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE },
531  { "weightb", "Weighted prediction for B-frames.", OFFSET(weightb), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE },
532  { "weightp", "Weighted prediction analysis method.", OFFSET(weightp), AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE, "weightp" },
533  { "none", NULL, 0, AV_OPT_TYPE_CONST, {X264_WEIGHTP_NONE}, INT_MIN, INT_MAX, VE, "weightp" },
534  { "simple", NULL, 0, AV_OPT_TYPE_CONST, {X264_WEIGHTP_SIMPLE}, INT_MIN, INT_MAX, VE, "weightp" },
535  { "smart", NULL, 0, AV_OPT_TYPE_CONST, {X264_WEIGHTP_SMART}, INT_MIN, INT_MAX, VE, "weightp" },
536  { "ssim", "Calculate and print SSIM stats.", OFFSET(ssim), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE },
537  { "intra-refresh", "Use Periodic Intra Refresh instead of IDR frames.",OFFSET(intra_refresh),AV_OPT_TYPE_INT, {-1 }, -1, 1, VE },
538  { "b-bias", "Influences how often B-frames are used", OFFSET(b_bias), AV_OPT_TYPE_INT, {INT_MIN}, INT_MIN, INT_MAX, VE },
539  { "b-pyramid", "Keep some B-frames as references.", OFFSET(b_pyramid), AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE, "b_pyramid" },
540  { "none", NULL, 0, AV_OPT_TYPE_CONST, {X264_B_PYRAMID_NONE}, INT_MIN, INT_MAX, VE, "b_pyramid" },
541  { "strict", "Strictly hierarchical pyramid", 0, AV_OPT_TYPE_CONST, {X264_B_PYRAMID_STRICT}, INT_MIN, INT_MAX, VE, "b_pyramid" },
542  { "normal", "Non-strict (not Blu-ray compatible)", 0, AV_OPT_TYPE_CONST, {X264_B_PYRAMID_NORMAL}, INT_MIN, INT_MAX, VE, "b_pyramid" },
543  { "mixed-refs", "One reference per partition, as opposed to one reference per macroblock", OFFSET(mixed_refs), AV_OPT_TYPE_INT, {-1}, -1, 1, VE },
544  { "8x8dct", "High profile 8x8 transform.", OFFSET(dct8x8), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE},
545  { "fast-pskip", NULL, OFFSET(fast_pskip), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE},
546  { "aud", "Use access unit delimiters.", OFFSET(aud), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE},
547  { "mbtree", "Use macroblock tree ratecontrol.", OFFSET(mbtree), AV_OPT_TYPE_INT, {-1 }, -1, 1, VE},
548  { "deblock", "Loop filter parameters, in <alpha:beta> form.", OFFSET(deblock), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
549  { "cplxblur", "Reduce fluctuations in QP (before curve compression)", OFFSET(cplxblur), AV_OPT_TYPE_FLOAT, {-1 }, -1, FLT_MAX, VE},
550  { "partitions", "A comma-separated list of partitions to consider. "
551  "Possible values: p8x8, p4x4, b8x8, i8x8, i4x4, none, all", OFFSET(partitions), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE},
552  { "direct-pred", "Direct MV prediction mode", OFFSET(direct_pred), AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE, "direct-pred" },
553  { "none", NULL, 0, AV_OPT_TYPE_CONST, { X264_DIRECT_PRED_NONE }, 0, 0, VE, "direct-pred" },
554  { "spatial", NULL, 0, AV_OPT_TYPE_CONST, { X264_DIRECT_PRED_SPATIAL }, 0, 0, VE, "direct-pred" },
555  { "temporal", NULL, 0, AV_OPT_TYPE_CONST, { X264_DIRECT_PRED_TEMPORAL }, 0, 0, VE, "direct-pred" },
556  { "auto", NULL, 0, AV_OPT_TYPE_CONST, { X264_DIRECT_PRED_AUTO }, 0, 0, VE, "direct-pred" },
557  { "slice-max-size","Limit the size of each slice in bytes", OFFSET(slice_max_size),AV_OPT_TYPE_INT, {-1 }, -1, INT_MAX, VE },
558  { "stats", "Filename for 2 pass stats", OFFSET(stats), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
559  { NULL },
560 };
561 
562 static const AVClass class = {
563  .class_name = "libx264",
564  .item_name = av_default_item_name,
565  .option = options,
567 };
568 
569 static const AVCodecDefault x264_defaults[] = {
570  { "b", "0" },
571  { "bf", "-1" },
572  { "g", "-1" },
573  { "qmin", "-1" },
574  { "qmax", "-1" },
575  { "qdiff", "-1" },
576  { "qblur", "-1" },
577  { "qcomp", "-1" },
578  { "refs", "-1" },
579  { "sc_threshold", "-1" },
580  { "trellis", "-1" },
581  { "nr", "-1" },
582  { "me_range", "-1" },
583  { "me_method", "-1" },
584  { "subq", "-1" },
585  { "b_strategy", "-1" },
586  { "keyint_min", "-1" },
587  { "coder", "-1" },
588  { "cmp", "-1" },
589  { "threads", AV_STRINGIFY(X264_THREADS_AUTO) },
590  { NULL },
591 };
592 
594  .name = "libx264",
595  .type = AVMEDIA_TYPE_VIDEO,
596  .id = CODEC_ID_H264,
597  .priv_data_size = sizeof(X264Context),
598  .init = X264_init,
599  .encode = X264_frame,
600  .close = X264_close,
601  .capabilities = CODEC_CAP_DELAY | CODEC_CAP_AUTO_THREADS,
602  .long_name = NULL_IF_CONFIG_SMALL("libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"),
603  .priv_class = &class,
604  .defaults = x264_defaults,
605  .init_static_data = X264_init_static,
606 };
#define CODEC_CAP_AUTO_THREADS
Codec supports avctx->thread_count == 0 (auto).
Definition: avcodec.h:800
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Definition: pixfmt.h:68
enum PixelFormat pix_fmt
Pixel format, see PIX_FMT_xxx.
Definition: avcodec.h:1426
static int X264_frame(AVCodecContext *ctx, uint8_t *buf, int bufsize, void *data)
Definition: libx264.c:117
char * partitions
Definition: libx264.c:66
int size
Audio Video Frame.
Definition: avcodec.h:985
int dct8x8
Definition: libx264.c:60
AVOption.
Definition: opt.h:244
#define CODEC_FLAG_INTERLACED_DCT
Use interlaced DCT.
Definition: avcodec.h:646
static int convert_pix_fmt(enum PixelFormat pix_fmt)
Definition: libx264.c:196
AVCodec ff_libx264_encoder
Definition: libx264.c:593
float qblur
amount of qscale smoothing over time (0.0-1.0)
Definition: avcodec.h:1483
#define PIX_FMT_YUV444P9
Definition: pixfmt.h:186
AVFrame * coded_frame
the picture in the bitstream
Definition: avcodec.h:2000
int max_b_frames
maximum number of B-frames between non-B-frames Note: The output will be delayed by max_b_frames+1 re...
Definition: avcodec.h:1512
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:117
int rc_initial_buffer_occupancy
Number of bits which should be loaded into the rc buffer before decoding starts.
Definition: avcodec.h:2343
enum PixelFormat pix_fmt
Definition: v4l.c:65
int num
numerator
Definition: rational.h:44
AVOptions.
AVRational sample_aspect_ratio
sample aspect ratio (0 if unknown) That is the width of a pixel divided by the height of the pixel...
Definition: avcodec.h:1993
static void X264_log(void *p, int level, const char *fmt, va_list args)
Definition: libx264.c:72
#define CODEC_FLAG_PASS1
Use internal 2pass ratecontrol in first pass mode.
Definition: avcodec.h:638
AVCodec.
Definition: avcodec.h:3189
static av_cold int X264_init(AVCodecContext *avctx)
Definition: libx264.c:218
int scenechange_threshold
scene change detection threshold 0 is default, larger means fewer detected scene changes.
Definition: avcodec.h:2292
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented...
Definition: avcodec.h:1398
void av_freep(void *arg)
Free a memory block which has been allocated with av_malloc(z)() or av_realloc() and set the pointer ...
Definition: mem.c:147
x264_param_t params
Definition: libx264.c:35
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:38
#define PIX_FMT_YUV420P10
Definition: pixfmt.h:187
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:64
#define av_cold
Definition: attributes.h:71
int me_range
maximum motion estimation search range in subpel units If 0 then no limit.
Definition: avcodec.h:2161
float b_quant_factor
qscale factor between IP and B-frames If > 0 then the last P-frame quantizer will be used (q= lastp_q...
Definition: avcodec.h:1521
int64_t pts
presentation timestamp in time_base units (time when frame should be shown to user) If AV_NOPTS_VALUE...
Definition: avcodec.h:1037
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1387
int me_cmp
motion estimation comparison function
Definition: avcodec.h:2048
const char data[16]
Definition: mxf.c:60
enhanced predictive zonal search
Definition: avcodec.h:514
static int encode_nals(AVCodecContext *ctx, uint8_t *buf, int size, x264_nal_t *nals, int nnal, int skip_sei)
Definition: libx264.c:88
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV420P and setting color_...
Definition: pixfmt.h:76
int coder_type
coder type
Definition: avcodec.h:2220
int b_pyramid
Definition: libx264.c:58
x264_picture_t pic
Definition: libx264.c:37
float cplxblur
Definition: libx264.c:65
#define FF_CMP_CHROMA
Definition: avcodec.h:2082
char * stats
Definition: libx264.c:69
int intra_refresh
Definition: libx264.c:56
static int init(AVCodecParserContext *s)
Definition: h264_parser.c:336
int rc_lookahead
Definition: libx264.c:52
void av_vlog(void *avcl, int level, const char *fmt, va_list vl)
Definition: log.c:152
int chromaoffset
chroma qp offset from luma
Definition: avcodec.h:2674
int has_b_frames
Size of the frame reordering buffer in the decoder.
Definition: avcodec.h:1745
void av_free(void *ptr)
Free a memory block which has been allocated with av_malloc(z)() or av_realloc(). ...
Definition: mem.c:137
#define CODEC_FLAG_PASS2
Use internal 2pass ratecontrol in second pass mode.
Definition: avcodec.h:639
static enum PixelFormat pix_fmts_9bit[]
Definition: libx264.c:491
#define AVERROR(e)
Definition: error.h:43
int qmax
maximum quantizer
Definition: avcodec.h:1497
char * profile
Definition: libx264.c:43
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:191
int fastfirstpass
Definition: libx264.c:44
int flags
CODEC_FLAG_*.
Definition: avcodec.h:1355
int rc_max_rate
maximum bitrate
Definition: avcodec.h:1816
void av_log(void *avcl, int level, const char *fmt,...)
Definition: log.c:140
int mbtree
Definition: libx264.c:63
const char * name
Name of the codec implementation.
Definition: avcodec.h:3196
float i_quant_factor
qscale factor between P and I-frames If > 0 then the last p frame quantizer will be used (q= lastp_q*...
Definition: avcodec.h:1840
char * deblock
Definition: libx264.c:64
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
Definition: pixfmt.h:69
static enum PixelFormat pix_fmts_10bit[]
Definition: libx264.c:496
int rc_buffer_size
decoder bitstream buffer size
Definition: avcodec.h:1830
char * psy_rd
Definition: libx264.c:50
int refs
number of reference frames
Definition: avcodec.h:2667
#define PARSE_X264_OPT(name, var)
Definition: libx264.c:212
int bit_rate
the average bitrate
Definition: avcodec.h:1340
enum AVPictureType pict_type
Picture type of the frame, see ?_TYPE below.
Definition: avcodec.h:1029
int width
picture width / height.
Definition: avcodec.h:1408
int cqp
Definition: libx264.c:47
x264_t * enc
Definition: libx264.c:36
int b_frame_strategy
Definition: avcodec.h:1527
int level
level
Definition: avcodec.h:2528
int quality
quality (between 1 (good) and FF_LAMBDA_MAX (bad))
Definition: avcodec.h:1057
#define CODEC_FLAG_LOOP_FILTER
loop filter
Definition: avcodec.h:654
int slice_max_size
Definition: libx264.c:68
#define PIX_FMT_YUV420P9
Definition: pixfmt.h:184
int max_qdiff
maximum quantizer difference between frames
Definition: avcodec.h:1504
int weightp
Definition: libx264.c:53
LIBAVUTIL_VERSION_INT
Definition: eval.c:50
int thread_count
thread count is used to decide how many independent tasks should be passed to execute() ...
Definition: avcodec.h:2392
static const AVCodecDefault x264_defaults[]
Definition: libx264.c:569
NULL
Definition: eval.c:50
AVFrame out_pic
Definition: libx264.c:40
external API header
static av_cold int X264_close(AVCodecContext *avctx)
Definition: libx264.c:183
int linesize[AV_NUM_DATA_POINTERS]
Size, in bytes, of the data for each picture/channel plane.
Definition: avcodec.h:1008
#define PIX_FMT_YUV422P10
Definition: pixfmt.h:188
av_default_item_name
Definition: dnxhdenc.c:43
main external API structure.
Definition: avcodec.h:1329
static void close(AVCodecParserContext *s)
Definition: h264_parser.c:327
static const AVOption options[]
Definition: libx264.c:515
int qmin
minimum quantizer
Definition: avcodec.h:1490
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:111
#define FF_CODER_TYPE_AC
Definition: avcodec.h:2211
int extradata_size
Definition: avcodec.h:1388
float crf
Definition: libx264.c:45
int aq_mode
Definition: libx264.c:48
void * av_malloc(size_t size)
Allocate a block of size bytes with alignment suitable for all memory accesses (including vectors if ...
Definition: mem.c:64
int aud
Definition: libx264.c:62
#define AV_STRINGIFY(s)
Definition: avutil.h:120
Describe the class of an AVClass context structure.
Definition: log.h:33
#define CODEC_FLAG_GLOBAL_HEADER
Place global headers in extradata instead of every keyframe.
Definition: avcodec.h:648
uint8_t * sei
Definition: libx264.c:38
transformed exhaustive search algorithm
Definition: avcodec.h:519
int psy
Definition: libx264.c:51
struct X264Context X264Context
float qcompress
amount of qscale change between easy & hard scenes (0.0-1.0)
Definition: avcodec.h:1482
int sei_size
Definition: libx264.c:39
char * preset
Definition: libx264.c:41
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: avcodec.h:997
enum PixelFormat * pix_fmts
array of supported pixel formats, or NULL if unknown, array is terminated by -1
Definition: avcodec.h:3216
uint8_t level
Definition: svq3.c:123
int b_bias
Definition: libx264.c:57
int fast_pskip
Definition: libx264.c:61
int noise_reduction
noise reduction strength
Definition: avcodec.h:2322
int gop_size
the number of pictures in a group of pictures, or 0 for intra_only
Definition: avcodec.h:1417
#define CODEC_FLAG_CLOSED_GOP
Definition: avcodec.h:656
static av_cold void X264_init_static(AVCodec *codec)
Definition: libx264.c:503
int mixed_refs
Definition: libx264.c:59
PixelFormat
Pixel format.
Definition: pixfmt.h:62
char * tune
Definition: libx264.c:42
#define VE
Definition: libx264.c:514
int weightb
Definition: libx264.c:54
float aq_strength
Definition: libx264.c:49
common internal api header.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:125
uneven multi-hexagon search
Definition: avcodec.h:517
Bi-dir predicted.
Definition: avutil.h:298
int den
denominator
Definition: rational.h:45
int trellis
trellis RD quantization
Definition: avcodec.h:2690
int slices
Number of slices.
Definition: avcodec.h:3064
void * priv_data
Definition: avcodec.h:1531
#define PIX_FMT_YUV444P10
Definition: pixfmt.h:189
int top_field_first
If the content is interlaced, is top field displayed first.
Definition: avcodec.h:1174
int key_frame
1 -> keyframe, 0-> not
Definition: avcodec.h:1022
int ssim
Definition: libx264.c:55
#define FF_QP2LAMBDA
factor to convert from H.263 QP to lambda
Definition: avutil.h:250
int flags2
CODEC_FLAG2_*.
Definition: avcodec.h:2357
float crf_max
Definition: libx264.c:46
Definition: h264.h:113
#define AV_LOG_INFO
Definition: log.h:119
#define OFFSET(x)
Definition: libx264.c:513
int direct_pred
Definition: libx264.c:67
#define CODEC_FLAG_PSNR
error[?] variables will be set during encoding.
Definition: avcodec.h:642
#define CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
Definition: avcodec.h:750
int me_method
Motion estimation algorithm used for video coding.
Definition: avcodec.h:1374
hexagon based search
Definition: avcodec.h:516
int me_subpel_quality
subpel ME quality
Definition: avcodec.h:2124
Predicted.
Definition: avutil.h:297
int keyint_min
minimum GOP size
Definition: avcodec.h:2660
static enum PixelFormat pix_fmts_8bit[]
Definition: libx264.c:484