diff options
author | Stefano Sabatini <stefasab@gmail.com> | 2013-04-08 17:16:06 +0400 |
---|---|---|
committer | Stefano Sabatini <stefasab@gmail.com> | 2013-04-21 20:24:04 +0400 |
commit | 3e40b85683e6a4c299e1f95383be4046a2dd9e9c (patch) | |
tree | 095ec18cc0f88c60086f69c250c4f8f7c0dbfd30 /doc | |
parent | df766673e57753bcc2e3877e15971275820c069f (diff) |
lavfi: add interleave filters
Diffstat (limited to 'doc')
-rw-r--r-- | doc/filters.texi | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/doc/filters.texi b/doc/filters.texi index 39747f943e..a4a0893186 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -7475,6 +7475,54 @@ do not have exactly the same duration in the first file. @end itemize +@section interleave, ainterleave + +Temporally interleave frames from several inputs. + +@code{interleave} works with video inputs, @code{ainterleave} with audio. + +These filters read frames from several inputs and send the oldest +queued frame to the output. + +Input streams must have a well defined, monotonically increasing frame +timestamp values. + +In order to submit one frame to output, these filters need to enqueue +at least one frame for each input, so they cannot work in case one +input is not yet terminated and will not receive incoming frames. + +For example consider the case when one input is a @code{select} filter +which always drop input frames. The @code{interleave} filter will keep +reading from that input, but it will never be able to send new frames +to output until the input will send an end-of-stream signal. + +Also, depending on inputs synchronization, the filters will drop +frames in case one input receives more frames than the other ones, and +the queue is already filled. + +These filters accept the following options: + +@table @option +@item nb_inputs, n +Set the number of different inputs, it is 2 by default. +@end table + +@subsection Examples + +@itemize +@item +Interleave frames belonging to different streams using @command{ffmpeg}: +@example +ffmpeg -i bambi.avi -i pr0n.mkv -filter_complex "[0:v][1:v] interleave" out.avi +@end example + +@item +Add flickering blur effect: +@example +select='if(gt(random(0), 0.2), 1, 2)':n=2 [tmp], boxblur=2:2, [tmp] interleave +@end example +@end itemize + @section showspectrum Convert input audio to a video output, representing the audio frequency |