From: Wim Taymans <wim.taymans@collabora.co.uk>
Date: Tue, 26 May 2009 09:53:05 +0000 (+0200)
Subject: element: add start_time field an methods
X-Git-Tag: RELEASE-0.10.24~203
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=83b2c63a3087705974d006859e1c19bc91880ffd;p=platform%2Fupstream%2Fgstreamer.git

element: add start_time field an methods

Add a start_time field and some methods. The start_time will contain the
running_time of when the element last went to paused. This time can be user to
report the position in PAUSED but also to do more correct clipping and
stepping later.
---

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index 337e0c0..25ea69a 100644
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -482,6 +482,7 @@ GST_ELEMENT_PARENT
 GST_ELEMENT_BUS
 GST_ELEMENT_CLOCK
 GST_ELEMENT_PADS
+GST_ELEMENT_START_TIME
 GST_ELEMENT_ERROR
 GST_ELEMENT_WARNING
 GST_ELEMENT_INFO
@@ -523,6 +524,8 @@ gst_element_link_filtered
 <SUBSECTION element-properties>
 gst_element_set_base_time
 gst_element_get_base_time
+gst_element_set_start_time
+gst_element_get_start_time
 gst_element_set_bus
 gst_element_get_bus
 gst_element_get_factory
diff --git a/gst/gstelement.c b/gst/gstelement.c
index c4815f9..c326992 100644
--- a/gst/gstelement.c
+++ b/gst/gstelement.c
@@ -531,6 +531,62 @@ gst_element_get_base_time (GstElement * element)
 }
 
 /**
+ * gst_element_set_start_time:
+ * @element: a #GstElement.
+ * @time: the base time to set.
+ *
+ * Set the start time of an element. See gst_element_get_start_time().
+ *
+ * MT safe.
+ *
+ * Since: 0.10.24
+ */
+void
+gst_element_set_start_time (GstElement * element, GstClockTime time)
+{
+  GstClockTime old;
+
+  g_return_if_fail (GST_IS_ELEMENT (element));
+
+  GST_OBJECT_LOCK (element);
+  old = GST_ELEMENT_START_TIME (element);
+  GST_ELEMENT_START_TIME (element) = time;
+  GST_OBJECT_UNLOCK (element);
+
+  GST_CAT_DEBUG_OBJECT (GST_CAT_CLOCK, element,
+      "set start_time=%" GST_TIME_FORMAT ", old %" GST_TIME_FORMAT,
+      GST_TIME_ARGS (time), GST_TIME_ARGS (old));
+}
+
+/**
+ * gst_element_get_start_time:
+ * @element: a #GstElement.
+ *
+ * Returns the start time of the element. The start time is the
+ * running time of the clock when this element was last put to
+ * PAUSED. 
+ *
+ * MT safe.
+ *
+ * Returns: the start time of the element.
+ *
+ * Since: 0.10.24
+ */
+GstClockTime
+gst_element_get_start_time (GstElement * element)
+{
+  GstClockTime result;
+
+  g_return_val_if_fail (GST_IS_ELEMENT (element), GST_CLOCK_TIME_NONE);
+
+  GST_OBJECT_LOCK (element);
+  result = GST_ELEMENT_START_TIME (element);
+  GST_OBJECT_UNLOCK (element);
+
+  return result;
+}
+
+/**
  * gst_element_is_indexable:
  * @element: a #GstElement.
  *
diff --git a/gst/gstelement.h b/gst/gstelement.h
index 65f281d..9bb1dd1 100644
--- a/gst/gstelement.h
+++ b/gst/gstelement.h
@@ -263,6 +263,17 @@ typedef enum
 #define GST_ELEMENT_PADS(elem)			(GST_ELEMENT_CAST(elem)->pads)
 
 /**
+ * GST_ELEMENT_START_TIME:
+ * @elem: a #GstElement to return the start time for.
+ *
+ * This macro returns the start_time of the @elem. The start_time is the
+ * running_time of the pipeline when the element went to PAUSED.
+ *
+ * Since: 0.10.24
+ */
+#define GST_ELEMENT_START_TIME(elem)		(GST_ELEMENT_CAST(elem)->abidata.ABI.start_time)
+
+/**
  * GST_ELEMENT_ERROR:
  * @el:     the element that generates the error
  * @domain: like CORE, LIBRARY, RESOURCE or STREAM (see #gstreamer-GstGError)
@@ -441,6 +452,8 @@ struct _GstElement
     struct {
       /* state set by application */
       GstState              target_state;
+      /* running time of the last PAUSED state */
+      GstClockTime          start_time;
     } ABI;
     /* adding + 0 to mark ABI change to be undone later */
     gpointer _gst_reserved[GST_PADDING + 0];
@@ -586,6 +599,8 @@ GstClock*		gst_element_get_clock		(GstElement *element);
 gboolean		gst_element_set_clock		(GstElement *element, GstClock *clock);
 void			gst_element_set_base_time	(GstElement *element, GstClockTime time);
 GstClockTime		gst_element_get_base_time	(GstElement *element);
+void			gst_element_set_start_time	(GstElement *element, GstClockTime time);
+GstClockTime		gst_element_get_start_time	(GstElement *element);
 
 /* indexes */
 gboolean		gst_element_is_indexable	(GstElement *element);
diff --git a/win32/common/libgstreamer.def b/win32/common/libgstreamer.def
index aa161fa..3c76a32 100644
--- a/win32/common/libgstreamer.def
+++ b/win32/common/libgstreamer.def
@@ -291,6 +291,7 @@ EXPORTS
 	gst_element_get_pad
 	gst_element_get_query_types
 	gst_element_get_request_pad
+	gst_element_get_start_time
 	gst_element_get_state
 	gst_element_get_static_pad
 	gst_element_get_type
@@ -330,6 +331,7 @@ EXPORTS
 	gst_element_set_clock
 	gst_element_set_index
 	gst_element_set_locked_state
+	gst_element_set_start_time
 	gst_element_set_state
 	gst_element_state_change_return_get_name
 	gst_element_state_get_name