From 526e2415bd1e7e3f1f601ca2eb5e94513a830c9a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cl=C3=A9ment=20B=C5=93sch?= Date: Tue, 18 Dec 2012 22:10:32 +0100 Subject: lavfi/gradfun: support named options. This breaks usage for out-of-range values. --- doc/filters.texi | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/filters.texi b/doc/filters.texi index 2f50d65bb8..6e9ebc75f2 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -2665,19 +2665,21 @@ This filter is designed for playback only. Do not use it prior to lossy compression, because compression tends to lose the dither and bring back the bands. -The filter takes two optional parameters, separated by ':': -@var{strength}:@var{radius} +The filter accepts a list of options in the form of @var{key}=@var{value} pairs +separated by ":". A description of the accepted options follows. @var{strength} is the maximum amount by which the filter will change any one pixel. Also the threshold for detecting nearly flat regions. Acceptable values range from .51 to 64, default value is -1.2, out-of-range values will be clipped to the valid range. +1.2. @var{radius} is the neighborhood to fit the gradient to. A larger radius makes for smoother gradients, but also prevents the filter from modifying the pixels near detailed regions. Acceptable values are -8-32, default value is 16, out-of-range values will be clipped to the -valid range. +8-32, default value is 16. + +Alternatively, the options can be specified as a flat string: +@var{strength}[:@var{radius}] @example # default parameters -- cgit v1.2.3