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;
46  char *preset;
47  char *tune;
48  char *profile;
49  char *x265_opts;
51 
52 static int is_keyframe(NalUnitType naltype)
53 {
54  switch (naltype) {
55  case NAL_UNIT_CODED_SLICE_BLA_W_LP:
56  case NAL_UNIT_CODED_SLICE_BLA_W_RADL:
57  case NAL_UNIT_CODED_SLICE_BLA_N_LP:
58  case NAL_UNIT_CODED_SLICE_IDR_W_RADL:
59  case NAL_UNIT_CODED_SLICE_IDR_N_LP:
60  case NAL_UNIT_CODED_SLICE_CRA:
61  return 1;
62  default:
63  return 0;
64  }
65 }
66 
68 {
69  libx265Context *ctx = avctx->priv_data;
70 
71  ctx->api->param_free(ctx->params);
72 
73  if (ctx->encoder)
74  ctx->api->encoder_close(ctx->encoder);
75 
76  return 0;
77 }
78 
80 {
81  libx265Context *ctx = avctx->priv_data;
82  AVCPBProperties *cpb_props = NULL;
83 
84  ctx->api = x265_api_get(av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth);
85  if (!ctx->api)
86  ctx->api = x265_api_get(0);
87 
88  ctx->params = ctx->api->param_alloc();
89  if (!ctx->params) {
90  av_log(avctx, AV_LOG_ERROR, "Could not allocate x265 param structure.\n");
91  return AVERROR(ENOMEM);
92  }
93 
94  if (ctx->api->param_default_preset(ctx->params, ctx->preset, ctx->tune) < 0) {
95  int i;
96 
97  av_log(avctx, AV_LOG_ERROR, "Error setting preset/tune %s/%s.\n", ctx->preset, ctx->tune);
98  av_log(avctx, AV_LOG_INFO, "Possible presets:");
99  for (i = 0; x265_preset_names[i]; i++)
100  av_log(avctx, AV_LOG_INFO, " %s", x265_preset_names[i]);
101 
102  av_log(avctx, AV_LOG_INFO, "\n");
103  av_log(avctx, AV_LOG_INFO, "Possible tunes:");
104  for (i = 0; x265_tune_names[i]; i++)
105  av_log(avctx, AV_LOG_INFO, " %s", x265_tune_names[i]);
106 
107  av_log(avctx, AV_LOG_INFO, "\n");
108 
109  return AVERROR(EINVAL);
110  }
111 
112  ctx->params->frameNumThreads = avctx->thread_count;
113  if (avctx->framerate.num > 0 && avctx->framerate.den > 0) {
114  ctx->params->fpsNum = avctx->framerate.num;
115  ctx->params->fpsDenom = avctx->framerate.den;
116  } else {
117  ctx->params->fpsNum = avctx->time_base.den;
118  ctx->params->fpsDenom = avctx->time_base.num * avctx->ticks_per_frame;
119  }
120  ctx->params->sourceWidth = avctx->width;
121  ctx->params->sourceHeight = avctx->height;
122  ctx->params->bEnablePsnr = !!(avctx->flags & AV_CODEC_FLAG_PSNR);
123  ctx->params->bOpenGOP = !(avctx->flags & AV_CODEC_FLAG_CLOSED_GOP);
124 
125  /* Tune the CTU size based on input resolution. */
126  if (ctx->params->sourceWidth < 64 || ctx->params->sourceHeight < 64)
127  ctx->params->maxCUSize = 32;
128  if (ctx->params->sourceWidth < 32 || ctx->params->sourceHeight < 32)
129  ctx->params->maxCUSize = 16;
130  if (ctx->params->sourceWidth < 16 || ctx->params->sourceHeight < 16) {
131  av_log(avctx, AV_LOG_ERROR, "Image size is too small (%dx%d).\n",
132  ctx->params->sourceWidth, ctx->params->sourceHeight);
133  return AVERROR(EINVAL);
134  }
135 
136 
137  ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
138 
139  ctx->params->vui.bEnableVideoFullRangeFlag = avctx->pix_fmt == AV_PIX_FMT_YUVJ420P ||
140  avctx->pix_fmt == AV_PIX_FMT_YUVJ422P ||
141  avctx->pix_fmt == AV_PIX_FMT_YUVJ444P ||
142  avctx->color_range == AVCOL_RANGE_JPEG;
143 
144  if ((avctx->color_primaries <= AVCOL_PRI_SMPTE432 &&
146  (avctx->color_trc <= AVCOL_TRC_ARIB_STD_B67 &&
147  avctx->color_trc != AVCOL_TRC_UNSPECIFIED) ||
148  (avctx->colorspace <= AVCOL_SPC_ICTCP &&
149  avctx->colorspace != AVCOL_SPC_UNSPECIFIED)) {
150 
151  ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
152 
153  // x265 validates the parameters internally
154  ctx->params->vui.colorPrimaries = avctx->color_primaries;
155  ctx->params->vui.transferCharacteristics = avctx->color_trc;
156  ctx->params->vui.matrixCoeffs = avctx->colorspace;
157  }
158 
159  if (avctx->sample_aspect_ratio.num > 0 && avctx->sample_aspect_ratio.den > 0) {
160  char sar[12];
161  int sar_num, sar_den;
162 
163  av_reduce(&sar_num, &sar_den,
164  avctx->sample_aspect_ratio.num,
165  avctx->sample_aspect_ratio.den, 65535);
166  snprintf(sar, sizeof(sar), "%d:%d", sar_num, sar_den);
167  if (ctx->api->param_parse(ctx->params, "sar", sar) == X265_PARAM_BAD_VALUE) {
168  av_log(avctx, AV_LOG_ERROR, "Invalid SAR: %d:%d.\n", sar_num, sar_den);
169  return AVERROR_INVALIDDATA;
170  }
171  }
172 
173  switch (avctx->pix_fmt) {
174  case AV_PIX_FMT_YUV420P:
177  ctx->params->internalCsp = X265_CSP_I420;
178  break;
179  case AV_PIX_FMT_YUV422P:
182  ctx->params->internalCsp = X265_CSP_I422;
183  break;
184  case AV_PIX_FMT_GBRP:
185  case AV_PIX_FMT_GBRP10:
186  case AV_PIX_FMT_GBRP12:
187  ctx->params->vui.matrixCoeffs = AVCOL_SPC_RGB;
188  ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
189  ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
190  case AV_PIX_FMT_YUV444P:
193  ctx->params->internalCsp = X265_CSP_I444;
194  break;
195  case AV_PIX_FMT_GRAY8:
196  case AV_PIX_FMT_GRAY10:
197  case AV_PIX_FMT_GRAY12:
198  if (ctx->api->api_build_number < 85) {
199  av_log(avctx, AV_LOG_ERROR,
200  "libx265 version is %d, must be at least 85 for gray encoding.\n",
201  ctx->api->api_build_number);
202  return AVERROR_INVALIDDATA;
203  }
204  ctx->params->internalCsp = X265_CSP_I400;
205  break;
206  }
207 
208  if (ctx->crf >= 0) {
209  char crf[6];
210 
211  snprintf(crf, sizeof(crf), "%2.2f", ctx->crf);
212  if (ctx->api->param_parse(ctx->params, "crf", crf) == X265_PARAM_BAD_VALUE) {
213  av_log(avctx, AV_LOG_ERROR, "Invalid crf: %2.2f.\n", ctx->crf);
214  return AVERROR(EINVAL);
215  }
216  } else if (avctx->bit_rate > 0) {
217  ctx->params->rc.bitrate = avctx->bit_rate / 1000;
218  ctx->params->rc.rateControlMode = X265_RC_ABR;
219  }
220 
221  ctx->params->rc.vbvBufferSize = avctx->rc_buffer_size / 1000;
222  ctx->params->rc.vbvMaxBitrate = avctx->rc_max_rate / 1000;
223 
224  cpb_props = ff_add_cpb_side_data(avctx);
225  if (!cpb_props)
226  return AVERROR(ENOMEM);
227  cpb_props->buffer_size = ctx->params->rc.vbvBufferSize * 1000;
228  cpb_props->max_bitrate = ctx->params->rc.vbvMaxBitrate * 1000;
229  cpb_props->avg_bitrate = ctx->params->rc.bitrate * 1000;
230 
231  if (!(avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER))
232  ctx->params->bRepeatHeaders = 1;
233 
234  if (ctx->x265_opts) {
235  AVDictionary *dict = NULL;
236  AVDictionaryEntry *en = NULL;
237 
238  if (!av_dict_parse_string(&dict, ctx->x265_opts, "=", ":", 0)) {
239  while ((en = av_dict_get(dict, "", en, AV_DICT_IGNORE_SUFFIX))) {
240  int parse_ret = ctx->api->param_parse(ctx->params, en->key, en->value);
241 
242  switch (parse_ret) {
243  case X265_PARAM_BAD_NAME:
244  av_log(avctx, AV_LOG_WARNING,
245  "Unknown option: %s.\n", en->key);
246  break;
247  case X265_PARAM_BAD_VALUE:
248  av_log(avctx, AV_LOG_WARNING,
249  "Invalid value for %s: %s.\n", en->key, en->value);
250  break;
251  default:
252  break;
253  }
254  }
255  av_dict_free(&dict);
256  }
257  }
258 
259  if (ctx->params->rc.vbvBufferSize && avctx->rc_initial_buffer_occupancy > 1000 &&
260  ctx->params->rc.vbvBufferInit == 0.9) {
261  ctx->params->rc.vbvBufferInit = (float)avctx->rc_initial_buffer_occupancy / 1000;
262  }
263 
264  if (ctx->profile) {
265  if (ctx->api->param_apply_profile(ctx->params, ctx->profile) < 0) {
266  int i;
267  av_log(avctx, AV_LOG_ERROR, "Invalid or incompatible profile set: %s.\n", ctx->profile);
268  av_log(avctx, AV_LOG_INFO, "Possible profiles:");
269  for (i = 0; x265_profile_names[i]; i++)
270  av_log(avctx, AV_LOG_INFO, " %s", x265_profile_names[i]);
271  av_log(avctx, AV_LOG_INFO, "\n");
272  return AVERROR(EINVAL);
273  }
274  }
275 
276  ctx->encoder = ctx->api->encoder_open(ctx->params);
277  if (!ctx->encoder) {
278  av_log(avctx, AV_LOG_ERROR, "Cannot open libx265 encoder.\n");
279  libx265_encode_close(avctx);
280  return AVERROR_INVALIDDATA;
281  }
282 
283  if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
284  x265_nal *nal;
285  int nnal;
286 
287  avctx->extradata_size = ctx->api->encoder_headers(ctx->encoder, &nal, &nnal);
288  if (avctx->extradata_size <= 0) {
289  av_log(avctx, AV_LOG_ERROR, "Cannot encode headers.\n");
290  libx265_encode_close(avctx);
291  return AVERROR_INVALIDDATA;
292  }
293 
295  if (!avctx->extradata) {
296  av_log(avctx, AV_LOG_ERROR,
297  "Cannot allocate HEVC header of size %d.\n", avctx->extradata_size);
298  libx265_encode_close(avctx);
299  return AVERROR(ENOMEM);
300  }
301 
302  memcpy(avctx->extradata, nal[0].payload, avctx->extradata_size);
303  }
304 
305  return 0;
306 }
307 
308 static av_cold int libx265_encode_set_roi(libx265Context *ctx, const AVFrame *frame, x265_picture* pic)
309 {
311  if (sd) {
312  if (ctx->params->rc.aqMode == X265_AQ_NONE) {
313  av_log(ctx, AV_LOG_WARNING, "Adaptive quantization must be enabled to use ROI encoding, skipping ROI.\n");
314  } else {
315  /* 8x8 block when qg-size is 8, 16*16 block otherwise. */
316  int mb_size = (ctx->params->rc.qgSize == 8) ? 8 : 16;
317  int mbx = (frame->width + mb_size - 1) / mb_size;
318  int mby = (frame->height + mb_size - 1) / mb_size;
319  int qp_range = 51 + 6 * (pic->bitDepth - 8);
320  int nb_rois;
321  const AVRegionOfInterest *roi;
322  uint32_t roi_size;
323  float *qoffsets; /* will be freed after encode is called. */
324 
325  roi = (const AVRegionOfInterest*)sd->data;
326  roi_size = roi->self_size;
327  if (!roi_size || sd->size % roi_size != 0) {
328  av_log(ctx, AV_LOG_ERROR, "Invalid AVRegionOfInterest.self_size.\n");
329  return AVERROR(EINVAL);
330  }
331  nb_rois = sd->size / roi_size;
332 
333  qoffsets = av_mallocz_array(mbx * mby, sizeof(*qoffsets));
334  if (!qoffsets)
335  return AVERROR(ENOMEM);
336 
337  // This list must be iterated in reverse because the first
338  // region in the list applies when regions overlap.
339  for (int i = nb_rois - 1; i >= 0; i--) {
340  int startx, endx, starty, endy;
341  float qoffset;
342 
343  roi = (const AVRegionOfInterest*)(sd->data + roi_size * i);
344 
345  starty = FFMIN(mby, roi->top / mb_size);
346  endy = FFMIN(mby, (roi->bottom + mb_size - 1)/ mb_size);
347  startx = FFMIN(mbx, roi->left / mb_size);
348  endx = FFMIN(mbx, (roi->right + mb_size - 1)/ mb_size);
349 
350  if (roi->qoffset.den == 0) {
351  av_free(qoffsets);
352  av_log(ctx, AV_LOG_ERROR, "AVRegionOfInterest.qoffset.den must not be zero.\n");
353  return AVERROR(EINVAL);
354  }
355  qoffset = roi->qoffset.num * 1.0f / roi->qoffset.den;
356  qoffset = av_clipf(qoffset * qp_range, -qp_range, +qp_range);
357 
358  for (int y = starty; y < endy; y++)
359  for (int x = startx; x < endx; x++)
360  qoffsets[x + y*mbx] = qoffset;
361  }
362 
363  pic->quantOffsets = qoffsets;
364  }
365  }
366  return 0;
367 }
368 
370  const AVFrame *pic, int *got_packet)
371 {
372  libx265Context *ctx = avctx->priv_data;
373  x265_picture x265pic;
374  x265_picture x265pic_out = { 0 };
375  x265_nal *nal;
376  uint8_t *dst;
377  int payload = 0;
378  int nnal;
379  int ret;
380  int i;
381 
382  ctx->api->picture_init(ctx->params, &x265pic);
383 
384  if (pic) {
385  for (i = 0; i < 3; i++) {
386  x265pic.planes[i] = pic->data[i];
387  x265pic.stride[i] = pic->linesize[i];
388  }
389 
390  x265pic.pts = pic->pts;
391  x265pic.bitDepth = av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth;
392 
393  x265pic.sliceType = pic->pict_type == AV_PICTURE_TYPE_I ?
394  (ctx->forced_idr ? X265_TYPE_IDR : X265_TYPE_I) :
395  pic->pict_type == AV_PICTURE_TYPE_P ? X265_TYPE_P :
396  pic->pict_type == AV_PICTURE_TYPE_B ? X265_TYPE_B :
397  X265_TYPE_AUTO;
398 
399  ret = libx265_encode_set_roi(ctx, pic, &x265pic);
400  if (ret < 0)
401  return ret;
402  }
403 
404  ret = ctx->api->encoder_encode(ctx->encoder, &nal, &nnal,
405  pic ? &x265pic : NULL, &x265pic_out);
406 
407  av_freep(&x265pic.quantOffsets);
408 
409  if (ret < 0)
410  return AVERROR_EXTERNAL;
411 
412  if (!nnal)
413  return 0;
414 
415  for (i = 0; i < nnal; i++)
416  payload += nal[i].sizeBytes;
417 
418  ret = ff_alloc_packet2(avctx, pkt, payload, payload);
419  if (ret < 0) {
420  av_log(avctx, AV_LOG_ERROR, "Error getting output packet.\n");
421  return ret;
422  }
423  dst = pkt->data;
424 
425  for (i = 0; i < nnal; i++) {
426  memcpy(dst, nal[i].payload, nal[i].sizeBytes);
427  dst += nal[i].sizeBytes;
428 
429  if (is_keyframe(nal[i].type))
431  }
432 
433  pkt->pts = x265pic_out.pts;
434  pkt->dts = x265pic_out.dts;
435 
436 #if FF_API_CODED_FRAME
438  switch (x265pic_out.sliceType) {
439  case X265_TYPE_IDR:
440  case X265_TYPE_I:
442  break;
443  case X265_TYPE_P:
445  break;
446  case X265_TYPE_B:
448  break;
449  }
451 #endif
452 
453 #if X265_BUILD >= 130
454  if (x265pic_out.sliceType == X265_TYPE_B)
455 #else
456  if (x265pic_out.frameData.sliceType == 'b')
457 #endif
459 
460  *got_packet = 1;
461  return 0;
462 }
463 
464 static const enum AVPixelFormat x265_csp_eight[] = {
474 };
475 
476 static const enum AVPixelFormat x265_csp_ten[] = {
491 };
492 
493 static const enum AVPixelFormat x265_csp_twelve[] = {
513 };
514 
516 {
517  if (x265_api_get(12))
518  codec->pix_fmts = x265_csp_twelve;
519  else if (x265_api_get(10))
520  codec->pix_fmts = x265_csp_ten;
521  else if (x265_api_get(8))
522  codec->pix_fmts = x265_csp_eight;
523 }
524 
525 #define OFFSET(x) offsetof(libx265Context, x)
526 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
527 static const AVOption options[] = {
528  { "crf", "set the x265 crf", OFFSET(crf), AV_OPT_TYPE_FLOAT, { .dbl = -1 }, -1, FLT_MAX, VE },
529  { "forced-idr", "if forcing keyframes, force them as IDR frames", OFFSET(forced_idr),AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, VE },
530  { "preset", "set the x265 preset", OFFSET(preset), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
531  { "tune", "set the x265 tune parameter", OFFSET(tune), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
532  { "profile", "set the x265 profile", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
533  { "x265-params", "set the x265 configuration using a :-separated list of key=value parameters", OFFSET(x265_opts), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
534  { NULL }
535 };
536 
537 static const AVClass class = {
538  .class_name = "libx265",
539  .item_name = av_default_item_name,
540  .option = options,
542 };
543 
544 static const AVCodecDefault x265_defaults[] = {
545  { "b", "0" },
546  { NULL },
547 };
548 
550  .name = "libx265",
551  .long_name = NULL_IF_CONFIG_SMALL("libx265 H.265 / HEVC"),
552  .type = AVMEDIA_TYPE_VIDEO,
553  .id = AV_CODEC_ID_HEVC,
554  .init = libx265_encode_init,
555  .init_static_data = libx265_encode_init_csp,
556  .encode2 = libx265_encode_frame,
557  .close = libx265_encode_close,
558  .priv_data_size = sizeof(libx265Context),
559  .priv_class = &class,
562  .wrapper_name = "libx265",
563 };
AVCodec
AVCodec.
Definition: avcodec.h:3481
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:85
x265_defaults
static const AVCodecDefault x265_defaults[]
Definition: libx265.c:544
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
AVERROR
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
opt.h
AVCodecContext::colorspace
enum AVColorSpace colorspace
YUV colorspace type.
Definition: avcodec.h:2193
libx265Context::forced_idr
int forced_idr
Definition: libx265.c:45
av_frame_get_side_data
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:734
av_pix_fmt_desc_get
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2522
libx265Context::params
x265_param * params
Definition: libx265.c:41
options
static const AVOption options[]
Definition: libx265.c:527
AVCodec::pix_fmts
enum AVPixelFormat * pix_fmts
array of supported pixel formats, or NULL if unknown, array is terminated by -1
Definition: avcodec.h:3502
profile
mfxU16 profile
Definition: qsvenc.c:44
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
pixdesc.h
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:388
AVCodecContext::color_trc
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:2186
VE
#define VE
Definition: libx265.c:526
AVCOL_RANGE_JPEG
@ AVCOL_RANGE_JPEG
the normal 2^n-1 "JPEG" YUV ranges
Definition: pixfmt.h:522
internal.h
AVPacket::data
uint8_t * data
Definition: avcodec.h:1477
AVComponentDescriptor::depth
int depth
Number of bits in the component.
Definition: pixdesc.h:58
AVOption
AVOption.
Definition: opt.h:246
AVCOL_TRC_UNSPECIFIED
@ AVCOL_TRC_UNSPECIFIED
Definition: pixfmt.h:470
AV_PIX_FMT_YUV420P10
#define AV_PIX_FMT_YUV420P10
Definition: pixfmt.h:387
AV_DICT_IGNORE_SUFFIX
#define AV_DICT_IGNORE_SUFFIX
Return first entry in a dictionary whose first part corresponds to the search key,...
Definition: dict.h:70
av_mallocz_array
void * av_mallocz_array(size_t nmemb, size_t size)
Definition: mem.c:191
AVCOL_SPC_RGB
@ AVCOL_SPC_RGB
order of coefficients is actually GBR, also IEC 61966-2-1 (sRGB)
Definition: pixfmt.h:497
float.h
AVDictionary
Definition: dict.c:30
AV_PKT_FLAG_DISPOSABLE
#define AV_PKT_FLAG_DISPOSABLE
Flag is used to indicate packets that contain frames that can be discarded by the decoder.
Definition: avcodec.h:1528
AV_CODEC_FLAG_PSNR
#define AV_CODEC_FLAG_PSNR
error[?] variables will be set during encoding.
Definition: avcodec.h:887
ff_add_cpb_side_data
AVCPBProperties * ff_add_cpb_side_data(AVCodecContext *avctx)
Add a CPB properties side data to an encoding context.
Definition: utils.c:2013
AV_PKT_FLAG_KEY
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: avcodec.h:1509
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:309
av_malloc
#define av_malloc(s)
Definition: tableprint_vlc.h:31
AV_CODEC_FLAG_GLOBAL_HEADER
#define AV_CODEC_FLAG_GLOBAL_HEADER
Place global headers in extradata instead of every keyframe.
Definition: avcodec.h:904
libx265Context::x265_opts
char * x265_opts
Definition: libx265.c:49
AVCodecContext::framerate
AVRational framerate
Definition: avcodec.h:3105
libx265_encode_frame
static int libx265_encode_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *pic, int *got_packet)
Definition: libx265.c:369
AVCodecContext::thread_count
int thread_count
thread count is used to decide how many independent tasks should be passed to execute()
Definition: avcodec.h:2824
AV_PIX_FMT_GBRP10
#define AV_PIX_FMT_GBRP10
Definition: pixfmt.h:403
defaults
static const AVCodecDefault defaults[]
Definition: amfenc_h264.c:361
libx265Context::preset
char * preset
Definition: libx265.c:46
AVCodecContext::flags
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:1645
type
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
Definition: writing_filters.txt:86
av_reduce
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
AVRational::num
int num
Numerator.
Definition: rational.h:59
AV_PIX_FMT_YUV444P10
#define AV_PIX_FMT_YUV444P10
Definition: pixfmt.h:390
preset
preset
Definition: vf_curves.c:46
AVCodecContext::color_primaries
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
Definition: avcodec.h:2179
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
av_cold
#define av_cold
Definition: attributes.h:84
AVRegionOfInterest
Structure describing a single Region Of Interest.
Definition: frame.h:220
AVCodecContext::rc_initial_buffer_occupancy
int rc_initial_buffer_occupancy
Number of bits which should be loaded into the rc buffer before decoding starts.
Definition: avcodec.h:2471
av_dict_get
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
AV_PIX_FMT_YUVJ422P
@ AV_PIX_FMT_YUVJ422P
planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV422P and setting col...
Definition: pixfmt.h:79
AVCodecContext::extradata_size
int extradata_size
Definition: avcodec.h:1667
AVRegionOfInterest::bottom
int bottom
Definition: frame.h:236
AVDictionaryEntry::key
char * key
Definition: dict.h:82
AVCodecContext::ticks_per_frame
int ticks_per_frame
For some codecs, the time base is closer to the field rate than the frame rate.
Definition: avcodec.h:1697
ctx
AVFormatContext * ctx
Definition: movenc.c:48
AV_PIX_FMT_YUV420P
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:66
AVCodecContext::rc_max_rate
int64_t rc_max_rate
maximum bitrate
Definition: avcodec.h:2443
AVCOL_PRI_UNSPECIFIED
@ AVCOL_PRI_UNSPECIFIED
Definition: pixfmt.h:446
AVCPBProperties
This structure describes the bitrate properties of an encoded bitstream.
Definition: avcodec.h:1128
AV_PIX_FMT_YUVJ444P
@ AV_PIX_FMT_YUVJ444P
planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV444P and setting col...
Definition: pixfmt.h:80
AV_PIX_FMT_GRAY10
#define AV_PIX_FMT_GRAY10
Definition: pixfmt.h:368
if
if(ret)
Definition: filter_design.txt:179
AVCodecDefault
Definition: internal.h:231
AVCodecContext::rc_buffer_size
int rc_buffer_size
decoder bitstream buffer size
Definition: avcodec.h:2428
AVCPBProperties::avg_bitrate
int avg_bitrate
Average bitrate of the stream, in bits per second.
Definition: avcodec.h:1152
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
libx265_encode_init_csp
static av_cold void libx265_encode_init_csp(AVCodec *codec)
Definition: libx265.c:515
AVCodecContext::color_range
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:2200
AV_PIX_FMT_YUVJ420P
@ AV_PIX_FMT_YUVJ420P
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
Definition: pixfmt.h:78
AVCodecContext::bit_rate
int64_t bit_rate
the average bitrate
Definition: avcodec.h:1615
libx265_encode_init
static av_cold int libx265_encode_init(AVCodecContext *avctx)
Definition: libx265.c:79
libx265Context::tune
char * tune
Definition: libx265.c:47
AVRegionOfInterest::self_size
uint32_t self_size
Must be set to the size of this data structure (that is, sizeof(AVRegionOfInterest)).
Definition: frame.h:225
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:191
AV_PICTURE_TYPE_I
@ AV_PICTURE_TYPE_I
Intra.
Definition: avutil.h:274
libx265Context::encoder
x265_encoder * encoder
Definition: libx265.c:40
OFFSET
#define OFFSET(x)
Definition: libx265.c:525
AV_PIX_FMT_YUV422P10
#define AV_PIX_FMT_YUV422P10
Definition: pixfmt.h:388
AV_PIX_FMT_GRAY8
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
Definition: pixfmt.h:74
AVCodecContext::time_base
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.
Definition: avcodec.h:1688
AV_CODEC_CAP_AUTO_THREADS
#define AV_CODEC_CAP_AUTO_THREADS
Codec supports avctx->thread_count == 0 (auto).
Definition: avcodec.h:1049
AVFrame::pict_type
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:378
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:188
AV_PIX_FMT_YUV422P12
#define AV_PIX_FMT_YUV422P12
Definition: pixfmt.h:392
AV_PIX_FMT_YUV444P12
#define AV_PIX_FMT_YUV444P12
Definition: pixfmt.h:394
AVFrameSideData::data
uint8_t * data
Definition: frame.h:203
AVPacket::dts
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed.
Definition: avcodec.h:1476
FFMIN
#define FFMIN(a, b)
Definition: common.h:96
AVCPBProperties::max_bitrate
int max_bitrate
Maximum bitrate of the stream, in bits per second.
Definition: avcodec.h:1134
AVERROR_EXTERNAL
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition: error.h:57
AVPacket::flags
int flags
A combination of AV_PKT_FLAG values.
Definition: avcodec.h:1483
av_dict_free
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values.
Definition: dict.c:203
AVRegionOfInterest::right
int right
Definition: frame.h:238
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:187
AV_OPT_TYPE_FLOAT
@ AV_OPT_TYPE_FLOAT
Definition: opt.h:226
ff_libx265_encoder
AVCodec ff_libx265_encoder
Definition: libx265.c:549
AVRegionOfInterest::left
int left
Definition: frame.h:237
libx265Context::crf
float crf
Definition: libx265.c:44
libx265Context::api
const x265_api * api
Definition: libx265.c:42
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:259
AVPacket::pts
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: avcodec.h:1470
AVCodecContext::extradata
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1666
AVRegionOfInterest::top
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
internal.h
AV_PIX_FMT_GBRP12
#define AV_PIX_FMT_GBRP12
Definition: pixfmt.h:404
common.h
AV_CODEC_ID_HEVC
@ AV_CODEC_ID_HEVC
Definition: avcodec.h:392
uint8_t
uint8_t
Definition: audio_convert.c:194
AVCodec::name
const char * name
Name of the codec implementation.
Definition: avcodec.h:3488
libx265_encode_set_roi
static av_cold int libx265_encode_set_roi(libx265Context *ctx, const AVFrame *frame, x265_picture *pic)
Definition: libx265.c:308
AVCOL_SPC_UNSPECIFIED
@ AVCOL_SPC_UNSPECIFIED
Definition: pixfmt.h:499
AVCodecContext::height
int height
Definition: avcodec.h:1738
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:1775
avcodec.h
AV_CODEC_FLAG_CLOSED_GOP
#define AV_CODEC_FLAG_CLOSED_GOP
Definition: avcodec.h:918
ret
ret
Definition: filter_design.txt:187
AVClass::class_name
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
frame
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
Definition: filter_design.txt:264
AVCPBProperties::buffer_size
int buffer_size
The size of the buffer to which the ratecontrol is applied, in bits.
Definition: avcodec.h:1161
AV_PIX_FMT_YUV420P12
#define AV_PIX_FMT_YUV420P12
Definition: pixfmt.h:391
AV_INPUT_BUFFER_PADDING_SIZE
#define AV_INPUT_BUFFER_PADDING_SIZE
Definition: avcodec.h:790
AVCodecContext::coded_frame
attribute_deprecated AVFrame * coded_frame
the picture in the bitstream
Definition: avcodec.h:2815
AVCodecContext
main external API structure.
Definition: avcodec.h:1565
AVCOL_TRC_ARIB_STD_B67
@ AVCOL_TRC_ARIB_STD_B67
ARIB STD-B67, known as "Hybrid log-gamma".
Definition: pixfmt.h:488
pkt
static AVPacket pkt
Definition: demuxing_decoding.c:54
AV_PICTURE_TYPE_B
@ AV_PICTURE_TYPE_B
Bi-dir predicted.
Definition: avutil.h:276
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
av_dict_parse_string
int av_dict_parse_string(AVDictionary **pm, const char *str, const char *key_val_sep, const char *pairs_sep, int flags)
Parse the key/value pairs list and add the parsed entries to a dictionary.
Definition: dict.c:180
AVPixFmtDescriptor::comp
AVComponentDescriptor comp[4]
Parameters that describe how pixels are packed.
Definition: pixdesc.h:117
x265_csp_ten
static enum AVPixelFormat x265_csp_ten[]
Definition: libx265.c:476
AV_CODEC_CAP_DELAY
#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:1006
libx265_encode_close
static av_cold int libx265_encode_close(AVCodecContext *avctx)
Definition: libx265.c:67
AV_PIX_FMT_YUV444P
@ AV_PIX_FMT_YUV444P
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
Definition: pixfmt.h:71
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:84
AV_PIX_FMT_GBRP
@ AV_PIX_FMT_GBRP
planar GBR 4:4:4 24bpp
Definition: pixfmt.h:168
AV_PICTURE_TYPE_P
@ AV_PICTURE_TYPE_P
Predicted.
Definition: avutil.h:275
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
AV_PIX_FMT_YUV422P
@ AV_PIX_FMT_YUV422P
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Definition: pixfmt.h:70
AVFrameSideData
Structure to hold side data for an AVFrame.
Definition: frame.h:201
AVCOL_PRI_SMPTE432
@ AVCOL_PRI_SMPTE432
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
Definition: pixfmt.h:458
av_free
#define av_free(p)
Definition: tableprint_vlc.h:34
AVDictionaryEntry
Definition: dict.h:81
AVPacket
This structure stores compressed data.
Definition: avcodec.h:1454
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:1592
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:240
AVFrameSideData::size
int size
Definition: frame.h:204
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:35
AVCodecContext::width
int width
picture width / height.
Definition: avcodec.h:1738
AV_FRAME_DATA_REGIONS_OF_INTEREST
@ AV_FRAME_DATA_REGIONS_OF_INTEREST
Regions Of Interest, the data is an array of AVRegionOfInterest type, the number of array element is ...
Definition: frame.h:181
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:326
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
libx265Context::profile
char * profile
Definition: libx265.c:48
AVDictionaryEntry::value
char * value
Definition: dict.h:83
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:227
AV_PIX_FMT_GRAY12
#define AV_PIX_FMT_GRAY12
Definition: pixfmt.h:369
libx265Context
Definition: libx265.c:37
ff_alloc_packet2
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
AVRegionOfInterest::qoffset
AVRational qoffset
Quantisation offset.
Definition: frame.h:262
AVCOL_SPC_ICTCP
@ AVCOL_SPC_ICTCP
ITU-R BT.2100-0, ICtCp.
Definition: pixfmt.h:512
snprintf
#define snprintf
Definition: snprintf.h:34
x265_csp_eight
static enum AVPixelFormat x265_csp_eight[]
Definition: libx265.c:464
x265_csp_twelve
static enum AVPixelFormat x265_csp_twelve[]
Definition: libx265.c:493
AVCodecContext::sample_aspect_ratio
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:1944
is_keyframe
static int is_keyframe(NalUnitType naltype)
Definition: libx265.c:52