mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-04 23:46:43 +00:00
288 lines
8.9 KiB
C
288 lines
8.9 KiB
C
/* GStreamer Mixer
|
|
* Copyright (C) 2003 Ronald Bultje <rbultje@ronald.bitfreak.net>
|
|
*
|
|
* mixertrack.c: mixer track object design
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
/**
|
|
* SECTION:gstmixertrack
|
|
* @short_description: Basic mixer control object (volume slider, switch)
|
|
* @see_also: GstMixer, GstMixerOptions
|
|
*
|
|
* Basic mixer control object (note that it is a GObject and not a GstObject).
|
|
*
|
|
* A mixer track represents a single slider control of none, one or more
|
|
* channels. A mixer track with no channels is usually interpreted as a
|
|
* on/off switch control.
|
|
*
|
|
* Note the presence of both min_volume and max_volume fields. Applications
|
|
* must not assume that min_volume is 0 or max_volume is any particular
|
|
* value.
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include "mixertrack.h"
|
|
#if 0
|
|
enum
|
|
{
|
|
/* FILL ME */
|
|
SIGNAL_VOLUME_CHANGED,
|
|
SIGNAL_RECORD_TOGGLED,
|
|
SIGNAL_MUTE_TOGGLED,
|
|
LAST_SIGNAL
|
|
};
|
|
static guint signals[LAST_SIGNAL] = { 0 };
|
|
#endif
|
|
|
|
enum
|
|
{
|
|
ARG_0,
|
|
ARG_LABEL,
|
|
ARG_UNTRANSLATED_LABEL,
|
|
ARG_INDEX,
|
|
ARG_MIN_VOLUME,
|
|
ARG_MAX_VOLUME,
|
|
ARG_FLAGS,
|
|
ARG_NUM_CHANNELS
|
|
};
|
|
|
|
static void gst_mixer_track_class_init (GstMixerTrackClass * klass);
|
|
static void gst_mixer_track_init (GstMixerTrack * mixer);
|
|
static void gst_mixer_track_dispose (GObject * object);
|
|
|
|
static void gst_mixer_track_get_property (GObject * object, guint prop_id,
|
|
GValue * value, GParamSpec * pspec);
|
|
static void gst_mixer_track_set_property (GObject * object, guint prop_id,
|
|
const GValue * value, GParamSpec * pspec);
|
|
|
|
static GObjectClass *parent_class = NULL;
|
|
|
|
GType
|
|
gst_mixer_track_get_type (void)
|
|
{
|
|
static GType gst_mixer_track_type = 0;
|
|
|
|
if (!gst_mixer_track_type) {
|
|
static const GTypeInfo mixer_track_info = {
|
|
sizeof (GstMixerTrackClass),
|
|
NULL,
|
|
NULL,
|
|
(GClassInitFunc) gst_mixer_track_class_init,
|
|
NULL,
|
|
NULL,
|
|
sizeof (GstMixerTrack),
|
|
0,
|
|
(GInstanceInitFunc) gst_mixer_track_init,
|
|
NULL
|
|
};
|
|
|
|
gst_mixer_track_type =
|
|
g_type_register_static (G_TYPE_OBJECT,
|
|
"GstMixerTrack", &mixer_track_info, 0);
|
|
}
|
|
|
|
return gst_mixer_track_type;
|
|
}
|
|
|
|
static void
|
|
gst_mixer_track_class_init (GstMixerTrackClass * klass)
|
|
{
|
|
GObjectClass *object_klass = G_OBJECT_CLASS (klass);
|
|
|
|
parent_class = g_type_class_peek_parent (klass);
|
|
|
|
object_klass->get_property = gst_mixer_track_get_property;
|
|
object_klass->set_property = gst_mixer_track_set_property;
|
|
|
|
g_object_class_install_property (object_klass, ARG_LABEL,
|
|
g_param_spec_string ("label", "Track label",
|
|
"The label assigned to the track (may be translated)", NULL,
|
|
G_PARAM_READABLE | G_PARAM_STATIC_STRINGS | G_PARAM_STATIC_STRINGS));
|
|
|
|
/**
|
|
* GstMixerTrack:untranslated-label
|
|
*
|
|
* The untranslated label of the mixer track, if available. Mixer track
|
|
* implementations must set this at construct time. Applications may find
|
|
* this useful to determine icons for various kind of tracks. However,
|
|
* applications mustn't make any assumptions about the naming of tracks,
|
|
* the untranslated labels are purely informational and may change.
|
|
*
|
|
* Since: 0.10.13
|
|
**/
|
|
g_object_class_install_property (object_klass, ARG_UNTRANSLATED_LABEL,
|
|
g_param_spec_string ("untranslated-label", "Untranslated track label",
|
|
"The untranslated label assigned to the track (since 0.10.13)",
|
|
NULL,
|
|
G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS));
|
|
|
|
/**
|
|
* GstMixerTrack:index
|
|
*
|
|
* Index of the mixer track, if available. Mixer track implementations
|
|
* must set this at construct time. This can be used to discern between
|
|
* multiple tracks with identical labels.
|
|
*
|
|
* Since: 0.10.21
|
|
*/
|
|
g_object_class_install_property (object_klass, ARG_INDEX,
|
|
g_param_spec_uint ("index", "Index",
|
|
"Track index", 0, G_MAXUINT,
|
|
0, G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
|
|
|
|
g_object_class_install_property (object_klass, ARG_MIN_VOLUME,
|
|
g_param_spec_int ("min-volume", "Minimum volume level",
|
|
"The minimum possible volume level", G_MININT, G_MAXINT,
|
|
0, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
|
|
|
|
g_object_class_install_property (object_klass, ARG_MAX_VOLUME,
|
|
g_param_spec_int ("max-volume", "Maximum volume level",
|
|
"The maximum possible volume level", G_MININT, G_MAXINT,
|
|
0, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
|
|
|
|
g_object_class_install_property (object_klass, ARG_FLAGS,
|
|
g_param_spec_uint ("flags", "Flags",
|
|
"Flags indicating the type of mixer track",
|
|
0, G_MAXUINT, 0, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
|
|
|
|
g_object_class_install_property (object_klass, ARG_NUM_CHANNELS,
|
|
g_param_spec_int ("num-channels", "Number of channels",
|
|
"The number of channels contained within the track",
|
|
0, G_MAXINT, 0, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
|
|
|
|
#if 0
|
|
signals[SIGNAL_RECORD_TOGGLED] =
|
|
g_signal_new ("record_toggled", G_TYPE_FROM_CLASS (klass),
|
|
G_SIGNAL_RUN_LAST,
|
|
G_STRUCT_OFFSET (GstMixerTrackClass,
|
|
record_toggled),
|
|
NULL, NULL, g_cclosure_marshal_VOID__BOOLEAN,
|
|
G_TYPE_NONE, 1, G_TYPE_BOOLEAN);
|
|
signals[SIGNAL_MUTE_TOGGLED] =
|
|
g_signal_new ("mute_toggled", G_TYPE_FROM_CLASS (klass),
|
|
G_SIGNAL_RUN_LAST,
|
|
G_STRUCT_OFFSET (GstMixerTrackClass,
|
|
mute_toggled),
|
|
NULL, NULL, g_cclosure_marshal_VOID__BOOLEAN,
|
|
G_TYPE_NONE, 1, G_TYPE_BOOLEAN);
|
|
signals[SIGNAL_VOLUME_CHANGED] =
|
|
g_signal_new ("volume_changed", G_TYPE_FROM_CLASS (klass),
|
|
G_SIGNAL_RUN_LAST,
|
|
G_STRUCT_OFFSET (GstMixerTrackClass,
|
|
volume_changed),
|
|
NULL, NULL, g_cclosure_marshal_VOID__POINTER,
|
|
G_TYPE_NONE, 1, G_TYPE_POINTER);
|
|
#endif
|
|
|
|
object_klass->dispose = gst_mixer_track_dispose;
|
|
}
|
|
|
|
static void
|
|
gst_mixer_track_init (GstMixerTrack * mixer_track)
|
|
{
|
|
mixer_track->label = NULL;
|
|
mixer_track->min_volume = mixer_track->max_volume = 0;
|
|
mixer_track->flags = 0;
|
|
mixer_track->num_channels = 0;
|
|
}
|
|
|
|
/* FIXME 0.11: move these as members into the mixer track structure */
|
|
#define MIXER_TRACK_OBJECT_DATA_KEY_UNTRANSLATED_LABEL "gst-mixer-track-ulabel"
|
|
#define MIXER_TRACK_OBJECT_DATA_KEY_INDEX "index"
|
|
|
|
static void
|
|
gst_mixer_track_get_property (GObject * object, guint prop_id, GValue * value,
|
|
GParamSpec * pspec)
|
|
{
|
|
GstMixerTrack *mixer_track;
|
|
|
|
mixer_track = GST_MIXER_TRACK (object);
|
|
|
|
switch (prop_id) {
|
|
case ARG_LABEL:
|
|
g_value_set_string (value, mixer_track->label);
|
|
break;
|
|
case ARG_UNTRANSLATED_LABEL:
|
|
g_value_set_string (value,
|
|
(const gchar *) g_object_get_data (G_OBJECT (mixer_track),
|
|
MIXER_TRACK_OBJECT_DATA_KEY_UNTRANSLATED_LABEL));
|
|
break;
|
|
case ARG_INDEX:
|
|
g_value_set_uint (value,
|
|
GPOINTER_TO_INT (g_object_get_data (G_OBJECT (mixer_track),
|
|
MIXER_TRACK_OBJECT_DATA_KEY_INDEX)));
|
|
break;
|
|
case ARG_MIN_VOLUME:
|
|
g_value_set_int (value, mixer_track->min_volume);
|
|
break;
|
|
case ARG_MAX_VOLUME:
|
|
g_value_set_int (value, mixer_track->max_volume);
|
|
break;
|
|
case ARG_FLAGS:
|
|
g_value_set_uint (value, (guint32) mixer_track->flags);
|
|
break;
|
|
case ARG_NUM_CHANNELS:
|
|
g_value_set_int (value, mixer_track->num_channels);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gst_mixer_track_set_property (GObject * object, guint prop_id,
|
|
const GValue * value, GParamSpec * pspec)
|
|
{
|
|
GstMixerTrack *mixer_track;
|
|
|
|
mixer_track = GST_MIXER_TRACK (object);
|
|
|
|
switch (prop_id) {
|
|
case ARG_UNTRANSLATED_LABEL:
|
|
g_object_set_data_full (G_OBJECT (mixer_track),
|
|
MIXER_TRACK_OBJECT_DATA_KEY_UNTRANSLATED_LABEL,
|
|
g_value_dup_string (value), (GDestroyNotify) g_free);
|
|
break;
|
|
case ARG_INDEX:
|
|
g_object_set_data (G_OBJECT (mixer_track),
|
|
MIXER_TRACK_OBJECT_DATA_KEY_INDEX,
|
|
GINT_TO_POINTER (g_value_get_uint (value)));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gst_mixer_track_dispose (GObject * object)
|
|
{
|
|
GstMixerTrack *channel = GST_MIXER_TRACK (object);
|
|
|
|
if (channel->label) {
|
|
g_free (channel->label);
|
|
channel->label = NULL;
|
|
}
|
|
|
|
if (parent_class->dispose)
|
|
parent_class->dispose (object);
|
|
}
|