[FFmpeg-devel] [PATCH v2] doc/encoders: document libjxl encoder options

[FFmpeg-devel] [PATCH v2] doc/encoders: document libjxl encoder options

[Leo Izen]

Add more detailed documenation for the libjxl encoder
wrapper than is present currently inside libavcodec.
---
 doc/encoders.texi | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/doc/encoders.texi b/doc/encoders.texi
index aac9f25e55..51f0dc3fcb 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -1809,6 +1809,41 @@ by ":". See the SVT-AV1 encoder user guide for a list of accepted parameters.
 
 @end table
 
+@section libjxl
+
+libjxl JPEG XL encoder wrapper.
+
+Requires the presence of the libjxl headers and library during
+configuration. You need to explicitly configure the build with
+@code{--enable-libjxl}.
+
+@subsection Options
+
+The libjxl wrapper supports the following options:
+
+@table @option
+
+@item distance
+Set the target Butteraugli distance. This is a quality setting: lower
+distance yields higher quality, with distance=1.0 roughly comparable to
+libjpeg Quality 90 for photographic content. Setting distance=0.0 yields
+true lossless encoding. Valid values range between 0.0 and 15.0, and sane
+values rarely exceed 5.0. Setting distance=0.1 is usually attains
+transparency for most input. The default is 1.0.
+
+@item effort
+Set the encoding effort used. Higher effort values produce more consistent
+quality and usually produces a better quality/bpp curve, at the cost of
+more CPU time required. Valid values range from 1 to 9, and the default is 7.
+
+@item modular
+Force the encoder to use Modular mode instead of choosing automatically. The
+default is to use VarDCT for lossy encoding and Modular for lossless. VarDCT
+is generally superior to Modular for lossy encoding but does not support
+lossless encoding.
+
+@end table
+
 @section libkvazaar
 
 Kvazaar H.265/HEVC encoder.
-- 
2.36.0

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".

Re: [FFmpeg-devel] [PATCH v2] doc/encoders: document libjxl encoder options

[Gyan Doshi]

Pushed as ec07b1547753864d1fb47eb2747613dddba507b2

On 2022-04-27 08:30 pm, Leo Izen wrote:
> Add more detailed documenation for the libjxl encoder
> wrapper than is present currently inside libavcodec.
> ---
>   doc/encoders.texi | 35 +++++++++++++++++++++++++++++++++++
>   1 file changed, 35 insertions(+)
>
> diff --git a/doc/encoders.texi b/doc/encoders.texi
> index aac9f25e55..51f0dc3fcb 100644
> --- a/doc/encoders.texi
> +++ b/doc/encoders.texi
> @@ -1809,6 +1809,41 @@ by ":". See the SVT-AV1 encoder user guide for a list of accepted parameters.
>   
>   @end table
>   
> +@section libjxl
> +
> +libjxl JPEG XL encoder wrapper.
> +
> +Requires the presence of the libjxl headers and library during
> +configuration. You need to explicitly configure the build with
> +@code{--enable-libjxl}.
> +
> +@subsection Options
> +
> +The libjxl wrapper supports the following options:
> +
> +@table @option
> +
> +@item distance
> +Set the target Butteraugli distance. This is a quality setting: lower
> +distance yields higher quality, with distance=1.0 roughly comparable to
> +libjpeg Quality 90 for photographic content. Setting distance=0.0 yields
> +true lossless encoding. Valid values range between 0.0 and 15.0, and sane
> +values rarely exceed 5.0. Setting distance=0.1 is usually attains
> +transparency for most input. The default is 1.0.
> +
> +@item effort
> +Set the encoding effort used. Higher effort values produce more consistent
> +quality and usually produces a better quality/bpp curve, at the cost of
> +more CPU time required. Valid values range from 1 to 9, and the default is 7.
> +
> +@item modular
> +Force the encoder to use Modular mode instead of choosing automatically. The
> +default is to use VarDCT for lossy encoding and Modular for lossless. VarDCT
> +is generally superior to Modular for lossy encoding but does not support
> +lossless encoding.
> +
> +@end table
> +
>   @section libkvazaar
>   
>   Kvazaar H.265/HEVC encoder.

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".