+++ /dev/null
-#FIG 3.2
-Landscape
-Center
-Inches
-Letter
-100.00
-Single
--2
-1200 2
-2 2 0 1 0 6 50 0 20 0.000 0 0 -1 0 0 5
- 3975 3600 4725 3600 4725 4125 3975 4125 3975 3600
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
- 2775 2775 4725 2775 4725 4425 2775 4425 2775 2775
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
- 5400 2775 7350 2775 7350 4425 5400 4425 5400 2775
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
- 8025 2775 9975 2775 9975 4425 8025 4425 8025 2775
-2 2 0 1 0 6 50 0 20 0.000 0 0 -1 0 0 5
- 5400 3600 6150 3600 6150 4125 5400 4125 5400 3600
-2 2 0 1 0 6 50 0 20 0.000 0 0 -1 0 0 5
- 8025 3600 8775 3600 8775 4125 8025 4125 8025 3600
-2 2 0 1 0 6 50 0 20 0.000 0 0 -1 0 0 5
- 6600 3600 7350 3600 7350 4125 6600 4125 6600 3600
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
- 1 1 1.00 90.00 120.00
- 4575 3750 5400 3750
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
- 1 1 1.00 90.00 120.00
- 7200 3750 8025 3750
-4 0 0 50 0 16 12 0.0000 4 105 255 4200 3975 src\001
-4 0 0 50 0 16 12 0.0000 4 135 330 5550 3975 sink\001
-4 0 0 50 0 16 12 0.0000 4 135 330 8175 3975 sink\001
-4 0 0 50 0 16 12 0.0000 4 105 255 6825 3975 src\001
-4 0 0 50 0 16 12 0.0000 4 135 750 5625 3075 element2\001
-4 0 0 50 0 16 12 0.0000 4 135 750 8250 3075 element3\001
-4 0 0 50 0 16 12 0.0000 4 135 750 3000 3075 element1\001
+++ /dev/null
-<chapter id="cha-links">
- <title>Connecting elements</title>
- <para>
- You can link the different pads of elements together so that the elements
- form a chain.
- </para>
-
- <figure float="1" id="sec-link">
- <title>Visualisation of three linked elements</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/linked-elements.&magic;" format="&MAGIC;" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- By linking these three elements, we have created a very simple
- chain. The effect of this will be that the output of the source element
- (element1) will be used as input for the filter element (element2). The
- filter element will do something with the data and send the result to
- the final sink element (element3).
- </para>
- <para>
- Imagine the above graph as a simple MPEG audio decoder. The source
- element is a disk source, the filter element is the MPEG decoder and
- the sink element is your audiocard. We will use this simple graph to
- construct an MPEG player later in this manual.
- </para>
-
- <sect1 id="sec-conn-basic">
- <title>Making simple links</title>
- <para>
- You can link two pads with:
- </para>
- <programlisting>
- GstPad *srcpad, *sinkpad;
-
- srcpad = gst_element_get_pad (element1, "src");
- sinpad = gst_element_get_pad (element2, "sink");
-
- // link them
- gst_pad_link (srcpad, sinkpad);
- ....
- // and unlink them
- gst_pad_unlink (srcpad, sinkpad);
-
- </programlisting>
- <para>
- A convenient shortcut for the above code is done with the gst_element_link_pads ()
- function:
- </para>
- <programlisting>
-
- // link them
- gst_element_link_pads (element1, "src", element2, "sink");
- ....
- // and unlink them
- gst_element_unlink_pads (element1, "src", element2, "sink");
-
- </programlisting>
- <para>
- An even more convenient shortcut for single-source, single-sink elements is the
- gst_element_link () function:
- </para>
- <programlisting>
-
- // link them
- gst_element_link (element1, element2);
- ....
- // and unlink them
- gst_element_unlink (element1, element2);
-
- </programlisting>
- <para>
- If you have more than one element to link, the gst_element_link_many () function takes
- a NULL-terminated list of elements:
- </para>
- <programlisting>
-
- // link them
- gst_element_link_many (element1, element2, element3, element4, NULL);
- ....
- // and unlink them
- gst_element_unlink_many (element1, element2, element3, element4, NULL);
-
- </programlisting>
- <para>
- You can query if a pad is linked with GST_PAD_IS_CONNECTED (pad).
- </para>
- <para>
- To query for the <classname>GstPad</classname> a pad is linked to, use
- gst_pad_get_peer (pad).
- </para>
- </sect1>
-
- <sect1 id="sec-conn-filtered">
- <title>Making filtered links</title>
- <para>
- You can also force a specific media type on the link by using gst_pad_link_filtered ()
- and gst_element_link_filtered (). FIXME link to caps documentation.
- </para>
- </sect1>
-
-</chapter>