Add format and noformat filters.

Originally committed as revision 20390 to svn://svn.ffmpeg.org/ffmpeg/trunk

1 files changed, 34 insertions, 0 deletions

diff --git a/doc/libavfilter.texi b/doc/libavfilter.texi
index dc10207bc4..4a4a953392 100644
--- a/doc/libavfilter.texi
+++ b/doc/libavfilter.texi
@@ -111,6 +111,40 @@ corner of the input image.
 
 The default value of ``width'' and ``height'' is 0.
 
+@section format
+
+Convert the input video to one of the specified pixel formats.
+Libavfilter will try to pick one that is supported as the input to
+the next filter.
+
+The filter takes as argument a list of pixel format names, separated
+by ``:'', for example ``yuv420p:monow:rgb24''.
+
+The following command:
+
+@example
+./ffmpeg -i in.avi -vfilters "format=yuv420p" out.avi
+@end example
+
+will convert the input video to the format ``yuv420p''.
+
+@section noformat
+
+Force libavfilter not to use any of the specified pixel formats as the
+input to the next filter.
+
+The filter takes as argument a list of pixel format names, separated
+by ``:'', for example ``yuv420p:monow:rgb24''.
+
+The following command:
+
+@example
+./ffmpeg -i in.avi -vfilters "noformat=yuv420p, vflip" out.avi
+@end example
+
+will make libavfilter use a format different from ``yuv420p'' as the
+input to the vflip filter.
+
 @section null
 
 Pass the source unchanged to the output.