Add HAL sound device wrapper plugins. Closes #329106

Original commit message from CVS:
* configure.ac:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-good-plugins-docs.sgml:
* docs/plugins/gst-plugins-good-plugins-sections.txt:
* docs/plugins/gst-plugins-good-plugins.hierarchy:
* ext/Makefile.am:
* ext/hal/Makefile.am:
* ext/hal/gsthalaudiosink.c: (gst_hal_audio_sink_base_init),
(gst_hal_audio_sink_class_init), (gst_hal_audio_sink_reset),
(gst_hal_audio_sink_init), (gst_hal_audio_sink_dispose),
(do_toggle_element), (gst_hal_audio_sink_set_property),
(gst_hal_audio_sink_get_property),
(gst_hal_audio_sink_change_state):
* ext/hal/gsthalaudiosink.h:
* ext/hal/gsthalaudiosrc.c: (gst_hal_audio_src_base_init),
(gst_hal_audio_src_class_init), (gst_hal_audio_src_reset),
(gst_hal_audio_src_init), (gst_hal_audio_src_dispose),
(do_toggle_element), (gst_hal_audio_src_set_property),
(gst_hal_audio_src_get_property), (gst_hal_audio_src_change_state):
* ext/hal/gsthalaudiosrc.h:
* ext/hal/gsthalelements.c: (plugin_init):
* ext/hal/gsthalelements.h:
* ext/hal/hal.c: (gst_hal_get_string),
(gst_hal_render_bin_from_udi), (gst_hal_get_audio_sink),
(gst_hal_get_audio_src):
* ext/hal/hal.h:
Add HAL sound device wrapper plugins. Closes #329106

1 files changed, 168 insertions, 0 deletions

diff --git a/ext/hal/hal.c b/ext/hal/hal.c
new file mode 100644
index 00000000..9b55f6d6
--- /dev/null
+++ b/ext/hal/hal.c
@@ -0,0 +1,168 @@
+/* GStreamer
+ * Copyright (C) <2002> Thomas Vander Stichele <thomas@apestaart.org>
+ * Copyright (C) <2006> Jürg Billeter <j@bitron.ch>
+ *
+ * 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.
+ */
+
+/*
+ * this library handles interaction with Hal
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <string.h>
+#include <glib.h>
+#include "hal.h"
+
+
+/* external functions */
+
+/**
+ * gst_hal_get_string:
+ * @key: a #gchar corresponding to the key you want to get.
+ *
+ * Get Hal UDI @udi's string value.
+ *
+ * Returns: a newly allocated #gchar string containing the appropriate pipeline
+ * for UDI @udi, or NULL in the case of an error..
+ */
+gchar *
+gst_hal_get_string (const gchar * udi)
+{
+  DBusConnection *connection;
+  DBusError error;
+  LibHalContext *ctx;
+  char *type, *string;
+  char *element;
+  int card, device;
+
+  dbus_error_init (&error);
+
+  connection = dbus_bus_get (DBUS_BUS_SYSTEM, &error);
+  g_return_val_if_fail (connection != NULL, NULL);
+
+  ctx = libhal_ctx_new ();
+  g_return_val_if_fail (ctx != NULL, NULL);
+
+  libhal_ctx_set_dbus_connection (ctx, connection);
+  libhal_ctx_init (ctx, &error);
+
+  string = NULL;
+
+  if (libhal_device_query_capability (ctx, udi, "alsa", &error)) {
+    type = libhal_device_get_property_string (ctx, udi, "alsa.type", &error);
+    if (strcmp (type, "playback") == 0) {
+      element = "alsasink";
+    } else if (strcmp (type, "capture") == 0) {
+      element = "alsasrc";
+    } else {
+      element = NULL;
+    }
+    card = libhal_device_get_property_int (ctx, udi, "alsa.card", &error);
+    device = libhal_device_get_property_int (ctx, udi, "alsa.device", &error);
+    if (device == 0) {
+      /* handle default device specially to use
+       * dmix, dsnoop, and softvol if appropriate */
+      string = g_strdup_printf ("%s device=default:%d", element, card);
+    } else {
+      string =
+          g_strdup_printf ("%s device=plughw:%d,%d", element, card, device);
+    }
+  }
+
+  libhal_ctx_shutdown (ctx, &error);
+  libhal_ctx_free (ctx);
+
+  dbus_error_free (&error);
+
+  return string;
+}
+
+/**
+ * gst_hal_render_bin_from_udi:
+ * @key: a #gchar string corresponding to a Hal UDI.
+ *
+ * Render bin from Hal UDI @udi.
+ *
+ * Returns: a #GstElement containing the rendered bin.
+ */
+GstElement *
+gst_hal_render_bin_from_udi (const gchar * udi)
+{
+  GstElement *bin = NULL;
+  gchar *value;
+
+  value = gst_hal_get_string (udi);
+  if (value)
+    bin = gst_parse_bin_from_description (value, TRUE, NULL);
+  g_free (value);
+  return bin;
+}
+
+/**
+ * gst_hal_get_audio_sink:
+ *
+ * Render audio output bin from GStreamer Hal UDI.
+ * If no device with the specified UDI exists, the default audio sink for the
+ * platform is used (typically osssink or sunaudiosink).
+ *
+ * Returns: a #GstElement containing the audio output bin, or NULL if
+ * everything failed.
+ */
+GstElement *
+gst_hal_get_audio_sink (const gchar * udi)
+{
+  GstElement *ret = gst_hal_render_bin_from_udi (udi);
+
+  if (!ret) {
+    ret = gst_element_factory_make (DEFAULT_AUDIOSINK, NULL);
+
+    if (!ret)
+      g_warning ("No Hal default audio sink key and %s doesn't work",
+          DEFAULT_AUDIOSINK);
+  }
+
+  return ret;
+}
+
+/**
+ * gst_hal_get_audio_src:
+ *
+ * Render audio acquisition bin from GStreamer Hal UDI.
+ * If no device with the specified UDI exists, the default audio source for the
+ * plaform is used (typically osssrc or sunaudiosrc).
+ *
+ * Returns: a #GstElement containing the audio source bin, or NULL if
+ * everything failed.
+ */
+GstElement *
+gst_hal_get_audio_src (const gchar * udi)
+{
+  GstElement *ret = gst_hal_render_bin_from_udi (udi);
+
+  if (!ret) {
+    ret = gst_element_factory_make (DEFAULT_AUDIOSRC, NULL);
+
+    if (!ret)
+      g_warning ("No Hal default audio src key and %s doesn't work",
+          DEFAULT_AUDIOSRC);
+  }
+
+  return ret;
+}