summaryrefslogtreecommitdiff
path: root/doc/filters.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/filters.texi')
-rw-r--r--doc/filters.texi13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/filters.texi b/doc/filters.texi
index df1e0c7326..ea04450965 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -3256,6 +3256,10 @@ named options, expressed as a sequence of @var{key}=@var{value} pairs,
separated by ":".
@table @option
+@item max
+Set the maximum integer value to use for expressing numerator and
+denominator when reducing the expressed aspect ratio to a rational.
+Default value is @code{100}.
@item r, ratio:
Set the aspect ratio used by the filter.
@@ -3268,6 +3272,9 @@ In case the form "@var{num}:@var{den}" the @code{:} character should
be escaped.
@end table
+If the keys are omitted in the named options list, the specifed values
+are assumed to be @var{ratio} and @var{max} in that order.
+
For example to change the display aspect ratio to 16:9, specify:
@example
setdar='16:9'
@@ -3283,6 +3290,12 @@ To change the sample aspect ratio to 10:11, specify:
setsar='10:11'
@end example
+To set a display aspect ratio of 16:9, and specify a maximum integer value of
+1000 in the aspect ratio reduction, use the command:
+@example
+setdar=ratio='16:9':max=1000
+@end example
+
@section setfield
Force field for the output video frame.