This element is a #GstBin that has a single source and sink pad. It allows the user (the application) to easily add and remove filter-like element (that has a single source and sink pad), to the pipeline while it is running. It features a fully asynchronous API inspired by GLib's GAsyncResult based APIs. Each operation (addition or removal) can take a callback, this callback is guaranteed to be called. Unlike GIO, there is no guarantee about where this callback will be called from, it could be called before the action returns or it could be called later from another thread. The signature of this callback GstInsertBinCallback(). Apart from the library API, since 1.24 insertbin can also be found in the registry: ``` C GstElement *pipeline, *insertbin, *videoflip; gst_init (NULL, NULL); pipeline = gst_parse_launch ("videotestsrc ! insertbin name=i ! autovideosink", NULL); ... insertbin = gst_bin_get_by_name (GST_BIN (pipeline), "i"); videoflip = gst_element_factory_make ("videoflip", NULL); ... g_object_set (videoflip, "method", 1, NULL); g_signal_emit_by_name (insertbin, "append", videoflip, NULL, NULL); ... ``` Creates a new #GstInsertBin The new #GstInsertBin The name of the new #GstInsertBin element (or %NULL) This action signal adds the filter like element after any other element in the bin. Same as the #GstInsertBin::append signal. the #GstElement to add the callback to call when the element has been added or not, or %NULL The data to pass to the callback This action signal adds the filter like element after the @sibling element in the bin. Same as the #GstInsertBin::insert-after signal. the #GstElement to add the #GstElement to add @element after the callback to call when the element has been added or not, or %NULL The data to pass to the callback This action signal adds the filter like element before the @sibling element in the bin. Same as the #GstInsertBin::insert-before signal. the #GstElement to add the #GstElement to add @element before the callback to call when the element has been added or not, or %NULL The data to pass to the callback This action signal adds the filter like element before any other element in the bin. Same as the #GstInsertBin::prepend signal. the #GstElement to add the callback to call when the element has been added or not, or %NULL The data to pass to the callback This action signal removed the filter like element from the bin. Same as the #GstInsertBin::remove signal. the #GstElement to remove the callback to call when the element has been removed or not, or %NULL The data to pass to the callback This action signal adds the filter like element after any other element in the bin. Same as gst_insert_bin_append() the callback to call when the element has been added or not, or %NULL The data to pass to the callback The user data of the signal (ignored) This action signal adds the filter like element after the @sibling element in the bin. element in the bin. Same as gst_insert_bin_insert_after() the #GstElement to add @element after the callback to call when the element has been added or not, or %NULL The data to pass to the callback The user data of the signal (ignored) This action signal adds the filter like element before the @sibling element in the bin. Same as gst_insert_bin_insert_before() the #GstElement to add @element before the callback to call when the element has been added or not, or %NULL The data to pass to the callback The user data of the signal (ignored) This action signal adds the filter like element before any other element in the bin. Same as gst_insert_bin_prepend() the callback to call when the element has been added or not, or %NULL The data to pass to the callback The user data of the signal (ignored) This action signal removed the filter like element from the bin. Same as gst_insert_bin_remove() the callback to call when the element has been removed or not, or %NULL The data to pass to the callback The user data of the signal (ignored) This is the prototype of callbacks to be called when the operation completes. It could be called at any time, including as a re-entrant call while the operation is requested. A #GstInsertBin The #GstElement on which the operation was performed %TRUE if the operation was successful The user data passed The object class structure.