/**
* SECTION:gstdeviceprovider
+ * @title: GstDeviceProvider
* @short_description: A device provider
* @see_also: #GstDevice, #GstDeviceMonitor
*
GMutex start_lock;
gboolean started_count;
+
+ GList *hidden_providers;
};
+enum
+{
+ PROVIDER_HIDDEN,
+ PROVIDER_UNHIDDEN,
+ LAST_SIGNAL
+};
+
+static guint gst_device_provider_signals[LAST_SIGNAL] = { 0 };
+
/* this is used in gstelementfactory.c:gst_element_register() */
GQuark __gst_deviceproviderclass_factory = 0;
static void gst_device_provider_class_init (GstDeviceProviderClass * klass);
static void gst_device_provider_init (GstDeviceProvider * element);
static void gst_device_provider_base_class_init (gpointer g_class);
-static void gst_device_provider_base_class_finalize (gpointer g_class);
static void gst_device_provider_dispose (GObject * object);
static void gst_device_provider_finalize (GObject * object);
static const GTypeInfo element_info = {
sizeof (GstDeviceProviderClass),
gst_device_provider_base_class_init,
- gst_device_provider_base_class_finalize,
+ NULL, /* base_class_finalize */
(GClassInitFunc) gst_device_provider_class_init,
NULL,
NULL,
}
static void
-gst_device_provider_base_class_finalize (gpointer g_class)
-{
- GstDeviceProviderClass *klass = GST_DEVICE_PROVIDER_CLASS (g_class);
-
- gst_structure_free (klass->metadata);
-}
-
-static void
gst_device_provider_class_init (GstDeviceProviderClass * klass)
{
GObjectClass *gobject_class = (GObjectClass *) klass;
gobject_class->dispose = gst_device_provider_dispose;
gobject_class->finalize = gst_device_provider_finalize;
+
+ gst_device_provider_signals[PROVIDER_HIDDEN] =
+ g_signal_new ("provider-hidden", G_TYPE_FROM_CLASS (klass),
+ G_SIGNAL_RUN_FIRST, 0, NULL,
+ NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 1, G_TYPE_STRING);
+
+ gst_device_provider_signals[PROVIDER_UNHIDDEN] =
+ g_signal_new ("provider-unhidden", G_TYPE_FROM_CLASS (klass),
+ G_SIGNAL_RUN_FIRST, 0, NULL,
+ NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 1, G_TYPE_STRING);
}
static void
* multiple author metadata. E.g: "Joe Bloggs <joe.blogs at foo.com>"
*
* Sets the detailed information for a #GstDeviceProviderClass.
- * <note>This function is for use in _class_init functions only.</note>
+ *
+ * > This function is for use in _class_init functions only.
*
* Since: 1.4
*/
* foo.com>"
*
* Sets the detailed information for a #GstDeviceProviderClass.
- * <note>This function is for use in _class_init functions only.</note>
+ *
+ * > This function is for use in _class_init functions only.
*
* Same as gst_device_provider_class_set_metadata(), but @longname, @classification,
* @description, and @author must be static strings or inlined strings, as
{
GstMessage *message;
+ g_return_if_fail (GST_IS_DEVICE_PROVIDER (provider));
+ g_return_if_fail (GST_IS_DEVICE (device));
+
if (!gst_object_set_parent (GST_OBJECT (device), GST_OBJECT (provider))) {
GST_WARNING_OBJECT (provider, "Could not parent device %p to provider,"
" it already has a parent", device);
GstMessage *message;
GList *item;
+ g_return_if_fail (GST_IS_DEVICE_PROVIDER (provider));
+ g_return_if_fail (GST_IS_DEVICE (device));
+
GST_OBJECT_LOCK (provider);
item = g_list_find (provider->devices, device);
if (item) {
if (item)
gst_object_unparent (GST_OBJECT (device));
}
+
+/**
+ * gst_device_provider_get_hidden_providers:
+ * @provider: a #GstDeviceProvider
+ *
+ * Get the provider factory names of the #GstDeviceProvider instances that
+ * are hidden by @provider.
+ *
+ * Returns: (transfer full) (array zero-terminated=1) (element-type gchar*):
+ * a list of hidden providers factory names or %NULL when
+ * nothing is hidden by @provider. Free with g_strfreev.
+ *
+ * Since: 1.6
+ */
+gchar **
+gst_device_provider_get_hidden_providers (GstDeviceProvider * provider)
+{
+ GList *walk;
+ guint i, len;
+ gchar **res = NULL;
+
+ g_return_val_if_fail (GST_IS_DEVICE_PROVIDER (provider), NULL);
+
+ GST_OBJECT_LOCK (provider);
+ len = g_list_length (provider->priv->hidden_providers);
+ if (len == 0)
+ goto done;
+
+ res = g_new (gchar *, len + 1);
+ for (i = 0, walk = provider->priv->hidden_providers; walk;
+ walk = g_list_next (walk), i++)
+ res[i] = g_strdup (walk->data);
+ res[i] = NULL;
+
+done:
+ GST_OBJECT_UNLOCK (provider);
+
+ return res;
+}
+
+/**
+ * gst_device_provider_hide_provider:
+ * @provider: a #GstDeviceProvider
+ * @name: a provider factory name
+ *
+ * Make @provider hide the devices from the factory with @name.
+ *
+ * This function is used when @provider will also provide the devices reported
+ * by provider factory @name. A monitor should stop monitoring the
+ * device provider with @name to avoid duplicate devices.
+ *
+ * Since: 1.6
+ */
+void
+gst_device_provider_hide_provider (GstDeviceProvider * provider,
+ const gchar * name)
+{
+ GList *find;
+ const gchar *hidden_name = NULL;
+
+ g_return_if_fail (GST_IS_DEVICE_PROVIDER (provider));
+ g_return_if_fail (name != NULL);
+
+ GST_OBJECT_LOCK (provider);
+ find =
+ g_list_find_custom (provider->priv->hidden_providers, name,
+ (GCompareFunc) g_strcmp0);
+ if (find == NULL) {
+ hidden_name = name;
+ provider->priv->hidden_providers =
+ g_list_prepend (provider->priv->hidden_providers, g_strdup (name));
+ }
+ GST_OBJECT_UNLOCK (provider);
+
+ if (hidden_name)
+ g_signal_emit (provider, gst_device_provider_signals[PROVIDER_HIDDEN],
+ 0, hidden_name);
+}
+
+/**
+ * gst_device_provider_unhide_provider:
+ * @provider: a #GstDeviceProvider
+ * @name: a provider factory name
+ *
+ * Make @provider unhide the devices from factory @name.
+ *
+ * This function is used when @provider will no longer provide the devices
+ * reported by provider factory @name. A monitor should start
+ * monitoring the devices from provider factory @name in order to see
+ * all devices again.
+ *
+ * Since: 1.6
+ */
+void
+gst_device_provider_unhide_provider (GstDeviceProvider * provider,
+ const gchar * name)
+{
+ GList *find;
+ gchar *unhidden_name = NULL;
+
+ g_return_if_fail (GST_IS_DEVICE_PROVIDER (provider));
+ g_return_if_fail (unhidden_name != NULL);
+
+ GST_OBJECT_LOCK (provider);
+ find =
+ g_list_find_custom (provider->priv->hidden_providers, name,
+ (GCompareFunc) g_strcmp0);
+ if (find) {
+ unhidden_name = find->data;
+ provider->priv->hidden_providers =
+ g_list_delete_link (provider->priv->hidden_providers, find);
+ }
+ GST_OBJECT_UNLOCK (provider);
+
+ if (unhidden_name) {
+ g_signal_emit (provider,
+ gst_device_provider_signals[PROVIDER_UNHIDDEN], 0, unhidden_name);
+ g_free (unhidden_name);
+ }
+}
projects / platform / upstream / gstreamer.git / blobdiff