gstreamer/gst/synaesthesia/gstsynaesthesia.c
Stefan Kost c49cf83ee3 Add missing elements to docs. Restore alphabetical order in section file. Document mad (it was included in docs alrea...
Original commit message from CVS:
* docs/plugins/gst-plugins-ugly-plugins-docs.sgml:
* docs/plugins/gst-plugins-ugly-plugins-sections.txt:
* ext/a52dec/gsta52dec.c:
* ext/amrnb/amrnbdec.c:
* ext/amrnb/amrnbenc.c:
* ext/amrnb/amrnbparse.c:
* ext/lame/gstlame.c:
* ext/mad/gstmad.c:
* ext/sidplay/gstsiddec.cc:
* gst/asfdemux/gstrtspwms.c:
* gst/mpegaudioparse/gstxingmux.c:
* gst/realmedia/rademux.c:
* gst/realmedia/rdtmanager.c:
* gst/realmedia/rtspreal.c:
* gst/synaesthesia/gstsynaesthesia.c:
Add missing elements to docs. Restore alphabetical order in section
file. Document mad (it was included in docs already).
Fix doc-markup: use convinience syntax for examples
(produces valid docbook), add several refsec2 when we have several
titles. Fix some types.
2008-06-13 06:57:21 +00:00

482 lines
14 KiB
C

/* GStreamer
* Copyright (C) <2001> Richard Boulton <richard@tartarus.org>
*
* gstsynaesthesia.c: implementation of synaesthesia drawing element
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
/**
* SECTION:element-synaesthesia
* @see_also: goom
*
* Synaesthesia is an audio visualisation element. It creates glitter and
* pulsating fog based on the incomming audio signal.
* <refsect2>
* <title>Example launch line</title>
* |[
* gst-launch -v audiotestsrc ! audioconvert ! synaesthesia ! ximagesink
* gst-launch -v audiotestsrc ! audioconvert ! synaesthesia ! ffmpegcolorspace ! xvimagesink
* ]|
* </refsect2>
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "gstsynaesthesia.h"
/* elementfactory information */
static const GstElementDetails gst_synaesthesia_details =
GST_ELEMENT_DETAILS ("Synaesthesia",
"Visualization",
"Creates video visualizations of audio input, using stereo and pitch information",
"Richard Boulton <richard@tartarus.org>");
/* signals and args */
enum
{
/* FILL ME */
LAST_SIGNAL
};
static GstStaticPadTemplate gst_synaesthesia_src_template =
GST_STATIC_PAD_TEMPLATE ("src",
GST_PAD_SRC,
GST_PAD_ALWAYS,
GST_STATIC_CAPS (GST_VIDEO_CAPS_xRGB_HOST_ENDIAN)
);
static GstStaticPadTemplate gst_synaesthesia_sink_template =
GST_STATIC_PAD_TEMPLATE ("sink",
GST_PAD_SINK,
GST_PAD_ALWAYS,
GST_STATIC_CAPS (GST_AUDIO_INT_STANDARD_PAD_TEMPLATE_CAPS)
);
static void gst_synaesthesia_base_init (gpointer g_class);
static void gst_synaesthesia_class_init (GstSynaesthesiaClass * klass);
static void gst_synaesthesia_init (GstSynaesthesia * synaesthesia);
static void gst_synaesthesia_finalize (GObject * object);
static void gst_synaesthesia_dispose (GObject * object);
static GstFlowReturn gst_synaesthesia_chain (GstPad * pad, GstBuffer * buffer);
static GstStateChangeReturn
gst_synaesthesia_change_state (GstElement * element, GstStateChange transition);
static GstCaps *gst_synaesthesia_src_getcaps (GstPad * pad);
static gboolean gst_synaesthesia_src_setcaps (GstPad * pad, GstCaps * caps);
static gboolean gst_synaesthesia_sink_setcaps (GstPad * pad, GstCaps * caps);
static GstElementClass *parent_class = NULL;
GType
gst_synaesthesia_get_type (void)
{
static GType type = 0;
if (!type) {
static const GTypeInfo info = {
sizeof (GstSynaesthesiaClass),
gst_synaesthesia_base_init,
NULL,
(GClassInitFunc) gst_synaesthesia_class_init,
NULL,
NULL,
sizeof (GstSynaesthesia),
0,
(GInstanceInitFunc) gst_synaesthesia_init,
};
type =
g_type_register_static (GST_TYPE_ELEMENT, "GstSynaesthesia", &info, 0);
}
return type;
}
static void
gst_synaesthesia_base_init (gpointer g_class)
{
GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
gst_element_class_set_details (element_class, &gst_synaesthesia_details);
gst_element_class_add_pad_template (element_class,
gst_static_pad_template_get (&gst_synaesthesia_src_template));
gst_element_class_add_pad_template (element_class,
gst_static_pad_template_get (&gst_synaesthesia_sink_template));
}
static void
gst_synaesthesia_class_init (GstSynaesthesiaClass * klass)
{
GObjectClass *gobject_class;
GstElementClass *gstelement_class;
gobject_class = (GObjectClass *) klass;
gstelement_class = (GstElementClass *) klass;
parent_class = g_type_class_peek_parent (klass);
gobject_class->dispose = gst_synaesthesia_dispose;
gobject_class->finalize = gst_synaesthesia_finalize;
gstelement_class->change_state =
GST_DEBUG_FUNCPTR (gst_synaesthesia_change_state);
synaesthesia_init ();
}
static void
gst_synaesthesia_init (GstSynaesthesia * synaesthesia)
{
/* create the sink and src pads */
synaesthesia->sinkpad =
gst_pad_new_from_static_template (&gst_synaesthesia_sink_template,
"sink");
gst_pad_set_chain_function (synaesthesia->sinkpad,
GST_DEBUG_FUNCPTR (gst_synaesthesia_chain));
gst_pad_set_setcaps_function (synaesthesia->sinkpad,
GST_DEBUG_FUNCPTR (gst_synaesthesia_sink_setcaps));
gst_element_add_pad (GST_ELEMENT (synaesthesia), synaesthesia->sinkpad);
synaesthesia->srcpad =
gst_pad_new_from_static_template (&gst_synaesthesia_src_template, "src");
gst_pad_set_getcaps_function (synaesthesia->srcpad,
GST_DEBUG_FUNCPTR (gst_synaesthesia_src_getcaps));
gst_pad_set_setcaps_function (synaesthesia->srcpad,
GST_DEBUG_FUNCPTR (gst_synaesthesia_src_setcaps));
gst_element_add_pad (GST_ELEMENT (synaesthesia), synaesthesia->srcpad);
synaesthesia->adapter = gst_adapter_new ();
/* reset the initial video state */
synaesthesia->width = SYNAES_WIDTH;
synaesthesia->height = SYNAES_HEIGHT;
synaesthesia->fps_n = 25; /* desired frame rate */
synaesthesia->fps_d = 1;
synaesthesia->frame_duration = -1;
/* reset the initial audio state */
synaesthesia->rate = GST_AUDIO_DEF_RATE;
synaesthesia->channels = 2;
synaesthesia->next_ts = GST_CLOCK_TIME_NONE;
/* FIXME: the size is currently ignored by the engine. It should
* not be, and also there should be a way to change the size later.
* We also need API to negotiate the spf (samples_per_frame)
* we can supply. */
synaesthesia->si =
synaesthesia_new (synaesthesia->width, synaesthesia->height);
}
static void
gst_synaesthesia_dispose (GObject * object)
{
GstSynaesthesia *synaesthesia;
synaesthesia = GST_SYNAESTHESIA (object);
if (synaesthesia->adapter) {
g_object_unref (synaesthesia->adapter);
synaesthesia->adapter = NULL;
}
G_OBJECT_CLASS (parent_class)->dispose (object);
}
static void
gst_synaesthesia_finalize (GObject * object)
{
GstSynaesthesia *synaesthesia;
synaesthesia = GST_SYNAESTHESIA (object);
synaesthesia_close (synaesthesia->si);
G_OBJECT_CLASS (parent_class)->finalize (object);
}
static gboolean
gst_synaesthesia_sink_setcaps (GstPad * pad, GstCaps * caps)
{
GstSynaesthesia *synaesthesia;
GstStructure *structure;
gint channels;
gint rate;
gboolean res = TRUE;
synaesthesia = GST_SYNAESTHESIA (gst_pad_get_parent (pad));
structure = gst_caps_get_structure (caps, 0);
if (!gst_structure_get_int (structure, "channels", &channels) ||
!gst_structure_get_int (structure, "rate", &rate))
goto missing_caps_details;
if (channels != 2)
goto wrong_channels;
if (rate <= 0)
goto wrong_rate;
synaesthesia->channels = channels;
synaesthesia->rate = rate;
done:
gst_object_unref (synaesthesia);
return res;
/* Errors */
missing_caps_details:
{
GST_WARNING_OBJECT (synaesthesia, "missing channels or rate in the caps");
res = FALSE;
goto done;
}
wrong_channels:
{
GST_WARNING_OBJECT (synaesthesia, "number of channels must be 2, but is %d",
channels);
res = FALSE;
goto done;
}
wrong_rate:
{
GST_WARNING_OBJECT (synaesthesia, "sample rate must be >0, but is %d",
rate);
res = FALSE;
goto done;
}
}
static GstCaps *
gst_synaesthesia_src_getcaps (GstPad * pad)
{
GstSynaesthesia *synaesthesia;
GstCaps *caps;
const GstCaps *templcaps;
gint i;
synaesthesia = GST_SYNAESTHESIA (gst_pad_get_parent (pad));
templcaps = gst_pad_get_pad_template_caps (pad);
caps = gst_caps_copy (templcaps);
for (i = 0; i < gst_caps_get_size (caps); i++) {
GstStructure *structure = gst_caps_get_structure (caps, i);
gst_structure_set (structure,
"width", G_TYPE_INT, synaesthesia->width,
"height", G_TYPE_INT, synaesthesia->height,
"framerate", GST_TYPE_FRACTION, synaesthesia->fps_n,
synaesthesia->fps_d, NULL);
}
gst_object_unref (synaesthesia);
GST_DEBUG ("final caps are %" GST_PTR_FORMAT, caps);
return caps;
}
static gboolean
gst_synaesthesia_src_setcaps (GstPad * pad, GstCaps * caps)
{
GstSynaesthesia *synaesthesia;
GstStructure *structure;
gint w, h;
gint num, denom;
gboolean res = TRUE;
synaesthesia = GST_SYNAESTHESIA (gst_pad_get_parent (pad));
structure = gst_caps_get_structure (caps, 0);
if (!gst_structure_get_int (structure, "width", &w) ||
!gst_structure_get_int (structure, "height", &h) ||
!gst_structure_get_fraction (structure, "framerate", &num, &denom)) {
goto missing_caps_details;
}
if ((w != SYNAES_WIDTH) || (h != SYNAES_HEIGHT))
goto wrong_resolution;
synaesthesia->width = w;
synaesthesia->height = h;
synaesthesia->fps_n = num;
synaesthesia->fps_d = denom;
synaesthesia->frame_duration = gst_util_uint64_scale_int (GST_SECOND,
synaesthesia->fps_d, synaesthesia->fps_n);
synaesthesia->spf = gst_util_uint64_scale_int (synaesthesia->rate,
synaesthesia->fps_d, synaesthesia->fps_n);
synaesthesia_init (synaesthesia->width, synaesthesia->height);
done:
gst_object_unref (synaesthesia);
return res;
/* Errors */
missing_caps_details:
{
GST_WARNING_OBJECT (synaesthesia, "missing channels or rate in the caps");
res = FALSE;
goto done;
}
wrong_resolution:
{
GST_WARNING_OBJECT (synaesthesia,
"unsupported resolution: %d x %d (wanted %d x %d)", w, h, SYNAES_WIDTH,
SYNAES_HEIGHT);
res = FALSE;
goto done;
}
}
static GstFlowReturn
gst_synaesthesia_chain (GstPad * pad, GstBuffer * buffer)
{
GstFlowReturn ret = GST_FLOW_OK;
GstSynaesthesia *synaesthesia;
guint32 avail, bytesperread;
synaesthesia = GST_SYNAESTHESIA (gst_pad_get_parent (pad));
GST_DEBUG ("chainfunc called");
/* resync on DISCONT */
if (GST_BUFFER_FLAG_IS_SET (buffer, GST_BUFFER_FLAG_DISCONT)) {
synaesthesia->next_ts = GST_CLOCK_TIME_NONE;
gst_adapter_clear (synaesthesia->adapter);
}
if (GST_PAD_CAPS (synaesthesia->srcpad) == NULL) {
GstCaps *target;
GST_DEBUG ("fixating");
if ((target = gst_synaesthesia_src_getcaps (synaesthesia->srcpad))) {
gst_pad_set_caps (synaesthesia->srcpad, target);
gst_caps_unref (target);
} else {
GST_DEBUG ("no caps on srcpad");
return GST_FLOW_NOT_NEGOTIATED;
}
}
/* Match timestamps from the incoming audio */
if (GST_BUFFER_TIMESTAMP (buffer) != GST_CLOCK_TIME_NONE)
synaesthesia->next_ts = GST_BUFFER_TIMESTAMP (buffer);
gst_adapter_push (synaesthesia->adapter, buffer);
/* this is what we want */
bytesperread = SYNAES_SAMPLES * synaesthesia->channels * sizeof (gint16);
/* FIXME: what about:
bytesperread = MAX (SYNAES_SAMPLES, synaesthesia->spf) * synaesthesia->channels * sizeof (gint16);
*/
/* this is what we have */
avail = gst_adapter_available (synaesthesia->adapter);
while (avail >
MAX (bytesperread,
synaesthesia->spf * synaesthesia->channels * sizeof (gint16))) {
const guint16 *data =
(const guint16 *) gst_adapter_peek (synaesthesia->adapter,
bytesperread);
GstBuffer *outbuf;
guchar *out_frame;
guint i;
/* deinterleave */
for (i = 0; i < SYNAES_SAMPLES; i++) {
synaesthesia->datain[0][i] = *data++;
synaesthesia->datain[1][i] = *data++;
}
ret =
gst_pad_alloc_buffer_and_set_caps (synaesthesia->srcpad,
GST_BUFFER_OFFSET_NONE,
synaesthesia->width * synaesthesia->height * 4,
GST_PAD_CAPS (synaesthesia->srcpad), &outbuf);
/* no buffer allocated, we don't care why. */
if (ret != GST_FLOW_OK)
break;
GST_BUFFER_TIMESTAMP (outbuf) = synaesthesia->next_ts;
GST_BUFFER_DURATION (outbuf) = synaesthesia->frame_duration;
out_frame = (guchar *)
synaesthesia_update (synaesthesia->si, synaesthesia->datain);
memcpy (GST_BUFFER_DATA (outbuf), out_frame, GST_BUFFER_SIZE (outbuf));
ret = gst_pad_push (synaesthesia->srcpad, outbuf);
outbuf = NULL;
if (ret != GST_FLOW_OK)
break;
if (synaesthesia->next_ts != GST_CLOCK_TIME_NONE)
synaesthesia->next_ts += synaesthesia->frame_duration;
/* flush sampled for one frame */
gst_adapter_flush (synaesthesia->adapter, synaesthesia->spf *
synaesthesia->channels * sizeof (gint16));
avail = gst_adapter_available (synaesthesia->adapter);
}
gst_object_unref (synaesthesia);
return ret;
}
static GstStateChangeReturn
gst_synaesthesia_change_state (GstElement * element, GstStateChange transition)
{
GstSynaesthesia *synaesthesia;
synaesthesia = GST_SYNAESTHESIA (element);
switch (transition) {
case GST_STATE_CHANGE_READY_TO_PAUSED:
synaesthesia->next_ts = GST_CLOCK_TIME_NONE;
gst_adapter_clear (synaesthesia->adapter);
break;
default:
break;
}
return GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
}
static gboolean
plugin_init (GstPlugin * plugin)
{
GST_DEBUG_CATEGORY_INIT (synaesthesia_debug, "synaesthesia", 0,
"synaesthesia audio visualisations");
return gst_element_register (plugin, "synaesthesia", GST_RANK_NONE,
GST_TYPE_SYNAESTHESIA);
}
GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
GST_VERSION_MINOR,
"synaesthesia",
"Creates video visualizations of audio input, using stereo and pitch information",
plugin_init, VERSION, "GPL", GST_PACKAGE_NAME, GST_PACKAGE_ORIGIN)