docs/random/ensonic/: Possible dynamic reconnection api, plus some type fixes the...

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.

diff --git a/ChangeLog b/ChangeLog
index 1ed8a79..e2b90f1 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2007-02-13  Stefan Kost  <ensonic@users.sf.net>
+
+       * 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  Sebastian Dröge  <slomo@circular-chaos.org>
 
        * plugins/elements/gstfilesink.c: (gst_file_sink_uri_set_uri):

diff --git a/docs/random/ensonic/dynlink.txt b/docs/random/ensonic/dynlink.txt
new file mode 100644 (file)
index 0000000..d302195
--- /dev/null
+++ b/docs/random/ensonic/dynlink.txt
@@ -0,0 +1,42 @@
+$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?
+

diff --git a/docs/random/ensonic/interfaces.txt b/docs/random/ensonic/interfaces.txt
index e0ba350..0320e6c 100644 (file)
--- a/docs/random/ensonic/interfaces.txt
+++ b/docs/random/ensonic/interfaces.txt
@@ -11,20 +11,6 @@ $Id$
   ./gst-plugins/gst-libs/gst/colorbalance/colorbalance.c
   ./gst-plugins/gst-libs/gst/navigation/navigation.c
 * new general interfaces
-  * GST_TYPE_PRESET_MANAGER
-    - add preset managment
-    - API:
-      GList *get_presets();
-      void activate_preset_by_index(glong index);
-      void activate_preset_by_name(const gchar *name);
-      void add_current(const gchar *name);
-      void remove_preset_by_index(glong index);
-      void remove_preset_by_name(const gchar *name);
-    - features
-      - there should always be a default preset
-    - questions
-      - were and how do we store the presets?
-
   * GST_TYPE_UI_HINT
     - add hints to generate 'good' looking interfaces to elements
     - API:

diff --git a/docs/random/ensonic/receipies.txt b/docs/random/ensonic/receipies.txt
index c74a53c..0d2a0a3 100644 (file)
--- a/docs/random/ensonic/receipies.txt
+++ b/docs/random/ensonic/receipies.txt
@@ -16,7 +16,7 @@ How to I configure the initial playback segment?
 3) set pipeline to PLAYING
 
 === problems ===
-1) would preroll the pipeline only to flush it when the seek comes
+1) would preroll the pipeline only, to flush it when the seek comes
 
 
 == async state changes ==