[FFmpeg-devel] [RFC]Add some docs for j2k encoding and remove experimental (instead of: Change the default j2k prediction to 5/3)

[Carl Eugen Hoyos]

Hi!

I just tested a patch to make the j2k encoder lossless by default 
but I had not realized that the encoder does listen to -qscale which 
might make more sense.

So instead I suggest the attached documentation update and the 
removal of the experimental flag.

Please comment, Carl Eugen
-------------- next part --------------
diff --git a/libavcodec/j2kenc.c b/libavcodec/j2kenc.c
index dcdf411..047dc13 100644
--- a/libavcodec/j2kenc.c
+++ b/libavcodec/j2kenc.c
@@ -1132,7 +1132,6 @@ AVCodec ff_jpeg2000_encoder = {
     .init           = j2kenc_init,
     .encode2        = encode_frame,
     .close          = j2kenc_destroy,
-    .capabilities   = CODEC_CAP_EXPERIMENTAL,
     .pix_fmts       = (const enum AVPixelFormat[]) {
         AV_PIX_FMT_RGB24, AV_PIX_FMT_YUV444P, AV_PIX_FMT_GRAY8,
 /*      AV_PIX_FMT_YUV420P,
-------------- next part --------------
diff --git a/doc/encoders.texi b/doc/encoders.texi
index 8fed2fc..851c3ae 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -1342,6 +1342,21 @@ disabled
 A description of some of the currently available video encoders
 follows.
 
+ at section jpeg2000
+
+The native jpeg 2000 encoder is lossy by default, the @code{-q:v}
+option can be used to set the encoding quality. Lossless encoding 
+can be selected with @code{-pred 1}.
+
+ at subsection Options
+
+ at table @option
+ at item format
+Can be set to either @code{j2k} or @code{jp2} (the default) that
+allows to store non-rgb pix_fmts.
+
+ at end table
+
 @section libtheora
 
 libtheora Theora encoder wrapper.