forked from enlightenment/efl
parent
7c7a6bade4
commit
faa433a789
|
@ -1246,9 +1246,20 @@ EAPI double ecore_loop_time_get(void);
|
|||
/**
|
||||
* @defgroup Ecore_Timer_Group Ecore Timer functions
|
||||
*
|
||||
* Functions to create events based on timers.
|
||||
* Ecore provides very flexible timer functionality. The basic usage of timers,
|
||||
* to call a certain function at a certain interval can be achieved with a
|
||||
* single line:
|
||||
* @code
|
||||
* Eina_Bool my_func(void *data) {
|
||||
* do_funky_stuff_with_data(data);
|
||||
* return EINA_TRUE;
|
||||
* }
|
||||
* ecore_timer_add(interval_in_seconds, my_func, data_given_to_function);
|
||||
* @endcode
|
||||
* @note If the function was to be executed only once simply return EINA_FALSE
|
||||
* instead.
|
||||
*
|
||||
* Examples:
|
||||
* An example that shows the usage of a lot of these:
|
||||
* @li @ref ecore_timer_example_c
|
||||
*
|
||||
* @ingroup Ecore_Main_Loop_Group
|
||||
|
|
|
@ -73,12 +73,15 @@ ecore_timer_precision_get(void)
|
|||
}
|
||||
|
||||
/**
|
||||
* Sets the precision to be used by timer infrastructure.
|
||||
* @brief Sets the precision to be used by timer infrastructure.
|
||||
*
|
||||
* When system calculates time to expire the next timer we'll be able
|
||||
* to delay the timer by the given amount so more timers will fit in
|
||||
* the same dispatch, waking up the system less often and thus being
|
||||
* able to save power.
|
||||
* @param value allowed introduced timeout delay, in seconds.
|
||||
*
|
||||
* This sets the precision for @b all timers. The precision determines how much
|
||||
* of an difference from the requested interval is acceptable. One common reason
|
||||
* to use this function is to @b increase the allowed timeout and thus @b
|
||||
* decrease precision of the timers, this is because less precise the timers
|
||||
* result in the system waking up less often and thus consuming less resources.
|
||||
*
|
||||
* Be aware that kernel may delay delivery even further, these delays
|
||||
* are always possible due other tasks having higher priorities or
|
||||
|
@ -93,8 +96,6 @@ ecore_timer_precision_get(void)
|
|||
* @note Ecore is smart enough to see if there are timers in the
|
||||
* precision range, if it does not, in our example if no second timer
|
||||
* in (T + precision) existed, then it would use the minimum timeout.
|
||||
*
|
||||
* @param value allowed introduced timeout delay, in seconds.
|
||||
*/
|
||||
EAPI void
|
||||
ecore_timer_precision_set(double value)
|
||||
|
|
Loading…
Reference in New Issue