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 
37 typedef struct libx265Context {
38  const AVClass *class;
39 
40  x265_encoder *encoder;
41  x265_param *params;
42  const x265_api *api;
43 
44  float crf;
45  int cqp;
47  char *preset;
48  char *tune;
49  char *profile;
51 
52  /**
53  * If the encoder does not support ROI then warn the first time we
54  * encounter a frame with ROI side data.
55  */
58 
59 static int is_keyframe(NalUnitType naltype)
60 {
61  switch (naltype) {
62  case NAL_UNIT_CODED_SLICE_BLA_W_LP:
63  case NAL_UNIT_CODED_SLICE_BLA_W_RADL:
64  case NAL_UNIT_CODED_SLICE_BLA_N_LP:
65  case NAL_UNIT_CODED_SLICE_IDR_W_RADL:
66  case NAL_UNIT_CODED_SLICE_IDR_N_LP:
67  case NAL_UNIT_CODED_SLICE_CRA:
68  return 1;
69  default:
70  return 0;
71  }
72 }
73 
75 {
76  libx265Context *ctx = avctx->priv_data;
77 
78  ctx->api->param_free(ctx->params);
79 
80  if (ctx->encoder)
81  ctx->api->encoder_close(ctx->encoder);
82 
83  return 0;
84 }
85 
87  const char *key, float value)
88 {
89  libx265Context *ctx = avctx->priv_data;
90  char buf[256];
91 
92  snprintf(buf, sizeof(buf), "%2.2f", value);
93  if (ctx->api->param_parse(ctx->params, key, buf) == X265_PARAM_BAD_VALUE) {
94  av_log(avctx, AV_LOG_ERROR, "Invalid value %2.2f for param \"%s\".\n", value, key);
95  return AVERROR(EINVAL);
96  }
97 
98  return 0;
99 }
100 
102  const char *key, int value)
103 {
104  libx265Context *ctx = avctx->priv_data;
105  char buf[256];
106 
107  snprintf(buf, sizeof(buf), "%d", value);
108  if (ctx->api->param_parse(ctx->params, key, buf) == X265_PARAM_BAD_VALUE) {
109  av_log(avctx, AV_LOG_ERROR, "Invalid value %d for param \"%s\".\n", value, key);
110  return AVERROR(EINVAL);
111  }
112 
113  return 0;
114 }
115 
117 {
118  libx265Context *ctx = avctx->priv_data;
119  AVCPBProperties *cpb_props = NULL;
120  int ret;
121 
122  ctx->api = x265_api_get(av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth);
123  if (!ctx->api)
124  ctx->api = x265_api_get(0);
125 
126  ctx->params = ctx->api->param_alloc();
127  if (!ctx->params) {
128  av_log(avctx, AV_LOG_ERROR, "Could not allocate x265 param structure.\n");
129  return AVERROR(ENOMEM);
130  }
131 
132  if (ctx->api->param_default_preset(ctx->params, ctx->preset, ctx->tune) < 0) {
133  int i;
134 
135  av_log(avctx, AV_LOG_ERROR, "Error setting preset/tune %s/%s.\n", ctx->preset, ctx->tune);
136  av_log(avctx, AV_LOG_INFO, "Possible presets:");
137  for (i = 0; x265_preset_names[i]; i++)
138  av_log(avctx, AV_LOG_INFO, " %s", x265_preset_names[i]);
139 
140  av_log(avctx, AV_LOG_INFO, "\n");
141  av_log(avctx, AV_LOG_INFO, "Possible tunes:");
142  for (i = 0; x265_tune_names[i]; i++)
143  av_log(avctx, AV_LOG_INFO, " %s", x265_tune_names[i]);
144 
145  av_log(avctx, AV_LOG_INFO, "\n");
146 
147  return AVERROR(EINVAL);
148  }
149 
150  ctx->params->frameNumThreads = avctx->thread_count;
151  if (avctx->framerate.num > 0 && avctx->framerate.den > 0) {
152  ctx->params->fpsNum = avctx->framerate.num;
153  ctx->params->fpsDenom = avctx->framerate.den;
154  } else {
155  ctx->params->fpsNum = avctx->time_base.den;
156  ctx->params->fpsDenom = avctx->time_base.num * avctx->ticks_per_frame;
157  }
158  ctx->params->sourceWidth = avctx->width;
159  ctx->params->sourceHeight = avctx->height;
160  ctx->params->bEnablePsnr = !!(avctx->flags & AV_CODEC_FLAG_PSNR);
161  ctx->params->bOpenGOP = !(avctx->flags & AV_CODEC_FLAG_CLOSED_GOP);
162 
163  /* Tune the CTU size based on input resolution. */
164  if (ctx->params->sourceWidth < 64 || ctx->params->sourceHeight < 64)
165  ctx->params->maxCUSize = 32;
166  if (ctx->params->sourceWidth < 32 || ctx->params->sourceHeight < 32)
167  ctx->params->maxCUSize = 16;
168  if (ctx->params->sourceWidth < 16 || ctx->params->sourceHeight < 16) {
169  av_log(avctx, AV_LOG_ERROR, "Image size is too small (%dx%d).\n",
170  ctx->params->sourceWidth, ctx->params->sourceHeight);
171  return AVERROR(EINVAL);
172  }
173 
174 
175  ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
176 
177  ctx->params->vui.bEnableVideoFullRangeFlag = avctx->pix_fmt == AV_PIX_FMT_YUVJ420P ||
178  avctx->pix_fmt == AV_PIX_FMT_YUVJ422P ||
179  avctx->pix_fmt == AV_PIX_FMT_YUVJ444P ||
180  avctx->color_range == AVCOL_RANGE_JPEG;
181 
182  if ((avctx->color_primaries <= AVCOL_PRI_SMPTE432 &&
184  (avctx->color_trc <= AVCOL_TRC_ARIB_STD_B67 &&
185  avctx->color_trc != AVCOL_TRC_UNSPECIFIED) ||
186  (avctx->colorspace <= AVCOL_SPC_ICTCP &&
187  avctx->colorspace != AVCOL_SPC_UNSPECIFIED)) {
188 
189  ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
190 
191  // x265 validates the parameters internally
192  ctx->params->vui.colorPrimaries = avctx->color_primaries;
193  ctx->params->vui.transferCharacteristics = avctx->color_trc;
194 #if X265_BUILD >= 159
195  if (avctx->color_trc == AVCOL_TRC_ARIB_STD_B67)
196  ctx->params->preferredTransferCharacteristics = ctx->params->vui.transferCharacteristics;
197 #endif
198  ctx->params->vui.matrixCoeffs = avctx->colorspace;
199  }
200 
201  if (avctx->sample_aspect_ratio.num > 0 && avctx->sample_aspect_ratio.den > 0) {
202  char sar[12];
203  int sar_num, sar_den;
204 
205  av_reduce(&sar_num, &sar_den,
206  avctx->sample_aspect_ratio.num,
207  avctx->sample_aspect_ratio.den, 65535);
208  snprintf(sar, sizeof(sar), "%d:%d", sar_num, sar_den);
209  if (ctx->api->param_parse(ctx->params, "sar", sar) == X265_PARAM_BAD_VALUE) {
210  av_log(avctx, AV_LOG_ERROR, "Invalid SAR: %d:%d.\n", sar_num, sar_den);
211  return AVERROR_INVALIDDATA;
212  }
213  }
214 
215  switch (avctx->pix_fmt) {
216  case AV_PIX_FMT_YUV420P:
219  ctx->params->internalCsp = X265_CSP_I420;
220  break;
221  case AV_PIX_FMT_YUV422P:
224  ctx->params->internalCsp = X265_CSP_I422;
225  break;
226  case AV_PIX_FMT_GBRP:
227  case AV_PIX_FMT_GBRP10:
228  case AV_PIX_FMT_GBRP12:
229  ctx->params->vui.matrixCoeffs = AVCOL_SPC_RGB;
230  ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
231  ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
232  case AV_PIX_FMT_YUV444P:
235  ctx->params->internalCsp = X265_CSP_I444;
236  break;
237  case AV_PIX_FMT_GRAY8:
238  case AV_PIX_FMT_GRAY10:
239  case AV_PIX_FMT_GRAY12:
240  if (ctx->api->api_build_number < 85) {
241  av_log(avctx, AV_LOG_ERROR,
242  "libx265 version is %d, must be at least 85 for gray encoding.\n",
243  ctx->api->api_build_number);
244  return AVERROR_INVALIDDATA;
245  }
246  ctx->params->internalCsp = X265_CSP_I400;
247  break;
248  }
249 
250  if (ctx->crf >= 0) {
251  char crf[6];
252 
253  snprintf(crf, sizeof(crf), "%2.2f", ctx->crf);
254  if (ctx->api->param_parse(ctx->params, "crf", crf) == X265_PARAM_BAD_VALUE) {
255  av_log(avctx, AV_LOG_ERROR, "Invalid crf: %2.2f.\n", ctx->crf);
256  return AVERROR(EINVAL);
257  }
258  } else if (avctx->bit_rate > 0) {
259  ctx->params->rc.bitrate = avctx->bit_rate / 1000;
260  ctx->params->rc.rateControlMode = X265_RC_ABR;
261  } else if (ctx->cqp >= 0) {
262  ret = libx265_param_parse_int(avctx, "qp", ctx->cqp);
263  if (ret < 0)
264  return ret;
265  }
266 
267 #if X265_BUILD >= 89
268  if (avctx->qmin >= 0) {
269  ret = libx265_param_parse_int(avctx, "qpmin", avctx->qmin);
270  if (ret < 0)
271  return ret;
272  }
273  if (avctx->qmax >= 0) {
274  ret = libx265_param_parse_int(avctx, "qpmax", avctx->qmax);
275  if (ret < 0)
276  return ret;
277  }
278 #endif
279  if (avctx->max_qdiff >= 0) {
280  ret = libx265_param_parse_int(avctx, "qpstep", avctx->max_qdiff);
281  if (ret < 0)
282  return ret;
283  }
284  if (avctx->qblur >= 0) {
285  ret = libx265_param_parse_float(avctx, "qblur", avctx->qblur);
286  if (ret < 0)
287  return ret;
288  }
289  if (avctx->qcompress >= 0) {
290  ret = libx265_param_parse_float(avctx, "qcomp", avctx->qcompress);
291  if (ret < 0)
292  return ret;
293  }
294  if (avctx->i_quant_factor >= 0) {
295  ret = libx265_param_parse_float(avctx, "ipratio", avctx->i_quant_factor);
296  if (ret < 0)
297  return ret;
298  }
299  if (avctx->b_quant_factor >= 0) {
300  ret = libx265_param_parse_float(avctx, "pbratio", avctx->b_quant_factor);
301  if (ret < 0)
302  return ret;
303  }
304 
305  ctx->params->rc.vbvBufferSize = avctx->rc_buffer_size / 1000;
306  ctx->params->rc.vbvMaxBitrate = avctx->rc_max_rate / 1000;
307 
308  cpb_props = ff_add_cpb_side_data(avctx);
309  if (!cpb_props)
310  return AVERROR(ENOMEM);
311  cpb_props->buffer_size = ctx->params->rc.vbvBufferSize * 1000;
312  cpb_props->max_bitrate = ctx->params->rc.vbvMaxBitrate * 1000;
313  cpb_props->avg_bitrate = ctx->params->rc.bitrate * 1000;
314 
315  if (!(avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER))
316  ctx->params->bRepeatHeaders = 1;
317 
318  if (avctx->gop_size >= 0) {
319  ret = libx265_param_parse_int(avctx, "keyint", avctx->gop_size);
320  if (ret < 0)
321  return ret;
322  }
323  if (avctx->keyint_min > 0) {
324  ret = libx265_param_parse_int(avctx, "min-keyint", avctx->keyint_min);
325  if (ret < 0)
326  return ret;
327  }
328  if (avctx->max_b_frames >= 0) {
329  ret = libx265_param_parse_int(avctx, "bframes", avctx->max_b_frames);
330  if (ret < 0)
331  return ret;
332  }
333  if (avctx->refs >= 0) {
334  ret = libx265_param_parse_int(avctx, "ref", avctx->refs);
335  if (ret < 0)
336  return ret;
337  }
338 
339  {
340  AVDictionaryEntry *en = NULL;
341  while ((en = av_dict_get(ctx->x265_opts, "", en, AV_DICT_IGNORE_SUFFIX))) {
342  int parse_ret = ctx->api->param_parse(ctx->params, en->key, en->value);
343 
344  switch (parse_ret) {
345  case X265_PARAM_BAD_NAME:
346  av_log(avctx, AV_LOG_WARNING,
347  "Unknown option: %s.\n", en->key);
348  break;
349  case X265_PARAM_BAD_VALUE:
350  av_log(avctx, AV_LOG_WARNING,
351  "Invalid value for %s: %s.\n", en->key, en->value);
352  break;
353  default:
354  break;
355  }
356  }
357  }
358 
359  if (ctx->params->rc.vbvBufferSize && avctx->rc_initial_buffer_occupancy > 1000 &&
360  ctx->params->rc.vbvBufferInit == 0.9) {
361  ctx->params->rc.vbvBufferInit = (float)avctx->rc_initial_buffer_occupancy / 1000;
362  }
363 
364  if (ctx->profile) {
365  if (ctx->api->param_apply_profile(ctx->params, ctx->profile) < 0) {
366  int i;
367  av_log(avctx, AV_LOG_ERROR, "Invalid or incompatible profile set: %s.\n", ctx->profile);
368  av_log(avctx, AV_LOG_INFO, "Possible profiles:");
369  for (i = 0; x265_profile_names[i]; i++)
370  av_log(avctx, AV_LOG_INFO, " %s", x265_profile_names[i]);
371  av_log(avctx, AV_LOG_INFO, "\n");
372  return AVERROR(EINVAL);
373  }
374  }
375 
376  ctx->encoder = ctx->api->encoder_open(ctx->params);
377  if (!ctx->encoder) {
378  av_log(avctx, AV_LOG_ERROR, "Cannot open libx265 encoder.\n");
379  libx265_encode_close(avctx);
380  return AVERROR_INVALIDDATA;
381  }
382 
383  if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
384  x265_nal *nal;
385  int nnal;
386 
387  avctx->extradata_size = ctx->api->encoder_headers(ctx->encoder, &nal, &nnal);
388  if (avctx->extradata_size <= 0) {
389  av_log(avctx, AV_LOG_ERROR, "Cannot encode headers.\n");
390  libx265_encode_close(avctx);
391  return AVERROR_INVALIDDATA;
392  }
393 
395  if (!avctx->extradata) {
396  av_log(avctx, AV_LOG_ERROR,
397  "Cannot allocate HEVC header of size %d.\n", avctx->extradata_size);
398  libx265_encode_close(avctx);
399  return AVERROR(ENOMEM);
400  }
401 
402  memcpy(avctx->extradata, nal[0].payload, avctx->extradata_size);
403  memset(avctx->extradata + avctx->extradata_size, 0, AV_INPUT_BUFFER_PADDING_SIZE);
404  }
405 
406  return 0;
407 }
408 
409 static av_cold int libx265_encode_set_roi(libx265Context *ctx, const AVFrame *frame, x265_picture* pic)
410 {
412  if (sd) {
413  if (ctx->params->rc.aqMode == X265_AQ_NONE) {
414  if (!ctx->roi_warned) {
415  ctx->roi_warned = 1;
416  av_log(ctx, AV_LOG_WARNING, "Adaptive quantization must be enabled to use ROI encoding, skipping ROI.\n");
417  }
418  } else {
419  /* 8x8 block when qg-size is 8, 16*16 block otherwise. */
420  int mb_size = (ctx->params->rc.qgSize == 8) ? 8 : 16;
421  int mbx = (frame->width + mb_size - 1) / mb_size;
422  int mby = (frame->height + mb_size - 1) / mb_size;
423  int qp_range = 51 + 6 * (pic->bitDepth - 8);
424  int nb_rois;
425  const AVRegionOfInterest *roi;
426  uint32_t roi_size;
427  float *qoffsets; /* will be freed after encode is called. */
428 
429  roi = (const AVRegionOfInterest*)sd->data;
430  roi_size = roi->self_size;
431  if (!roi_size || sd->size % roi_size != 0) {
432  av_log(ctx, AV_LOG_ERROR, "Invalid AVRegionOfInterest.self_size.\n");
433  return AVERROR(EINVAL);
434  }
435  nb_rois = sd->size / roi_size;
436 
437  qoffsets = av_mallocz_array(mbx * mby, sizeof(*qoffsets));
438  if (!qoffsets)
439  return AVERROR(ENOMEM);
440 
441  // This list must be iterated in reverse because the first
442  // region in the list applies when regions overlap.
443  for (int i = nb_rois - 1; i >= 0; i--) {
444  int startx, endx, starty, endy;
445  float qoffset;
446 
447  roi = (const AVRegionOfInterest*)(sd->data + roi_size * i);
448 
449  starty = FFMIN(mby, roi->top / mb_size);
450  endy = FFMIN(mby, (roi->bottom + mb_size - 1)/ mb_size);
451  startx = FFMIN(mbx, roi->left / mb_size);
452  endx = FFMIN(mbx, (roi->right + mb_size - 1)/ mb_size);
453 
454  if (roi->qoffset.den == 0) {
455  av_free(qoffsets);
456  av_log(ctx, AV_LOG_ERROR, "AVRegionOfInterest.qoffset.den must not be zero.\n");
457  return AVERROR(EINVAL);
458  }
459  qoffset = roi->qoffset.num * 1.0f / roi->qoffset.den;
460  qoffset = av_clipf(qoffset * qp_range, -qp_range, +qp_range);
461 
462  for (int y = starty; y < endy; y++)
463  for (int x = startx; x < endx; x++)
464  qoffsets[x + y*mbx] = qoffset;
465  }
466 
467  pic->quantOffsets = qoffsets;
468  }
469  }
470  return 0;
471 }
472 
474  const AVFrame *pic, int *got_packet)
475 {
476  libx265Context *ctx = avctx->priv_data;
477  x265_picture x265pic;
478  x265_picture x265pic_out = { 0 };
479  x265_nal *nal;
480  uint8_t *dst;
481  int pict_type;
482  int payload = 0;
483  int nnal;
484  int ret;
485  int i;
486 
487  ctx->api->picture_init(ctx->params, &x265pic);
488 
489  if (pic) {
490  for (i = 0; i < 3; i++) {
491  x265pic.planes[i] = pic->data[i];
492  x265pic.stride[i] = pic->linesize[i];
493  }
494 
495  x265pic.pts = pic->pts;
496  x265pic.bitDepth = av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth;
497 
498  x265pic.sliceType = pic->pict_type == AV_PICTURE_TYPE_I ?
499  (ctx->forced_idr ? X265_TYPE_IDR : X265_TYPE_I) :
500  pic->pict_type == AV_PICTURE_TYPE_P ? X265_TYPE_P :
501  pic->pict_type == AV_PICTURE_TYPE_B ? X265_TYPE_B :
502  X265_TYPE_AUTO;
503 
504  ret = libx265_encode_set_roi(ctx, pic, &x265pic);
505  if (ret < 0)
506  return ret;
507  }
508 
509  ret = ctx->api->encoder_encode(ctx->encoder, &nal, &nnal,
510  pic ? &x265pic : NULL, &x265pic_out);
511 
512  av_freep(&x265pic.quantOffsets);
513 
514  if (ret < 0)
515  return AVERROR_EXTERNAL;
516 
517  if (!nnal)
518  return 0;
519 
520  for (i = 0; i < nnal; i++)
521  payload += nal[i].sizeBytes;
522 
523  ret = ff_alloc_packet2(avctx, pkt, payload, payload);
524  if (ret < 0) {
525  av_log(avctx, AV_LOG_ERROR, "Error getting output packet.\n");
526  return ret;
527  }
528  dst = pkt->data;
529 
530  for (i = 0; i < nnal; i++) {
531  memcpy(dst, nal[i].payload, nal[i].sizeBytes);
532  dst += nal[i].sizeBytes;
533 
534  if (is_keyframe(nal[i].type))
535  pkt->flags |= AV_PKT_FLAG_KEY;
536  }
537 
538  pkt->pts = x265pic_out.pts;
539  pkt->dts = x265pic_out.dts;
540 
541  switch (x265pic_out.sliceType) {
542  case X265_TYPE_IDR:
543  case X265_TYPE_I:
544  pict_type = AV_PICTURE_TYPE_I;
545  break;
546  case X265_TYPE_P:
547  pict_type = AV_PICTURE_TYPE_P;
548  break;
549  case X265_TYPE_B:
550  case X265_TYPE_BREF:
551  pict_type = AV_PICTURE_TYPE_B;
552  break;
553  }
554 
555 #if FF_API_CODED_FRAME
557  avctx->coded_frame->pict_type = pict_type;
559 #endif
560 
561 #if X265_BUILD >= 130
562  if (x265pic_out.sliceType == X265_TYPE_B)
563 #else
564  if (x265pic_out.frameData.sliceType == 'b')
565 #endif
567 
568  ff_side_data_set_encoder_stats(pkt, x265pic_out.frameData.qp * FF_QP2LAMBDA, NULL, 0, pict_type);
569 
570  *got_packet = 1;
571  return 0;
572 }
573 
574 static const enum AVPixelFormat x265_csp_eight[] = {
584 };
585 
586 static const enum AVPixelFormat x265_csp_ten[] = {
601 };
602 
603 static const enum AVPixelFormat x265_csp_twelve[] = {
623 };
624 
626 {
627  if (x265_api_get(12))
628  codec->pix_fmts = x265_csp_twelve;
629  else if (x265_api_get(10))
630  codec->pix_fmts = x265_csp_ten;
631  else if (x265_api_get(8))
632  codec->pix_fmts = x265_csp_eight;
633 }
634 
635 #define OFFSET(x) offsetof(libx265Context, x)
636 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
637 static const AVOption options[] = {
638  { "crf", "set the x265 crf", OFFSET(crf), AV_OPT_TYPE_FLOAT, { .dbl = -1 }, -1, FLT_MAX, VE },
639  { "qp", "set the x265 qp", OFFSET(cqp), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, VE },
640  { "forced-idr", "if forcing keyframes, force them as IDR frames", OFFSET(forced_idr),AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, VE },
641  { "preset", "set the x265 preset", OFFSET(preset), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
642  { "tune", "set the x265 tune parameter", OFFSET(tune), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
643  { "profile", "set the x265 profile", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
644  { "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 },
645  { NULL }
646 };
647 
648 static const AVClass class = {
649  .class_name = "libx265",
650  .item_name = av_default_item_name,
651  .option = options,
653 };
654 
655 static const AVCodecDefault x265_defaults[] = {
656  { "b", "0" },
657  { "bf", "-1" },
658  { "g", "-1" },
659  { "keyint_min", "-1" },
660  { "refs", "-1" },
661  { "qmin", "-1" },
662  { "qmax", "-1" },
663  { "qdiff", "-1" },
664  { "qblur", "-1" },
665  { "qcomp", "-1" },
666  { "i_qfactor", "-1" },
667  { "b_qfactor", "-1" },
668  { NULL },
669 };
670 
672  .name = "libx265",
673  .long_name = NULL_IF_CONFIG_SMALL("libx265 H.265 / HEVC"),
674  .type = AVMEDIA_TYPE_VIDEO,
675  .id = AV_CODEC_ID_HEVC,
676  .init = libx265_encode_init,
677  .init_static_data = libx265_encode_init_csp,
678  .encode2 = libx265_encode_frame,
679  .close = libx265_encode_close,
680  .priv_data_size = sizeof(libx265Context),
681  .priv_class = &class,
682  .defaults = x265_defaults,
684  .wrapper_name = "libx265",
685 };
char * profile
Definition: libx265.c:49
#define NULL
Definition: coverity.c:32
static const AVOption options[]
Definition: libx265.c:637
AVRational framerate
Definition: avcodec.h:3161
#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:235
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2549
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
AVOption.
Definition: opt.h:246
int ff_side_data_set_encoder_stats(AVPacket *pkt, int quality, int64_t *error, int error_count, int pict_type)
Definition: avpacket.c:723
static int is_keyframe(NalUnitType naltype)
Definition: libx265.c:59
float qblur
amount of qscale smoothing over time (0.0-1.0)
Definition: avcodec.h:2456
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:182
int64_t bit_rate
the average bitrate
Definition: avcodec.h:1671
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
float crf
Definition: libx265.c:44
int max_bitrate
Maximum bitrate of the stream, in bits per second.
Definition: avcodec.h:1164
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:1881
int rc_initial_buffer_occupancy
Number of bits which should be loaded into the rc buffer before decoding starts.
Definition: avcodec.h:2527
AVDictionary * x265_opts
Definition: libx265.c:50
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
Definition: pixfmt.h:470
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:2256
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:413
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:235
int forced_idr
Definition: libx265.c:46
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:2000
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:1831
GLint GLenum type
Definition: opengl_enc.c:104
x265_param * params
Definition: libx265.c:41
#define AV_PIX_FMT_YUV420P12
Definition: pixfmt.h:401
const char * key
static AVPacket pkt
#define AV_CODEC_CAP_AUTO_THREADS
Codec supports avctx->thread_count == 0 (auto).
Definition: avcodec.h:1067
AVCodec.
Definition: avcodec.h:3555
order of coefficients is actually GBR, also IEC 61966-2-1 (sRGB)
Definition: pixfmt.h:510
#define AV_PKT_FLAG_DISPOSABLE
Flag is used to indicate packets that contain frames that can be discarded by the decoder...
Definition: avcodec.h:1584
AVRational qoffset
Quantisation offset.
Definition: frame.h:262
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented...
Definition: avcodec.h:1744
#define AV_PIX_FMT_GRAY10
Definition: pixfmt.h:378
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:739
#define AV_PIX_FMT_GRAY12
Definition: pixfmt.h:379
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: avcodec.h:1024
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:32
AVComponentDescriptor comp[4]
Parameters that describe how pixels are packed.
Definition: pixdesc.h:117
uint8_t
#define av_cold
Definition: attributes.h:82
#define av_malloc(s)
AVOptions.
#define VE
Definition: libx265.c:636
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:1890
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:388
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1722
Structure to hold side data for an AVFrame.
Definition: frame.h:201
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: avcodec.h:1533
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:1191
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:225
#define AV_PIX_FMT_YUV422P12
Definition: pixfmt.h:402
#define av_log(a,...)
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: avcodec.h:1565
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:259
int width
Definition: frame.h:353
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
const x265_api * api
Definition: libx265.c:42
static int libx265_encode_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *pic, int *got_packet)
Definition: libx265.c:473
int qmax
maximum quantizer
Definition: avcodec.h:2470
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:1701
const char * name
Name of the codec implementation.
Definition: avcodec.h:3562
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:1926
#define AV_PIX_FMT_YUV444P10
Definition: pixfmt.h:400
static const AVCodecDefault defaults[]
Definition: amfenc_h264.c:361
int flags
A combination of AV_PKT_FLAG values.
Definition: avcodec.h:1539
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:2484
common internal API header
int refs
number of reference frames
Definition: avcodec.h:2209
static av_cold void libx265_encode_init_csp(AVCodec *codec)
Definition: libx265.c:625
enum AVPixelFormat * pix_fmts
array of supported pixel formats, or NULL if unknown, array is terminated by -1
Definition: avcodec.h:3576
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:378
#define FFMIN(a, b)
Definition: common.h:96
AVCodec ff_libx265_encoder
Definition: libx265.c:671
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:116
int width
picture width / height.
Definition: avcodec.h:1794
AVFormatContext * ctx
Definition: movenc.c:48
#define AV_CODEC_FLAG_PSNR
error[?] variables will be set during encoding.
Definition: avcodec.h:905
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
Definition: avcodec.h:2235
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:220
int ticks_per_frame
For some codecs, the time base is closer to the field rate than the frame rate.
Definition: avcodec.h:1753
static av_cold int libx265_encode_set_roi(libx265Context *ctx, const AVFrame *frame, x265_picture *pic)
Definition: libx265.c:409
#define OFFSET(x)
Definition: libx265.c:635
int max_qdiff
maximum quantizer difference between frames
Definition: avcodec.h:2477
int thread_count
thread count is used to decide how many independent tasks should be passed to execute() ...
Definition: avcodec.h:2880
the normal 2^n-1 "JPEG" YUV ranges
Definition: pixfmt.h:535
if(ret)
char * preset
Definition: libx265.c:47
This structure describes the bitrate properties of an encoded bitstream.
Definition: avcodec.h:1158
ITU-R BT.2100-0, ICtCp.
Definition: pixfmt.h:525
#define AV_LOG_INFO
Standard information.
Definition: log.h:187
Libavcodec external API header.
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:326
main external API structure.
Definition: avcodec.h:1621
int qmin
minimum quantizer
Definition: avcodec.h:2463
uint8_t * data
Definition: frame.h:203
void * buf
Definition: avisynth_c.h:766
int extradata_size
Definition: avcodec.h:1723
#define AV_PIX_FMT_YUV420P10
Definition: pixfmt.h:397
Describe the class of an AVClass context structure.
Definition: log.h:67
enum AVColorSpace colorspace
YUV colorspace type.
Definition: avcodec.h:2249
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:2242
static enum AVPixelFormat x265_csp_ten[]
Definition: libx265.c:586
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:56
#define snprintf
Definition: snprintf.h:34
float qcompress
amount of qscale change between easy & hard scenes (0.0-1.0)
Definition: avcodec.h:2455
char * tune
Definition: libx265.c:48
#define AV_PIX_FMT_GBRP12
Definition: pixfmt.h:414
#define AV_PIX_FMT_YUV422P10
Definition: pixfmt.h:398
#define AV_PIX_FMT_YUV444P12
Definition: pixfmt.h:404
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:309
#define AV_CODEC_FLAG_GLOBAL_HEADER
Place global headers in extradata instead of every keyframe.
Definition: avcodec.h:922
int gop_size
the number of pictures in a group of pictures, or 0 for intra_only
Definition: avcodec.h:1816
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:603
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:2871
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:1979
#define AV_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding...
Definition: avcodec.h:808
ARIB STD-B67, known as "Hybrid log-gamma".
Definition: pixfmt.h:501
void * priv_data
Definition: avcodec.h:1648
static const AVCodecDefault x265_defaults[]
Definition: libx265.c:655
#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:1182
static av_cold int libx265_param_parse_float(AVCodecContext *avctx, const char *key, float value)
Definition: libx265.c:86
#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:101
static av_cold int libx265_encode_close(AVCodecContext *avctx)
Definition: libx265.c:74
static enum AVPixelFormat x265_csp_eight[]
Definition: libx265.c:574
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed...
Definition: avcodec.h:1532
int height
Definition: frame.h:353
#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:936
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: avcodec.h:1510
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: avcodec.h:1526
Predicted.
Definition: avutil.h:275
int64_t rc_max_rate
maximum bitrate
Definition: avcodec.h:2499
void * av_mallocz_array(size_t nmemb, size_t size)
Definition: mem.c:191
int keyint_min
minimum GOP size
Definition: avcodec.h:2202
x265_encoder * encoder
Definition: libx265.c:40