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_static_pad_template (eklass, &src_template);
80 gst_element_class_set_details_simple (eklass, "HAL audio source",
82 "Audio source for sound device access via HAL",
83 "Jürg Billeter <j@bitron.ch>");
87 gst_hal_audio_src_class_init (GstHalAudioSrcClass * klass)
89 GObjectClass *oklass = G_OBJECT_CLASS (klass);
90 GstElementClass *eklass = GST_ELEMENT_CLASS (klass);
92 oklass->set_property = gst_hal_audio_src_set_property;
93 oklass->get_property = gst_hal_audio_src_get_property;
94 oklass->dispose = gst_hal_audio_src_dispose;
95 eklass->change_state = gst_hal_audio_src_change_state;
97 g_object_class_install_property (oklass, PROP_UDI,
98 g_param_spec_string ("udi",
99 "UDI", "Unique Device Id", NULL,
100 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
104 * Hack to make negotiation work.
108 gst_hal_audio_src_reset (GstHalAudioSrc * src)
114 gst_element_set_state (src->kid, GST_STATE_NULL);
115 gst_bin_remove (GST_BIN (src), src->kid);
117 src->kid = gst_element_factory_make ("fakesrc", "testsrc");
118 gst_bin_add (GST_BIN (src), src->kid);
120 targetpad = gst_element_get_static_pad (src->kid, "src");
121 gst_ghost_pad_set_target (GST_GHOST_PAD (src->pad), targetpad);
122 gst_object_unref (targetpad);
126 gst_hal_audio_src_init (GstHalAudioSrc * src, GstHalAudioSrcClass * g_class)
128 src->pad = gst_ghost_pad_new_no_target ("src", GST_PAD_SRC);
129 gst_element_add_pad (GST_ELEMENT (src), src->pad);
131 gst_hal_audio_src_reset (src);
135 gst_hal_audio_src_dispose (GObject * object)
137 GstHalAudioSrc *src = GST_HAL_AUDIO_SRC (object);
144 GST_CALL_PARENT (G_OBJECT_CLASS, dispose, (object));
148 do_toggle_element (GstHalAudioSrc * src)
152 /* kill old element */
154 GST_DEBUG_OBJECT (src, "Removing old kid");
155 gst_element_set_state (src->kid, GST_STATE_NULL);
156 gst_bin_remove (GST_BIN (src), src->kid);
160 GST_DEBUG_OBJECT (src, "Creating new kid");
162 GST_INFO_OBJECT (src, "No UDI set for device, using default one");
164 if (!(src->kid = gst_hal_get_audio_src (src->udi))) {
165 GST_ELEMENT_ERROR (src, LIBRARY, SETTINGS, (NULL),
166 ("Failed to render audio source from Hal"));
169 gst_element_set_state (src->kid, GST_STATE (src));
170 gst_bin_add (GST_BIN (src), src->kid);
172 /* re-attach ghostpad */
173 GST_DEBUG_OBJECT (src, "Creating new ghostpad");
174 targetpad = gst_element_get_static_pad (src->kid, "src");
175 gst_ghost_pad_set_target (GST_GHOST_PAD (src->pad), targetpad);
176 gst_object_unref (targetpad);
177 GST_DEBUG_OBJECT (src, "done changing hal audio source");
183 gst_hal_audio_src_set_property (GObject * object, guint prop_id,
184 const GValue * value, GParamSpec * pspec)
186 GstHalAudioSrc *this = GST_HAL_AUDIO_SRC (object);
188 GST_OBJECT_LOCK (this);
194 this->udi = g_value_dup_string (value);
197 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
201 GST_OBJECT_UNLOCK (this);
205 gst_hal_audio_src_get_property (GObject * object, guint prop_id,
206 GValue * value, GParamSpec * pspec)
208 GstHalAudioSrc *this = GST_HAL_AUDIO_SRC (object);
210 GST_OBJECT_LOCK (this);
214 g_value_set_string (value, this->udi);
217 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
221 GST_OBJECT_UNLOCK (this);
224 static GstStateChangeReturn
225 gst_hal_audio_src_change_state (GstElement * element, GstStateChange transition)
227 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
228 GstHalAudioSrc *src = GST_HAL_AUDIO_SRC (element);
230 switch (transition) {
231 case GST_STATE_CHANGE_NULL_TO_READY:
232 if (!do_toggle_element (src))
233 return GST_STATE_CHANGE_FAILURE;
239 ret = GST_CALL_PARENT_WITH_DEFAULT (GST_ELEMENT_CLASS, change_state,
240 (element, transition), GST_STATE_CHANGE_SUCCESS);
242 switch (transition) {
243 case GST_STATE_CHANGE_READY_TO_NULL:
244 gst_hal_audio_src_reset (src);