1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>interlace: GStreamer Bad Plugins 1.0 Plugins Reference Manual</title> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="index.html" title="GStreamer Bad Plugins 1.0 Plugins Reference Manual"> 8<link rel="up" href="ch01.html" title="gst-plugins-bad Elements"> 9<link rel="prev" href="gst-plugins-bad-plugins-interaudiosrc.html" title="interaudiosrc"> 10<link rel="next" href="gst-plugins-bad-plugins-intersubsink.html" title="intersubsink"> 11<meta name="generator" content="GTK-Doc V1.28 (XML mode)"> 12<link rel="stylesheet" href="style.css" type="text/css"> 13</head> 14<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 15<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> 16<td width="100%" align="left" class="shortcuts"> 17<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 18 <a href="#gst-plugins-bad-plugins-interlace.description" class="shortcut">Description</a></span> 19</td> 20<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 21<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 22<td><a accesskey="p" href="gst-plugins-bad-plugins-interaudiosrc.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 23<td><a accesskey="n" href="gst-plugins-bad-plugins-intersubsink.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 24</tr></table> 25<div class="refentry"> 26<a name="gst-plugins-bad-plugins-interlace"></a><div class="titlepage"></div> 27<div class="refnamediv"><table width="100%"><tr> 28<td valign="top"> 29<h2><span class="refentrytitle"><a name="gst-plugins-bad-plugins-interlace.top_of_page"></a>interlace</span></h2> 30<p>interlace</p> 31</td> 32<td class="gallery_image" valign="top" align="right"></td> 33</tr></table></div> 34<div class="refsect1"> 35<a name="gst-plugins-bad-plugins-interlace.description"></a><h2>Description</h2> 36<p>The interlace element takes a non-interlaced raw video stream as input, 37creates fields out of each frame, then combines fields into interlaced 38frames to output as an interlaced video stream. It can also produce 39telecined streams from progressive input.</p> 40<div class="refsect3"> 41<a name="id-1.2.112.3.3"></a><h4>Example launch line</h4> 42<div class="informalexample"> 43 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 44 <tbody> 45 <tr> 46 <td class="listing_lines" align="right"><pre>1</pre></td> 47 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v videotestsrc pattern<span class="gtkdoc opt">=</span>ball <span class="gtkdoc opt">!</span> interlace <span class="gtkdoc opt">!</span> xvimagesink</pre></td> 48 </tr> 49 </tbody> 50 </table> 51</div> 52 53<p> 54This pipeline illustrates the combing effects caused by displaying 55two interlaced fields as one progressive frame.</p> 56<div class="informalexample"> 57 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 58 <tbody> 59 <tr> 60 <td class="listing_lines" align="right"><pre>1 612 623 634</pre></td> 64 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v filesrc location<span class="gtkdoc opt">=/</span>path<span class="gtkdoc opt">/</span>to<span class="gtkdoc opt">/</span>file <span class="gtkdoc opt">!</span> decodebin <span class="gtkdoc opt">!</span> videorate <span class="gtkdoc opt">!</span> 65 videoscale <span class="gtkdoc opt">!</span> video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>raw<span class="gtkdoc opt">,</span>format<span class="gtkdoc opt">=</span>\<span class="gtkdoc opt">(</span>string\<span class="gtkdoc opt">)</span>I420<span class="gtkdoc opt">,</span>width<span class="gtkdoc opt">=</span><span class="number">720</span><span class="gtkdoc opt">,</span>height<span class="gtkdoc opt">=</span><span class="number">480</span><span class="gtkdoc opt">,</span> 66 framerate<span class="gtkdoc opt">=</span><span class="number">60000</span><span class="gtkdoc opt">/</span><span class="number">1001</span><span class="gtkdoc opt">,</span>pixel<span class="gtkdoc opt">-</span>aspect<span class="gtkdoc opt">-</span>ratio<span class="gtkdoc opt">=</span><span class="number">11</span><span class="gtkdoc opt">/</span><span class="number">10</span> <span class="gtkdoc opt">!</span> 67 interlace top<span class="gtkdoc opt">-</span>field<span class="gtkdoc opt">-</span>first<span class="gtkdoc opt">=</span><span class="keyword">false</span> <span class="gtkdoc opt">!</span> autovideosink</pre></td> 68 </tr> 69 </tbody> 70 </table> 71</div> 72 73<p> 74This pipeline converts a progressive video stream into an interlaced 75stream suitable for standard definition NTSC.</p> 76<div class="informalexample"> 77 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 78 <tbody> 79 <tr> 80 <td class="listing_lines" align="right"><pre>1 812 823 834</pre></td> 84 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v videotestsrc pattern<span class="gtkdoc opt">=</span>ball <span class="gtkdoc opt">!</span> video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>raw<span class="gtkdoc opt">,</span> 85 format<span class="gtkdoc opt">=</span>\<span class="gtkdoc opt">(</span>string\<span class="gtkdoc opt">)</span>I420<span class="gtkdoc opt">,</span>width<span class="gtkdoc opt">=</span><span class="number">720</span><span class="gtkdoc opt">,</span>height<span class="gtkdoc opt">=</span><span class="number">480</span><span class="gtkdoc opt">,</span>framerate<span class="gtkdoc opt">=</span><span class="number">24000</span><span class="gtkdoc opt">/</span><span class="number">1001</span><span class="gtkdoc opt">,</span> 86 pixel<span class="gtkdoc opt">-</span>aspect<span class="gtkdoc opt">-</span>ratio<span class="gtkdoc opt">=</span><span class="number">11</span><span class="gtkdoc opt">/</span><span class="number">10</span> <span class="gtkdoc opt">!</span> interlace <span class="gtkdoc opt">!</span> 87 autovideosink</pre></td> 88 </tr> 89 </tbody> 90 </table> 91</div> 92 93<p> 94This pipeline converts a 24 frames per second progressive film stream into a 9530000/1001 2:3:2:3... pattern telecined stream suitable for displaying film 96content on NTSC.</p> 97</div> 98<div class="refsynopsisdiv"> 99<h2>Synopsis</h2> 100<div class="refsect2"> 101<a name="id-1.2.112.3.4.1"></a><h3>Element Information</h3> 102<div class="variablelist"><table border="0" class="variablelist"> 103<colgroup> 104<col align="left" valign="top"> 105<col> 106</colgroup> 107<tbody> 108<tr> 109<td><p><span class="term">plugin</span></p></td> 110<td> 111 <a class="link" href="gst-plugins-bad-plugins-plugin-interlace.html#plugin-interlace">interlace</a> 112 </td> 113</tr> 114<tr> 115<td><p><span class="term">author</span></p></td> 116<td>David Schleef <ds@schleef.org></td> 117</tr> 118<tr> 119<td><p><span class="term">class</span></p></td> 120<td>Filter/Video</td> 121</tr> 122</tbody> 123</table></div> 124</div> 125<hr> 126<div class="refsect2"> 127<a name="id-1.2.112.3.4.2"></a><h3>Element Pads</h3> 128<div class="variablelist"><table border="0" class="variablelist"> 129<colgroup> 130<col align="left" valign="top"> 131<col> 132</colgroup> 133<tbody> 134<tr> 135<td><p><span class="term">name</span></p></td> 136<td>sink</td> 137</tr> 138<tr> 139<td><p><span class="term">direction</span></p></td> 140<td>sink</td> 141</tr> 142<tr> 143<td><p><span class="term">presence</span></p></td> 144<td>always</td> 145</tr> 146<tr> 147<td><p><span class="term">details</span></p></td> 148<td>video/x-raw, format=(string){ AYUV, YUY2, UYVY, I420, YV12, Y42B, Y444, NV12, NV21 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td> 149</tr> 150</tbody> 151</table></div> 152<div class="variablelist"><table border="0" class="variablelist"> 153<colgroup> 154<col align="left" valign="top"> 155<col> 156</colgroup> 157<tbody> 158<tr> 159<td><p><span class="term">name</span></p></td> 160<td>src</td> 161</tr> 162<tr> 163<td><p><span class="term">direction</span></p></td> 164<td>source</td> 165</tr> 166<tr> 167<td><p><span class="term">presence</span></p></td> 168<td>always</td> 169</tr> 170<tr> 171<td><p><span class="term">details</span></p></td> 172<td>video/x-raw, format=(string){ AYUV, YUY2, UYVY, I420, YV12, Y42B, Y444, NV12, NV21 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ], interlace-mode=(string){ interleaved, mixed }</td> 173</tr> 174</tbody> 175</table></div> 176</div> 177</div> 178</div> 179<div class="refsect1"> 180<a name="gst-plugins-bad-plugins-interlace.functions_details"></a><h2>Functions</h2> 181<p></p> 182</div> 183<div class="refsect1"> 184<a name="gst-plugins-bad-plugins-interlace.other_details"></a><h2>Types and Values</h2> 185</div> 186</div> 187<div class="footer"> 188<hr>Generated by GTK-Doc V1.28</div> 189</body> 190</html>
