docs/plugins/html/gst-plugins-good-plugins-deinterlace.html

   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>deinterlace</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
   7 <link rel="home" href="index.html" title="GStreamer Good Plugins 0.10 Plugins Reference Manual">
   8 <link rel="up" href="ch01.html" title="gst-plugins-good Elements">
   9 <link rel="prev" href="gst-plugins-good-plugins-dcaparse.html" title="dcaparse">
  10 <link rel="next" href="gst-plugins-good-plugins-deinterleave.html" title="deinterleave">
  11 <meta name="generator" content="GTK-Doc V1.17 (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="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gst-plugins-good-plugins-dcaparse.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GStreamer Good Plugins 0.10 Plugins Reference Manual</th>
  21 <td><a accesskey="n" href="gst-plugins-good-plugins-deinterleave.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gst-plugins-good-plugins-deinterlace.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-good-plugins-deinterlace.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gst-plugins-good-plugins-deinterlace.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#gst-plugins-good-plugins-deinterlace.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#gst-plugins-good-plugins-deinterlace.properties" class="shortcut">Properties</a>
  33 </td></tr>
  34 </table>
  35 <div class="refentry">
  36 <a name="gst-plugins-good-plugins-deinterlace"></a><div class="titlepage"></div>
  37 <div class="refnamediv"><table width="100%"><tr>
  38 <td valign="top">
  39 <h2><span class="refentrytitle"><a name="gst-plugins-good-plugins-deinterlace.top_of_page"></a>deinterlace</span></h2>
  40 <p>deinterlace — Deinterlace Methods ported from DScaler/TvTime</p>
  41 </td>
  42 <td valign="top" align="right"></td>
  43 </tr></table></div>
  44 <div class="refsynopsisdiv">
  45 <a name="gst-plugins-good-plugins-deinterlace.synopsis"></a><h2>Synopsis</h2>
  46 <a name="GstDeinterlace"></a><pre class="synopsis">struct              <a class="link" href="gst-plugins-good-plugins-deinterlace.html#GstDeinterlace-struct" title="struct GstDeinterlace">GstDeinterlace</a>;
  47 </pre>
  48 </div>
  49 <div class="refsect1">
  50 <a name="gst-plugins-good-plugins-deinterlace.object-hierarchy"></a><h2>Object Hierarchy</h2>
  51 <pre class="synopsis">
  52   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  53    +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstObject.html">GstObject</a>
  54          +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html">GstElement</a>
  55                +----GstDeinterlace
  56 </pre>
  57 </div>
  58 <div class="refsect1">
  59 <a name="gst-plugins-good-plugins-deinterlace.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
  60 <p>
  61 GstDeinterlace implements
  62  <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstChildProxy.html">GstChildProxy</a>.</p>
  63 </div>
  64 <div class="refsect1">
  65 <a name="gst-plugins-good-plugins-deinterlace.properties"></a><h2>Properties</h2>
  66 <pre class="synopsis">
  67   "<a class="link" href="gst-plugins-good-plugins-deinterlace.html#GstDeinterlace--fields" title='The "fields" property'>fields</a>"                   <span class="type">GstDeinterlaceFields</span>  : Read / Write
  68   "<a class="link" href="gst-plugins-good-plugins-deinterlace.html#GstDeinterlace--method" title='The "method" property'>method</a>"                   <span class="type">GstDeinterlaceMethods</span>  : Read / Write
  69   "<a class="link" href="gst-plugins-good-plugins-deinterlace.html#GstDeinterlace--mode" title='The "mode" property'>mode</a>"                     <span class="type">GstDeinterlaceModes</span>   : Read / Write
  70   "<a class="link" href="gst-plugins-good-plugins-deinterlace.html#GstDeinterlace--tff" title='The "tff" property'>tff</a>"                      <span class="type">GstDeinterlaceFieldLayout</span>  : Read / Write
  71 </pre>
  72 </div>
  73 <div class="refsect1">
  74 <a name="gst-plugins-good-plugins-deinterlace.description"></a><h2>Description</h2>
  75 <p>
  76 deinterlace deinterlaces interlaced video frames to progressive video frames.
  77 For this different algorithms can be selected which will be described later.
  78 </p>
  79 <p>
  80 </p>
  81 <div class="refsect2">
  82 <a name="idp8051920"></a><h3>Example launch line</h3>
  83 <div class="informalexample">
  84   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
  85     <tbody>
  86       <tr>
  87         <td class="listing_lines" align="right"><pre>1</pre></td>
  88         <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch <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> decodebin2 <span class="gtkdoc opt">!</span> ffmpegcolorspace <span class="gtkdoc opt">!</span> deinterlace <span class="gtkdoc opt">!</span> ffmpegcolorspace <span class="gtkdoc opt">!</span> autovideosink</pre></td>
  89       </tr>
  90     </tbody>
  91   </table>
  92 </div>
  93  This pipeline deinterlaces a video file with the default deinterlacing options.
  94 </div>
  95 <p>
  96 </p>
  97 <div class="refsynopsisdiv">
  98 <h2>Synopsis</h2>
  99 <div class="refsect2">
 100 <a name="idp7099456"></a><h3>Element Information</h3>
 101 <div class="variablelist"><table border="0">
 102 <col align="left" valign="top">
 103 <tbody>
 104 <tr>
 105 <td><p><span class="term">plugin</span></p></td>
 106 <td>
 107             <a class="link" href="gst-plugins-good-plugins-plugin-deinterlace.html#plugin-deinterlace">deinterlace</a>
 108           </td>
 109 </tr>
 110 <tr>
 111 <td><p><span class="term">author</span></p></td>
 112 <td>Martin Eikermann &lt;meiker@upb.de&gt;, Sebastian Dröge &lt;sebastian.droege@collabora.co.uk&gt;</td>
 113 </tr>
 114 <tr>
 115 <td><p><span class="term">class</span></p></td>
 116 <td>Filter/Effect/Video/Deinterlace</td>
 117 </tr>
 118 </tbody>
 119 </table></div>
 120 </div>
 121 <hr>
 122 <div class="refsect2">
 123 <a name="idp12340128"></a><h3>Element Pads</h3>
 124 <div class="variablelist"><table border="0">
 125 <col align="left" valign="top">
 126 <tbody>
 127 <tr>
 128 <td><p><span class="term">name</span></p></td>
 129 <td>sink</td>
 130 </tr>
 131 <tr>
 132 <td><p><span class="term">direction</span></p></td>
 133 <td>sink</td>
 134 </tr>
 135 <tr>
 136 <td><p><span class="term">presence</span></p></td>
 137 <td>always</td>
 138 </tr>
 139 <tr>
 140 <td><p><span class="term">details</span></p></td>
 141 <td>video/x-raw-yuv, format=(fourcc){ AYUV, Y444, YUY2, YVYU, UYVY, Y42B, I420, YV12, Y41B, NV12, NV21 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 142 </tr>
 143 <tr>
 144 <td><p><span class="term"></span></p></td>
 145 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 146 </tr>
 147 <tr>
 148 <td><p><span class="term"></span></p></td>
 149 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 150 </tr>
 151 <tr>
 152 <td><p><span class="term"></span></p></td>
 153 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 154 </tr>
 155 <tr>
 156 <td><p><span class="term"></span></p></td>
 157 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 158 </tr>
 159 <tr>
 160 <td><p><span class="term"></span></p></td>
 161 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 162 </tr>
 163 <tr>
 164 <td><p><span class="term"></span></p></td>
 165 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 166 </tr>
 167 <tr>
 168 <td><p><span class="term"></span></p></td>
 169 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 170 </tr>
 171 <tr>
 172 <td><p><span class="term"></span></p></td>
 173 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 174 </tr>
 175 <tr>
 176 <td><p><span class="term"></span></p></td>
 177 <td> video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 178 </tr>
 179 <tr>
 180 <td><p><span class="term"></span></p></td>
 181 <td> video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 182 </tr>
 183 </tbody>
 184 </table></div>
 185 <div class="variablelist"><table border="0">
 186 <col align="left" valign="top">
 187 <tbody>
 188 <tr>
 189 <td><p><span class="term">name</span></p></td>
 190 <td>src</td>
 191 </tr>
 192 <tr>
 193 <td><p><span class="term">direction</span></p></td>
 194 <td>source</td>
 195 </tr>
 196 <tr>
 197 <td><p><span class="term">presence</span></p></td>
 198 <td>always</td>
 199 </tr>
 200 <tr>
 201 <td><p><span class="term">details</span></p></td>
 202 <td>video/x-raw-yuv, format=(fourcc){ AYUV, Y444, YUY2, YVYU, UYVY, Y42B, I420, YV12, Y41B, NV12, NV21 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 203 </tr>
 204 <tr>
 205 <td><p><span class="term"></span></p></td>
 206 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 207 </tr>
 208 <tr>
 209 <td><p><span class="term"></span></p></td>
 210 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 211 </tr>
 212 <tr>
 213 <td><p><span class="term"></span></p></td>
 214 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 215 </tr>
 216 <tr>
 217 <td><p><span class="term"></span></p></td>
 218 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 219 </tr>
 220 <tr>
 221 <td><p><span class="term"></span></p></td>
 222 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 223 </tr>
 224 <tr>
 225 <td><p><span class="term"></span></p></td>
 226 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 227 </tr>
 228 <tr>
 229 <td><p><span class="term"></span></p></td>
 230 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 231 </tr>
 232 <tr>
 233 <td><p><span class="term"></span></p></td>
 234 <td> video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 235 </tr>
 236 <tr>
 237 <td><p><span class="term"></span></p></td>
 238 <td> video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 239 </tr>
 240 <tr>
 241 <td><p><span class="term"></span></p></td>
 242 <td> video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td>
 243 </tr>
 244 </tbody>
 245 </table></div>
 246 </div>
 247 </div>
 248 <p>
 249 </p>
 250 </div>
 251 <div class="refsect1">
 252 <a name="gst-plugins-good-plugins-deinterlace.details"></a><h2>Details</h2>
 253 <div class="refsect2">
 254 <a name="GstDeinterlace-struct"></a><h3>struct GstDeinterlace</h3>
 255 <pre class="programlisting">struct GstDeinterlace;</pre>
 256 <p>
 257 </p>
 258 </div>
 259 </div>
 260 <div class="refsect1">
 261 <a name="gst-plugins-good-plugins-deinterlace.property-details"></a><h2>Property Details</h2>
 262 <div class="refsect2">
 263 <a name="GstDeinterlace--fields"></a><h3>The <code class="literal">"fields"</code> property</h3>
 264 <pre class="programlisting">  "fields"                   <span class="type">GstDeinterlaceFields</span>  : Read / Write</pre>
 265 <p>
 266 This selects which fields should be output. If "all" is selected
 267 the output framerate will be double.
 268 </p>
 269 <p>Default value: All fields</p>
 270 </div>
 271 <hr>
 272 <div class="refsect2">
 273 <a name="GstDeinterlace--method"></a><h3>The <code class="literal">"method"</code> property</h3>
 274 <pre class="programlisting">  "method"                   <span class="type">GstDeinterlaceMethods</span>  : Read / Write</pre>
 275 <p>
 276 Selects the different deinterlacing algorithms that can be used.
 277 These provide different quality and CPU usage.
 278 </p>
 279 <p>
 280 Some methods provide parameters which can be set by getting
 281 the "method" child via the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstChildProxy.html"><span class="type">GstChildProxy</span></a> interface and
 282 setting the appropiate properties on it.
 283 </p>
 284 <p>
 285 </p>
 286 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
 287 <li class="listitem"><p>
 288 tomsmocomp
 289 Motion Adaptive: Motion Search
 290 </p></li>
 291 <li class="listitem"><p>
 292 greedyh
 293 Motion Adaptive: Advanced Detection
 294 </p></li>
 295 <li class="listitem"><p>
 296 greedyl
 297 Motion Adaptive: Simple Detection
 298 </p></li>
 299 <li class="listitem"><p>
 300 vfir
 301 Blur vertical
 302 </p></li>
 303 <li class="listitem"><p>
 304 linear
 305 Linear interpolation
 306 </p></li>
 307 <li class="listitem"><p>
 308 linearblend
 309 Linear interpolation in time domain.  Any motion causes significant
 310 ghosting, so this method should not be used.
 311 </p></li>
 312 <li class="listitem"><p>
 313 scalerbob
 314 Double lines
 315 </p></li>
 316 <li class="listitem"><p>
 317 weave
 318 Weave.  Bad quality, do not use.
 319 </p></li>
 320 <li class="listitem"><p>
 321 weavetff
 322 Progressive: Top Field First.  Bad quality, do not use.
 323 </p></li>
 324 <li class="listitem"><p>
 325 weavebff
 326 Progressive: Bottom Field First.  Bad quality, do not use.
 327 </p></li>
 328 </ul></div>
 329 <p>
 330 </p>
 331 <p>Default value: Television: Full resolution</p>
 332 </div>
 333 <hr>
 334 <div class="refsect2">
 335 <a name="GstDeinterlace--mode"></a><h3>The <code class="literal">"mode"</code> property</h3>
 336 <pre class="programlisting">  "mode"                     <span class="type">GstDeinterlaceModes</span>   : Read / Write</pre>
 337 <p>
 338 This selects whether the deinterlacing methods should
 339 always be applied or if they should only be applied
 340 on content that has the "interlaced" flag on the caps.
 341 </p>
 342 <p>Default value: Auto detection</p>
 343 </div>
 344 <hr>
 345 <div class="refsect2">
 346 <a name="GstDeinterlace--tff"></a><h3>The <code class="literal">"tff"</code> property</h3>
 347 <pre class="programlisting">  "tff"                      <span class="type">GstDeinterlaceFieldLayout</span>  : Read / Write</pre>
 348 <p>Deinterlace top field first.</p>
 349 <p>Default value: Auto detection</p>
 350 </div>
 351 </div>
 352 </div>
 353 <div class="footer">
 354 <hr>
 355           Generated by GTK-Doc V1.17</div>
 356 </body>
 357 </html>