sys/oss/gstossmixerelement.c

   1 /* OSS mixer interface element.
   2  * Copyright (C) 2005 Andrew Vander Wingo <wingo@pobox.com>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /**
  21  * SECTION:element-ossmixer
  22  *
  23  * This element lets you adjust sound input and output levels with the
  24  * Open Sound System (OSS). It supports the #GstMixer interface, which can be
  25  * used to obtain a list of available mixer tracks. Set the mixer element to
  26  * READY state before using the #GstMixer interface on it.
  27  *
  28  * <refsect2>
  29  * <title>Example pipelines</title>
  30  * <para>
  31  * ossmixer can't be used in a sensible way in gst-launch.
  32  * </para>
  33  * </refsect2>
  34  */
  35
  36 #ifdef HAVE_CONFIG_H
  37 #include "config.h"
  38 #endif
  39
  40 #include "gstossmixerelement.h"
  41
  42 GST_DEBUG_CATEGORY_EXTERN (oss_debug);
  43 #define GST_CAT_DEFAULT oss_debug
  44
  45 #define DEFAULT_DEVICE       "/dev/mixer"
  46 #define DEFAULT_DEVICE_NAME  NULL
  47
  48 enum
  49 {
  50   PROP_0,
  51   PROP_DEVICE,
  52   PROP_DEVICE_NAME
  53 };
  54
  55 GST_BOILERPLATE_WITH_INTERFACE (GstOssMixerElement, gst_oss_mixer_element,
  56     GstElement, GST_TYPE_ELEMENT, GstMixer, GST_TYPE_MIXER,
  57     gst_oss_mixer_element);
  58
  59 GST_IMPLEMENT_OSS_MIXER_METHODS (GstOssMixerElement, gst_oss_mixer_element);
  60
  61 static GstStateChangeReturn gst_oss_mixer_element_change_state (GstElement *
  62     element, GstStateChange transition);
  63
  64 static void gst_oss_mixer_element_set_property (GObject * object,
  65     guint prop_id, const GValue * value, GParamSpec * pspec);
  66 static void gst_oss_mixer_element_get_property (GObject * object,
  67     guint prop_id, GValue * value, GParamSpec * pspec);
  68 static void gst_oss_mixer_element_finalize (GObject * object);
  69
  70 static void
  71 gst_oss_mixer_element_base_init (gpointer klass)
  72 {
  73   gst_element_class_set_details_simple (GST_ELEMENT_CLASS (klass), "OSS Mixer",
  74       "Generic/Audio",
  75       "Control sound input and output levels with OSS",
  76       "Andrew Vander Wingo <wingo@pobox.com>");
  77 }
  78
  79 static void
  80 gst_oss_mixer_element_class_init (GstOssMixerElementClass * klass)
  81 {
  82   GstElementClass *element_class;
  83   GObjectClass *gobject_class;
  84
  85   element_class = (GstElementClass *) klass;
  86   gobject_class = (GObjectClass *) klass;
  87
  88   gobject_class->finalize = gst_oss_mixer_element_finalize;
  89   gobject_class->set_property = gst_oss_mixer_element_set_property;
  90   gobject_class->get_property = gst_oss_mixer_element_get_property;
  91
  92   /**
  93    * GstOssMixerElement:device
  94    *
  95    * OSS mixer device (usually /dev/mixer)
  96    *
  97    * Since: 0.10.5
  98    **/
  99   g_object_class_install_property (gobject_class, PROP_DEVICE,
 100       g_param_spec_string ("device", "Device",
 101           "OSS mixer device (usually /dev/mixer)", DEFAULT_DEVICE,
 102           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 103
 104   g_object_class_install_property (gobject_class, PROP_DEVICE_NAME,
 105       g_param_spec_string ("device-name", "Device name",
 106           "Human-readable name of the sound device", DEFAULT_DEVICE_NAME,
 107           G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 108
 109   element_class->change_state =
 110       GST_DEBUG_FUNCPTR (gst_oss_mixer_element_change_state);
 111 }
 112
 113 static void
 114 gst_oss_mixer_element_finalize (GObject * obj)
 115 {
 116   GstOssMixerElement *this = GST_OSS_MIXER_ELEMENT (obj);
 117
 118   g_free (this->device);
 119
 120   G_OBJECT_CLASS (parent_class)->finalize (obj);
 121 }
 122
 123 static void
 124 gst_oss_mixer_element_init (GstOssMixerElement * this,
 125     GstOssMixerElementClass * g_class)
 126 {
 127   this->mixer = NULL;
 128   this->device = g_strdup (DEFAULT_DEVICE);
 129 }
 130
 131 static void
 132 gst_oss_mixer_element_set_property (GObject * object, guint prop_id,
 133     const GValue * value, GParamSpec * pspec)
 134 {
 135   GstOssMixerElement *this = GST_OSS_MIXER_ELEMENT (object);
 136
 137   switch (prop_id) {
 138     case PROP_DEVICE:
 139       g_free (this->device);
 140       this->device = g_value_dup_string (value);
 141       /* make sure we never set NULL */
 142       if (this->device == NULL) {
 143         this->device = g_strdup (DEFAULT_DEVICE);
 144       }
 145       break;
 146     default:
 147       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 148       break;
 149   }
 150 }
 151
 152 static void
 153 gst_oss_mixer_element_get_property (GObject * object, guint prop_id,
 154     GValue * value, GParamSpec * pspec)
 155 {
 156   GstOssMixerElement *this = GST_OSS_MIXER_ELEMENT (object);
 157
 158   switch (prop_id) {
 159     case PROP_DEVICE:
 160       g_value_set_string (value, this->device);
 161       break;
 162     case PROP_DEVICE_NAME:
 163       if (this->mixer) {
 164         g_value_set_string (value, this->mixer->cardname);
 165       } else {
 166         g_value_set_string (value, NULL);
 167       }
 168       break;
 169     default:
 170       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 171       break;
 172   }
 173 }
 174
 175 static GstStateChangeReturn
 176 gst_oss_mixer_element_change_state (GstElement * element,
 177     GstStateChange transition)
 178 {
 179   GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
 180   GstOssMixerElement *this = GST_OSS_MIXER_ELEMENT (element);
 181
 182   switch (transition) {
 183     case GST_STATE_CHANGE_NULL_TO_READY:
 184       if (!this->mixer) {
 185         this->mixer = gst_ossmixer_new (this->device, GST_OSS_MIXER_ALL);
 186         if (!this->mixer)
 187           goto open_failed;
 188       }
 189       break;
 190       break;
 191     default:
 192       break;
 193   }
 194
 195   ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
 196   if (ret == GST_STATE_CHANGE_FAILURE)
 197     return ret;
 198
 199   switch (transition) {
 200     case GST_STATE_CHANGE_READY_TO_NULL:
 201       if (this->mixer) {
 202         gst_ossmixer_free (this->mixer);
 203         this->mixer = NULL;
 204       }
 205       break;
 206     default:
 207       break;
 208   }
 209   return ret;
 210
 211   /* ERRORS */
 212 open_failed:
 213   {
 214     GST_ELEMENT_ERROR (element, RESOURCE, OPEN_READ_WRITE, (NULL),
 215         ("Failed to open oss mixer device '%s'", this->device));
 216     return GST_STATE_CHANGE_FAILURE;
 217   }
 218 }