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>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the
20 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 * Boston, MA 02111-1307, USA.
31 #include "../../gst/gst-i18n-lib.h"
32 #include "gstidentity.h"
33 #include <gst/gstmarshal.h>
35 static GstStaticPadTemplate sinktemplate = GST_STATIC_PAD_TEMPLATE ("sink",
40 static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src",
45 GST_DEBUG_CATEGORY_STATIC (gst_identity_debug);
46 #define GST_CAT_DEFAULT gst_identity_debug
48 static GstElementDetails gst_identity_details = GST_ELEMENT_DETAILS ("Identity",
50 "Pass data without modification",
51 "Erik Walthinsen <omega@cse.ogi.edu>");
54 /* Identity signals and args */
62 #define DEFAULT_SLEEP_TIME 0
63 #define DEFAULT_DUPLICATE 1
64 #define DEFAULT_ERROR_AFTER -1
65 #define DEFAULT_DROP_PROBABILITY 0.0
66 #define DEFAULT_DATARATE 0
67 #define DEFAULT_SILENT FALSE
68 #define DEFAULT_SINGLE_SEGMENT FALSE
69 #define DEFAULT_DUMP FALSE
70 #define DEFAULT_SYNC FALSE
71 #define DEFAULT_CHECK_PERFECT FALSE
78 PROP_DROP_PROBABILITY,
89 #define _do_init(bla) \
90 GST_DEBUG_CATEGORY_INIT (gst_identity_debug, "identity", 0, "identity element");
92 GST_BOILERPLATE_FULL (GstIdentity, gst_identity, GstBaseTransform,
93 GST_TYPE_BASE_TRANSFORM, _do_init);
95 static void gst_identity_finalize (GObject * object);
96 static void gst_identity_set_property (GObject * object, guint prop_id,
97 const GValue * value, GParamSpec * pspec);
98 static void gst_identity_get_property (GObject * object, guint prop_id,
99 GValue * value, GParamSpec * pspec);
101 static gboolean gst_identity_event (GstBaseTransform * trans, GstEvent * event);
102 static GstFlowReturn gst_identity_transform_ip (GstBaseTransform * trans,
104 static gboolean gst_identity_start (GstBaseTransform * trans);
105 static gboolean gst_identity_stop (GstBaseTransform * trans);
107 static guint gst_identity_signals[LAST_SIGNAL] = { 0 };
110 gst_identity_base_init (gpointer g_class)
112 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (g_class);
114 gst_element_class_add_pad_template (gstelement_class,
115 gst_static_pad_template_get (&srctemplate));
116 gst_element_class_add_pad_template (gstelement_class,
117 gst_static_pad_template_get (&sinktemplate));
118 gst_element_class_set_details (gstelement_class, &gst_identity_details);
122 gst_identity_finalize (GObject * object)
124 GstIdentity *identity;
126 identity = GST_IDENTITY (object);
128 g_free (identity->last_message);
130 G_OBJECT_CLASS (parent_class)->finalize (object);
133 /* fixme: do something about this */
135 marshal_VOID__MINIOBJECT (GClosure * closure, GValue * return_value,
136 guint n_param_values, const GValue * param_values, gpointer invocation_hint,
137 gpointer marshal_data)
139 typedef void (*marshalfunc_VOID__MINIOBJECT) (gpointer obj, gpointer arg1,
141 register marshalfunc_VOID__MINIOBJECT callback;
142 register GCClosure *cc = (GCClosure *) closure;
143 register gpointer data1, data2;
145 g_return_if_fail (n_param_values == 2);
147 if (G_CCLOSURE_SWAP_DATA (closure)) {
148 data1 = closure->data;
149 data2 = g_value_peek_pointer (param_values + 0);
151 data1 = g_value_peek_pointer (param_values + 0);
152 data2 = closure->data;
155 (marshalfunc_VOID__MINIOBJECT) (marshal_data ? marshal_data : cc->
158 callback (data1, gst_value_get_mini_object (param_values + 1), data2);
162 gst_identity_class_init (GstIdentityClass * klass)
164 GObjectClass *gobject_class;
165 GstElementClass *gstelement_class;
166 GstBaseTransformClass *gstbasetrans_class;
168 gobject_class = G_OBJECT_CLASS (klass);
169 gstelement_class = GST_ELEMENT_CLASS (klass);
170 gstbasetrans_class = GST_BASE_TRANSFORM_CLASS (klass);
172 gobject_class->set_property = GST_DEBUG_FUNCPTR (gst_identity_set_property);
173 gobject_class->get_property = GST_DEBUG_FUNCPTR (gst_identity_get_property);
175 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SLEEP_TIME,
176 g_param_spec_uint ("sleep-time", "Sleep time",
177 "Microseconds to sleep between processing", 0, G_MAXUINT,
178 DEFAULT_SLEEP_TIME, G_PARAM_READWRITE));
179 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_ERROR_AFTER,
180 g_param_spec_int ("error_after", "Error After", "Error after N buffers",
181 G_MININT, G_MAXINT, DEFAULT_ERROR_AFTER, G_PARAM_READWRITE));
182 g_object_class_install_property (G_OBJECT_CLASS (klass),
183 PROP_DROP_PROBABILITY, g_param_spec_float ("drop_probability",
184 "Drop Probability", "The Probability a buffer is dropped", 0.0, 1.0,
185 DEFAULT_DROP_PROBABILITY, G_PARAM_READWRITE));
186 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_DATARATE,
187 g_param_spec_int ("datarate", "Datarate",
188 "(Re)timestamps buffers with number of bytes per second (0 = inactive)",
189 0, G_MAXINT, DEFAULT_DATARATE, G_PARAM_READWRITE));
190 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SILENT,
191 g_param_spec_boolean ("silent", "silent", "silent", DEFAULT_SILENT,
193 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SINGLE_SEGMENT,
194 g_param_spec_boolean ("single-segment", "Single Segment",
195 "Timestamp buffers and eat newsegments so as to appear as one segment",
196 DEFAULT_SINGLE_SEGMENT, G_PARAM_READWRITE));
197 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_LAST_MESSAGE,
198 g_param_spec_string ("last-message", "last-message", "last-message", NULL,
200 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_DUMP,
201 g_param_spec_boolean ("dump", "Dump", "Dump buffer contents",
202 DEFAULT_DUMP, G_PARAM_READWRITE));
203 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SYNC,
204 g_param_spec_boolean ("sync", "Synchronize",
205 "Synchronize to pipeline clock", DEFAULT_SYNC, G_PARAM_READWRITE));
206 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_CHECK_PERFECT,
207 g_param_spec_boolean ("check-perfect", "Check For Perfect Stream",
208 "Verify that the stream is time- and data-contiguous",
209 DEFAULT_CHECK_PERFECT, G_PARAM_READWRITE));
211 gst_identity_signals[SIGNAL_HANDOFF] =
212 g_signal_new ("handoff", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
213 G_STRUCT_OFFSET (GstIdentityClass, handoff), NULL, NULL,
214 marshal_VOID__MINIOBJECT, G_TYPE_NONE, 1, GST_TYPE_BUFFER);
216 gobject_class->finalize = GST_DEBUG_FUNCPTR (gst_identity_finalize);
218 gstbasetrans_class->event = GST_DEBUG_FUNCPTR (gst_identity_event);
219 gstbasetrans_class->transform_ip =
220 GST_DEBUG_FUNCPTR (gst_identity_transform_ip);
221 gstbasetrans_class->start = GST_DEBUG_FUNCPTR (gst_identity_start);
222 gstbasetrans_class->stop = GST_DEBUG_FUNCPTR (gst_identity_stop);
226 gst_identity_init (GstIdentity * identity, GstIdentityClass * g_class)
228 gst_base_transform_set_passthrough (GST_BASE_TRANSFORM (identity), TRUE);
230 identity->sleep_time = DEFAULT_SLEEP_TIME;
231 identity->error_after = DEFAULT_ERROR_AFTER;
232 identity->drop_probability = DEFAULT_DROP_PROBABILITY;
233 identity->datarate = DEFAULT_DATARATE;
234 identity->silent = DEFAULT_SILENT;
235 identity->single_segment = DEFAULT_SINGLE_SEGMENT;
236 identity->sync = DEFAULT_SYNC;
237 identity->check_perfect = DEFAULT_CHECK_PERFECT;
238 identity->dump = DEFAULT_DUMP;
239 identity->last_message = NULL;
243 gst_identity_event (GstBaseTransform * trans, GstEvent * event)
245 GstIdentity *identity;
248 identity = GST_IDENTITY (trans);
250 if (!identity->silent) {
251 const GstStructure *s;
254 GST_OBJECT_LOCK (identity);
255 g_free (identity->last_message);
257 if ((s = gst_event_get_structure (event)))
258 sstr = gst_structure_to_string (s);
260 sstr = g_strdup ("");
262 identity->last_message =
263 g_strdup_printf ("event ******* (%s:%s) E (type: %d, %s) %p",
264 GST_DEBUG_PAD_NAME (trans->sinkpad), GST_EVENT_TYPE (event), sstr,
267 GST_OBJECT_UNLOCK (identity);
269 g_object_notify (G_OBJECT (identity), "last_message");
272 if (identity->single_segment
273 && (GST_EVENT_TYPE (event) == GST_EVENT_NEWSEGMENT)) {
274 if (trans->have_newsegment == FALSE) {
278 gst_event_parse_new_segment (event, NULL, NULL, &format, NULL, NULL,
281 /* This is the first newsegment, send out a (0, -1) newsegment */
282 news = gst_event_new_new_segment (TRUE, 1.0, format, 0, -1, 0);
284 if (!(gst_pad_event_default (trans->sinkpad, news)))
289 GST_BASE_TRANSFORM_CLASS (parent_class)->event (trans, event);
291 if (identity->single_segment
292 && (GST_EVENT_TYPE (event) == GST_EVENT_NEWSEGMENT)) {
293 /* eat up segments */
301 gst_identity_check_perfect (GstIdentity * identity, GstBuffer * buf)
303 GstClockTime timestamp;
305 timestamp = GST_BUFFER_TIMESTAMP (buf);
307 /* see if we need to do perfect stream checking */
308 /* invalid timestamp drops us out of check. FIXME: maybe warn ? */
309 if (timestamp != GST_CLOCK_TIME_NONE) {
310 /* check if we had a previous buffer to compare to */
311 if (identity->prev_timestamp != GST_CLOCK_TIME_NONE) {
314 if (identity->prev_timestamp + identity->prev_duration != timestamp) {
315 GST_WARNING_OBJECT (identity,
316 "Buffer not time-contiguous with previous one: " "prev ts %"
317 GST_TIME_FORMAT ", prev dur %" GST_TIME_FORMAT ", new ts %"
318 GST_TIME_FORMAT, GST_TIME_ARGS (identity->prev_timestamp),
319 GST_TIME_ARGS (identity->prev_duration), GST_TIME_ARGS (timestamp));
322 offset = GST_BUFFER_OFFSET (buf);
323 if (identity->prev_offset_end != offset) {
324 GST_WARNING_OBJECT (identity,
325 "Buffer not data-contiguous with previous one: "
326 "prev offset_end %" G_GINT64_FORMAT ", new offset %"
327 G_GINT64_FORMAT, identity->prev_offset_end, offset);
330 /* update prev values */
331 identity->prev_timestamp = timestamp;
332 identity->prev_duration = GST_BUFFER_DURATION (buf);
333 identity->prev_offset_end = GST_BUFFER_OFFSET_END (buf);
338 gst_identity_transform_ip (GstBaseTransform * trans, GstBuffer * buf)
340 GstFlowReturn ret = GST_FLOW_OK;
341 GstIdentity *identity = GST_IDENTITY (trans);
342 GstClockTime runtimestamp = G_GINT64_CONSTANT (0);
344 if (identity->check_perfect)
345 gst_identity_check_perfect (identity, buf);
347 if (identity->error_after >= 0) {
348 identity->error_after--;
349 if (identity->error_after == 0) {
350 GST_ELEMENT_ERROR (identity, CORE, FAILED,
351 (_("Failed after iterations as requested.")), (NULL));
352 return GST_FLOW_ERROR;
356 if (identity->drop_probability > 0.0) {
357 if ((gfloat) (1.0 * rand () / (RAND_MAX)) < identity->drop_probability) {
358 GST_OBJECT_LOCK (identity);
359 g_free (identity->last_message);
360 identity->last_message =
361 g_strdup_printf ("dropping ******* (%s:%s)i (%d bytes, timestamp: %"
362 GST_TIME_FORMAT ", duration: %" GST_TIME_FORMAT ", offset: %"
363 G_GINT64_FORMAT ", offset_end: % " G_GINT64_FORMAT ", flags: %d) %p",
364 GST_DEBUG_PAD_NAME (trans->sinkpad), GST_BUFFER_SIZE (buf),
365 GST_TIME_ARGS (GST_BUFFER_TIMESTAMP (buf)),
366 GST_TIME_ARGS (GST_BUFFER_DURATION (buf)),
367 GST_BUFFER_OFFSET (buf), GST_BUFFER_OFFSET_END (buf),
368 GST_BUFFER_FLAGS (buf), buf);
369 GST_OBJECT_UNLOCK (identity);
370 g_object_notify (G_OBJECT (identity), "last-message");
375 if (identity->dump) {
376 gst_util_dump_mem (GST_BUFFER_DATA (buf), GST_BUFFER_SIZE (buf));
379 if (!identity->silent) {
380 GST_OBJECT_LOCK (identity);
381 g_free (identity->last_message);
382 identity->last_message =
383 g_strdup_printf ("chain ******* (%s:%s)i (%d bytes, timestamp: %"
384 GST_TIME_FORMAT ", duration: %" GST_TIME_FORMAT ", offset: %"
385 G_GINT64_FORMAT ", offset_end: % " G_GINT64_FORMAT ", flags: %d) %p",
386 GST_DEBUG_PAD_NAME (trans->sinkpad), GST_BUFFER_SIZE (buf),
387 GST_TIME_ARGS (GST_BUFFER_TIMESTAMP (buf)),
388 GST_TIME_ARGS (GST_BUFFER_DURATION (buf)),
389 GST_BUFFER_OFFSET (buf), GST_BUFFER_OFFSET_END (buf),
390 GST_BUFFER_FLAGS (buf), buf);
391 GST_OBJECT_UNLOCK (identity);
392 g_object_notify (G_OBJECT (identity), "last-message");
395 if (identity->datarate > 0) {
396 GstClockTime time = identity->offset * GST_SECOND / identity->datarate;
398 GST_BUFFER_TIMESTAMP (buf) = time;
399 GST_BUFFER_DURATION (buf) =
400 GST_BUFFER_SIZE (buf) * GST_SECOND / identity->datarate;
403 g_signal_emit (G_OBJECT (identity), gst_identity_signals[SIGNAL_HANDOFF], 0,
406 if (trans->segment.format == GST_FORMAT_TIME)
407 runtimestamp = gst_segment_to_running_time (&trans->segment,
408 GST_FORMAT_TIME, GST_BUFFER_TIMESTAMP (buf));
410 if ((identity->sync) && (trans->segment.format == GST_FORMAT_TIME)) {
413 GST_OBJECT_LOCK (identity);
414 if ((clock = GST_ELEMENT (identity)->clock)) {
416 GstClockTime timestamp;
418 timestamp = runtimestamp + GST_ELEMENT (identity)->base_time;
420 /* save id if we need to unlock */
421 /* FIXME: actually unlock this somewhere in the state changes */
422 identity->clock_id = gst_clock_new_single_shot_id (clock, timestamp);
423 GST_OBJECT_UNLOCK (identity);
425 cret = gst_clock_id_wait (identity->clock_id, NULL);
427 GST_OBJECT_LOCK (identity);
428 if (identity->clock_id) {
429 gst_clock_id_unref (identity->clock_id);
430 identity->clock_id = NULL;
432 if (cret == GST_CLOCK_UNSCHEDULED)
433 ret = GST_FLOW_UNEXPECTED;
435 GST_OBJECT_UNLOCK (identity);
438 identity->offset += GST_BUFFER_SIZE (buf);
440 if (identity->sleep_time && ret == GST_FLOW_OK)
441 g_usleep (identity->sleep_time);
443 if (identity->single_segment && (trans->segment.format == GST_FORMAT_TIME)
444 && (ret == GST_FLOW_OK))
445 GST_BUFFER_TIMESTAMP (buf) = runtimestamp;
451 gst_identity_set_property (GObject * object, guint prop_id,
452 const GValue * value, GParamSpec * pspec)
454 GstIdentity *identity;
456 identity = GST_IDENTITY (object);
459 case PROP_SLEEP_TIME:
460 identity->sleep_time = g_value_get_uint (value);
463 identity->silent = g_value_get_boolean (value);
465 case PROP_SINGLE_SEGMENT:
466 identity->single_segment = g_value_get_boolean (value);
469 identity->dump = g_value_get_boolean (value);
471 case PROP_ERROR_AFTER:
472 identity->error_after = g_value_get_int (value);
474 case PROP_DROP_PROBABILITY:
475 identity->drop_probability = g_value_get_float (value);
478 identity->datarate = g_value_get_int (value);
481 identity->sync = g_value_get_boolean (value);
483 case PROP_CHECK_PERFECT:
484 identity->check_perfect = g_value_get_boolean (value);
487 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
493 gst_identity_get_property (GObject * object, guint prop_id, GValue * value,
496 GstIdentity *identity;
498 identity = GST_IDENTITY (object);
501 case PROP_SLEEP_TIME:
502 g_value_set_uint (value, identity->sleep_time);
504 case PROP_ERROR_AFTER:
505 g_value_set_int (value, identity->error_after);
507 case PROP_DROP_PROBABILITY:
508 g_value_set_float (value, identity->drop_probability);
511 g_value_set_int (value, identity->datarate);
514 g_value_set_boolean (value, identity->silent);
516 case PROP_SINGLE_SEGMENT:
517 g_value_set_boolean (value, identity->single_segment);
520 g_value_set_boolean (value, identity->dump);
522 case PROP_LAST_MESSAGE:
523 GST_OBJECT_LOCK (identity);
524 g_value_set_string (value, identity->last_message);
525 GST_OBJECT_UNLOCK (identity);
528 g_value_set_boolean (value, identity->sync);
530 case PROP_CHECK_PERFECT:
531 g_value_set_boolean (value, identity->check_perfect);
534 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
540 gst_identity_start (GstBaseTransform * trans)
542 GstIdentity *identity;
544 identity = GST_IDENTITY (trans);
546 identity->offset = 0;
547 identity->prev_timestamp = GST_CLOCK_TIME_NONE;
548 identity->prev_duration = GST_CLOCK_TIME_NONE;
549 identity->prev_offset_end = -1;
555 gst_identity_stop (GstBaseTransform * trans)
557 GstIdentity *identity;
559 identity = GST_IDENTITY (trans);
561 GST_OBJECT_LOCK (identity);
562 g_free (identity->last_message);
563 identity->last_message = NULL;
564 GST_OBJECT_UNLOCK (identity);