mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-26 19:51:11 +00:00
fix docstring of get_time
Original commit message from CVS: fix docstring of get_time
This commit is contained in:
parent
452269537c
commit
659ebcc92c
1 changed files with 19 additions and 7 deletions
|
@ -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)));
|
||||||
|
|
Loading…
Reference in a new issue