element: Enforce that elements created by gst_element_factory_create/make() are floating

[platform/upstream/gstreamer.git] / gst / gstchildproxy.h

diff --git a/gst/gstchildproxy.h b/gst/gstchildproxy.h
index ebb2d14..57e3012 100644 (file)
--- a/gst/gstchildproxy.h
+++ b/gst/gstchildproxy.h
@@ -15,8 +15,8 @@
  *
  * You should have received a copy of the GNU Library General Public
  * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
  */
 
 #ifndef __GST_CHILD_PROXY_H__
@@ -28,10 +28,10 @@
 G_BEGIN_DECLS
 
 
-#define GST_TYPE_CHILD_PROXY                   (gst_child_proxy_get_type ())
-#define GST_CHILD_PROXY(obj)                   (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_CHILD_PROXY, GstChildProxy))
-#define GST_IS_CHILD_PROXY(obj)                        (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_CHILD_PROXY))
-#define GST_CHILD_PROXY_GET_INTERFACE(obj)     (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GST_TYPE_CHILD_PROXY, GstChildProxyInterface))
+#define GST_TYPE_CHILD_PROXY               (gst_child_proxy_get_type ())
+#define GST_CHILD_PROXY(obj)               (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_CHILD_PROXY, GstChildProxy))
+#define GST_IS_CHILD_PROXY(obj)            (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_CHILD_PROXY))
+#define GST_CHILD_PROXY_GET_INTERFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GST_TYPE_CHILD_PROXY, GstChildProxyInterface))
 
 /**
  * GstChildProxy:
@@ -44,7 +44,8 @@ typedef struct _GstChildProxyInterface GstChildProxyInterface;
 /**
  * GstChildProxyInterface:
  * @parent: parent interface type.
- * @get_child_by_index: virtual method to fetch the child
+ * @get_child_by_name:  virtual method to fetch the child by name
+ * @get_child_by_index: virtual method to fetch the child by index
  * @get_children_count: virtual method to get the children count
  *
  * #GstChildProxy interface.
@@ -54,37 +55,62 @@ struct _GstChildProxyInterface
   GTypeInterface parent;
 
   /* methods */
-  GstObject *(*get_child_by_index) (GstChildProxy * parent, guint index);
-  guint (*get_children_count) (GstChildProxy * parent);
+  GObject * (*get_child_by_name)  (GstChildProxy * parent, const gchar * name);
+  GObject * (*get_child_by_index) (GstChildProxy * parent, guint index);
+  guint     (*get_children_count) (GstChildProxy * parent);
   /*< private >*/
   /* signals */
-  void (*child_added) (GstChildProxy * parent, GstObject * child);
-  void (*child_removed) (GstChildProxy * parent, GstObject * child);
+  void      (*child_added)        (GstChildProxy * parent, GObject * child, const gchar * name);
+  void      (*child_removed)      (GstChildProxy * parent, GObject * child, const gchar * name);
 
   /*< private >*/
   gpointer _gst_reserved[GST_PADDING];
 };
 
-GType gst_child_proxy_get_type (void);
-
-GstObject *gst_child_proxy_get_child_by_name (GstChildProxy * parent, const gchar * name);
-GstObject *gst_child_proxy_get_child_by_index (GstChildProxy * parent, guint index);
-guint gst_child_proxy_get_children_count (GstChildProxy * parent);
-
-gboolean gst_child_proxy_lookup (GstObject *object, const gchar *name,
-    GstObject **target, GParamSpec **pspec);
-void gst_child_proxy_get_property (GstObject * object, const gchar *name, GValue *value);
-void gst_child_proxy_get_valist (GstObject * object,
-    const gchar * first_property_name, va_list var_args);
-void gst_child_proxy_get (GstObject * object, const gchar * first_property_name,
-    ...) G_GNUC_NULL_TERMINATED;
-void gst_child_proxy_set_property (GstObject * object, const gchar *name, const GValue *value);
-void gst_child_proxy_set_valist (GstObject* object,
-    const gchar * first_property_name, va_list var_args);
-void gst_child_proxy_set (GstObject * object, const gchar * first_property_name,
-    ...) G_GNUC_NULL_TERMINATED;
-void gst_child_proxy_child_added (GstObject * object, GstObject *  child);
-void gst_child_proxy_child_removed (GstObject * object, GstObject *  child);
+GST_API
+GType     gst_child_proxy_get_type (void);
+
+GST_API
+GObject * gst_child_proxy_get_child_by_name  (GstChildProxy * parent, const gchar * name);
+
+GST_API
+guint     gst_child_proxy_get_children_count (GstChildProxy * parent);
+
+GST_API
+GObject * gst_child_proxy_get_child_by_index (GstChildProxy * parent, guint index);
+
+GST_API
+gboolean  gst_child_proxy_lookup             (GstChildProxy *object, const gchar *name,
+                                              GObject **target, GParamSpec **pspec);
+GST_API
+void      gst_child_proxy_get_property       (GstChildProxy * object, const gchar *name,
+                                              GValue *value);
+GST_API
+void      gst_child_proxy_get_valist         (GstChildProxy * object,
+                                              const gchar * first_property_name,
+                                              va_list var_args);
+GST_API
+void      gst_child_proxy_get                (GstChildProxy * object,
+                                              const gchar * first_property_name,
+                                              ...) G_GNUC_NULL_TERMINATED;
+GST_API
+void      gst_child_proxy_set_property       (GstChildProxy * object, const gchar *name,
+                                              const GValue *value);
+
+GST_API
+void      gst_child_proxy_set_valist         (GstChildProxy* object,
+                                              const gchar * first_property_name,
+                                              va_list var_args);
+GST_API
+void      gst_child_proxy_set                (GstChildProxy * object,
+                                              const gchar * first_property_name,
+                                              ...) G_GNUC_NULL_TERMINATED;
+GST_API
+void      gst_child_proxy_child_added        (GstChildProxy * parent, GObject * child,
+                                              const gchar *name);
+GST_API
+void      gst_child_proxy_child_removed      (GstChildProxy * parent, GObject * child,
+                                              const gchar *name);
 
 G_END_DECLS