generic-library/ffmpeg
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

doc/filters: Add ascii graphics to clarify what the currently implemented tinterlace modes do

Browse Source 
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
This commit is contained in:
Michael Niedermayer
2014-12-02 16:32:25 +01:00
parent e65849a70b
commit b1c8dfc84e
1 changed files with 131 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

131
doc/filters.texi
View File

@@ -8537,33 +8537,164 @@ Available values are:
@item merge, 0 @item merge, 0
Move odd frames into the upper field, even into the lower field, Move odd frames into the upper field, even into the lower field,
generating a double height frame at half frame rate. generating a double height frame at half frame rate.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
Output:
11111 33333
22222 44444
11111 33333
22222 44444
11111 33333
22222 44444
11111 33333
22222 44444
@end example
@item drop_odd, 1 @item drop_odd, 1
Only output even frames, odd frames are dropped, generating a frame with Only output even frames, odd frames are dropped, generating a frame with
unchanged height at half frame rate. unchanged height at half frame rate.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
Output:
22222 44444
22222 44444
22222 44444
22222 44444
@end example
@item drop_even, 2 @item drop_even, 2
Only output odd frames, even frames are dropped, generating a frame with Only output odd frames, even frames are dropped, generating a frame with
unchanged height at half frame rate. unchanged height at half frame rate.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
Output:
11111 33333
11111 33333
11111 33333
11111 33333
@end example
@item pad, 3 @item pad, 3
Expand each frame to full height, but pad alternate lines with black, Expand each frame to full height, but pad alternate lines with black,
generating a frame with double height at the same input frame rate. generating a frame with double height at the same input frame rate.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
Output:
11111 ..... 33333 .....
..... 22222 ..... 44444
11111 ..... 33333 .....
..... 22222 ..... 44444
11111 ..... 33333 .....
..... 22222 ..... 44444
11111 ..... 33333 .....
..... 22222 ..... 44444
@end example
@item interleave_top, 4 @item interleave_top, 4
Interleave the upper field from odd frames with the lower field from Interleave the upper field from odd frames with the lower field from
even frames, generating a frame with unchanged height at half frame rate. even frames, generating a frame with unchanged height at half frame rate.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111<- 22222 33333<- 44444
11111 22222<- 33333 44444<-
11111<- 22222 33333<- 44444
11111 22222<- 33333 44444<-
Output:
11111 33333
22222 44444
11111 33333
22222 44444
@end example
@item interleave_bottom, 5 @item interleave_bottom, 5
Interleave the lower field from odd frames with the upper field from Interleave the lower field from odd frames with the upper field from
even frames, generating a frame with unchanged height at half frame rate. even frames, generating a frame with unchanged height at half frame rate.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111 22222<- 33333 44444<-
11111<- 22222 33333<- 44444
11111 22222<- 33333 44444<-
11111<- 22222 33333<- 44444
Output:
22222 44444
11111 33333
22222 44444
11111 33333
@end example
@item interlacex2, 6 @item interlacex2, 6
Double frame rate with unchanged height. Frames are inserted each Double frame rate with unchanged height. Frames are inserted each
containing the second temporal field from the previous input frame and containing the second temporal field from the previous input frame and
the first temporal field from the next input frame. This mode relies on the first temporal field from the next input frame. This mode relies on
the top_field_first flag. Useful for interlaced video displays with no the top_field_first flag. Useful for interlaced video displays with no
field synchronisation. field synchronisation.
@example
------> time
Input:
Frame 1 Frame 2 Frame 3 Frame 4
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
11111 22222 33333 44444
Output:
11111 22222 22222 33333 33333 44444 44444
11111 11111 22222 22222 33333 33333 44444
11111 22222 22222 33333 33333 44444 44444
11111 11111 22222 22222 33333 33333 44444
@end example
@end table @end table
Numeric values are deprecated but are accepted for backward Numeric values are deprecated but are accepted for backward