[FFmpeg-devel] [PATCH] Updated the documentation about the encoding options for libaom-av1 encoder.

[Sam John]

James,

Thanks for the review. I am sending the updated patch now.

libaom-av1 enables  global-motion/intrabc by default. These options were
added to enable/disable these tools to reduce the complexity. The default
value is set to -1.





On Thu, Apr 4, 2019 at 10:31 AM James Almer <jamrial at gmail.com> wrote:

> On 4/2/2019 9:49 PM, Sam John via ffmpeg-devel wrote:
> > ---
> >  doc/encoders.texi | 46 ++++++++++++++++++++++++++++++++++++++++++++++
> >  1 file changed, 46 insertions(+)
> >
> > diff --git a/doc/encoders.texi b/doc/encoders.texi
> > index 94337d009c..a669ac3739 100644
> > --- a/doc/encoders.texi
> > +++ b/doc/encoders.texi
> > @@ -1434,6 +1434,12 @@ value is 1, which will be slow and high quality.
> >  Enable use of alternate reference frames.  Defaults to the internal
> >  default of the library.
> >
> > + at item arnr-max-frames
> > +Set altref noise reduction max frame count.
> > +
> > + at item arnr-strength
> > +Set altref noise reduction filter strength.
> > +
> >  @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
> > @@ -1466,6 +1472,33 @@ buffer falls below this percentage, frames will
> be dropped until it
> >  has refilled above the threshold.  Defaults to zero (no frames are
> >  dropped).
> >
> > + at item denoise-noise-level
> > +Amount of noise to be removed for grain synthesis. Grain synthesis is
> disabled if
> > +it is not set or set to 0.
> > +
> > + at item denoise-block-size
> > +Block size used for denoising for grain synthesis. If not set, AV1 codec
> > +uses the default value of 32.
> > +
> > + at item undershoot-pct
> > +Set datarate undershoot (min) percentage of the target bitrate.
> > +
> > + at item overshoot-pct
> > +Set datarate overshoot (max) percentage of the target bitrate.
> > +
> > + at item maxrate (@emph{maxsection-pct})
> > +Set GOP max bitrate in bits/s. Note @command{libaom-av1}'s option
> maxsection-pct is
> > +specified as a percentage of the target bitrate. If maxsection-pct is
> not set, the
> > +libaomenc wrapper computes it as follows: @code{(maxrate * 100 /
> bitrate)}.
> > +
> > + at item minrate (@emph{minsection-pct})
> > +Set GOP min bitrate in bits/s. Note @command{libaom-av1}'s option
> minsection-pct is
> > +specified as a percentage of the target bitrate. If minsection-pct is
> not set, the
> > +libaomenc wrapper computes it as follows: @code{(minrate * 100 /
> bitrate)}.
> > +
> > + at item frame-parallel @var{boolean}
> > +Enable frame parallel decodability features. The default value is true.
> > +
> >  @item tiles
> >  Set the number of tiles to encode the input video with, as columns x
> >  rows.  Larger numbers allow greater parallelism in both encoding and
> > @@ -1480,6 +1513,19 @@ Provided for compatibility with libvpx/VP9.
> >  @item row-mt (Requires libaom >= 1.0.0-759-g90a15f4f2)
> >  Enable row based multi-threading. Disabled by default.
> >
> > + at item enable-cdef @var{boolean}
> > +Flag to enable or disable Constrianed Directional Enhancement Filter.
> The libaom-av1
> > +encoder enables CDEF by default.
> > +
> > + at item enable-global-motion @var{boolean}
> > +Flag to enable or disable the use of global motion for block
> prediction.
> > +The default value is true.
> > +
> > + at item enable-intrabc @var{boolean}
> > +Flag to enable or disable block copy mode for intra block prediction.
> This mode is
> > +useful for screen content. The default value is true.
>
> Maybe "The libaom-av1 encoder enables global-motion/intrabc by default"
> like you did for cdef. For all three the default value is -1, meaning up
> to the library.
>
> > +
> > +
> >  @end table
> >
> >  @section libkvazaar
> >
>
> _______________________________________________
> ffmpeg-devel mailing list
> ffmpeg-devel at ffmpeg.org
> https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
>
> To unsubscribe, visit link above, or email
> ffmpeg-devel-request at ffmpeg.org with subject "unsubscribe".