From b9dfee9fa259dfc885508179a359dccc9e7840bd Mon Sep 17 00:00:00 2001 From: Anton Khirnov Date: Mon, 25 Feb 2013 21:21:29 +0100 Subject: vf_fade: switch to an AVOptions-based system. --- doc/filters.texi | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) (limited to 'doc/filters.texi') diff --git a/doc/filters.texi b/doc/filters.texi index 27b6093b89..0cbbe6b6f3 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -1000,33 +1000,37 @@ For more information about libfreetype, check: Apply fade-in/out effect to input video. -It accepts the parameters: -@var{type}:@var{start_frame}:@var{nb_frames} +This filter accepts the following options: + +@table @option -@var{type} specifies if the effect type, can be either "in" for -fade-in, or "out" for a fade-out effect. +@item type +The effect type -- can be either "in" for fade-in, or "out" for a fade-out +effect. + +@item start_frame +The number of the start frame for starting to apply the fade effect. -@var{start_frame} specifies the number of the start frame for starting -to apply the fade effect. +@item nb_frames +The number of frames for which the fade effect has to last. At the end of the +fade-in effect the output video will have the same intensity as the input video, +at the end of the fade-out transition the output video will be completely black. -@var{nb_frames} specifies the number of frames for which the fade -effect has to last. At the end of the fade-in effect the output video -will have the same intensity as the input video, at the end of the -fade-out transition the output video will be completely black. +@end table A few usage examples follow, usable too as test scenarios. @example # fade in first 30 frames of video -fade=in:0:30 +fade=type=in:nb_frames=30 # fade out last 45 frames of a 200-frame video -fade=out:155:45 +fade=type=out:start_frame=155:nb_frames=45 # fade in first 25 frames and fade out last 25 frames of a 1000-frame video -fade=in:0:25, fade=out:975:25 +fade=type=in:start_frame=0:nb_frames=25, fade=type=out:start_frame=975:nb_frames=25 # make first 5 frames black, then fade in from frame 5-24 -fade=in:5:20 +fade=type=in:start_frame=5:nb_frames=20 @end example @section fieldorder -- cgit v1.2.3