mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-25 19:21:06 +00:00
Code Issues 1 Projects Releases Wiki Activity

gst/gstchildproxy.c: Improve docs and add some ideas for making this more general-purpose.

Browse source 
Original commit message from CVS:
* gst/gstchildproxy.c:
Improve docs and add some ideas for making this more general-purpose.
This commit is contained in:
Stefan Kost 2008-01-10 21:06:58 +00:00
parent e1e8bace45
commit 2016723b87
2 changed files with 19 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
2008-01-10 Stefan Kost <ensonic@users.sf.net>
* gst/gstchildproxy.c:
Improve docs and add some ideas for making this more general-purpose.
2008-01-10 Tim-Philipp Müller <tim at centricular dot net> 2008-01-10 Tim-Philipp Müller <tim at centricular dot net>
* gst/gst_private.h: (GST_CAT_TYPES): * gst/gst_private.h: (GST_CAT_TYPES):

19
gst/gstchildproxy.c
View file

@ -24,17 +24,26 @@
* @short_description: Interface for multi child elements. * @short_description: Interface for multi child elements.
* @see_also: #GstBin * @see_also: #GstBin
* *
* This interface abstracts handling of property sets for child elements. * This interface abstracts handling of property sets for elements with
* Imagine elements such as mixers or polyphonic generators. They all have * children. Imagine elements such as mixers or polyphonic generators. They all
* multiple #GstPad or some kind of voice objects. The element acts as a * have multiple #GstPad or some kind of voice objects. Another use case are
* parent for those child objects. Each child has the same properties. * container elements like #GstBin.
* The element implementing the interface acts as a parent for those child
* objects.
* *
* By implementing this interface the child properties can be accessed from the * By implementing this interface the child properties can be accessed from the
* parent element by using gst_child_proxy_get() and gst_child_proxy_set(). * parent element by using gst_child_proxy_get() and gst_child_proxy_set().
* *
* Property names are written as "child-name::property-name". The whole naming * Property names are written as "child-name::property-name". The whole naming
* scheme is recursive. Thus "child1::child2::property" is valid too, if * scheme is recursive. Thus "child1::child2::property" is valid too, if
* "child1" also implements the #GstChildProxy interface. * "child1" and "child2" implement the #GstChildProxy interface.
*/
/* FIXME-0.11:
* it would be nice to make gst_child_proxy_get_child_by_name virtual too and
* use GObject instead of GstObject. We could eventually provide the current
* implementation as a default if children are GstObjects.
* This change would allow to propose the interface for inclusion with
* glib/gobject. IMHO this is useful for GtkContainer and compound widgets too.
*/ */
#include "gst_private.h" #include "gst_private.h"