2 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
3 * 2000 Wim Taymans <wtay@chello.be>
4 * 2005 Wim Taymans <wim@fluendo.com>
5 * 2005 David Schleef <ds@schleef.org>
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
23 * SECTION:element-capsfilter
25 * The element does not modify data as such, but can enforce limitations on the
33 #include "../../gst/gst-i18n-lib.h"
34 #include "gstcapsfilter.h"
43 static GstStaticPadTemplate sinktemplate = GST_STATIC_PAD_TEMPLATE ("sink",
48 static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src",
54 GST_DEBUG_CATEGORY_STATIC (gst_capsfilter_debug);
55 #define GST_CAT_DEFAULT gst_capsfilter_debug
57 #define _do_init(bla) \
58 GST_DEBUG_CATEGORY_INIT (gst_capsfilter_debug, "capsfilter", 0, \
59 "capsfilter element");
61 GST_BOILERPLATE_FULL (GstCapsFilter, gst_capsfilter, GstBaseTransform,
62 GST_TYPE_BASE_TRANSFORM, _do_init);
65 static void gst_capsfilter_set_property (GObject * object, guint prop_id,
66 const GValue * value, GParamSpec * pspec);
67 static void gst_capsfilter_get_property (GObject * object, guint prop_id,
68 GValue * value, GParamSpec * pspec);
69 static void gst_capsfilter_dispose (GObject * object);
71 static GstCaps *gst_capsfilter_transform_caps (GstBaseTransform * base,
72 GstPadDirection direction, GstCaps * caps);
73 static GstFlowReturn gst_capsfilter_transform_ip (GstBaseTransform * base,
75 static GstFlowReturn gst_capsfilter_prepare_buf (GstBaseTransform * trans,
76 GstBuffer * input, gint size, GstCaps * caps, GstBuffer ** buf);
79 gst_capsfilter_base_init (gpointer g_class)
81 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (g_class);
83 gst_element_class_set_details_simple (gstelement_class,
86 "Pass data without modification, limiting formats",
87 "David Schleef <ds@schleef.org>");
88 gst_element_class_add_pad_template (gstelement_class,
89 gst_static_pad_template_get (&srctemplate));
90 gst_element_class_add_pad_template (gstelement_class,
91 gst_static_pad_template_get (&sinktemplate));
95 gst_capsfilter_class_init (GstCapsFilterClass * klass)
97 GObjectClass *gobject_class;
98 GstBaseTransformClass *trans_class;
100 gobject_class = G_OBJECT_CLASS (klass);
101 gobject_class->set_property = gst_capsfilter_set_property;
102 gobject_class->get_property = gst_capsfilter_get_property;
103 gobject_class->dispose = gst_capsfilter_dispose;
105 g_object_class_install_property (gobject_class, PROP_FILTER_CAPS,
106 g_param_spec_boxed ("caps", _("Filter caps"),
107 _("Restrict the possible allowed capabilities (NULL means ANY). "
108 "Setting this property takes a reference to the supplied GstCaps "
109 "object."), GST_TYPE_CAPS,
110 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
112 trans_class = GST_BASE_TRANSFORM_CLASS (klass);
113 trans_class->transform_caps =
114 GST_DEBUG_FUNCPTR (gst_capsfilter_transform_caps);
115 trans_class->transform_ip = GST_DEBUG_FUNCPTR (gst_capsfilter_transform_ip);
116 trans_class->prepare_output_buffer =
117 GST_DEBUG_FUNCPTR (gst_capsfilter_prepare_buf);
121 gst_capsfilter_init (GstCapsFilter * filter, GstCapsFilterClass * g_class)
123 GstBaseTransform *trans = GST_BASE_TRANSFORM (filter);
124 gst_base_transform_set_gap_aware (trans, TRUE);
125 filter->filter_caps = gst_caps_new_any ();
129 copy_func (GQuark field_id, const GValue * value, GstStructure * dest)
131 gst_structure_id_set_value (dest, field_id, value);
137 gst_capsfilter_set_property (GObject * object, guint prop_id,
138 const GValue * value, GParamSpec * pspec)
140 GstCapsFilter *capsfilter = GST_CAPSFILTER (object);
143 case PROP_FILTER_CAPS:{
145 GstCaps *old_caps, *suggest, *nego;
146 const GstCaps *new_caps_val = gst_value_get_caps (value);
148 if (new_caps_val == NULL) {
149 new_caps = gst_caps_new_any ();
151 new_caps = (GstCaps *) new_caps_val;
152 gst_caps_ref (new_caps);
155 GST_OBJECT_LOCK (capsfilter);
156 old_caps = capsfilter->filter_caps;
157 capsfilter->filter_caps = new_caps;
158 GST_OBJECT_UNLOCK (capsfilter);
160 gst_caps_unref (old_caps);
162 GST_DEBUG_OBJECT (capsfilter, "set new caps %" GST_PTR_FORMAT, new_caps);
164 /* filter the currently negotiated format against the new caps */
165 GST_OBJECT_LOCK (GST_BASE_TRANSFORM_SINK_PAD (object));
166 nego = GST_PAD_CAPS (GST_BASE_TRANSFORM_SINK_PAD (object));
168 GST_DEBUG_OBJECT (capsfilter, "we had negotiated caps %" GST_PTR_FORMAT,
171 if (G_UNLIKELY (gst_caps_is_any (new_caps))) {
172 GST_DEBUG_OBJECT (capsfilter, "not settings any suggestion");
176 GstStructure *s1, *s2;
178 /* first check if the name is the same */
179 s1 = gst_caps_get_structure (nego, 0);
180 s2 = gst_caps_get_structure (new_caps, 0);
182 if (gst_structure_get_name_id (s1) == gst_structure_get_name_id (s2)) {
183 /* same name, copy all fields from the new caps into the previously
185 suggest = gst_caps_copy (nego);
186 s1 = gst_caps_get_structure (suggest, 0);
187 gst_structure_foreach (s2, (GstStructureForeachFunc) copy_func, s1);
188 GST_DEBUG_OBJECT (capsfilter, "copied structure fields");
190 GST_DEBUG_OBJECT (capsfilter, "different structure names");
191 /* different names, we can only suggest the complete caps */
192 suggest = gst_caps_copy (new_caps);
196 GST_DEBUG_OBJECT (capsfilter, "no negotiated caps");
197 /* no previous caps, the getcaps function will be used to find suitable
201 GST_OBJECT_UNLOCK (GST_BASE_TRANSFORM_SINK_PAD (object));
203 GST_DEBUG_OBJECT (capsfilter, "suggesting new caps %" GST_PTR_FORMAT,
205 gst_base_transform_suggest (GST_BASE_TRANSFORM (object), suggest, 0);
207 gst_caps_unref (suggest);
212 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
218 gst_capsfilter_get_property (GObject * object, guint prop_id, GValue * value,
221 GstCapsFilter *capsfilter = GST_CAPSFILTER (object);
224 case PROP_FILTER_CAPS:
225 GST_OBJECT_LOCK (capsfilter);
226 gst_value_set_caps (value, capsfilter->filter_caps);
227 GST_OBJECT_UNLOCK (capsfilter);
230 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
236 gst_capsfilter_dispose (GObject * object)
238 GstCapsFilter *filter = GST_CAPSFILTER (object);
240 gst_caps_replace (&filter->filter_caps, NULL);
242 G_OBJECT_CLASS (parent_class)->dispose (object);
246 gst_capsfilter_transform_caps (GstBaseTransform * base,
247 GstPadDirection direction, GstCaps * caps)
249 GstCapsFilter *capsfilter = GST_CAPSFILTER (base);
250 GstCaps *ret, *filter_caps;
252 GST_OBJECT_LOCK (capsfilter);
253 filter_caps = gst_caps_ref (capsfilter->filter_caps);
254 GST_OBJECT_UNLOCK (capsfilter);
256 ret = gst_caps_intersect (caps, filter_caps);
257 GST_DEBUG_OBJECT (capsfilter, "input: %" GST_PTR_FORMAT, caps);
258 GST_DEBUG_OBJECT (capsfilter, "filter: %" GST_PTR_FORMAT, filter_caps);
259 GST_DEBUG_OBJECT (capsfilter, "intersect: %" GST_PTR_FORMAT, ret);
261 gst_caps_unref (filter_caps);
267 gst_capsfilter_transform_ip (GstBaseTransform * base, GstBuffer * buf)
269 /* No actual work here. It's all done in the prepare output buffer
274 /* Output buffer preparation... if the buffer has no caps, and
275 * our allowed output caps is fixed, then give the caps to the
277 * This ensures that outgoing buffers have caps if we can, so
278 * that pipelines like:
279 * gst-launch filesrc location=rawsamples.raw !
280 * audio/x-raw-int,width=16,depth=16,rate=48000,channels=2,
281 * endianness=4321,signed='(boolean)'true ! alsasink
285 gst_capsfilter_prepare_buf (GstBaseTransform * trans, GstBuffer * input,
286 gint size, GstCaps * caps, GstBuffer ** buf)
288 GstFlowReturn ret = GST_FLOW_OK;
290 if (GST_BUFFER_CAPS (input) != NULL) {
291 /* Output buffer already has caps */
292 GST_LOG_OBJECT (trans, "Input buffer already has caps (implicitely fixed)");
293 /* FIXME : Move this behaviour to basetransform. The given caps are the ones
294 * of the source pad, therefore our outgoing buffers should always have
296 if (GST_BUFFER_CAPS (input) != caps) {
297 /* caps are different, make a metadata writable output buffer to set
299 if (gst_buffer_is_metadata_writable (input)) {
300 /* input is writable, just set caps and use this as the output */
302 gst_buffer_set_caps (*buf, caps);
303 gst_buffer_ref (input);
305 GST_DEBUG_OBJECT (trans, "Creating sub-buffer and setting caps");
306 *buf = gst_buffer_create_sub (input, 0, GST_BUFFER_SIZE (input));
307 gst_buffer_set_caps (*buf, caps);
310 /* caps are right, just use a ref of the input as the outbuf */
312 gst_buffer_ref (input);
315 /* Buffer has no caps. See if the output pad only supports fixed caps */
318 out_caps = GST_PAD_CAPS (trans->srcpad);
320 if (out_caps != NULL) {
321 gst_caps_ref (out_caps);
323 out_caps = gst_pad_get_allowed_caps (trans->srcpad);
324 g_return_val_if_fail (out_caps != NULL, GST_FLOW_ERROR);
327 out_caps = gst_caps_make_writable (out_caps);
328 gst_caps_do_simplify (out_caps);
330 if (gst_caps_is_fixed (out_caps) && !gst_caps_is_empty (out_caps)) {
331 GST_DEBUG_OBJECT (trans, "Have fixed output caps %"
332 GST_PTR_FORMAT " to apply to buffer with no caps", out_caps);
333 if (gst_buffer_is_metadata_writable (input)) {
334 gst_buffer_ref (input);
337 GST_DEBUG_OBJECT (trans, "Creating sub-buffer and setting caps");
338 *buf = gst_buffer_create_sub (input, 0, GST_BUFFER_SIZE (input));
340 GST_BUFFER_CAPS (*buf) = out_caps;
342 if (GST_PAD_CAPS (trans->srcpad) == NULL)
343 gst_pad_set_caps (trans->srcpad, out_caps);
345 gchar *caps_str = gst_caps_to_string (out_caps);
347 GST_DEBUG_OBJECT (trans, "Cannot choose caps. Have unfixed output caps %"
348 GST_PTR_FORMAT, out_caps);
349 gst_caps_unref (out_caps);
351 ret = GST_FLOW_ERROR;
352 GST_ELEMENT_ERROR (trans, STREAM, FORMAT,
353 ("Filter caps do not completely specify the output format"),
354 ("Output caps are unfixed: %s", caps_str));