diff mbox series

[FFmpeg-devel,RFC,v4,5/5] doc/encoders.texi: Add documentation for JPEG2000 layers

Message ID 20200825042007.18535-5-gautamramk@gmail.com
State New
Headers show
Series [FFmpeg-devel,RFC,v4,1/5] libavcodec/jpeg2000: Make tag tree functions non static | expand

Checks

Context Check Description
andriy/default pending
andriy/make success Make finished
andriy/make_fate success Make fate finished

Commit Message

Gautam Ramakrishnan Aug. 25, 2020, 4:20 a.m. UTC
From: Gautam Ramakrishnan <gautamramk@gmail.com>

This patch adds documentation for the utility and usage
of "layer_rates" option used in the JPEG2000 encoder.
---
 doc/encoders.texi | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

Comments

Michael Niedermayer Aug. 25, 2020, 8:37 a.m. UTC | #1
On Tue, Aug 25, 2020 at 09:50:07AM +0530, gautamramk@gmail.com wrote:
> From: Gautam Ramakrishnan <gautamramk@gmail.com>
> 
> This patch adds documentation for the utility and usage
> of "layer_rates" option used in the JPEG2000 encoder.
> ---
>  doc/encoders.texi | 16 ++++++++++++++++
>  1 file changed, 16 insertions(+)

this should be in the patch which adds the feature described
that way its all selfcontained

thx

[...]
Gautam Ramakrishnan Aug. 25, 2020, 9:51 a.m. UTC | #2
On Tue, Aug 25, 2020 at 2:07 PM Michael Niedermayer
<michael@niedermayer.cc> wrote:
>
> On Tue, Aug 25, 2020 at 09:50:07AM +0530, gautamramk@gmail.com wrote:
> > From: Gautam Ramakrishnan <gautamramk@gmail.com>
> >
> > This patch adds documentation for the utility and usage
> > of "layer_rates" option used in the JPEG2000 encoder.
> > ---
> >  doc/encoders.texi | 16 ++++++++++++++++
> >  1 file changed, 16 insertions(+)
>
> this should be in the patch which adds the feature described
> that way its all selfcontained
I'll squash this with the previous patch and resubmit.
>
> thx
>
> [...]
> --
> Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB
>
> I do not agree with what you have to say, but I'll defend to the death your
> right to say it. -- Voltaire
> _______________________________________________
> 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".
diff mbox series

Patch

diff --git a/doc/encoders.texi b/doc/encoders.texi
index fd9235a05a..481ad2fb3d 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -1401,6 +1401,22 @@  Possible values are:
 @end table
 Set to @code{lrcp} by default.
 
+@item layer_rates @var{string}
+By default, compression is done using the quality metric. This option allows for
+compression using compression ratio. The compression ratio for each level could
+be specified. The compression ratio of a layer @code{l} species the what ratio of
+total file size is contained in the first @code{l} layers.
+
+Example usage:
+
+@example
+ffmpeg -i input.bmp -c:v jpeg2000 -layer_rates "100,10,1" output.j2k
+@end example
+
+This would compress the image to contain 3 layers, where the data contained in the
+first layer would be compressed by 1000 times, compressed by 100 in the first two layers,
+and shall contain all data while using all 3 layers.
+
 @end table
 
 @section librav1e