4 * Copyright (c) 2019 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
25 #include "libavutil/internal.h"
26 #include "libavutil/avassert.h"
27 #include "libavutil/base64.h"
28 #include "libavutil/common.h"
29 #include "libavutil/mathematics.h"
30 #include "libavutil/opt.h"
31 #include "libavutil/pixdesc.h"
35 typedef struct librav1eContext {
53 static inline RaPixelRange range_map(enum AVPixelFormat pix_fmt, enum AVColorRange range)
56 case AV_PIX_FMT_YUVJ420P:
57 case AV_PIX_FMT_YUVJ422P:
58 case AV_PIX_FMT_YUVJ444P:
59 return RA_PIXEL_RANGE_FULL;
63 case AVCOL_RANGE_JPEG:
64 return RA_PIXEL_RANGE_FULL;
65 case AVCOL_RANGE_MPEG:
67 return RA_PIXEL_RANGE_LIMITED;
71 static inline RaChromaSampling pix_fmt_map(enum AVPixelFormat pix_fmt)
74 case AV_PIX_FMT_YUV420P:
75 case AV_PIX_FMT_YUVJ420P:
76 case AV_PIX_FMT_YUV420P10:
77 case AV_PIX_FMT_YUV420P12:
78 return RA_CHROMA_SAMPLING_CS420;
79 case AV_PIX_FMT_YUV422P:
80 case AV_PIX_FMT_YUVJ422P:
81 case AV_PIX_FMT_YUV422P10:
82 case AV_PIX_FMT_YUV422P12:
83 return RA_CHROMA_SAMPLING_CS422;
84 case AV_PIX_FMT_YUV444P:
85 case AV_PIX_FMT_YUVJ444P:
86 case AV_PIX_FMT_YUV444P10:
87 case AV_PIX_FMT_YUV444P12:
88 return RA_CHROMA_SAMPLING_CS444;
94 static inline RaChromaSamplePosition chroma_loc_map(enum AVChromaLocation chroma_loc)
97 case AVCHROMA_LOC_LEFT:
98 return RA_CHROMA_SAMPLE_POSITION_VERTICAL;
99 case AVCHROMA_LOC_TOPLEFT:
100 return RA_CHROMA_SAMPLE_POSITION_COLOCATED;
102 return RA_CHROMA_SAMPLE_POSITION_UNKNOWN;
106 static int get_stats(AVCodecContext *avctx, int eos)
108 librav1eContext *ctx = avctx->priv_data;
109 RaData* buf = rav1e_twopass_out(ctx->ctx);
114 uint8_t *tmp = av_fast_realloc(ctx->pass_data, &ctx->pass_size,
115 ctx->pass_pos + buf->len);
117 rav1e_data_unref(buf);
118 return AVERROR(ENOMEM);
121 ctx->pass_data = tmp;
122 memcpy(ctx->pass_data + ctx->pass_pos, buf->data, buf->len);
123 ctx->pass_pos += buf->len;
125 size_t b64_size = AV_BASE64_SIZE(ctx->pass_pos);
127 memcpy(ctx->pass_data, buf->data, buf->len);
129 avctx->stats_out = av_malloc(b64_size);
130 if (!avctx->stats_out) {
131 rav1e_data_unref(buf);
132 return AVERROR(ENOMEM);
135 av_base64_encode(avctx->stats_out, b64_size, ctx->pass_data, ctx->pass_pos);
137 av_freep(&ctx->pass_data);
140 rav1e_data_unref(buf);
145 static int set_stats(AVCodecContext *avctx)
147 librav1eContext *ctx = avctx->priv_data;
150 while (ret > 0 && ctx->pass_size - ctx->pass_pos > 0) {
151 ret = rav1e_twopass_in(ctx->ctx, ctx->pass_data + ctx->pass_pos, ctx->pass_size);
153 return AVERROR_EXTERNAL;
154 ctx->pass_pos += ret;
160 static av_cold int librav1e_encode_close(AVCodecContext *avctx)
162 librav1eContext *ctx = avctx->priv_data;
165 rav1e_context_unref(ctx->ctx);
169 av_bsf_free(&ctx->bsf);
170 av_freep(&ctx->pass_data);
175 static av_cold int librav1e_encode_init(AVCodecContext *avctx)
177 librav1eContext *ctx = avctx->priv_data;
178 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(avctx->pix_fmt);
179 RaConfig *cfg = NULL;
183 cfg = rav1e_config_default();
185 av_log(avctx, AV_LOG_ERROR, "Could not allocate rav1e config.\n");
186 return AVERROR_EXTERNAL;
189 rav1e_config_set_time_base(cfg, (RaRational) {
190 avctx->time_base.num * avctx->ticks_per_frame,
194 if (avctx->flags & AV_CODEC_FLAG_PASS2) {
195 if (!avctx->stats_in) {
196 av_log(avctx, AV_LOG_ERROR, "No stats file provided for second pass.\n");
197 ret = AVERROR(EINVAL);
201 ctx->pass_size = (strlen(avctx->stats_in) * 3) / 4;
202 ctx->pass_data = av_malloc(ctx->pass_size);
203 if (!ctx->pass_data) {
204 av_log(avctx, AV_LOG_ERROR, "Could not allocate stats buffer.\n");
205 ret = AVERROR(ENOMEM);
209 ctx->pass_size = av_base64_decode(ctx->pass_data, avctx->stats_in, ctx->pass_size);
210 if (ctx->pass_size < 0) {
211 av_log(avctx, AV_LOG_ERROR, "Invalid pass file.\n");
212 ret = AVERROR(EINVAL);
217 if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
218 const AVBitStreamFilter *filter = av_bsf_get_by_name("extract_extradata");
222 av_log(avctx, AV_LOG_ERROR, "extract_extradata bitstream filter "
223 "not found. This is a bug, please report it.\n");
228 bret = av_bsf_alloc(filter, &ctx->bsf);
234 bret = avcodec_parameters_from_context(ctx->bsf->par_in, avctx);
240 bret = av_bsf_init(ctx->bsf);
247 if (ctx->rav1e_opts) {
248 AVDictionary *dict = NULL;
249 AVDictionaryEntry *en = NULL;
251 if (!av_dict_parse_string(&dict, ctx->rav1e_opts, "=", ":", 0)) {
252 while (en = av_dict_get(dict, "", en, AV_DICT_IGNORE_SUFFIX)) {
253 int parse_ret = rav1e_config_parse(cfg, en->key, en->value);
255 av_log(avctx, AV_LOG_WARNING, "Invalid value for %s: %s.\n", en->key, en->value);
261 rret = rav1e_config_parse_int(cfg, "width", avctx->width);
263 av_log(avctx, AV_LOG_ERROR, "Invalid width passed to rav1e.\n");
264 ret = AVERROR_INVALIDDATA;
268 rret = rav1e_config_parse_int(cfg, "height", avctx->height);
270 av_log(avctx, AV_LOG_ERROR, "Invalid height passed to rav1e.\n");
271 ret = AVERROR_INVALIDDATA;
275 rret = rav1e_config_parse_int(cfg, "threads", avctx->thread_count);
277 av_log(avctx, AV_LOG_WARNING, "Invalid number of threads, defaulting to auto.\n");
279 if (ctx->speed >= 0) {
280 rret = rav1e_config_parse_int(cfg, "speed", ctx->speed);
282 av_log(avctx, AV_LOG_ERROR, "Could not set speed preset.\n");
283 ret = AVERROR_EXTERNAL;
288 /* rav1e handles precedence between 'tiles' and cols/rows for us. */
289 if (ctx->tiles > 0) {
290 rret = rav1e_config_parse_int(cfg, "tiles", ctx->tiles);
292 av_log(avctx, AV_LOG_ERROR, "Could not set number of tiles to encode with.\n");
293 ret = AVERROR_EXTERNAL;
297 if (ctx->tile_rows > 0) {
298 rret = rav1e_config_parse_int(cfg, "tile_rows", ctx->tile_rows);
300 av_log(avctx, AV_LOG_ERROR, "Could not set number of tile rows to encode with.\n");
301 ret = AVERROR_EXTERNAL;
305 if (ctx->tile_cols > 0) {
306 rret = rav1e_config_parse_int(cfg, "tile_cols", ctx->tile_cols);
308 av_log(avctx, AV_LOG_ERROR, "Could not set number of tile cols to encode with.\n");
309 ret = AVERROR_EXTERNAL;
314 if (avctx->gop_size > 0) {
315 rret = rav1e_config_parse_int(cfg, "key_frame_interval", avctx->gop_size);
317 av_log(avctx, AV_LOG_ERROR, "Could not set max keyint.\n");
318 ret = AVERROR_EXTERNAL;
323 if (avctx->keyint_min > 0) {
324 rret = rav1e_config_parse_int(cfg, "min_key_frame_interval", avctx->keyint_min);
326 av_log(avctx, AV_LOG_ERROR, "Could not set min keyint.\n");
327 ret = AVERROR_EXTERNAL;
332 if (avctx->bit_rate && ctx->quantizer < 0) {
333 int max_quantizer = avctx->qmax >= 0 ? avctx->qmax : 255;
335 rret = rav1e_config_parse_int(cfg, "quantizer", max_quantizer);
337 av_log(avctx, AV_LOG_ERROR, "Could not set max quantizer.\n");
338 ret = AVERROR_EXTERNAL;
342 if (avctx->qmin >= 0) {
343 rret = rav1e_config_parse_int(cfg, "min_quantizer", avctx->qmin);
345 av_log(avctx, AV_LOG_ERROR, "Could not set min quantizer.\n");
346 ret = AVERROR_EXTERNAL;
351 rret = rav1e_config_parse_int(cfg, "bitrate", avctx->bit_rate);
353 av_log(avctx, AV_LOG_ERROR, "Could not set bitrate.\n");
354 ret = AVERROR_INVALIDDATA;
357 } else if (ctx->quantizer >= 0) {
359 av_log(avctx, AV_LOG_WARNING, "Both bitrate and quantizer specified. Using quantizer mode.");
361 rret = rav1e_config_parse_int(cfg, "quantizer", ctx->quantizer);
363 av_log(avctx, AV_LOG_ERROR, "Could not set quantizer.\n");
364 ret = AVERROR_EXTERNAL;
369 rret = rav1e_config_set_pixel_format(cfg, desc->comp[0].depth,
370 pix_fmt_map(avctx->pix_fmt),
371 chroma_loc_map(avctx->chroma_sample_location),
372 range_map(avctx->pix_fmt, avctx->color_range));
374 av_log(avctx, AV_LOG_ERROR, "Failed to set pixel format properties.\n");
375 ret = AVERROR_INVALIDDATA;
379 /* rav1e's colorspace enums match standard values. */
380 rret = rav1e_config_set_color_description(cfg, (RaMatrixCoefficients) avctx->colorspace,
381 (RaColorPrimaries) avctx->color_primaries,
382 (RaTransferCharacteristics) avctx->color_trc);
384 av_log(avctx, AV_LOG_WARNING, "Failed to set color properties.\n");
385 if (avctx->err_recognition & AV_EF_EXPLODE) {
386 ret = AVERROR_INVALIDDATA;
391 ctx->ctx = rav1e_context_new(cfg);
393 av_log(avctx, AV_LOG_ERROR, "Failed to create rav1e encode context.\n");
394 ret = AVERROR_EXTERNAL;
402 rav1e_config_unref(cfg);
407 static int librav1e_send_frame(AVCodecContext *avctx, const AVFrame *frame)
409 librav1eContext *ctx = avctx->priv_data;
410 RaFrame *rframe = NULL;
414 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(frame->format);
416 rframe = rav1e_frame_new(ctx->ctx);
418 av_log(avctx, AV_LOG_ERROR, "Could not allocate new rav1e frame.\n");
419 return AVERROR(ENOMEM);
422 for (int i = 0; i < desc->nb_components; i++) {
423 int shift = i ? desc->log2_chroma_h : 0;
424 int bytes = desc->comp[0].depth == 8 ? 1 : 2;
425 rav1e_frame_fill_plane(rframe, i, frame->data[i],
426 (frame->height >> shift) * frame->linesize[i],
427 frame->linesize[i], bytes);
431 ret = rav1e_send_frame(ctx->ctx, rframe);
433 rav1e_frame_unref(rframe); /* No need to unref if flushing. */
436 case RA_ENCODER_STATUS_SUCCESS:
438 case RA_ENCODER_STATUS_ENOUGH_DATA:
439 return AVERROR(EAGAIN);
440 case RA_ENCODER_STATUS_FAILURE:
441 av_log(avctx, AV_LOG_ERROR, "Could not send frame: %s\n", rav1e_status_to_str(ret));
442 return AVERROR_EXTERNAL;
444 av_log(avctx, AV_LOG_ERROR, "Unknown return code %d from rav1e_send_frame: %s\n", ret, rav1e_status_to_str(ret));
445 return AVERROR_UNKNOWN;
451 static int librav1e_receive_packet(AVCodecContext *avctx, AVPacket *pkt)
453 librav1eContext *ctx = avctx->priv_data;
454 RaPacket *rpkt = NULL;
459 if (avctx->flags & AV_CODEC_FLAG_PASS1) {
460 int sret = get_stats(avctx, 0);
463 } else if (avctx->flags & AV_CODEC_FLAG_PASS2) {
464 int sret = set_stats(avctx);
469 ret = rav1e_receive_packet(ctx->ctx, &rpkt);
471 case RA_ENCODER_STATUS_SUCCESS:
473 case RA_ENCODER_STATUS_LIMIT_REACHED:
474 if (avctx->flags & AV_CODEC_FLAG_PASS1) {
475 int sret = get_stats(avctx, 1);
480 case RA_ENCODER_STATUS_ENCODED:
481 if (avctx->internal->draining)
483 return AVERROR(EAGAIN);
484 case RA_ENCODER_STATUS_NEED_MORE_DATA:
485 if (avctx->internal->draining) {
486 av_log(avctx, AV_LOG_ERROR, "Unexpected error when receiving packet after EOF.\n");
487 return AVERROR_EXTERNAL;
489 return AVERROR(EAGAIN);
490 case RA_ENCODER_STATUS_FAILURE:
491 av_log(avctx, AV_LOG_ERROR, "Could not encode frame: %s\n", rav1e_status_to_str(ret));
492 return AVERROR_EXTERNAL;
494 av_log(avctx, AV_LOG_ERROR, "Unknown return code %d from rav1e_receive_packet: %s\n", ret, rav1e_status_to_str(ret));
495 return AVERROR_UNKNOWN;
498 ret = av_new_packet(pkt, rpkt->len);
500 av_log(avctx, AV_LOG_ERROR, "Could not allocate packet.\n");
501 rav1e_packet_unref(rpkt);
505 memcpy(pkt->data, rpkt->data, rpkt->len);
507 if (rpkt->frame_type == RA_FRAME_TYPE_KEY)
508 pkt->flags |= AV_PKT_FLAG_KEY;
510 pkt->pts = pkt->dts = rpkt->input_frameno * avctx->ticks_per_frame;
511 rav1e_packet_unref(rpkt);
513 if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) {
514 int ret = av_bsf_send_packet(ctx->bsf, pkt);
516 av_log(avctx, AV_LOG_ERROR, "extradata extraction send failed.\n");
517 av_packet_unref(pkt);
521 ret = av_bsf_receive_packet(ctx->bsf, pkt);
523 av_log(avctx, AV_LOG_ERROR, "extradata extraction receive failed.\n");
524 av_packet_unref(pkt);
532 #define OFFSET(x) offsetof(librav1eContext, x)
533 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
535 static const AVOption options[] = {
536 { "qp", "use constant quantizer mode", OFFSET(quantizer), AV_OPT_TYPE_INT, { .i64 = 100 }, -1, 255, VE },
537 { "speed", "what speed preset to use", OFFSET(speed), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 10, VE },
538 { "tiles", "number of tiles encode with", OFFSET(tiles), AV_OPT_TYPE_INT, { .i64 = 0 }, -1, INT64_MAX, VE },
539 { "tile-rows", "number of tiles rows to encode with", OFFSET(tile_rows), AV_OPT_TYPE_INT, { .i64 = 0 }, -1, INT64_MAX, VE },
540 { "tile-columns", "number of tiles columns to encode with", OFFSET(tile_cols), AV_OPT_TYPE_INT, { .i64 = 0 }, -1, INT64_MAX, VE },
541 { "rav1e-params", "set the rav1e configuration using a :-separated list of key=value parameters", OFFSET(rav1e_opts), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
545 static const AVCodecDefault librav1e_defaults[] = {
548 { "keyint_min", "0" },
554 const enum AVPixelFormat librav1e_pix_fmts[] = {
557 AV_PIX_FMT_YUV420P10,
558 AV_PIX_FMT_YUV420P12,
561 AV_PIX_FMT_YUV422P10,
562 AV_PIX_FMT_YUV422P12,
565 AV_PIX_FMT_YUV444P10,
566 AV_PIX_FMT_YUV444P12,
570 static const AVClass class = {
571 .class_name = "librav1e",
572 .item_name = av_default_item_name,
574 .version = LIBAVUTIL_VERSION_INT,
577 AVCodec ff_librav1e_encoder = {
579 .long_name = NULL_IF_CONFIG_SMALL("librav1e AV1"),
580 .type = AVMEDIA_TYPE_VIDEO,
581 .id = AV_CODEC_ID_AV1,
582 .init = librav1e_encode_init,
583 .send_frame = librav1e_send_frame,
584 .receive_packet = librav1e_receive_packet,
585 .close = librav1e_encode_close,
586 .priv_data_size = sizeof(librav1eContext),
587 .priv_class = &class,
588 .defaults = librav1e_defaults,
589 .pix_fmts = librav1e_pix_fmts,
590 .capabilities = AV_CODEC_CAP_DELAY | AV_CODEC_CAP_AUTO_THREADS,
591 .caps_internal = FF_CODEC_CAP_INIT_CLEANUP,
592 .wrapper_name = "librav1e",