/* GStreamer * * Copyright (C) 1999,2000 Erik Walthinsen * 2000 Wim Taymans * * gstbin.c: GstBin container object and support code * * 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. */ #include "gst_private.h" #include "gstevent.h" #include "gstbin.h" #include "gstxml.h" #include "gstinfo.h" #include "gstscheduler.h" #include "gstindex.h" GstElementDetails gst_bin_details = { "Generic bin", "Generic/Bin", "LGPL", "Simple container object", VERSION, "Erik Walthinsen ", "(C) 1999", }; GType _gst_bin_type = 0; static void gst_bin_dispose (GObject * object); static GstElementStateReturn gst_bin_change_state (GstElement *element); static GstElementStateReturn gst_bin_change_state_norecurse (GstBin *bin); #ifndef GST_DISABLE_INDEX static void gst_bin_set_index (GstElement *element, GstIndex *index); #endif static void gst_bin_add_func (GstBin *bin, GstElement *element); static void gst_bin_remove_func (GstBin *bin, GstElement *element); static void gst_bin_child_state_change_func (GstBin *bin, GstElementState oldstate, GstElementState newstate, GstElement *child); static GstClock* gst_bin_get_clock_func (GstElement *element); static void gst_bin_set_clock_func (GstElement *element, GstClock *clock); static gboolean gst_bin_iterate_func (GstBin *bin); #ifndef GST_DISABLE_LOADSAVE static xmlNodePtr gst_bin_save_thyself (GstObject * object, xmlNodePtr parent); static void gst_bin_restore_thyself (GstObject * object, xmlNodePtr self); #endif /* Bin signals and args */ enum { ELEMENT_ADDED, ELEMENT_REMOVED, LAST_SIGNAL }; enum { ARG_0 /* FILL ME */ }; static void gst_bin_class_init (GstBinClass * klass); static void gst_bin_init (GstBin * bin); static GstElementClass *parent_class = NULL; static guint gst_bin_signals[LAST_SIGNAL] = { 0 }; GType gst_bin_get_type (void) { if (!_gst_bin_type) { static const GTypeInfo bin_info = { sizeof (GstBinClass), NULL, NULL, (GClassInitFunc) gst_bin_class_init, NULL, NULL, sizeof (GstBin), 8, (GInstanceInitFunc) gst_bin_init, NULL }; _gst_bin_type = g_type_register_static (GST_TYPE_ELEMENT, "GstBin", &bin_info, 0); } return _gst_bin_type; } static void gst_bin_class_init (GstBinClass * klass) { GObjectClass *gobject_class; GstObjectClass *gstobject_class; GstElementClass *gstelement_class; gobject_class = (GObjectClass *) klass; gstobject_class = (GstObjectClass *) klass; gstelement_class = (GstElementClass *) klass; parent_class = g_type_class_ref (GST_TYPE_ELEMENT); gst_bin_signals[ELEMENT_ADDED] = g_signal_new ("element_added", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GstBinClass, element_added), NULL, NULL, gst_marshal_VOID__POINTER, G_TYPE_NONE, 1, G_TYPE_POINTER); gst_bin_signals[ELEMENT_REMOVED] = g_signal_new ("element_removed", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GstBinClass, element_removed), NULL, NULL, gst_marshal_VOID__POINTER, G_TYPE_NONE, 1, G_TYPE_POINTER); gobject_class->dispose = GST_DEBUG_FUNCPTR (gst_bin_dispose); #ifndef GST_DISABLE_LOADSAVE gstobject_class->save_thyself = GST_DEBUG_FUNCPTR (gst_bin_save_thyself); gstobject_class->restore_thyself = GST_DEBUG_FUNCPTR (gst_bin_restore_thyself); #endif gstelement_class->change_state = GST_DEBUG_FUNCPTR (gst_bin_change_state); #ifndef GST_DISABLE_INDEX gstelement_class->set_index = GST_DEBUG_FUNCPTR (gst_bin_set_index); #endif klass->add_element = GST_DEBUG_FUNCPTR (gst_bin_add_func); klass->remove_element = GST_DEBUG_FUNCPTR (gst_bin_remove_func); klass->child_state_change = GST_DEBUG_FUNCPTR (gst_bin_child_state_change_func); klass->iterate = GST_DEBUG_FUNCPTR (gst_bin_iterate_func); } static void gst_bin_init (GstBin * bin) { /* in general, we prefer to use cothreads for most things */ GST_FLAG_SET (bin, GST_BIN_FLAG_PREFER_COTHREADS); bin->numchildren = 0; bin->children = NULL; bin->pre_iterate_func = NULL; bin->post_iterate_func = NULL; bin->pre_iterate_data = NULL; bin->post_iterate_data = NULL; } /** * gst_bin_new: * @name: name of new bin * * Create a new bin with given name. * * Returns: new bin */ GstElement * gst_bin_new (const gchar * name) { return gst_element_factory_make ("bin", name); } static GstClock* gst_bin_get_clock_func (GstElement *element) { if (GST_ELEMENT_SCHED (element)) return gst_scheduler_get_clock (GST_ELEMENT_SCHED (element)); return NULL; } static void gst_bin_set_clock_func (GstElement *element, GstClock *clock) { if (GST_ELEMENT_SCHED (element)) gst_scheduler_use_clock (GST_ELEMENT_SCHED (element), clock); } /** * gst_bin_get_clock: * @bin: a #GstBin to get the clock of * * Gets the current clock of the (scheduler of the) bin. * * Returns: the #GstClock of the bin */ GstClock* gst_bin_get_clock (GstBin *bin) { g_return_val_if_fail (bin != NULL, NULL); g_return_val_if_fail (GST_IS_BIN (bin), NULL); return gst_bin_get_clock_func (GST_ELEMENT (bin)); } /** * gst_bin_use_clock: * @bin: the bin to set the clock for * @clock: the clock to use. * * Force the bin to use the given clock. Use NULL to * force it to use no clock at all. */ void gst_bin_use_clock (GstBin *bin, GstClock *clock) { g_return_if_fail (GST_IS_BIN (bin)); gst_bin_set_clock_func (GST_ELEMENT (bin), clock); } /** * gst_bin_auto_clock: * @bin: the bin to autoclock * * Let the bin select a clock automatically. */ void gst_bin_auto_clock (GstBin *bin) { g_return_if_fail (GST_IS_BIN (bin)); if (GST_ELEMENT_SCHED (bin)) gst_scheduler_auto_clock (GST_ELEMENT_SCHED (bin)); } #ifndef GST_DISABLE_INDEX static void gst_bin_set_index (GstElement *element, GstIndex *index) { GstBin *bin = GST_BIN (element); g_return_if_fail (GST_IS_BIN (bin)); g_list_foreach (bin->children, (GFunc) gst_element_set_index, index); } #endif static void gst_bin_set_element_sched (GstElement *element, GstScheduler *sched) { GST_CAT_INFO (GST_CAT_SCHEDULING, "setting element \"%s\" sched to %p", GST_ELEMENT_NAME (element), sched); /* if it's actually a Bin */ if (GST_IS_BIN (element)) { if (GST_FLAG_IS_SET (element, GST_BIN_FLAG_MANAGER)) { GST_CAT_INFO (GST_CAT_PARENTAGE, "[%s]: child is already a manager, not resetting", GST_ELEMENT_NAME (element)); if (GST_ELEMENT_SCHED (element)) gst_scheduler_add_scheduler (sched, GST_ELEMENT_SCHED (element)); return; } GST_CAT_INFO (GST_CAT_PARENTAGE, "[%s]: setting children's schedule to parent's", GST_ELEMENT_NAME (element)); gst_scheduler_add_element (sched, element); /* set the children's schedule */ g_list_foreach (GST_BIN (element)->children, (GFunc) gst_bin_set_element_sched, sched); } /* otherwise, if it's just a regular old element */ else { GList *pads; gst_scheduler_add_element (sched, element); /* set the sched pointer in all the pads */ pads = element->pads; while (pads) { GstPad *pad; pad = GST_PAD (pads->data); pads = g_list_next (pads); /* we only operate on real pads */ if (!GST_IS_REAL_PAD (pad)) continue; /* if the peer element exists and is a candidate */ if (GST_PAD_PEER (pad)) { if (gst_pad_get_scheduler (GST_PAD_PEER (pad)) == sched) { GST_CAT_INFO (GST_CAT_SCHEDULING, "peer is in same scheduler, telling scheduler"); if (GST_PAD_IS_SRC (pad)) gst_scheduler_pad_link (sched, pad, GST_PAD_PEER (pad)); else gst_scheduler_pad_link (sched, GST_PAD_PEER (pad), pad); } } } } } static void gst_bin_unset_element_sched (GstElement *element, GstScheduler *sched) { if (GST_ELEMENT_SCHED (element) == NULL) { GST_CAT_INFO (GST_CAT_SCHEDULING, "element \"%s\" has no scheduler", GST_ELEMENT_NAME (element)); return; } GST_CAT_INFO (GST_CAT_SCHEDULING, "removing element \"%s\" from its sched %p", GST_ELEMENT_NAME (element), GST_ELEMENT_SCHED (element)); /* if it's actually a Bin */ if (GST_IS_BIN (element)) { if (GST_FLAG_IS_SET (element, GST_BIN_FLAG_MANAGER)) { GST_CAT_INFO (GST_CAT_PARENTAGE, "[%s]: child is already a manager, not unsetting sched", GST_ELEMENT_NAME (element)); if (sched) { gst_scheduler_remove_scheduler (sched, GST_ELEMENT_SCHED (element)); } return; } /* for each child, remove them from their schedule */ g_list_foreach (GST_BIN (element)->children, (GFunc) gst_bin_unset_element_sched, sched); gst_scheduler_remove_element (GST_ELEMENT_SCHED (element), element); } /* otherwise, if it's just a regular old element */ else { GList *pads; /* set the sched pointer in all the pads */ pads = element->pads; while (pads) { GstPad *pad; pad = GST_PAD (pads->data); pads = g_list_next (pads); /* we only operate on real pads */ if (!GST_IS_REAL_PAD (pad)) continue; /* if the peer element exists and is a candidate */ if (GST_PAD_PEER (pad)) { if (gst_pad_get_scheduler (GST_PAD_PEER (pad)) == sched) { GST_CAT_INFO (GST_CAT_SCHEDULING, "peer is in same scheduler, telling scheduler"); if (GST_PAD_IS_SRC (pad)) gst_scheduler_pad_unlink (sched, pad, GST_PAD_PEER (pad)); else gst_scheduler_pad_unlink (sched, GST_PAD_PEER (pad), pad); } } } gst_scheduler_remove_element (GST_ELEMENT_SCHED (element), element); } } /** * gst_bin_add_many: * @bin: the bin to add the elements to * @element_1: the first element to add to the bin * @...: NULL-terminated list of elements to add to the bin * * Add a list of elements to a bin. Uses #gst_bin_add. */ void gst_bin_add_many (GstBin *bin, GstElement *element_1, ...) { va_list args; g_return_if_fail (GST_IS_BIN (bin)); g_return_if_fail (GST_IS_ELEMENT (element_1)); va_start (args, element_1); while (element_1) { gst_bin_add (bin, element_1); element_1 = va_arg (args, GstElement*); } va_end (args); } static void gst_bin_add_func (GstBin *bin, GstElement *element) { gint state_idx = 0; GstElementState state; GstScheduler *sched; /* the element must not already have a parent */ g_return_if_fail (GST_ELEMENT_PARENT (element) == NULL); /* then check to see if the element's name is already taken in the bin */ if (gst_object_check_uniqueness (bin->children, GST_ELEMENT_NAME (element)) == FALSE) { g_warning ("Name %s is not unique in bin %s, not adding\n", GST_ELEMENT_NAME (element), GST_ELEMENT_NAME (bin)); return; } /* set the element's parent and add the element to the bin's list of children */ gst_object_set_parent (GST_OBJECT (element), GST_OBJECT (bin)); bin->children = g_list_append (bin->children, element); bin->numchildren++; /* bump our internal state counter */ state = GST_STATE (element); while (state >>= 1) state_idx++; bin->child_states[state_idx]++; /* now we have to deal with manager stuff * we can only do this if there's a scheduler: * if we're not a manager, and aren't attached to anything, we have no sched (yet) */ sched = GST_ELEMENT_SCHED (bin); if (sched) { gst_bin_set_element_sched (element, sched); } GST_CAT_INFO (GST_CAT_PARENTAGE, "[%s]: added child \"%s\"", GST_ELEMENT_NAME (bin), GST_ELEMENT_NAME (element)); g_signal_emit (G_OBJECT (bin), gst_bin_signals[ELEMENT_ADDED], 0, element); } /** * gst_bin_add: * @bin: #GstBin to add element to * @element: #GstElement to add to bin * * Add the given element to the bin. Set the elements parent, and thus * add a reference. */ void gst_bin_add (GstBin *bin, GstElement *element) { GstBinClass *bclass; g_return_if_fail (GST_IS_BIN (bin)); g_return_if_fail (GST_IS_ELEMENT (element)); GST_CAT_DEBUG (GST_CAT_PARENTAGE, "adding element \"%s\" to bin \"%s\"", GST_ELEMENT_NAME (element), GST_ELEMENT_NAME (bin)); bclass = GST_BIN_GET_CLASS (bin); if (bclass->add_element) { bclass->add_element (bin, element); } else { g_warning ("cannot add elements to bin %s\n", GST_ELEMENT_NAME (bin)); } } static void gst_bin_remove_func (GstBin *bin, GstElement *element) { gint state_idx = 0; GstElementState state; /* the element must have its parent set to the current bin */ g_return_if_fail (GST_ELEMENT_PARENT (element) == (GstObject *) bin); /* the element must be in the bin's list of children */ if (g_list_find (bin->children, element) == NULL) { g_warning ("no element \"%s\" in bin \"%s\"\n", GST_ELEMENT_NAME (element), GST_ELEMENT_NAME (bin)); return; } /* remove this element from the list of managed elements */ gst_bin_unset_element_sched (element, GST_ELEMENT_SCHED (bin)); /* now remove the element from the list of elements */ bin->children = g_list_remove (bin->children, element); bin->numchildren--; /* bump our internal state counter */ state = GST_STATE (element); while (state >>= 1) state_idx++; bin->child_states[state_idx]--; GST_CAT_INFO (GST_CAT_PARENTAGE, "[%s]: removed child %s", GST_ELEMENT_NAME (bin), GST_ELEMENT_NAME (element)); /* ref as we're going to emit a signal */ gst_object_ref (GST_OBJECT (element)); gst_object_unparent (GST_OBJECT (element)); /* if we're down to zero children, force state to NULL */ if (bin->numchildren == 0 && GST_ELEMENT_SCHED (bin) != NULL) { GST_STATE_PENDING (bin) = GST_STATE_NULL; gst_bin_change_state_norecurse (bin); } g_signal_emit (G_OBJECT (bin), gst_bin_signals[ELEMENT_REMOVED], 0, element); /* element is really out of our control now */ gst_object_unref (GST_OBJECT (element)); } /** * gst_bin_remove: * @bin: #GstBin to remove element from * @element: #GstElement to remove * * Remove the element from its associated bin, unparenting as well. * The element will also be unreferenced so there's no need to call * gst_object_unref on it. * If you want the element to still exist after removing, you need to call * #gst_object_ref before removing it from the bin. */ void gst_bin_remove (GstBin *bin, GstElement *element) { GstBinClass *bclass; GST_CAT_DEBUG (GST_CAT_PARENTAGE, "[%s]: trying to remove child %s", GST_ELEMENT_NAME (bin), GST_ELEMENT_NAME (element)); g_return_if_fail (GST_IS_BIN (bin)); g_return_if_fail (GST_IS_ELEMENT (element)); g_return_if_fail (bin->children != NULL); bclass = GST_BIN_GET_CLASS (bin); if (bclass->remove_element) { bclass->remove_element (bin, element); } else { g_warning ("cannot remove elements from bin %s\n", GST_ELEMENT_NAME (bin)); } } /** * gst_bin_remove_many: * @bin: the bin to remove the elements from * @element_1: the first element to remove from the bin * @...: NULL-terminated list of elements to remove from the bin * * Remove a list of elements from a bin. Uses #gst_bin_remove. */ void gst_bin_remove_many (GstBin *bin, GstElement *element_1, ...) { va_list args; g_return_if_fail (GST_IS_BIN (bin)); g_return_if_fail (GST_IS_ELEMENT (element_1)); va_start (args, element_1); while (element_1) { gst_bin_remove (bin, element_1); element_1 = va_arg (args, GstElement*); } va_end (args); } /** * gst_bin_child_state_change: * @bin: #GstBin with the child * @oldstate: The old child state * @newstate: The new child state * @child: #GstElement that signaled an changed state * * An internal function to inform the parent bin about a state change * of a child. */ void gst_bin_child_state_change (GstBin *bin, GstElementState oldstate, GstElementState newstate, GstElement *child) { GstBinClass *bclass; g_return_if_fail (GST_IS_BIN (bin)); g_return_if_fail (GST_IS_ELEMENT (child)); GST_CAT_INFO (GST_CAT_STATES, "child %s changed state in bin %s from %s to %s", GST_ELEMENT_NAME (child), GST_ELEMENT_NAME (bin), gst_element_state_get_name (oldstate), gst_element_state_get_name (newstate)); bclass = GST_BIN_GET_CLASS (bin); if (bclass->child_state_change) { bclass->child_state_change (bin, oldstate, newstate, child); } else { g_warning ("cannot signal state change of child %s to bin %s\n", GST_ELEMENT_NAME (child), GST_ELEMENT_NAME (bin)); } } static void gst_bin_child_state_change_func (GstBin *bin, GstElementState oldstate, GstElementState newstate, GstElement *child) { gint old_idx = 0, new_idx = 0, i; while (oldstate >>= 1) old_idx++; while (newstate >>= 1) new_idx++; GST_LOCK (bin); bin->child_states[old_idx]--; bin->child_states[new_idx]++; for (i = GST_NUM_STATES - 1; i >= 0; i--) { if (bin->child_states[i] != 0) { gint state = (1 << i); if (GST_STATE (bin) != state) { GST_CAT_INFO (GST_CAT_STATES, "bin %s need state change to %s", GST_ELEMENT_NAME (bin), gst_element_state_get_name (state)); GST_STATE_PENDING (bin) = state; GST_UNLOCK (bin); gst_bin_change_state_norecurse (bin); if (state != GST_STATE (bin)) { g_warning ("%s: state change in cllback %d %d", GST_ELEMENT_NAME (bin), state, GST_STATE (bin)); } return; } break; } } GST_UNLOCK (bin); } static GstElementStateReturn gst_bin_change_state (GstElement * element) { GstBin *bin; GList *children; GstElement *child; GstElementStateReturn ret; GstElementState old_state, pending; gint transition; gboolean have_async = FALSE; g_return_val_if_fail (GST_IS_BIN (element), GST_STATE_FAILURE); bin = GST_BIN (element); old_state = GST_STATE (element); pending = GST_STATE_PENDING (element); transition = GST_STATE_TRANSITION (element); GST_CAT_INFO (GST_CAT_STATES, "[%s]: changing childrens' state from %s to %s", GST_ELEMENT_NAME (element), gst_element_state_get_name (old_state), gst_element_state_get_name (pending)); if (pending == GST_STATE_VOID_PENDING) return GST_STATE_SUCCESS; if (old_state == pending) { GST_CAT_INFO (GST_CAT_STATES, "[%s]: old and pending state are both %s, returning", GST_ELEMENT_NAME (element), gst_element_state_get_name (pending)); return GST_STATE_SUCCESS; } children = bin->children; while (children) { GstElementState old_child_state; child = GST_ELEMENT (children->data); children = g_list_next (children); if (GST_FLAG_IS_SET (child, GST_ELEMENT_LOCKED_STATE)) continue; old_child_state = GST_STATE (child); switch (gst_element_set_state (child, pending)) { case GST_STATE_FAILURE: GST_CAT_DEBUG (GST_CAT_STATES, "child '%s' failed to go to state %d(%s)", GST_ELEMENT_NAME (child), pending, gst_element_state_get_name (pending)); gst_element_set_state (child, old_child_state); /* FIXME, this is legacy code, a failed state change of a child should * return a failure in all cases */ if (GST_ELEMENT_SCHED (child) == GST_ELEMENT_SCHED (element)) { /* try to reset it to what is was */ GST_STATE_PENDING (element) = old_state; return GST_STATE_FAILURE; } break; case GST_STATE_ASYNC: GST_CAT_DEBUG (GST_CAT_STATES, "child '%s' is changing state asynchronously", GST_ELEMENT_NAME (child)); have_async = TRUE; break; case GST_STATE_SUCCESS: break; } } GST_CAT_INFO (GST_CAT_STATES, "[%s]: done changing bin's state from %s to %s, now in %s", GST_ELEMENT_NAME (element), gst_element_state_get_name (old_state), gst_element_state_get_name (pending), gst_element_state_get_name (GST_STATE (element))); if (have_async) ret = GST_STATE_ASYNC; else { if (parent_class->change_state) { ret = parent_class->change_state(element); } else ret = GST_STATE_SUCCESS; } return ret; } static GstElementStateReturn gst_bin_change_state_norecurse (GstBin * bin) { GstElementStateReturn ret; if (parent_class->change_state) { GST_CAT_DEBUG (GST_CAT_STATES, "[%s]: setting bin's own state", GST_ELEMENT_NAME (bin)); ret = parent_class->change_state (GST_ELEMENT (bin)); return ret; } else return GST_STATE_FAILURE; } static void gst_bin_dispose (GObject * object) { GstBin *bin = GST_BIN (object); GList *children, *orig; GstElement *child; GST_CAT_DEBUG (GST_CAT_REFCOUNTING, "dispose"); if (gst_element_get_state (GST_ELEMENT (object)) == GST_STATE_PLAYING) gst_element_set_state (GST_ELEMENT (object), GST_STATE_PAUSED); if (bin->children) { orig = children = g_list_copy (bin->children); while (children) { child = GST_ELEMENT (children->data); gst_bin_remove (bin, child); children = g_list_next (children); } g_list_free (bin->children); g_list_free (orig); } bin->children = NULL; bin->numchildren = 0; G_OBJECT_CLASS (parent_class)->dispose (object); } /** * gst_bin_get_by_name: * @bin: #Gstbin to search * @name: the element name to search for * * Get the element with the given name from this bin. * * Returns: the element with the given name */ GstElement * gst_bin_get_by_name (GstBin * bin, const gchar * name) { GList *children; GstElement *child; g_return_val_if_fail (bin != NULL, NULL); g_return_val_if_fail (GST_IS_BIN (bin), NULL); g_return_val_if_fail (name != NULL, NULL); GST_CAT_INFO (GST_CAT_PARENTAGE, "[%s]: looking up child element %s", GST_ELEMENT_NAME (bin), name); children = bin->children; while (children) { child = GST_ELEMENT (children->data); if (!strcmp (GST_OBJECT_NAME (child), name)) return child; if (GST_IS_BIN (child)) { GstElement *res = gst_bin_get_by_name (GST_BIN (child), name); if (res) return res; } children = g_list_next (children); } return NULL; } /** * gst_bin_get_by_name_recurse_up: * @bin: #Gstbin to search * @name: the element name to search for * * Get the element with the given name from this bin. If the * element is not found, a recursion is performed on the parent bin. * * Returns: the element with the given name */ GstElement * gst_bin_get_by_name_recurse_up (GstBin * bin, const gchar * name) { GstElement *result = NULL; GstObject *parent; g_return_val_if_fail (bin != NULL, NULL); g_return_val_if_fail (GST_IS_BIN (bin), NULL); g_return_val_if_fail (name != NULL, NULL); result = gst_bin_get_by_name (bin, name); if (!result) { parent = gst_object_get_parent (GST_OBJECT (bin)); if (parent && GST_IS_BIN (parent)) { result = gst_bin_get_by_name_recurse_up (GST_BIN (parent), name); } } return result; } /** * gst_bin_get_list: * @bin: #Gstbin to get the list from * * Get the list of elements in this bin. * * Returns: a GList of elements */ const GList * gst_bin_get_list (GstBin * bin) { g_return_val_if_fail (GST_IS_BIN (bin), NULL); return bin->children; } /** * gst_bin_sync_children_state: * @bin: #Gstbin to sync state * * Tries to set the state of the children of this bin to the same state of the * bin by calling gst_element_set_state for each child not already having a * synchronized state. * * Returns: The worst return value of any gst_element_set_state. So if one child * returns #GST_STATE_FAILURE while all others return #GST_STATE_SUCCESS * this function returns #GST_STATE_FAILURE. */ GstElementStateReturn gst_bin_sync_children_state (GstBin *bin) { GList *children; GstElement *element; GstElementState state; GstElementStateReturn ret = GST_STATE_SUCCESS; g_return_val_if_fail (GST_IS_BIN (bin), GST_STATE_FAILURE); state = GST_STATE (bin); children = bin->children; GST_CAT_INFO (GST_CAT_STATES, "syncing state of children with bin \"%s\"'s state %s", GST_ELEMENT_NAME (bin), gst_element_state_get_name (state)); while (children) { element = GST_ELEMENT (children->data); children = children->next; if (GST_STATE(element) != state) { switch (gst_element_set_state (element, state)) { case GST_STATE_SUCCESS: break; case GST_STATE_ASYNC: if (ret == GST_STATE_SUCCESS) ret = GST_STATE_ASYNC; break; case GST_STATE_FAILURE: ret = GST_STATE_FAILURE; default: /* make sure gst_element_set_state never returns this */ g_assert_not_reached (); } } } return ret; } #ifndef GST_DISABLE_LOADSAVE static xmlNodePtr gst_bin_save_thyself (GstObject * object, xmlNodePtr parent) { GstBin *bin = GST_BIN (object); xmlNodePtr childlist, elementnode; GList *children; GstElement *child; if (GST_OBJECT_CLASS (parent_class)->save_thyself) GST_OBJECT_CLASS (parent_class)->save_thyself (GST_OBJECT (bin), parent); childlist = xmlNewChild (parent, NULL, "children", NULL); GST_CAT_INFO (GST_CAT_XML, "[%s]: saving %d children", GST_ELEMENT_NAME (bin), bin->numchildren); children = bin->children; while (children) { child = GST_ELEMENT (children->data); elementnode = xmlNewChild (childlist, NULL, "element", NULL); gst_object_save_thyself (GST_OBJECT (child), elementnode); children = g_list_next (children); } return childlist; } static void gst_bin_restore_thyself (GstObject * object, xmlNodePtr self) { GstBin *bin = GST_BIN (object); xmlNodePtr field = self->xmlChildrenNode; xmlNodePtr childlist; while (field) { if (!strcmp (field->name, "children")) { GST_CAT_INFO (GST_CAT_XML, "[%s]: loading children", GST_ELEMENT_NAME (object)); childlist = field->xmlChildrenNode; while (childlist) { if (!strcmp (childlist->name, "element")) { GstElement *element = gst_xml_make_element (childlist, GST_OBJECT (bin)); /* it had to be parented to find the pads, now we ref and unparent so * we can add it to the bin */ gst_object_ref (GST_OBJECT (element)); gst_object_unparent (GST_OBJECT (element)); gst_bin_add (bin, element); } childlist = childlist->next; } } field = field->next; } } #endif /* GST_DISABLE_LOADSAVE */ static gboolean gst_bin_iterate_func (GstBin * bin) { /* only iterate if this is the manager bin */ if (GST_ELEMENT_SCHED (bin) && GST_ELEMENT_SCHED (bin)->parent == GST_ELEMENT (bin)) { GstSchedulerState state; state = gst_scheduler_iterate (GST_ELEMENT_SCHED (bin)); if (state == GST_SCHEDULER_STATE_RUNNING) { return TRUE; } else if (state == GST_SCHEDULER_STATE_ERROR) { gst_element_set_state (GST_ELEMENT (bin), GST_STATE_PAUSED); } } else { g_warning ("bin \"%s\" is not the managing bin, can't be iterated on!\n", GST_ELEMENT_NAME (bin)); } return FALSE; } /** * gst_bin_iterate: * @bin: a#GstBin to iterate. * * Iterates over the elements in this bin. * * Returns: TRUE if the bin did something useful. This value * can be used to determine it the bin is in EOS. */ gboolean gst_bin_iterate (GstBin *bin) { GstBinClass *oclass; gboolean running = TRUE; GST_CAT_LOG_OBJECT (GST_CAT_DATAFLOW, bin, "starting iteration"); g_return_val_if_fail (bin != NULL, FALSE); g_return_val_if_fail (GST_IS_BIN (bin), FALSE); oclass = GST_BIN_GET_CLASS (bin); gst_object_ref (GST_OBJECT (bin)); if (bin->pre_iterate_func) (bin->pre_iterate_func) (bin, bin->pre_iterate_data); if (oclass->iterate) running = (oclass->iterate) (bin); if (bin->post_iterate_func) (bin->post_iterate_func) (bin, bin->post_iterate_data); GST_CAT_LOG_OBJECT (GST_CAT_DATAFLOW, bin, "finished iteration"); if (!running) { if (GST_STATE (bin) == GST_STATE_PLAYING && GST_STATE_PENDING (bin) == GST_STATE_VOID_PENDING) { GST_CAT_DEBUG (GST_CAT_DATAFLOW, "[%s]: polling for child shutdown after useless iteration", GST_ELEMENT_NAME (bin)); g_usleep (1); running = TRUE; } } gst_object_unref (GST_OBJECT (bin)); return running; } /** * gst_bin_set_pre_iterate_function: * @bin: #Gstbin to attach to * @func: callback function to call * @user_data: user data to put in the function call * * Attaches a callback which will be run before every iteration of the bin * */ void gst_bin_set_pre_iterate_function (GstBin *bin, GstBinPrePostIterateFunction func, gpointer user_data) { g_return_if_fail (GST_IS_BIN (bin)); if (!GST_FLAG_IS_SET (bin, GST_BIN_FLAG_MANAGER)) g_warning ("setting pre_iterate on a non MANAGER bin has no effect"); bin->pre_iterate_func = func; bin->pre_iterate_data = user_data; } /** * gst_bin_set_post_iterate_function: * @bin: #Gstbin to attach to * @func: callback function to call * @user_data: user data to put in the function call * * Attaches a callback which will be run after every iteration of the bin * */ void gst_bin_set_post_iterate_function (GstBin *bin, GstBinPrePostIterateFunction func, gpointer user_data) { g_return_if_fail (GST_IS_BIN (bin)); if (!GST_FLAG_IS_SET (bin, GST_BIN_FLAG_MANAGER)) g_warning ("setting post_iterate on a non MANAGER bin has no effect"); bin->post_iterate_func = func; bin->post_iterate_data = user_data; } f888154737f7'>Updated Slovenian translationMartin Srebotnjak1-2/+2 2022-05-10sl: typo fixAndras Timar1-1/+1 2022-05-08Updated Slovenian translationMartin Srebotnjak73-14454/+22809 2022-05-04update translations for masterChristian Lohmaier1269-158594/+173192 2022-04-26update translations for masterChristian Lohmaier1557-157600/+163634 2022-04-11update translations for masterChristian Lohmaier