-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 04/12/14 08:24, tim nicholson wrote:
> On 02/12/14 17:13, Michael Niedermayer wrote:
>> On Tue, Dec 02, 2014 at 05:02:49PM +0000, tim nicholson wrote:
>>> On 02/12/14 15:33, Michael Niedermayer wrote:
>>>> Signed-off-by: Michael Niedermayer <michae...@gmx.at>
>>>> ---
>>>>  doc/filters.texi |  131 
>>>> ++++++++++++++++++++++++++++++++++++++++++++++++++++++
>>>>  1 file changed, 131 insertions(+)
>>>>
>>>> diff --git a/doc/filters.texi b/doc/filters.texi
>>>> index 8c16c7a..0ea3955 100644
>>>> --- a/doc/filters.texi
>>>> +++ b/doc/filters.texi
>>>> @@ -8537,33 +8537,164 @@ Available values are:
>>>>  @item merge, 0
>>>>  Move odd frames into the upper field, even into the lower field,
>>>>  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
>>>> [..]
>>>
>>> I find the ascii graphic style of the interlace filter more
>>> understandable....
> 
>> how do you suggest above (and the other modes) would be documented
>> in that style ?
> 
> 
> Sorry for the delayed reply ISP issue...
> 
> I think the main difference is going left to right, not top to bottom
> for input to output, this then matches not only interlace but the
> general filtergraph descriptions.
> 
> I will try and see if I can give an example if you like.
> 

Attached, follows style of existing interlace filter ascii art.

> 
>> [...]

- -- 
Tim.
Key Fingerprint 38CF DB09 3ED0 F607 8B67 6CED 0C0B FC44 8B0B FC83
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBAgAGBQJUgIWzAAoJEAwL/ESLC/yDGVMIAL/B/xLvAMPYUUW63RHxTiCP
XQpKYKtfsFR6+QaC+pql1WSl8mYvlFRJUYLOm6ESd9JS72gLv6UTs1rLdITKaRdo
SkSVLBWiVAdY8nzjNESjxWnolelM1JzcEopnfqT1hcxeGnyAx+IMHBd3pW0+r/6U
F1BSnTM3yCELBvS/t7d4ZlpZkw4IDO2Lx0qseKi6CvQA/8ehfP9TcRbfdVgotcTf
4zorBilGKhZgaqpftxz8Kxbcldv/xrCczBOWVbB3sZRp4A6zLI9Xuc1c2hIyOia9
EbvHOPmyEBBKdoa31aK8pjFf8gqXF4pM+ZbeaYfR00/WRJC2PbB+tKBQIXXNX4M=
=cLiK
-----END PGP SIGNATURE-----
>From 365723f7bae6bd5e233f6c5550826cd9aeb956f2 Mon Sep 17 00:00:00 2001
From: Tim Nicholson <tim.nichol...@bbc.co.uk>
Date: Thu, 4 Dec 2014 15:55:59 +0000
Subject: [PATCH] doc/filters: Add ascii graphics to clarify what the currently
 implemented tinterlace modes do

Signed-off-by: Tim Nicholson <tim.nichol...@bbc.co.uk>
---
 doc/filters.texi | 151 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 151 insertions(+)

diff --git a/doc/filters.texi b/doc/filters.texi
index 8c16c7a..01f1f63 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -8537,26 +8537,116 @@ Available values are:
 @item merge, 0
 Move odd frames into the upper field, even into the lower field,
 generating a double height frame at half frame rate.
+@example
+   Original        Original             New Frame
+   Frame 'j'      Frame 'j+1'
+  ==========      ===========       ==================
+    Line 0  -------------------->   Frame 'j'   Line 0
+                    Line 0  ---->   Frame 'j+1' Line 1
+    Line 1 --------------------->   Frame 'j'   Line 2
+                    Line 1  ---->   Frame 'j+1' Line 3
+    Line 2  -------------------->   Frame 'j'   Line 4
+                    Line 2  ---->   Frame 'j+1' Line 5
+    Line 3 --------------------->   Frame 'j'   Line 6
+                    Line 3  ---->   Frame 'j+1' Line 7
+@end example
 
 @item drop_odd, 1
 Only output even frames, odd frames are dropped, generating a frame with
 unchanged height at half frame rate.
+@example
+   Original        Original             New Frame
+   Frame 'j'      Frame 'j+1'
+  ==========      ===========       ==================
+    Line 0
+                    Line 0  ---->   Frame 'j+1' Line 0
+    Line 1
+                    Line 1  ---->   Frame 'j+1' Line 1
+    Line 2
+                    Line 2  ---->   Frame 'j+1' Line 2
+    Line 3
+                    Line 3  ---->   Frame 'j+1' Line 3
+@end example
 
 @item drop_even, 2
 Only output odd frames, even frames are dropped, generating a frame with
 unchanged height at half frame rate.
+@example
+   Original        Original             New Frame
+   Frame 'j'      Frame 'j+1'
+  ==========      ===========       ==================
+    Line 0  -------------------->   Frame 'j'   Line 0
+                    Line 0
+    Line 1 --------------------->   Frame 'j'   Line 1
+                    Line 1
+    Line 2  -------------------->   Frame 'j'   Line 2
+                    Line 2
+    Line 3 --------------------->   Frame 'j'   Line 3
+                    Line 3
+@end example
 
 @item pad, 3
 Expand each frame to full height, but pad alternate lines with black,
 generating a frame with double height at the same input frame rate.
+@example
+   Original                              New Frame
+   Frame 'j'                             Frame 'n'
+  ==========                        ==================
+    Line 0  --------------------->  Frame 'j'   Line 0
+                                    black       Line 1
+    Line 1  --------------------->  Frame 'j'   Line 2
+                                    black       Line 3
+    Line 2  --------------------->  Frame 'j'   Line 4
+                                    black       Line 5
+    Line 3  --------------------->  Frame 'j'   Line 6
+                                    black       Line 7
+
+   Original                              New Frame
+   Frame 'j+1'                          Frame 'n+1'
+  ===========                       ==================
+                                    black       Line 0
+    Line 0  --------------------->  Frame 'j+1' Line 1
+                                    black       Line 2
+    Line 1  --------------------->  Frame 'j+1' Line 3
+                                    black       Line 4
+    Line 2  --------------------->  Frame 'j+1' Line 5
+                                    black       Line 6
+    Line 3  --------------------->  Frame 'j+1' Line 7
+@end example
 
 @item interleave_top, 4
 Interleave the upper field from odd frames with the lower field from
 even frames, generating a frame with unchanged height at half frame rate.
+@example
+   Original        Original             New Frame
+   Frame 'j'      Frame 'j+1'             (tff)
+  ==========      ===========       ==================
+    Line 0  -------------------->   Frame 'j'   Line 0
+                    Line 1  ---->   Frame 'j+1' Line 1
+    Line 2 --------------------->   Frame 'j'   Line 2
+                    Line 3  ---->   Frame 'j+1' Line 3
+    Line 4  -------------------->   Frame 'j'   Line 4
+                    Line 5  ---->   Frame 'j+1' Line 5
+    Line 6 --------------------->   Frame 'j'   Line 6
+                    Line 7  ---->   Frame 'j+1' Line 7
+@end example
 
 @item interleave_bottom, 5
 Interleave the lower field from odd frames with the upper field from
 even frames, generating a frame with unchanged height at half frame rate.
+@example
+   Original        Original             New Frame
+   Frame 'j'      Frame 'j+1'             (bff)
+  ==========      ===========       ==================
+                    Line 0------>   Frame 'j+1' Line 0
+    Line 1 --------------------->   Frame 'j'   Line 1
+                    Line 2------>   Frame 'j+1' Line 2
+    Line 3 --------------------->   Frame 'j'   Line 3
+                    Line 4------>   Frame 'j+1' Line 4
+    Line 5 --------------------->   Frame 'j'   Line 5
+                    Line 6------>   Frame 'j+1' Line 6
+    Line 7 --------------------->   Frame 'j'   Line 7
+@end example
 
 @item interlacex2, 6
 Double frame rate with unchanged height. Frames are inserted each
@@ -8564,6 +8654,67 @@ 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 top_field_first flag. Useful for interlaced video displays with no
 field synchronisation.
+@example
+   Original                              New Frame
+   Frame 'j'                             Frame 'n'
+  ==========                        ==================
+    Line 0 --------------------->   Frame 'j'   Line 0
+    Line 1 --------------------->   Frame 'j'   Line 1
+    Line 2 --------------------->   Frame 'j'   Line 2
+    Line 3 --------------------->   Frame 'j'   Line 3
+    Line 4 --------------------->   Frame 'j'   Line 4
+    Line 5 --------------------->   Frame 'j'   Line 5
+    Line 6 --------------------->   Frame 'j'   Line 6
+    Line 7 --------------------->   Frame 'j'   Line 7
+
+   Original        Original              New Frame
+   Frame 'j'      Frame 'j+1'           Frame 'n+1'
+  ==========      ===========       ==================
+                    Line 0------>   Frame 'j+1' Line 0
+    Line 1 --------------------->   Frame 'j'   Line 1
+                    Line 2------>   Frame 'j+1' Line 2
+    Line 3 --------------------->   Frame 'j'   Line 3
+                    Line 4------>   Frame 'j+1' Line 4
+    Line 5 --------------------->   Frame 'j'   Line 5
+                    Line 6------>   Frame 'j+1' Line 6
+    Line 7 --------------------->   Frame 'j'   Line 7
+
+   Original                              New Frame
+   Frame 'j+1'                          Frame 'n+2'
+  ==========                        ==================
+    Line 0 --------------------->   Frame 'j+1' Line 0
+    Line 1 --------------------->   Frame 'j+1' Line 1
+    Line 2 --------------------->   Frame 'j+1' Line 2
+    Line 3 --------------------->   Frame 'j+1' Line 3
+    Line 4 --------------------->   Frame 'j+1' Line 4
+    Line 5 --------------------->   Frame 'j+1' Line 5
+    Line 6 --------------------->   Frame 'j+1' Line 6
+    Line 7 --------------------->   Frame 'j+1' Line 7
+
+   Original        Original              New Frame
+   Frame 'j+1'    Frame 'j+2'           Frame 'n+3'
+  ==========      ===========       ==================
+                    Line 0------>   Frame 'j+2' Line 0
+    Line 1 --------------------->   Frame 'j+1' Line 1
+                    Line 2------>   Frame 'j+2' Line 2
+    Line 3 --------------------->   Frame 'j+1' Line 3
+                    Line 4------>   Frame 'j+2' Line 4
+    Line 5 --------------------->   Frame 'j+1' Line 5
+                    Line 6------>   Frame 'j+2' Line 6
+    Line 7 --------------------->   Frame 'j+1' Line 7
+
+   Original                              New Frame
+   Frame 'j+2'                          Frame 'n+4'
+  ==========                        ==================
+    Line 0 --------------------->   Frame 'j+2' Line 0
+    Line 1 --------------------->   Frame 'j+2' Line 1
+    Line 2 --------------------->   Frame 'j+2' Line 2
+    Line 3 --------------------->   Frame 'j+2' Line 3
+    Line 4 --------------------->   Frame 'j+2' Line 4
+    Line 5 --------------------->   Frame 'j+2' Line 5
+    Line 6 --------------------->   Frame 'j+2' Line 6
+    Line 7 --------------------->   Frame 'j+2' Line 7
+@end example
 @end table
 
 Numeric values are deprecated but are accepted for backward
-- 
2.1.3

Attachment: 0001-doc-filters-Add-ascii-graphics-to-clarify-what-the-c.patch.sig
Description: PGP signature

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
http://ffmpeg.org/mailman/listinfo/ffmpeg-devel

Reply via email to