mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-30 05:31:15 +00:00
28bf20507e
Original commit message from CVS: * gst/gstbin.c: (gst_bin_get_type), (gst_bin_class_init), (gst_bin_fix_state), (gst_bin_add_func), (gst_bin_remove_func), (gst_bin_child_state_change_func), (set_kid_state_func), (gst_bin_set_state), (gst_bin_change_state_norecurse): make state changes work correctly and reentrant (so removing elements from bins during state changes of bins doesn't cause segfaults or even wrong states) add debugging category and debugging output to print children states * gst/gstbin.c: (gst_bin_dispose): add some assertion checks * gst/gstbin.h: * gst/gstbin.c: (gst_bin_sync_children_state): deprecate this function - it just does gst_bin_set_state (bin, GST_STATE (bin)) * testsuite/threads/queue.c: (main): don't use gst_bin_sync_children_state anymore * testsuite/states/Makefile.am: * testsuite/states/bin.c: test that the state changes of bins work as expected * gst/gstthread.c: (gst_thread_class_init), (gst_thread_set_state): some adjustments to change states correctly, too * gst/gstthread.c: (gst_thread_change_state): don't enable/disable "threadsafe" properties, they're unused and cause random segfaults * testsuite/threads/Makefile.am: the queue check randomly passes now, ignore it
126 lines
4.1 KiB
C
126 lines
4.1 KiB
C
/* GStreamer
|
|
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
|
|
* 2000 Wim Taymans <wtay@chello.be>
|
|
*
|
|
* gstbin.h: Header for GstBin container object
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
|
|
#ifndef __GST_BIN_H__
|
|
#define __GST_BIN_H__
|
|
|
|
#include <gst/gstelement.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
GST_EXPORT GType _gst_bin_type;
|
|
|
|
#define GST_TYPE_BIN (_gst_bin_type)
|
|
#define GST_IS_BIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_BIN))
|
|
#define GST_IS_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_BIN))
|
|
#define GST_BIN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_BIN, GstBinClass))
|
|
#define GST_BIN(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_BIN, GstBin))
|
|
#define GST_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_BIN, GstBinClass))
|
|
|
|
typedef enum {
|
|
/* this bin is a manager of child elements, i.e. a pipeline or thread */
|
|
GST_BIN_FLAG_MANAGER = GST_ELEMENT_FLAG_LAST,
|
|
|
|
/* this bin iterates itself */
|
|
GST_BIN_SELF_SCHEDULABLE,
|
|
|
|
/* we prefer to have cothreads when its an option, over chain-based */
|
|
GST_BIN_FLAG_PREFER_COTHREADS,
|
|
|
|
GST_BIN_FLAG_FIXED_CLOCK,
|
|
|
|
/* padding */
|
|
GST_BIN_FLAG_LAST = GST_ELEMENT_FLAG_LAST + 5
|
|
} GstBinFlags;
|
|
|
|
/*typedef struct _GstBin GstBin; */
|
|
/*typedef struct _GstBinClass GstBinClass; */
|
|
|
|
struct _GstBin {
|
|
GstElement element;
|
|
|
|
/* our children */
|
|
gint numchildren;
|
|
GList *children;
|
|
|
|
/* FIXME 0.9: important!! make this guint instead of GstElementState */
|
|
GstElementState child_states[GST_NUM_STATES];
|
|
|
|
gpointer _gst_reserved[GST_PADDING];
|
|
};
|
|
|
|
struct _GstBinClass {
|
|
GstElementClass parent_class;
|
|
|
|
/* vtable */
|
|
void (*add_element) (GstBin *bin, GstElement *element);
|
|
void (*remove_element) (GstBin *bin, GstElement *element);
|
|
void (*child_state_change) (GstBin *bin, GstElementState oldstate,
|
|
GstElementState newstate, GstElement *element);
|
|
|
|
/* run a full iteration of operation */
|
|
gboolean (*iterate) (GstBin *bin);
|
|
|
|
/* signals */
|
|
void (*element_added) (GstBin *bin, GstElement *child);
|
|
void (*element_removed) (GstBin *bin, GstElement *child);
|
|
|
|
gpointer _gst_reserved[GST_PADDING];
|
|
};
|
|
|
|
GType gst_bin_get_type (void);
|
|
GstElement* gst_bin_new (const gchar *name);
|
|
|
|
/* add and remove elements from the bin */
|
|
void gst_bin_add (GstBin *bin, GstElement *element);
|
|
void gst_bin_add_many (GstBin *bin, GstElement *element_1, ...);
|
|
void gst_bin_remove (GstBin *bin, GstElement *element);
|
|
void gst_bin_remove_many (GstBin *bin, GstElement *element_1, ...);
|
|
|
|
/* retrieve a single element or the list of children */
|
|
GstElement* gst_bin_get_by_name (GstBin *bin, const gchar *name);
|
|
GstElement* gst_bin_get_by_name_recurse_up (GstBin *bin, const gchar *name);
|
|
G_CONST_RETURN GList*
|
|
gst_bin_get_list (GstBin *bin);
|
|
GstElement* gst_bin_get_by_interface (GstBin *bin, GType interface);
|
|
GList * gst_bin_get_all_by_interface (GstBin *bin, GType interface);
|
|
|
|
gboolean gst_bin_iterate (GstBin *bin);
|
|
|
|
void gst_bin_use_clock (GstBin *bin, GstClock *clock);
|
|
GstClock* gst_bin_get_clock (GstBin *bin);
|
|
void gst_bin_auto_clock (GstBin *bin);
|
|
|
|
#ifndef GST_DISABLE_DEPRECATED
|
|
GstElementStateReturn gst_bin_sync_children_state (GstBin *bin);
|
|
#endif
|
|
|
|
/* internal */
|
|
/* one of our childs signaled a state change */
|
|
void gst_bin_child_state_change (GstBin *bin, GstElementState oldstate,
|
|
GstElementState newstate, GstElement *child);
|
|
|
|
G_END_DECLS
|
|
|
|
|
|
#endif /* __GST_BIN_H__ */
|