fix docstring of get_time

Original commit message from CVS:
fix docstring of get_time
This commit is contained in:
Thomas Vander Stichele 2004-06-14 16:55:28 +00:00
parent 452269537c
commit 659ebcc92c

View file

@ -792,7 +792,7 @@ gst_element_clock_wait (GstElement * element, GstClockID id,
g_return_val_if_fail (GST_IS_ELEMENT (element), GST_CLOCK_ERROR); g_return_val_if_fail (GST_IS_ELEMENT (element), GST_CLOCK_ERROR);
if (GST_ELEMENT_SCHED (element)) { if (GST_ELEMENT_SCHED (element)) {
GST_CAT_DEBUG (GST_CAT_CLOCK, "waiting on scheduler clock"); GST_CAT_DEBUG (GST_CAT_CLOCK, "waiting on scheduler clock with id %d");
res = res =
gst_scheduler_clock_wait (GST_ELEMENT_SCHED (element), element, id, gst_scheduler_clock_wait (GST_ELEMENT_SCHED (element), element, id,
jitter); jitter);
@ -810,10 +810,18 @@ gst_element_clock_wait (GstElement * element, GstClockID id,
* gst_element_get_time: * gst_element_get_time:
* @element: element to query * @element: element to query
* *
* Query the element's time. The element must use * Query the element's time. FIXME: The element must use
* *
* Returns: the current time of the element or #GST_CLOCK_TIME_NONE when there * Returns: the current stream time in #GST_STATE_PLAYING,
* is no time available. * the element base time in #GST_STATE_PAUSED,
* or #GST_CLOCK_TIME_NONE otherwise.
*/
/* FIXME: this should always return time on the same scale. Now it returns
* the (absolute) base_time in PAUSED and the (current running) time in
* PLAYING.
* Solution: have a get_base_time and make the element subtract if it needs
* to. In PAUSED return the same as PLAYING, ie. the current timestamp where
* the element is at according to the provided clock.
*/ */
GstClockTime GstClockTime
gst_element_get_time (GstElement * element) gst_element_get_time (GstElement * element)
@ -854,6 +862,7 @@ gst_element_wait (GstElement * element, GstClockTime timestamp)
{ {
GstClockID id; GstClockID id;
GstClockReturn ret; GstClockReturn ret;
GstClockTime time;
g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE); g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE);
g_return_val_if_fail (GST_IS_CLOCK (element->clock), FALSE); g_return_val_if_fail (GST_IS_CLOCK (element->clock), FALSE);
@ -861,8 +870,11 @@ gst_element_wait (GstElement * element, GstClockTime timestamp)
g_return_val_if_fail (GST_CLOCK_TIME_IS_VALID (timestamp), FALSE); g_return_val_if_fail (GST_CLOCK_TIME_IS_VALID (timestamp), FALSE);
/* shortcut when we're already late... */ /* shortcut when we're already late... */
if (gst_element_get_time (element) >= timestamp) { time = gst_element_get_time (element);
GST_INFO_OBJECT (element, GST_CAT_LOG_OBJECT (GST_CAT_CLOCK, element, "element time %" GST_TIME_FORMAT,
GST_TIME_ARGS (time));
if (time >= timestamp) {
GST_CAT_INFO_OBJECT (GST_CAT_CLOCK, element,
"called gst_element_wait (% " GST_TIME_FORMAT ") and was late (%" "called gst_element_wait (% " GST_TIME_FORMAT ") and was late (%"
GST_TIME_FORMAT, GST_TIME_ARGS (timestamp), GST_TIME_FORMAT, GST_TIME_ARGS (timestamp),
GST_TIME_ARGS (gst_element_get_time (element))); GST_TIME_ARGS (gst_element_get_time (element)));