FFmpeg
libx265.c
Go to the documentation of this file.
1 /*
2  * libx265 encoder
3  *
4  * Copyright (c) 2013-2014 Derek Buitenhuis
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #if defined(_MSC_VER)
24 #define X265_API_IMPORTS 1
25 #endif
26 
27 #include <x265.h>
28 #include <float.h>
29 
30 #include "libavutil/internal.h"
31 #include "libavutil/common.h"
32 #include "libavutil/opt.h"
33 #include "libavutil/pixdesc.h"
34 #include "avcodec.h"
35 #include "internal.h"
36 #include "packet_internal.h"
37 
38 typedef struct libx265Context {
39  const AVClass *class;
40 
41  x265_encoder *encoder;
42  x265_param *params;
43  const x265_api *api;
44 
45  float crf;
46  int cqp;
48  char *preset;
49  char *tune;
50  char *profile;
52 
53  /**
54  * If the encoder does not support ROI then warn the first time we
55  * encounter a frame with ROI side data.
56  */
59 
60 static int is_keyframe(NalUnitType naltype)
61 {
62  switch (naltype) {
63  case NAL_UNIT_CODED_SLICE_BLA_W_LP:
64  case NAL_UNIT_CODED_SLICE_BLA_W_RADL:
65  case NAL_UNIT_CODED_SLICE_BLA_N_LP:
66  case NAL_UNIT_CODED_SLICE_IDR_W_RADL:
67  case NAL_UNIT_CODED_SLICE_IDR_N_LP:
68  case NAL_UNIT_CODED_SLICE_CRA:
69  return 1;
70  default:
71  return 0;
72  }
73 }
74 
76 {
77  libx265Context *ctx = avctx->priv_data;
78 
79  ctx->api->param_free(ctx->params);
80 
81  if (ctx->encoder)
82  ctx->api->encoder_close(ctx->encoder);
83 
84  return 0;
85 }
86 
88  const char *key, float value)
89 {
90  libx265Context *ctx = avctx->priv_data;
91  char buf[256];
92 
93  snprintf(buf, sizeof(buf), "%2.2f", value);
94  if (ctx->api->param_parse(ctx->params, key, buf) == X265_PARAM_BAD_VALUE) {
95  av_log(avctx, AV_LOG_ERROR, "Invalid value %2.2f for param \"%s\".\n", value, key);
96  return AVERROR(EINVAL);
97  }
98 
99  return 0;
100 }
101 
103  const char *key, int value)
104 {
105  libx265Context *ctx = avctx->priv_data;
106  char buf[256];
107 
108  snprintf(buf, sizeof(buf), "%d", value);
109  if (ctx->api->param_parse(ctx->params, key, buf) == X265_PARAM_BAD_VALUE) {
110  av_log(avctx, AV_LOG_ERROR, "Invalid value %d for param \"%s\".\n", value, key);
111  return AVERROR(EINVAL);
112  }
113 
114  return 0;
115 }
116 
118 {
119  libx265Context *ctx = avctx->priv_data;
120  AVCPBProperties *cpb_props = NULL;
121  int ret;
122 
123  ctx->api = x265_api_get(av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth);
124  if (!ctx->api)
125  ctx->api = x265_api_get(0);
126 
127  ctx->params = ctx->api->param_alloc();
128  if (!ctx->params) {
129  av_log(avctx, AV_LOG_ERROR, "Could not allocate x265 param structure.\n");
130  return AVERROR(ENOMEM);
131  }
132 
133  if (ctx->api->param_default_preset(ctx->params, ctx->preset, ctx->tune) < 0) {
134  int i;
135 
136  av_log(avctx, AV_LOG_ERROR, "Error setting preset/tune %s/%s.\n", ctx->preset, ctx->tune);
137  av_log(avctx, AV_LOG_INFO, "Possible presets:");
138  for (i = 0; x265_preset_names[i]; i++)
139  av_log(avctx, AV_LOG_INFO, " %s", x265_preset_names[i]);
140 
141  av_log(avctx, AV_LOG_INFO, "\n");
142  av_log(avctx, AV_LOG_INFO, "Possible tunes:");
143  for (i = 0; x265_tune_names[i]; i++)
144  av_log(avctx, AV_LOG_INFO, " %s", x265_tune_names[i]);
145 
146  av_log(avctx, AV_LOG_INFO, "\n");
147 
148  return AVERROR(EINVAL);
149  }
150 
151  ctx->params->frameNumThreads = avctx->thread_count;
152  if (avctx->framerate.num > 0 && avctx->framerate.den > 0) {
153  ctx->params->fpsNum = avctx->framerate.num;
154  ctx->params->fpsDenom = avctx->framerate.den;
155  } else {
156  ctx->params->fpsNum = avctx->time_base.den;
157  ctx->params->fpsDenom = avctx->time_base.num * avctx->ticks_per_frame;
158  }
159  ctx->params->sourceWidth = avctx->width;
160  ctx->params->sourceHeight = avctx->height;
161  ctx->params->bEnablePsnr = !!(avctx->flags & AV_CODEC_FLAG_PSNR);
162  ctx->params->bOpenGOP = !(avctx->flags & AV_CODEC_FLAG_CLOSED_GOP);
163 
164  /* Tune the CTU size based on input resolution. */
165  if (ctx->params->sourceWidth < 64 || ctx->params->sourceHeight < 64)
166  ctx->params->maxCUSize = 32;
167  if (ctx->params->sourceWidth < 32 || ctx->params->sourceHeight < 32)
168  ctx->params->maxCUSize = 16;
169  if (ctx->params->sourceWidth < 16 || ctx->params->sourceHeight < 16) {
170  av_log(avctx, AV_LOG_ERROR, "Image size is too small (%dx%d).\n",
171  ctx->params->sourceWidth, ctx->params->sourceHeight);
172  return AVERROR(EINVAL);
173  }
174 
175 
176  ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
177 
178  ctx->params->vui.bEnableVideoFullRangeFlag = avctx->pix_fmt == AV_PIX_FMT_YUVJ420P ||
179  avctx->pix_fmt == AV_PIX_FMT_YUVJ422P ||
180  avctx->pix_fmt == AV_PIX_FMT_YUVJ444P ||
181  avctx->color_range == AVCOL_RANGE_JPEG;
182 
183  if ((avctx->color_primaries <= AVCOL_PRI_SMPTE432 &&
185  (avctx->color_trc <= AVCOL_TRC_ARIB_STD_B67 &&
186  avctx->color_trc != AVCOL_TRC_UNSPECIFIED) ||
187  (avctx->colorspace <= AVCOL_SPC_ICTCP &&
188  avctx->colorspace != AVCOL_SPC_UNSPECIFIED)) {
189 
190  ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
191 
192  // x265 validates the parameters internally
193  ctx->params->vui.colorPrimaries = avctx->color_primaries;
194  ctx->params->vui.transferCharacteristics = avctx->color_trc;
195 #if X265_BUILD >= 159
196  if (avctx->color_trc == AVCOL_TRC_ARIB_STD_B67)
197  ctx->params->preferredTransferCharacteristics = ctx->params->vui.transferCharacteristics;
198 #endif
199  ctx->params->vui.matrixCoeffs = avctx->colorspace;
200  }
201 
202  if (avctx->sample_aspect_ratio.num > 0 && avctx->sample_aspect_ratio.den > 0) {
203  char sar[12];
204  int sar_num, sar_den;
205 
206  av_reduce(&sar_num, &sar_den,
207  avctx->sample_aspect_ratio.num,
208  avctx->sample_aspect_ratio.den, 65535);
209  snprintf(sar, sizeof(sar), "%d:%d", sar_num, sar_den);
210  if (ctx->api->param_parse(ctx->params, "sar", sar) == X265_PARAM_BAD_VALUE) {
211  av_log(avctx, AV_LOG_ERROR, "Invalid SAR: %d:%d.\n", sar_num, sar_den);
212  return AVERROR_INVALIDDATA;
213  }
214  }
215 
216  switch (avctx->pix_fmt) {
217  case AV_PIX_FMT_YUV420P:
220  ctx->params->internalCsp = X265_CSP_I420;
221  break;
222  case AV_PIX_FMT_YUV422P:
225  ctx->params->internalCsp = X265_CSP_I422;
226  break;
227  case AV_PIX_FMT_GBRP:
228  case AV_PIX_FMT_GBRP10:
229  case AV_PIX_FMT_GBRP12:
230  ctx->params->vui.matrixCoeffs = AVCOL_SPC_RGB;
231  ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
232  ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
233  case AV_PIX_FMT_YUV444P:
236  ctx->params->internalCsp = X265_CSP_I444;
237  break;
238  case AV_PIX_FMT_GRAY8:
239  case AV_PIX_FMT_GRAY10:
240  case AV_PIX_FMT_GRAY12:
241  if (ctx->api->api_build_number < 85) {
242  av_log(avctx, AV_LOG_ERROR,
243  "libx265 version is %d, must be at least 85 for gray encoding.\n",
244  ctx->api->api_build_number);
245  return AVERROR_INVALIDDATA;
246  }
247  ctx->params->internalCsp = X265_CSP_I400;
248  break;
249  }
250 
251  if (ctx->crf >= 0) {
252  char crf[6];
253 
254  snprintf(crf, sizeof(crf), "%2.2f", ctx->crf);
255  if (ctx->api->param_parse(ctx->params, "crf", crf) == X265_PARAM_BAD_VALUE) {
256  av_log(avctx, AV_LOG_ERROR, "Invalid crf: %2.2f.\n", ctx->crf);
257  return AVERROR(EINVAL);
258  }
259  } else if (avctx->bit_rate > 0) {
260  ctx->params->rc.bitrate = avctx->bit_rate / 1000;
261  ctx->params->rc.rateControlMode = X265_RC_ABR;
262  } else if (ctx->cqp >= 0) {
263  ret = libx265_param_parse_int(avctx, "qp", ctx->cqp);
264  if (ret < 0)
265  return ret;
266  }
267 
268 #if X265_BUILD >= 89
269  if (avctx->qmin >= 0) {
270  ret = libx265_param_parse_int(avctx, "qpmin", avctx->qmin);
271  if (ret < 0)
272  return ret;
273  }
274  if (avctx->qmax >= 0) {
275  ret = libx265_param_parse_int(avctx, "qpmax", avctx->qmax);
276  if (ret < 0)
277  return ret;
278  }
279 #endif
280  if (avctx->max_qdiff >= 0) {
281  ret = libx265_param_parse_int(avctx, "qpstep", avctx->max_qdiff);
282  if (ret < 0)
283  return ret;
284  }
285  if (avctx->qblur >= 0) {
286  ret = libx265_param_parse_float(avctx, "qblur", avctx->qblur);
287  if (ret < 0)
288  return ret;
289  }
290  if (avctx->qcompress >= 0) {
291  ret = libx265_param_parse_float(avctx, "qcomp", avctx->qcompress);
292  if (ret < 0)
293  return ret;
294  }
295  if (avctx->i_quant_factor >= 0) {
296  ret = libx265_param_parse_float(avctx, "ipratio", avctx->i_quant_factor);
297  if (ret < 0)
298  return ret;
299  }
300  if (avctx->b_quant_factor >= 0) {
301  ret = libx265_param_parse_float(avctx, "pbratio", avctx->b_quant_factor);
302  if (ret < 0)
303  return ret;
304  }
305 
306  ctx->params->rc.vbvBufferSize = avctx->rc_buffer_size / 1000;
307  ctx->params->rc.vbvMaxBitrate = avctx->rc_max_rate / 1000;
308 
309  cpb_props = ff_add_cpb_side_data(avctx);
310  if (!cpb_props)
311  return AVERROR(ENOMEM);
312  cpb_props->buffer_size = ctx->params->rc.vbvBufferSize * 1000;
313  cpb_props->max_bitrate = ctx->params->rc.vbvMaxBitrate * 1000LL;
314  cpb_props->avg_bitrate = ctx->params->rc.bitrate * 1000LL;
315 
316  if (!(avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER))
317  ctx->params->bRepeatHeaders = 1;
318 
319  if (avctx->gop_size >= 0) {
320  ret = libx265_param_parse_int(avctx, "keyint", avctx->gop_size);
321  if (ret < 0)
322  return ret;
323  }
324  if (avctx->keyint_min > 0) {
325  ret = libx265_param_parse_int(avctx, "min-keyint", avctx->keyint_min);
326  if (ret < 0)
327  return ret;
328  }
329  if (avctx->max_b_frames >= 0) {
330  ret = libx265_param_parse_int(avctx, "bframes", avctx->max_b_frames);
331  if (ret < 0)
332  return ret;
333  }
334  if (avctx->refs >= 0) {
335  ret = libx265_param_parse_int(avctx, "ref", avctx->refs);
336  if (ret < 0)
337  return ret;
338  }
339 
340  {
341  AVDictionaryEntry *en = NULL;
342  while ((en = av_dict_get(ctx->x265_opts, "", en, AV_DICT_IGNORE_SUFFIX))) {
343  int parse_ret = ctx->api->param_parse(ctx->params, en->key, en->value);
344 
345  switch (parse_ret) {
346  case X265_PARAM_BAD_NAME:
347  av_log(avctx, AV_LOG_WARNING,
348  "Unknown option: %s.\n", en->key);
349  break;
350  case X265_PARAM_BAD_VALUE:
351  av_log(avctx, AV_LOG_WARNING,
352  "Invalid value for %s: %s.\n", en->key, en->value);
353  break;
354  default:
355  break;
356  }
357  }
358  }
359 
360  if (ctx->params->rc.vbvBufferSize && avctx->rc_initial_buffer_occupancy > 1000 &&
361  ctx->params->rc.vbvBufferInit == 0.9) {
362  ctx->params->rc.vbvBufferInit = (float)avctx->rc_initial_buffer_occupancy / 1000;
363  }
364 
365  if (ctx->profile) {
366  if (ctx->api->param_apply_profile(ctx->params, ctx->profile) < 0) {
367  int i;
368  av_log(avctx, AV_LOG_ERROR, "Invalid or incompatible profile set: %s.\n", ctx->profile);
369  av_log(avctx, AV_LOG_INFO, "Possible profiles:");
370  for (i = 0; x265_profile_names[i]; i++)
371  av_log(avctx, AV_LOG_INFO, " %s", x265_profile_names[i]);
372  av_log(avctx, AV_LOG_INFO, "\n");
373  return AVERROR(EINVAL);
374  }
375  }
376 
377  ctx->encoder = ctx->api->encoder_open(ctx->params);
378  if (!ctx->encoder) {
379  av_log(avctx, AV_LOG_ERROR, "Cannot open libx265 encoder.\n");
380  libx265_encode_close(avctx);
381  return AVERROR_INVALIDDATA;
382  }
383 
384  if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
385  x265_nal *nal;
386  int nnal;
387 
388  avctx->extradata_size = ctx->api->encoder_headers(ctx->encoder, &nal, &nnal);
389  if (avctx->extradata_size <= 0) {
390  av_log(avctx, AV_LOG_ERROR, "Cannot encode headers.\n");
391  libx265_encode_close(avctx);
392  return AVERROR_INVALIDDATA;
393  }
394 
396  if (!avctx->extradata) {
397  av_log(avctx, AV_LOG_ERROR,
398  "Cannot allocate HEVC header of size %d.\n", avctx->extradata_size);
399  libx265_encode_close(avctx);
400  return AVERROR(ENOMEM);
401  }
402 
403  memcpy(avctx->extradata, nal[0].payload, avctx->extradata_size);
404  memset(avctx->extradata + avctx->extradata_size, 0, AV_INPUT_BUFFER_PADDING_SIZE);
405  }
406 
407  return 0;
408 }
409 
410 static av_cold int libx265_encode_set_roi(libx265Context *ctx, const AVFrame *frame, x265_picture* pic)
411 {
413  if (sd) {
414  if (ctx->params->rc.aqMode == X265_AQ_NONE) {
415  if (!ctx->roi_warned) {
416  ctx->roi_warned = 1;
417  av_log(ctx, AV_LOG_WARNING, "Adaptive quantization must be enabled to use ROI encoding, skipping ROI.\n");
418  }
419  } else {
420  /* 8x8 block when qg-size is 8, 16*16 block otherwise. */
421  int mb_size = (ctx->params->rc.qgSize == 8) ? 8 : 16;
422  int mbx = (frame->width + mb_size - 1) / mb_size;
423  int mby = (frame->height + mb_size - 1) / mb_size;
424  int qp_range = 51 + 6 * (pic->bitDepth - 8);
425  int nb_rois;
426  const AVRegionOfInterest *roi;
427  uint32_t roi_size;
428  float *qoffsets; /* will be freed after encode is called. */
429 
430  roi = (const AVRegionOfInterest*)sd->data;
431  roi_size = roi->self_size;
432  if (!roi_size || sd->size % roi_size != 0) {
433  av_log(ctx, AV_LOG_ERROR, "Invalid AVRegionOfInterest.self_size.\n");
434  return AVERROR(EINVAL);
435  }
436  nb_rois = sd->size / roi_size;
437 
438  qoffsets = av_mallocz_array(mbx * mby, sizeof(*qoffsets));
439  if (!qoffsets)
440  return AVERROR(ENOMEM);
441 
442  // This list must be iterated in reverse because the first
443  // region in the list applies when regions overlap.
444  for (int i = nb_rois - 1; i >= 0; i--) {
445  int startx, endx, starty, endy;
446  float qoffset;
447 
448  roi = (const AVRegionOfInterest*)(sd->data + roi_size * i);
449 
450  starty = FFMIN(mby, roi->top / mb_size);
451  endy = FFMIN(mby, (roi->bottom + mb_size - 1)/ mb_size);
452  startx = FFMIN(mbx, roi->left / mb_size);
453  endx = FFMIN(mbx, (roi->right + mb_size - 1)/ mb_size);
454 
455  if (roi->qoffset.den == 0) {
456  av_free(qoffsets);
457  av_log(ctx, AV_LOG_ERROR, "AVRegionOfInterest.qoffset.den must not be zero.\n");
458  return AVERROR(EINVAL);
459  }
460  qoffset = roi->qoffset.num * 1.0f / roi->qoffset.den;
461  qoffset = av_clipf(qoffset * qp_range, -qp_range, +qp_range);
462 
463  for (int y = starty; y < endy; y++)
464  for (int x = startx; x < endx; x++)
465  qoffsets[x + y*mbx] = qoffset;
466  }
467 
468  pic->quantOffsets = qoffsets;
469  }
470  }
471  return 0;
472 }
473 
475  const AVFrame *pic, int *got_packet)
476 {
477  libx265Context *ctx = avctx->priv_data;
478  x265_picture x265pic;
479  x265_picture x265pic_out = { 0 };
480  x265_nal *nal;
481  uint8_t *dst;
482  int pict_type;
483  int payload = 0;
484  int nnal;
485  int ret;
486  int i;
487 
488  ctx->api->picture_init(ctx->params, &x265pic);
489 
490  if (pic) {
491  for (i = 0; i < 3; i++) {
492  x265pic.planes[i] = pic->data[i];
493  x265pic.stride[i] = pic->linesize[i];
494  }
495 
496  x265pic.pts = pic->pts;
497  x265pic.bitDepth = av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth;
498 
499  x265pic.sliceType = pic->pict_type == AV_PICTURE_TYPE_I ?
500  (ctx->forced_idr ? X265_TYPE_IDR : X265_TYPE_I) :
501  pic->pict_type == AV_PICTURE_TYPE_P ? X265_TYPE_P :
502  pic->pict_type == AV_PICTURE_TYPE_B ? X265_TYPE_B :
503  X265_TYPE_AUTO;
504 
505  ret = libx265_encode_set_roi(ctx, pic, &x265pic);
506  if (ret < 0)
507  return ret;
508 
509  if (pic->reordered_opaque) {
510  x265pic.userData = av_malloc(sizeof(pic->reordered_opaque));
511  if (!x265pic.userData) {
512  av_freep(&x265pic.quantOffsets);
513  return AVERROR(ENOMEM);
514  }
515 
516  memcpy(x265pic.userData, &pic->reordered_opaque, sizeof(pic->reordered_opaque));
517  }
518  }
519 
520  ret = ctx->api->encoder_encode(ctx->encoder, &nal, &nnal,
521  pic ? &x265pic : NULL, &x265pic_out);
522 
523  av_freep(&x265pic.quantOffsets);
524 
525  if (ret < 0)
526  return AVERROR_EXTERNAL;
527 
528  if (!nnal)
529  return 0;
530 
531  for (i = 0; i < nnal; i++)
532  payload += nal[i].sizeBytes;
533 
534  ret = ff_alloc_packet2(avctx, pkt, payload, payload);
535  if (ret < 0) {
536  av_log(avctx, AV_LOG_ERROR, "Error getting output packet.\n");
537  return ret;
538  }
539  dst = pkt->data;
540 
541  for (i = 0; i < nnal; i++) {
542  memcpy(dst, nal[i].payload, nal[i].sizeBytes);
543  dst += nal[i].sizeBytes;
544 
545  if (is_keyframe(nal[i].type))
546  pkt->flags |= AV_PKT_FLAG_KEY;
547  }
548 
549  pkt->pts = x265pic_out.pts;
550  pkt->dts = x265pic_out.dts;
551 
552  switch (x265pic_out.sliceType) {
553  case X265_TYPE_IDR:
554  case X265_TYPE_I:
555  pict_type = AV_PICTURE_TYPE_I;
556  break;
557  case X265_TYPE_P:
558  pict_type = AV_PICTURE_TYPE_P;
559  break;
560  case X265_TYPE_B:
561  case X265_TYPE_BREF:
562  pict_type = AV_PICTURE_TYPE_B;
563  break;
564  default:
565  av_log(avctx, AV_LOG_ERROR, "Unknown picture type encountered.\n");
566  return AVERROR_EXTERNAL;
567  }
568 
569 #if FF_API_CODED_FRAME
571  avctx->coded_frame->pict_type = pict_type;
573 #endif
574 
575 #if X265_BUILD >= 130
576  if (x265pic_out.sliceType == X265_TYPE_B)
577 #else
578  if (x265pic_out.frameData.sliceType == 'b')
579 #endif
581 
582  ff_side_data_set_encoder_stats(pkt, x265pic_out.frameData.qp * FF_QP2LAMBDA, NULL, 0, pict_type);
583 
584  if (x265pic_out.userData) {
585  memcpy(&avctx->reordered_opaque, x265pic_out.userData, sizeof(avctx->reordered_opaque));
586  av_freep(&x265pic_out.userData);
587  } else
588  avctx->reordered_opaque = 0;
589 
590  *got_packet = 1;
591  return 0;
592 }
593 
594 static const enum AVPixelFormat x265_csp_eight[] = {
604 };
605 
606 static const enum AVPixelFormat x265_csp_ten[] = {
621 };
622 
623 static const enum AVPixelFormat x265_csp_twelve[] = {
643 };
644 
646 {
647  if (x265_api_get(12))
648  codec->pix_fmts = x265_csp_twelve;
649  else if (x265_api_get(10))
650  codec->pix_fmts = x265_csp_ten;
651  else if (x265_api_get(8))
652  codec->pix_fmts = x265_csp_eight;
653 }
654 
655 #define OFFSET(x) offsetof(libx265Context, x)
656 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
657 static const AVOption options[] = {
658  { "crf", "set the x265 crf", OFFSET(crf), AV_OPT_TYPE_FLOAT, { .dbl = -1 }, -1, FLT_MAX, VE },
659  { "qp", "set the x265 qp", OFFSET(cqp), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE },
660  { "forced-idr", "if forcing keyframes, force them as IDR frames", OFFSET(forced_idr),AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, VE },
661  { "preset", "set the x265 preset", OFFSET(preset), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
662  { "tune", "set the x265 tune parameter", OFFSET(tune), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
663  { "profile", "set the x265 profile", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
664  { "x265-params", "set the x265 configuration using a :-separated list of key=value parameters", OFFSET(x265_opts), AV_OPT_TYPE_DICT, { 0 }, 0, 0, VE },
665  { NULL }
666 };
667 
668 static const AVClass class = {
669  .class_name = "libx265",
670  .item_name = av_default_item_name,
671  .option = options,
673 };
674 
675 static const AVCodecDefault x265_defaults[] = {
676  { "b", "0" },
677  { "bf", "-1" },
678  { "g", "-1" },
679  { "keyint_min", "-1" },
680  { "refs", "-1" },
681  { "qmin", "-1" },
682  { "qmax", "-1" },
683  { "qdiff", "-1" },
684  { "qblur", "-1" },
685  { "qcomp", "-1" },
686  { "i_qfactor", "-1" },
687  { "b_qfactor", "-1" },
688  { NULL },
689 };
690 
692  .name = "libx265",
693  .long_name = NULL_IF_CONFIG_SMALL("libx265 H.265 / HEVC"),
694  .type = AVMEDIA_TYPE_VIDEO,
695  .id = AV_CODEC_ID_HEVC,
696  .init = libx265_encode_init,
697  .init_static_data = libx265_encode_init_csp,
698  .encode2 = libx265_encode_frame,
699  .close = libx265_encode_close,
700  .priv_data_size = sizeof(libx265Context),
701  .priv_class = &class,
702  .defaults = x265_defaults,
705  .wrapper_name = "libx265",
706 };
char * profile
Definition: libx265.c:50
#define NULL
Definition: coverity.c:32
static const AVOption options[]
Definition: libx265.c:657
AVRational framerate
Definition: avcodec.h:2069
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
int top
Distance in pixels from the top edge of the frame to the top and bottom edges and from the left edge ...
Definition: frame.h:248
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2573
This structure describes decoded (raw) audio or video data.
Definition: frame.h:308
AVOption.
Definition: opt.h:248
int ff_side_data_set_encoder_stats(AVPacket *pkt, int quality, int64_t *error, int error_count, int pict_type)
Definition: avpacket.c:796
static int is_keyframe(NalUnitType naltype)
Definition: libx265.c:60
float qblur
amount of qscale smoothing over time (0.0-1.0)
Definition: avcodec.h:1361
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
Definition: pixfmt.h:71
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:200
int64_t bit_rate
the average bitrate
Definition: avcodec.h:576
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
float crf
Definition: libx265.c:45
int max_bitrate
Maximum bitrate of the stream, in bits per second.
Definition: avcodec.h:454
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:786
int rc_initial_buffer_occupancy
Number of bits which should be loaded into the rc buffer before decoding starts.
Definition: avcodec.h:1432
AVDictionary * x265_opts
Definition: libx265.c:51
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
Definition: pixfmt.h:473
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:1161
planar GBR 4:4:4 24bpp
Definition: pixfmt.h:168
int num
Numerator.
Definition: rational.h:59
#define AV_PIX_FMT_GBRP10
Definition: pixfmt.h:415
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:235
int forced_idr
Definition: libx265.c:47
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:905
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:736
GLint GLenum type
Definition: opengl_enc.c:104
x265_param * params
Definition: libx265.c:42
#define AV_PIX_FMT_YUV420P12
Definition: pixfmt.h:403
const char * key
static AVPacket pkt
#define AV_CODEC_CAP_AUTO_THREADS
Codec supports avctx->thread_count == 0 (auto).
Definition: codec.h:118
AVCodec.
Definition: codec.h:190
order of coefficients is actually GBR, also IEC 61966-2-1 (sRGB)
Definition: pixfmt.h:513
#define AV_PKT_FLAG_DISPOSABLE
Flag is used to indicate packets that contain frames that can be discarded by the decoder...
Definition: packet.h:420
AVRational qoffset
Quantisation offset.
Definition: frame.h:275
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented...
Definition: avcodec.h:649
#define AV_PIX_FMT_GRAY10
Definition: pixfmt.h:380
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:751
#define AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE
This codec takes the reordered_opaque field from input AVFrames and returns it in the corresponding f...
Definition: codec.h:164
#define AV_PIX_FMT_GRAY12
Definition: pixfmt.h:381
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:72
#define AV_CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
Definition: codec.h:75
int ff_alloc_packet2(AVCodecContext *avctx, AVPacket *avpkt, int64_t size, int64_t min_size)
Check AVPacket size and/or allocate data.
Definition: encode.c:33
AVComponentDescriptor comp[4]
Parameters that describe how pixels are packed.
Definition: pixdesc.h:117
uint8_t
#define av_cold
Definition: attributes.h:88
#define av_malloc(s)
AVOptions.
#define VE
Definition: libx265.c:656
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:795
GLsizei GLboolean const GLfloat * value
Definition: opengl_enc.c:108
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:401
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:627
Structure to hold side data for an AVFrame.
Definition: frame.h:214
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
Definition: dict.c:40
uint8_t * data
Definition: packet.h:363
planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV422P and setting col...
Definition: pixfmt.h:79
int buffer_size
The size of the buffer to which the ratecontrol is applied, in bits.
Definition: avcodec.h:481
int av_reduce(int *dst_num, int *dst_den, int64_t num, int64_t den, int64_t max)
Reduce a fraction.
Definition: rational.c:35
uint32_t self_size
Must be set to the size of this data structure (that is, sizeof(AVRegionOfInterest)).
Definition: frame.h:238
#define AV_PIX_FMT_YUV422P12
Definition: pixfmt.h:404
#define av_log(a,...)
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: packet.h:401
int width
Definition: frame.h:366
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:194
const x265_api * api
Definition: libx265.c:43
static int libx265_encode_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *pic, int *got_packet)
Definition: libx265.c:474
int qmax
maximum quantizer
Definition: avcodec.h:1375
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:153
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:606
const char * name
Name of the codec implementation.
Definition: codec.h:197
float i_quant_factor
qscale factor between P- and I-frames If > 0 then the last P-frame quantizer will be used (q = lastp_...
Definition: avcodec.h:831
#define AV_PIX_FMT_YUV444P10
Definition: pixfmt.h:402
static const AVCodecDefault defaults[]
Definition: amfenc_h264.c:361
int flags
A combination of AV_PKT_FLAG values.
Definition: packet.h:369
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Definition: pixfmt.h:70
int rc_buffer_size
decoder bitstream buffer size
Definition: avcodec.h:1389
common internal API header
int refs
number of reference frames
Definition: avcodec.h:1114
static av_cold void libx265_encode_init_csp(AVCodec *codec)
Definition: libx265.c:645
enum AVPixelFormat * pix_fmts
array of supported pixel formats, or NULL if unknown, array is terminated by -1
Definition: codec.h:211
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:391
#define FFMIN(a, b)
Definition: common.h:96
AVCodec ff_libx265_encoder
Definition: libx265.c:691
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
Definition: pixfmt.h:78
static av_cold int libx265_encode_init(AVCodecContext *avctx)
Definition: libx265.c:117
int width
picture width / height.
Definition: avcodec.h:699
AVFormatContext * ctx
Definition: movenc.c:48
#define AV_CODEC_FLAG_PSNR
error[?] variables will be set during encoding.
Definition: avcodec.h:312
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
Definition: avcodec.h:1140
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Structure describing a single Region Of Interest.
Definition: frame.h:233
int64_t reordered_opaque
opaque 64-bit number (generally a PTS) that will be reordered and output in AVFrame.reordered_opaque
Definition: avcodec.h:1683
int ticks_per_frame
For some codecs, the time base is closer to the field rate than the frame rate.
Definition: avcodec.h:658
static av_cold int libx265_encode_set_roi(libx265Context *ctx, const AVFrame *frame, x265_picture *pic)
Definition: libx265.c:410
#define OFFSET(x)
Definition: libx265.c:655
int max_qdiff
maximum quantizer difference between frames
Definition: avcodec.h:1382
int thread_count
thread count is used to decide how many independent tasks should be passed to execute() ...
Definition: avcodec.h:1785
Full range content.
Definition: pixfmt.h:586
if(ret)
char * preset
Definition: libx265.c:48
This structure describes the bitrate properties of an encoded bitstream.
Definition: avcodec.h:448
ITU-R BT.2100-0, ICtCp.
Definition: pixfmt.h:528
#define AV_LOG_INFO
Standard information.
Definition: log.h:205
Libavcodec external API header.
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:339
main external API structure.
Definition: avcodec.h:526
int qmin
minimum quantizer
Definition: avcodec.h:1368
uint8_t * data
Definition: frame.h:216
int extradata_size
Definition: avcodec.h:628
#define AV_PIX_FMT_YUV420P10
Definition: pixfmt.h:399
int64_t reordered_opaque
reordered opaque 64 bits (generally an integer or a double precision float PTS but can be anything)...
Definition: frame.h:475
Describe the class of an AVClass context structure.
Definition: log.h:67
enum AVColorSpace colorspace
YUV colorspace type.
Definition: avcodec.h:1154
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:1147
static enum AVPixelFormat x265_csp_ten[]
Definition: libx265.c:606
Regions Of Interest, the data is an array of AVRegionOfInterest type, the number of array element is ...
Definition: frame.h:181
int roi_warned
If the encoder does not support ROI then warn the first time we encounter a frame with ROI side data...
Definition: libx265.c:57
#define snprintf
Definition: snprintf.h:34
float qcompress
amount of qscale change between easy & hard scenes (0.0-1.0)
Definition: avcodec.h:1360
char * tune
Definition: libx265.c:49
#define AV_PIX_FMT_GBRP12
Definition: pixfmt.h:416
#define AV_PIX_FMT_YUV422P10
Definition: pixfmt.h:400
#define AV_PIX_FMT_YUV444P12
Definition: pixfmt.h:406
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:322
#define AV_CODEC_FLAG_GLOBAL_HEADER
Place global headers in extradata instead of every keyframe.
Definition: avcodec.h:329
int gop_size
the number of pictures in a group of pictures, or 0 for intra_only
Definition: avcodec.h:721
preset
Definition: vf_curves.c:46
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:66
Y , 8bpp.
Definition: pixfmt.h:74
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:84
common internal api header.
common internal and external API header
static enum AVPixelFormat x265_csp_twelve[]
Definition: libx265.c:623
Bi-dir predicted.
Definition: avutil.h:276
planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV444P and setting col...
Definition: pixfmt.h:80
attribute_deprecated AVFrame * coded_frame
the picture in the bitstream
Definition: avcodec.h:1776
char * key
Definition: dict.h:86
int den
Denominator.
Definition: rational.h:60
AVCPBProperties * ff_add_cpb_side_data(AVCodecContext *avctx)
Add a CPB properties side data to an encoding context.
Definition: utils.c:2010
#define AV_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding...
Definition: avcodec.h:215
ARIB STD-B67, known as "Hybrid log-gamma".
Definition: pixfmt.h:504
void * priv_data
Definition: avcodec.h:553
static const AVCodecDefault x265_defaults[]
Definition: libx265.c:675
#define av_free(p)
char * value
Definition: dict.h:87
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:85
int avg_bitrate
Average bitrate of the stream, in bits per second.
Definition: avcodec.h:472
static av_cold int libx265_param_parse_float(AVCodecContext *avctx, const char *key, float value)
Definition: libx265.c:87
#define FF_QP2LAMBDA
factor to convert from H.263 QP to lambda
Definition: avutil.h:227
static av_cold int libx265_param_parse_int(AVCodecContext *avctx, const char *key, int value)
Definition: libx265.c:102
static av_cold int libx265_encode_close(AVCodecContext *avctx)
Definition: libx265.c:75
static enum AVPixelFormat x265_csp_eight[]
Definition: libx265.c:594
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed...
Definition: packet.h:362
int height
Definition: frame.h:366
#define av_freep(p)
#define AV_DICT_IGNORE_SUFFIX
Return first entry in a dictionary whose first part corresponds to the search key, ignoring the suffix of the found key string.
Definition: dict.h:70
#define AV_CODEC_FLAG_CLOSED_GOP
Definition: avcodec.h:343
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later.That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another.Frame references ownership and permissions
int depth
Number of bits in the component.
Definition: pixdesc.h:58
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition: error.h:57
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
This structure stores compressed data.
Definition: packet.h:340
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: packet.h:356
int i
Definition: input.c:407
Predicted.
Definition: avutil.h:275
int64_t rc_max_rate
maximum bitrate
Definition: avcodec.h:1404
void * av_mallocz_array(size_t nmemb, size_t size)
Definition: mem.c:190
int keyint_min
minimum GOP size
Definition: avcodec.h:1107
x265_encoder * encoder
Definition: libx265.c:41