gstreamer/docs/random/ensonic/dynlink.txt
Stefan Kost c53989742b docs/random/ensonic/: Possible dynamic reconnection api, plus some type fixes the other two docs.
Original commit message from CVS:
* docs/random/ensonic/dynlink.txt:
* docs/random/ensonic/interfaces.txt:
* docs/random/ensonic/receipies.txt:
Possible dynamic reconnection api, plus some type fixes the other two
docs.
2007-02-13 14:52:47 +00:00

42 lines
964 B
Text

$Id$
Currently its only save to link/unlink elements/pad when pipeline is in READY.
= current api =
gboolean gst_element_link (GstElement *src, GstElement *dest);
void gst_element_unlink (GstElement *src, GstElement *dest);
gst_element_link_many, gst_element_unlink_many, gst_element_link_filtered,
gst_element_link_pads, gst_element_unlink_pads, gst_element_link_pads_filtered
GstPadLinkReturn gst_pad_link (GstPad *srcpad, GstPad *sinkpad);
gboolean gst_pad_unlink (GstPad *srcpad, GstPad *sinkpad);
= use cases =
== inserting an element ==
* we have: e1 ! e2
* we want: e1 ! e3 ! e2
gst_element_insert_linked(e1, e2, e3);
== removing an element ==
* we have: e1 ! e2 ! e3
* we want: e1 ! e3
gst_element_remove_linked(e2);
== swapping out an elelment ==
* we have: e1 ! e2 ! e3
* we want: e1 ! e4 ! e3
gst_element_swap_linked(e1, e3, e4);
= thoughts =
* I don't think we need api for pads
* Should current api check for the state?