[FFmpeg-cvslog] doc/filters: extend syntax description for transpose, and add examples

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Wed Dec 12 12:36:25 2012 +0100| [a871b5cc98c2c0be6945502b8dbab791fe2f550c] | committer: Stefano Sabatini

doc/filters: extend syntax description for transpose, and add examples

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=a871b5cc98c2c0be6945502b8dbab791fe2f550c
---

 doc/filters.texi |   18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index 794fd47..55a6f68 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -3946,7 +3946,12 @@ Default mode is @code{merge}.
 
 Transpose rows with columns in the input video and optionally flip it.
 
-This filter accepts the following named parameters:
+The filter accepts parameters as a list of @var{key}=@var{value}
+pairs, separated by ":". If the key of the first options is omitted,
+the arguments are interpreted according to the following syntax:
+ at example
+transpose=@var{dir}:@var{passthrough}
+ at end example
 
 @table @option
 @item dir
@@ -4005,6 +4010,17 @@ Preserve landscape geometry (when @var{width} >= @var{height}).
 Default value is @code{none}.
 @end table
 
+For example to rotate by 90 degrees clockwise and preserve portrait
+layout:
+ at example
+transpose=dir=1:passthrough=portrait
+ at end example
+
+The command above can also be specified as:
+ at example
+transpose=1:portrait
+ at end example
+
 @section unsharp
 
 Sharpen or blur the input video.