2 * (c) 2005 Ronald S. Bultje <rbultje@ronald.bitfreak.net>
3 * (c) 2005 Tim-Philipp Müller <tim centricular net>
4 * (c) 2006 Jürg Billeter <j@bitron.ch>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
23 * SECTION:element-halaudiosrc
25 * HalAudioSrc allows access to input of sound devices by specifying the
26 * corresponding persistent Unique Device Id (UDI) from the Hardware Abstraction
27 * Layer (HAL) in the #GstHalAudioSrc:udi property.
28 * It currently always embeds alsasrc or osssrc as HAL doesn't support other
29 * sound systems yet. You can also specify the UDI of a device that has ALSA or
30 * OSS subdevices. If both are present ALSA is preferred.
33 * <title>Examples</title>
35 * hal-find-by-property --key alsa.type --string capture
36 * ]| list the UDIs of all your ALSA input devices
38 * gst-launch -v halaudiosrc udi=/org/freedesktop/Hal/devices/pci_8086_27d8_alsa_capture_0 ! autoaudiosink
39 * ]| You should now hear yourself with a small delay if you have a microphone
40 * connected to the specified sound device.
48 #include "gsthalelements.h"
49 #include "gsthalaudiosrc.h"
51 static void gst_hal_audio_src_dispose (GObject * object);
52 static GstStateChangeReturn
53 gst_hal_audio_src_change_state (GstElement * element,
54 GstStateChange transition);
62 GST_BOILERPLATE (GstHalAudioSrc, gst_hal_audio_src, GstBin, GST_TYPE_BIN);
64 static void gst_hal_audio_src_set_property (GObject * object, guint prop_id,
65 const GValue * value, GParamSpec * pspec);
66 static void gst_hal_audio_src_get_property (GObject * object, guint prop_id,
67 GValue * value, GParamSpec * pspec);
70 gst_hal_audio_src_base_init (gpointer klass)
72 GstElementClass *eklass = GST_ELEMENT_CLASS (klass);
74 static GstStaticPadTemplate src_template = GST_STATIC_PAD_TEMPLATE ("src",
79 gst_element_class_add_pad_template (eklass,
80 gst_static_pad_template_get (&src_template));
81 gst_element_class_set_details_simple (eklass, "HAL audio source",
83 "Audio source for sound device access via HAL",
84 "Jürg Billeter <j@bitron.ch>");
88 gst_hal_audio_src_class_init (GstHalAudioSrcClass * klass)
90 GObjectClass *oklass = G_OBJECT_CLASS (klass);
91 GstElementClass *eklass = GST_ELEMENT_CLASS (klass);
93 oklass->set_property = gst_hal_audio_src_set_property;
94 oklass->get_property = gst_hal_audio_src_get_property;
95 oklass->dispose = gst_hal_audio_src_dispose;
96 eklass->change_state = gst_hal_audio_src_change_state;
98 g_object_class_install_property (oklass, PROP_UDI,
99 g_param_spec_string ("udi",
100 "UDI", "Unique Device Id", NULL,
101 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
105 * Hack to make negotiation work.
109 gst_hal_audio_src_reset (GstHalAudioSrc * src)
115 gst_element_set_state (src->kid, GST_STATE_NULL);
116 gst_bin_remove (GST_BIN (src), src->kid);
118 src->kid = gst_element_factory_make ("fakesrc", "testsrc");
119 gst_bin_add (GST_BIN (src), src->kid);
121 targetpad = gst_element_get_static_pad (src->kid, "src");
122 gst_ghost_pad_set_target (GST_GHOST_PAD (src->pad), targetpad);
123 gst_object_unref (targetpad);
127 gst_hal_audio_src_init (GstHalAudioSrc * src, GstHalAudioSrcClass * g_class)
129 src->pad = gst_ghost_pad_new_no_target ("src", GST_PAD_SRC);
130 gst_element_add_pad (GST_ELEMENT (src), src->pad);
132 gst_hal_audio_src_reset (src);
136 gst_hal_audio_src_dispose (GObject * object)
138 GstHalAudioSrc *src = GST_HAL_AUDIO_SRC (object);
145 GST_CALL_PARENT (G_OBJECT_CLASS, dispose, (object));
149 do_toggle_element (GstHalAudioSrc * src)
153 /* kill old element */
155 GST_DEBUG_OBJECT (src, "Removing old kid");
156 gst_element_set_state (src->kid, GST_STATE_NULL);
157 gst_bin_remove (GST_BIN (src), src->kid);
161 GST_DEBUG_OBJECT (src, "Creating new kid");
163 GST_INFO_OBJECT (src, "No UDI set for device, using default one");
165 if (!(src->kid = gst_hal_get_audio_src (src->udi))) {
166 GST_ELEMENT_ERROR (src, LIBRARY, SETTINGS, (NULL),
167 ("Failed to render audio source from Hal"));
170 gst_element_set_state (src->kid, GST_STATE (src));
171 gst_bin_add (GST_BIN (src), src->kid);
173 /* re-attach ghostpad */
174 GST_DEBUG_OBJECT (src, "Creating new ghostpad");
175 targetpad = gst_element_get_static_pad (src->kid, "src");
176 gst_ghost_pad_set_target (GST_GHOST_PAD (src->pad), targetpad);
177 gst_object_unref (targetpad);
178 GST_DEBUG_OBJECT (src, "done changing hal audio source");
184 gst_hal_audio_src_set_property (GObject * object, guint prop_id,
185 const GValue * value, GParamSpec * pspec)
187 GstHalAudioSrc *this = GST_HAL_AUDIO_SRC (object);
189 GST_OBJECT_LOCK (this);
195 this->udi = g_value_dup_string (value);
198 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
202 GST_OBJECT_UNLOCK (this);
206 gst_hal_audio_src_get_property (GObject * object, guint prop_id,
207 GValue * value, GParamSpec * pspec)
209 GstHalAudioSrc *this = GST_HAL_AUDIO_SRC (object);
211 GST_OBJECT_LOCK (this);
215 g_value_set_string (value, this->udi);
218 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
222 GST_OBJECT_UNLOCK (this);
225 static GstStateChangeReturn
226 gst_hal_audio_src_change_state (GstElement * element, GstStateChange transition)
228 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
229 GstHalAudioSrc *src = GST_HAL_AUDIO_SRC (element);
231 switch (transition) {
232 case GST_STATE_CHANGE_NULL_TO_READY:
233 if (!do_toggle_element (src))
234 return GST_STATE_CHANGE_FAILURE;
240 ret = GST_CALL_PARENT_WITH_DEFAULT (GST_ELEMENT_CLASS, change_state,
241 (element, transition), GST_STATE_CHANGE_SUCCESS);
243 switch (transition) {
244 case GST_STATE_CHANGE_READY_TO_NULL:
245 gst_hal_audio_src_reset (src);