From 34a0ac41a880039c7fb4b3abce10d8e2ce48fac7 Mon Sep 17 00:00:00 2001
From: Rudolf Polzer <divVerent@xonotic.org>
Date: Sat, 2 Nov 2013 11:57:24 +0100
Subject: vf_aspect: support variables in evaluating the aspect ratios

Example: -vf setsar=sar="sar*9/10"

Signed-off-by: Rudolf Polzer <divverent@xonotic.org>
Signed-off-by: Anton Khirnov <anton@khirnov.net>
---
 doc/filters.texi | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 52 insertions(+), 2 deletions(-)

(limited to 'doc/filters.texi')

diff --git a/doc/filters.texi b/doc/filters.texi
index e4fb57eb69..afb48b1192 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -2049,10 +2049,35 @@ This filter accepts the following options:
 @table @option
 
 @item dar
-Output display aspect ratio, as a rational or a decimal number.
+Output display aspect ratio.
 
 @end table
 
+The parameter @var{dar} is an expression containing
+the following constants:
+
+@table @option
+@item E, PI, PHI
+the corresponding mathematical approximated values for e
+(euler number), pi (greek PI), phi (golden ratio)
+
+@item w, h
+the input width and height
+
+@item a
+same as @var{w} / @var{h}
+
+@item sar
+input sample aspect ratio
+
+@item dar
+input display aspect ratio, it is the same as (@var{w} / @var{h}) * @var{sar}
+
+@item hsub, vsub
+horizontal and vertical chroma subsample values. For example for the
+pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1.
+@end table
+
 For example to change the display aspect ratio to 16:9, specify:
 @example
 setdar=dar=16/9
@@ -2158,10 +2183,35 @@ This filter accepts the following options:
 @table @option
 
 @item sar
-Output sample aspect ratio, as a rational or decimal number.
+Output sample aspect ratio.
 
 @end table
 
+The parameter @var{sar} is an expression containing
+the following constants:
+
+@table @option
+@item E, PI, PHI
+the corresponding mathematical approximated values for e
+(euler number), pi (greek PI), phi (golden ratio)
+
+@item w, h
+the input width and height
+
+@item a
+same as @var{w} / @var{h}
+
+@item sar
+input sample aspect ratio
+
+@item dar
+input display aspect ratio, it is the same as (@var{w} / @var{h}) * @var{sar}
+
+@item hsub, vsub
+horizontal and vertical chroma subsample values. For example for the
+pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1.
+@end table
+
 For example to change the sample aspect ratio to 10:11, specify:
 @example
 setsar=sar=10/11
-- 
cgit v1.2.3