2 * Copyright (C) 2008 Stefan Kost <ensonic@users.sf.net>
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.
22 * SECTION:element-taginject
24 * Element that injects new metadata tags, but passes incomming data through
28 * <title>Example launch lines</title>
30 * gst-launch audiotestsrc num-buffers=100 ! taginject tags="title=testsrc,artist=gstreamer" ! vorbisenc ! oggmux ! filesink location=test.ogg
31 * ]| set title and artist
33 * gst-launch audiotestsrc num-buffers=100 ! taginject tags="keywords=\{\"testone\",\"audio\"\},title=\"audio testtone\"" ! vorbisenc ! oggmux ! filesink location=test.ogg
34 * ]| set keywords and title demonstrating quoting of special chars and handling lists
44 #include "gsttaginject.h"
46 static GstStaticPadTemplate sinktemplate = GST_STATIC_PAD_TEMPLATE ("sink",
51 static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src",
56 GST_DEBUG_CATEGORY_STATIC (gst_tag_inject_debug);
57 #define GST_CAT_DEFAULT gst_tag_inject_debug
65 #define DEBUG_INIT(bla) \
66 GST_DEBUG_CATEGORY_INIT (gst_tag_inject_debug, "taginject", 0, "tag inject element");
68 GST_BOILERPLATE_FULL (GstTagInject, gst_tag_inject, GstBaseTransform,
69 GST_TYPE_BASE_TRANSFORM, DEBUG_INIT);
71 static void gst_tag_inject_finalize (GObject * object);
72 static void gst_tag_inject_set_property (GObject * object, guint prop_id,
73 const GValue * value, GParamSpec * pspec);
74 static void gst_tag_inject_get_property (GObject * object, guint prop_id,
75 GValue * value, GParamSpec * pspec);
77 static GstFlowReturn gst_tag_inject_transform_ip (GstBaseTransform * trans,
79 static gboolean gst_tag_inject_start (GstBaseTransform * trans);
83 gst_tag_inject_base_init (gpointer g_class)
85 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (g_class);
87 gst_element_class_set_details_simple (gstelement_class,
89 "Generic", "inject metadata tags", "Stefan Kost <ensonic@users.sf.net>");
90 gst_element_class_add_pad_template (gstelement_class,
91 gst_static_pad_template_get (&srctemplate));
92 gst_element_class_add_pad_template (gstelement_class,
93 gst_static_pad_template_get (&sinktemplate));
97 gst_tag_inject_finalize (GObject * object)
99 GstTagInject *self = GST_TAG_INJECT (object);
102 gst_tag_list_free (self->tags);
106 G_OBJECT_CLASS (parent_class)->finalize (object);
110 gst_tag_inject_class_init (GstTagInjectClass * klass)
112 GObjectClass *gobject_class;
113 GstBaseTransformClass *gstbasetrans_class;
115 gobject_class = G_OBJECT_CLASS (klass);
116 gstbasetrans_class = GST_BASE_TRANSFORM_CLASS (klass);
118 gobject_class->set_property = gst_tag_inject_set_property;
119 gobject_class->get_property = gst_tag_inject_get_property;
121 g_object_class_install_property (gobject_class, PROP_TAGS,
122 g_param_spec_string ("tags", "taglist",
123 "List of tags to inject into the target file",
124 NULL, G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS));
126 gobject_class->finalize = gst_tag_inject_finalize;
128 gstbasetrans_class->transform_ip =
129 GST_DEBUG_FUNCPTR (gst_tag_inject_transform_ip);
131 gstbasetrans_class->start = GST_DEBUG_FUNCPTR (gst_tag_inject_start);
135 gst_tag_inject_init (GstTagInject * self, GstTagInjectClass * g_class)
141 gst_tag_inject_transform_ip (GstBaseTransform * trans, GstBuffer * buf)
143 GstTagInject *self = GST_TAG_INJECT (trans);
145 if (G_UNLIKELY (!self->tags_sent)) {
146 self->tags_sent = TRUE;
148 if (self->tags && !gst_tag_list_is_empty (self->tags)) {
149 GST_DEBUG ("tag event :%" GST_PTR_FORMAT, self->tags);
150 gst_element_found_tags (GST_ELEMENT (trans),
151 gst_tag_list_copy (self->tags));
159 gst_tag_inject_set_property (GObject * object, guint prop_id,
160 const GValue * value, GParamSpec * pspec)
162 GstTagInject *self = GST_TAG_INJECT (object);
167 g_strdup_printf ("taglist,%s", g_value_get_string (value));
168 if (!(self->tags = gst_structure_from_string (structure, NULL))) {
169 GST_WARNING ("unparsable taglist = '%s'", structure);
172 /* make sure that tags will be send */
173 self->tags_sent = FALSE;
178 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
184 gst_tag_inject_get_property (GObject * object, guint prop_id, GValue * value,
187 /*GstTagInject *self = GST_TAG_INJECT (object); */
191 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
197 gst_tag_inject_start (GstBaseTransform * trans)
199 GstTagInject *self = GST_TAG_INJECT (trans);
201 /* we need to sent tags _transform_ip() once */
202 self->tags_sent = FALSE;