4 * Copyright (c) 2013-2014 Derek Buitenhuis
6 * This file is part of FFmpeg.
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.
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.
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
24 #define X265_API_IMPORTS 1
30 #include "libavutil/internal.h"
31 #include "libavutil/common.h"
32 #include "libavutil/opt.h"
33 #include "libavutil/pixdesc.h"
37 typedef struct libx265Context {
40 x265_encoder *encoder;
52 static int is_keyframe(NalUnitType 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:
67 static av_cold int libx265_encode_close(AVCodecContext *avctx)
69 libx265Context *ctx = avctx->priv_data;
71 ctx->api->param_free(ctx->params);
74 ctx->api->encoder_close(ctx->encoder);
79 static av_cold int libx265_encode_init(AVCodecContext *avctx)
81 libx265Context *ctx = avctx->priv_data;
83 ctx->api = x265_api_get(av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth);
85 ctx->api = x265_api_get(0);
87 ctx->params = ctx->api->param_alloc();
89 av_log(avctx, AV_LOG_ERROR, "Could not allocate x265 param structure.\n");
90 return AVERROR(ENOMEM);
93 if (ctx->api->param_default_preset(ctx->params, ctx->preset, ctx->tune) < 0) {
96 av_log(avctx, AV_LOG_ERROR, "Error setting preset/tune %s/%s.\n", ctx->preset, ctx->tune);
97 av_log(avctx, AV_LOG_INFO, "Possible presets:");
98 for (i = 0; x265_preset_names[i]; i++)
99 av_log(avctx, AV_LOG_INFO, " %s", x265_preset_names[i]);
101 av_log(avctx, AV_LOG_INFO, "\n");
102 av_log(avctx, AV_LOG_INFO, "Possible tunes:");
103 for (i = 0; x265_tune_names[i]; i++)
104 av_log(avctx, AV_LOG_INFO, " %s", x265_tune_names[i]);
106 av_log(avctx, AV_LOG_INFO, "\n");
108 return AVERROR(EINVAL);
111 ctx->params->frameNumThreads = avctx->thread_count;
112 ctx->params->fpsNum = avctx->time_base.den;
113 ctx->params->fpsDenom = avctx->time_base.num * avctx->ticks_per_frame;
114 ctx->params->sourceWidth = avctx->width;
115 ctx->params->sourceHeight = avctx->height;
116 ctx->params->bEnablePsnr = !!(avctx->flags & AV_CODEC_FLAG_PSNR);
118 /* Tune the CTU size based on input resolution. */
119 if (ctx->params->sourceWidth < 64 || ctx->params->sourceHeight < 64)
120 ctx->params->maxCUSize = 32;
121 if (ctx->params->sourceWidth < 32 || ctx->params->sourceHeight < 32)
122 ctx->params->maxCUSize = 16;
123 if (ctx->params->sourceWidth < 16 || ctx->params->sourceHeight < 16) {
124 av_log(avctx, AV_LOG_ERROR, "Image size is too small (%dx%d).\n",
125 ctx->params->sourceWidth, ctx->params->sourceHeight);
126 return AVERROR(EINVAL);
129 if ((avctx->color_primaries <= AVCOL_PRI_SMPTE432 &&
130 avctx->color_primaries != AVCOL_PRI_UNSPECIFIED) ||
131 (avctx->color_trc <= AVCOL_TRC_ARIB_STD_B67 &&
132 avctx->color_trc != AVCOL_TRC_UNSPECIFIED) ||
133 (avctx->colorspace <= AVCOL_SPC_ICTCP &&
134 avctx->colorspace != AVCOL_SPC_UNSPECIFIED)) {
136 ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
137 ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
139 // x265 validates the parameters internally
140 ctx->params->vui.colorPrimaries = avctx->color_primaries;
141 ctx->params->vui.transferCharacteristics = avctx->color_trc;
142 ctx->params->vui.matrixCoeffs = avctx->colorspace;
145 if (avctx->sample_aspect_ratio.num > 0 && avctx->sample_aspect_ratio.den > 0) {
147 int sar_num, sar_den;
149 av_reduce(&sar_num, &sar_den,
150 avctx->sample_aspect_ratio.num,
151 avctx->sample_aspect_ratio.den, 65535);
152 snprintf(sar, sizeof(sar), "%d:%d", sar_num, sar_den);
153 if (ctx->api->param_parse(ctx->params, "sar", sar) == X265_PARAM_BAD_VALUE) {
154 av_log(avctx, AV_LOG_ERROR, "Invalid SAR: %d:%d.\n", sar_num, sar_den);
155 return AVERROR_INVALIDDATA;
159 switch (avctx->pix_fmt) {
160 case AV_PIX_FMT_YUV420P:
161 case AV_PIX_FMT_YUV420P10:
162 case AV_PIX_FMT_YUV420P12:
163 ctx->params->internalCsp = X265_CSP_I420;
165 case AV_PIX_FMT_YUV422P:
166 case AV_PIX_FMT_YUV422P10:
167 case AV_PIX_FMT_YUV422P12:
168 ctx->params->internalCsp = X265_CSP_I422;
170 case AV_PIX_FMT_GBRP:
171 case AV_PIX_FMT_GBRP10:
172 case AV_PIX_FMT_GBRP12:
173 ctx->params->vui.matrixCoeffs = AVCOL_SPC_RGB;
174 ctx->params->vui.bEnableVideoSignalTypePresentFlag = 1;
175 ctx->params->vui.bEnableColorDescriptionPresentFlag = 1;
176 case AV_PIX_FMT_YUV444P:
177 case AV_PIX_FMT_YUV444P10:
178 case AV_PIX_FMT_YUV444P12:
179 ctx->params->internalCsp = X265_CSP_I444;
181 case AV_PIX_FMT_GRAY8:
182 case AV_PIX_FMT_GRAY10:
183 case AV_PIX_FMT_GRAY12:
184 if (ctx->api->api_build_number < 85) {
185 av_log(avctx, AV_LOG_ERROR,
186 "libx265 version is %d, must be at least 85 for gray encoding.\n",
187 ctx->api->api_build_number);
188 return AVERROR_INVALIDDATA;
190 ctx->params->internalCsp = X265_CSP_I400;
197 snprintf(crf, sizeof(crf), "%2.2f", ctx->crf);
198 if (ctx->api->param_parse(ctx->params, "crf", crf) == X265_PARAM_BAD_VALUE) {
199 av_log(avctx, AV_LOG_ERROR, "Invalid crf: %2.2f.\n", ctx->crf);
200 return AVERROR(EINVAL);
202 } else if (avctx->bit_rate > 0) {
203 ctx->params->rc.bitrate = avctx->bit_rate / 1000;
204 ctx->params->rc.rateControlMode = X265_RC_ABR;
207 if (!(avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER))
208 ctx->params->bRepeatHeaders = 1;
210 if (ctx->x265_opts) {
211 AVDictionary *dict = NULL;
212 AVDictionaryEntry *en = NULL;
214 if (!av_dict_parse_string(&dict, ctx->x265_opts, "=", ":", 0)) {
215 while ((en = av_dict_get(dict, "", en, AV_DICT_IGNORE_SUFFIX))) {
216 int parse_ret = ctx->api->param_parse(ctx->params, en->key, en->value);
219 case X265_PARAM_BAD_NAME:
220 av_log(avctx, AV_LOG_WARNING,
221 "Unknown option: %s.\n", en->key);
223 case X265_PARAM_BAD_VALUE:
224 av_log(avctx, AV_LOG_WARNING,
225 "Invalid value for %s: %s.\n", en->key, en->value);
236 if (ctx->api->param_apply_profile(ctx->params, ctx->profile) < 0) {
238 av_log(avctx, AV_LOG_ERROR, "Invalid or incompatible profile set: %s.\n", ctx->profile);
239 av_log(avctx, AV_LOG_INFO, "Possible profiles:");
240 for (i = 0; x265_profile_names[i]; i++)
241 av_log(avctx, AV_LOG_INFO, " %s", x265_profile_names[i]);
242 av_log(avctx, AV_LOG_INFO, "\n");
243 return AVERROR(EINVAL);
247 ctx->encoder = ctx->api->encoder_open(ctx->params);
249 av_log(avctx, AV_LOG_ERROR, "Cannot open libx265 encoder.\n");
250 libx265_encode_close(avctx);
251 return AVERROR_INVALIDDATA;
254 if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
258 avctx->extradata_size = ctx->api->encoder_headers(ctx->encoder, &nal, &nnal);
259 if (avctx->extradata_size <= 0) {
260 av_log(avctx, AV_LOG_ERROR, "Cannot encode headers.\n");
261 libx265_encode_close(avctx);
262 return AVERROR_INVALIDDATA;
265 avctx->extradata = av_malloc(avctx->extradata_size + AV_INPUT_BUFFER_PADDING_SIZE);
266 if (!avctx->extradata) {
267 av_log(avctx, AV_LOG_ERROR,
268 "Cannot allocate HEVC header of size %d.\n", avctx->extradata_size);
269 libx265_encode_close(avctx);
270 return AVERROR(ENOMEM);
273 memcpy(avctx->extradata, nal[0].payload, avctx->extradata_size);
279 static int libx265_encode_frame(AVCodecContext *avctx, AVPacket *pkt,
280 const AVFrame *pic, int *got_packet)
282 libx265Context *ctx = avctx->priv_data;
283 x265_picture x265pic;
284 x265_picture x265pic_out = { 0 };
292 ctx->api->picture_init(ctx->params, &x265pic);
295 for (i = 0; i < 3; i++) {
296 x265pic.planes[i] = pic->data[i];
297 x265pic.stride[i] = pic->linesize[i];
300 x265pic.pts = pic->pts;
301 x265pic.bitDepth = av_pix_fmt_desc_get(avctx->pix_fmt)->comp[0].depth;
303 x265pic.sliceType = pic->pict_type == AV_PICTURE_TYPE_I ?
304 (ctx->forced_idr ? X265_TYPE_IDR : X265_TYPE_I) :
305 pic->pict_type == AV_PICTURE_TYPE_P ? X265_TYPE_P :
306 pic->pict_type == AV_PICTURE_TYPE_B ? X265_TYPE_B :
310 ret = ctx->api->encoder_encode(ctx->encoder, &nal, &nnal,
311 pic ? &x265pic : NULL, &x265pic_out);
313 return AVERROR_EXTERNAL;
318 for (i = 0; i < nnal; i++)
319 payload += nal[i].sizeBytes;
321 ret = ff_alloc_packet2(avctx, pkt, payload, payload);
323 av_log(avctx, AV_LOG_ERROR, "Error getting output packet.\n");
328 for (i = 0; i < nnal; i++) {
329 memcpy(dst, nal[i].payload, nal[i].sizeBytes);
330 dst += nal[i].sizeBytes;
332 if (is_keyframe(nal[i].type))
333 pkt->flags |= AV_PKT_FLAG_KEY;
336 pkt->pts = x265pic_out.pts;
337 pkt->dts = x265pic_out.dts;
339 #if FF_API_CODED_FRAME
340 FF_DISABLE_DEPRECATION_WARNINGS
341 switch (x265pic_out.sliceType) {
344 avctx->coded_frame->pict_type = AV_PICTURE_TYPE_I;
347 avctx->coded_frame->pict_type = AV_PICTURE_TYPE_P;
350 avctx->coded_frame->pict_type = AV_PICTURE_TYPE_B;
353 FF_ENABLE_DEPRECATION_WARNINGS
356 #if X265_BUILD >= 130
357 if (x265pic_out.sliceType == X265_TYPE_B)
359 if (x265pic_out.frameData.sliceType == 'b')
361 pkt->flags |= AV_PKT_FLAG_DISPOSABLE;
367 static const enum AVPixelFormat x265_csp_eight[] = {
376 static const enum AVPixelFormat x265_csp_ten[] = {
381 AV_PIX_FMT_YUV420P10,
382 AV_PIX_FMT_YUV422P10,
383 AV_PIX_FMT_YUV444P10,
390 static const enum AVPixelFormat x265_csp_twelve[] = {
395 AV_PIX_FMT_YUV420P10,
396 AV_PIX_FMT_YUV422P10,
397 AV_PIX_FMT_YUV444P10,
399 AV_PIX_FMT_YUV420P12,
400 AV_PIX_FMT_YUV422P12,
401 AV_PIX_FMT_YUV444P12,
409 static av_cold void libx265_encode_init_csp(AVCodec *codec)
411 if (x265_api_get(12))
412 codec->pix_fmts = x265_csp_twelve;
413 else if (x265_api_get(10))
414 codec->pix_fmts = x265_csp_ten;
415 else if (x265_api_get(8))
416 codec->pix_fmts = x265_csp_eight;
419 #define OFFSET(x) offsetof(libx265Context, x)
420 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
421 static const AVOption options[] = {
422 { "crf", "set the x265 crf", OFFSET(crf), AV_OPT_TYPE_FLOAT, { .dbl = -1 }, -1, FLT_MAX, VE },
423 { "forced-idr", "if forcing keyframes, force them as IDR frames", OFFSET(forced_idr),AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, VE },
424 { "preset", "set the x265 preset", OFFSET(preset), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
425 { "tune", "set the x265 tune parameter", OFFSET(tune), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
426 { "profile", "set the x265 profile", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
427 { "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 },
431 static const AVClass class = {
432 .class_name = "libx265",
433 .item_name = av_default_item_name,
435 .version = LIBAVUTIL_VERSION_INT,
438 static const AVCodecDefault x265_defaults[] = {
443 AVCodec ff_libx265_encoder = {
445 .long_name = NULL_IF_CONFIG_SMALL("libx265 H.265 / HEVC"),
446 .type = AVMEDIA_TYPE_VIDEO,
447 .id = AV_CODEC_ID_HEVC,
448 .init = libx265_encode_init,
449 .init_static_data = libx265_encode_init_csp,
450 .encode2 = libx265_encode_frame,
451 .close = libx265_encode_close,
452 .priv_data_size = sizeof(libx265Context),
453 .priv_class = &class,
454 .defaults = x265_defaults,
455 .capabilities = AV_CODEC_CAP_DELAY | AV_CODEC_CAP_AUTO_THREADS,
456 .wrapper_name = "libx265",