From patchwork Sun Oct 28 20:08:18 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mark Thompson X-Patchwork-Id: 10823 Return-Path: X-Original-To: patchwork@ffaux-bg.ffmpeg.org Delivered-To: patchwork@ffaux-bg.ffmpeg.org Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by ffaux.localdomain (Postfix) with ESMTP id AF09544E1DD for ; Sun, 28 Oct 2018 22:08:30 +0200 (EET) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 233C668A495; Sun, 28 Oct 2018 22:08:02 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-wr1-f66.google.com (mail-wr1-f66.google.com [209.85.221.66]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 8F70668A286 for ; Sun, 28 Oct 2018 22:07:55 +0200 (EET) Received: by mail-wr1-f66.google.com with SMTP id i17-v6so6399718wre.7 for ; Sun, 28 Oct 2018 13:08:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jkqxz-net.20150623.gappssmtp.com; s=20150623; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=YK5g9pQy1YpTxyfZuVAealka/96M7D4tS1xCZXD1WyI=; b=w6pVf2yNwA9jdwVfEMbtghaZj7x+p8XjBRSSvEHVQoVoODwban6argyVsJ/UREuQkB gta+Tsr2/8hwcEx+bsriR8yFi0TZzan8rtUD3VMdLenfaM9AEVpz3Ddua3xHoEItUGlZ iXSxsCwq1UBMrEpfY003M1Mj90lEWhPnpxQU7zByALjgoFbygehSh8D486JVxFbzUMLx o+wVGE2jBb/lqcS7w6sjpJjX/mFsUKwQ7BMmnQvpVG4UsLTsbuARAZsp5EThIVAxFj6l S4nIVZWfWaKlQuP//WPn/wBvR0Z+OcrDO/Uqypd2SRZtIEJe2PyHNHZuB9hdAmHyD8+6 37nA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=YK5g9pQy1YpTxyfZuVAealka/96M7D4tS1xCZXD1WyI=; b=ZTAhD5nb0uVcolsqpmlojNbIWvthPHPvMdA+Ir+ejQ16t0dYi6c2bC1iXrJtsRlK9A C1aFICJydECGlBkaCPnaVL3TvXgCMnFGFxdBEpqQtNsS/T6hmcS5uXvly0zczUlvLoWV DEY7lwETy5uMYGE2i6v/+63CmrAScnrGTHGMOSPKq4qIX826gKU8WiRsw9aTsCtdNzG6 oD3yEyMW87BQJMIcpx4gA8ZZbsd3ppMRKzwtt7p3LBVqhVMUE+qJpuF7ESvSJN0t0Szj mZYtfVcNAFrZsixXNbwfF+gO3WG0vrg4BWziwbkL1Z5xtnJLMeM9hAcJ46iD8VImCYdi SZSg== X-Gm-Message-State: AGRZ1gJfI+R4TT5M63D+dY1yeB3LPICDW/JWy50PDuts549Zn17X/RnZ Z61V752zCV+OJCH9R7ywALhfVo3MUmo= X-Google-Smtp-Source: AJdET5ey8mzu+DtDBruzl91Rkj7uAOjg/7WDjqrNmOdkjQqLm2rdzTtyMiZvD0y2nCIMOHNk6G+uTw== X-Received: by 2002:a5d:5012:: with SMTP id e18-v6mr8022034wrt.161.1540757305148; Sun, 28 Oct 2018 13:08:25 -0700 (PDT) Received: from rywe.jkqxz.net (cpc91242-cmbg18-2-0-cust650.5-4.cable.virginm.net. [82.8.130.139]) by smtp.gmail.com with ESMTPSA id c9-v6sm15350840wrh.50.2018.10.28.13.08.23 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 28 Oct 2018 13:08:24 -0700 (PDT) From: Mark Thompson To: ffmpeg-devel@ffmpeg.org Date: Sun, 28 Oct 2018 20:08:18 +0000 Message-Id: <20181028200819.15139-2-sw@jkqxz.net> X-Mailer: git-send-email 2.19.1 In-Reply-To: <20181028200819.15139-1-sw@jkqxz.net> References: <20181028200819.15139-1-sw@jkqxz.net> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 2/3] doc/encoders: Add libaom-av1 X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" --- doc/encoders.texi | 103 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) diff --git a/doc/encoders.texi b/doc/encoders.texi index 1ca0ef1543..3156f5d65c 100644 --- a/doc/encoders.texi +++ b/doc/encoders.texi @@ -1370,6 +1370,109 @@ makes it possible to store non-rgb pix_fmts. @end table +@section libaom-av1 + +libaom AV1 encoder wrapper. + +Requires the presence of the libaom headers and library during +configuration. You need to explicitly configure the build with +@code{--enable-libaom}. + +@subsection Options + +The wrapper supports the following standard libavcodec options: + +@table @option + +@item b +Set bitrate in bits/second. + +@item g +Set GOP size (maximum distance between key frames). + +@item qmin qmax +Set minimum/maximum quantisation values. Valid range is from 0 to 63 +(warning: this does not match the quantiser values actually used by AV1 +- divide by four to map real quantiser values to this range). Defaults +to min/max (no constraint). + +@item minrate maxrate bufsize rc_init_occupancy +Set rate control buffering parameters. Not used if not set - defaults +to unconstrained variable bitrate. + +@item threads +Set the number of threads to use while encoding. This may require the +@option{tiles} option to also be set to actually use the specified +number of threads fully. Defaults to the number of hardware threads +supported by the host machine. + +@item profile +Set the encoding profile. Defaults to using the profile which matches +the bit depth and chroma subsampling of the input. + +@item color_range color_primaries colorspace color_trc +Set colour properties. Defaults to using the properties from the input, +if available. + +@end table + +The wrapper also has some specific options: + +@table @option + +@item cpu-used +Set the quality/encoding speed tradeoff. Valid range is from 0 to 8, +higher numbers indicating greater speed and lower quality. The default +value is 1, which will be slow and high quality. + +@item auto-alt-ref +Enable use of alternate reference frames. Defaults to the internal +default of the library. + +@item lag-in-frames +Set the maximum number of frames which the encoder may keep in flight +at any one time for lookahead purposes. Defaults to the internal +default of the library. + +@item error-resilience +Enable error resilience features: +@table @option +@item default +Improve resilience against losses of whole frames. +@end table +Not enabled by default. + +@item crf +Set the quality/size tradeoff for constant-quality and +constrained-quality modes. Valid range is 0 to 63, higher numbers +indicating lower quality and smaller output size. Only used if set, +uses the bitrate target only by default. + +@item static-thresh +Set a change threshold on blocks below which they will be skipped by +the encoder. Defined in arbitrary units as a nonnegative integer, +defaulting to zero (no blocks are skipped). + +@item drop-threshold +Set a threshold for dropping frames when close to rate control bounds. +Defined as a percentage of the target buffer - when the rate control +buffer falls below this percentage, frames will be dropped until it +has refilled above the threshold. Defaults to zero (no frames are +dropped). + +@item tiles +Set the number of tiles to encode the input video with, as colums x +rows. Larger numbers allow greater parallelism in both encoding and +decoding, but may decrease coding efficiency. Defaults to the minimum +number of tiles required by the size of the input video (this is 1x1 +(that is, a single tile) for sizes up to and including 4K). + +@item tile-columns tile-rows +Set the number of tiles as log2 of the number of tile rows and columns. +Provided for compatibility with libvpx/VP9. + +@end table + @section libkvazaar Kvazaar H.265/HEVC encoder.