\hypertarget{group__Ecore__Timer__Group}{}\doxysection{Ecore Timer functions}
\label{group__Ecore__Timer__Group}\index{Ecore Timer functions@{Ecore Timer functions}}


Ecore provides very flexible timer functionality.  


\doxysubsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
\mbox{\Hypertarget{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}\label{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}} 
typedef Eo {\bfseries Ecore\+\_\+\+Timer}
\begin{DoxyCompactList}\small\item\em A handle for timers. \end{DoxyCompactList}\end{DoxyCompactItemize}
\doxysubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
double \mbox{\hyperlink{group__Ecore__Timer__Group_ga0045e6840c492e9aaf045fb79ac76c21}{ecore\+\_\+timer\+\_\+precision\+\_\+get}} (void)
\begin{DoxyCompactList}\small\item\em Retrieves the current precision used by timer infrastructure. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_gaf7d0f56778f5614c63a69d4cfbee7b3d}{ecore\+\_\+timer\+\_\+precision\+\_\+set}} (double precision)
\begin{DoxyCompactList}\small\item\em Sets the precision to be used by timer infrastructure. \end{DoxyCompactList}\item 
char $\ast$ \mbox{\hyperlink{group__Ecore__Timer__Group_ga502ddcd427b5cddee5f5a4da251cf442}{ecore\+\_\+timer\+\_\+dump}} (void)
\begin{DoxyCompactList}\small\item\em This function returns a human readable text-\/based log for Ecore\+\_\+\+Timer events. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$ \mbox{\hyperlink{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}{ecore\+\_\+timer\+\_\+add}} (double in, \mbox{\hyperlink{group__Ecore__Main__Loop__Group_ga8a36ef1ac24bfa317a7826617264e530}{Ecore\+\_\+\+Task\+\_\+\+Cb}} func, const void $\ast$data)
\begin{DoxyCompactList}\small\item\em Creates a timer to call the given function in the given period of time. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$ \mbox{\hyperlink{group__Ecore__Timer__Group_ga697f9d492879c257a123d61b41b367a3}{ecore\+\_\+timer\+\_\+loop\+\_\+add}} (double in, \mbox{\hyperlink{group__Ecore__Main__Loop__Group_ga8a36ef1ac24bfa317a7826617264e530}{Ecore\+\_\+\+Task\+\_\+\+Cb}} func, const void $\ast$data)
\begin{DoxyCompactList}\small\item\em Creates a timer to call the given function in the given period of time. \end{DoxyCompactList}\item 
void $\ast$ \mbox{\hyperlink{group__Ecore__Timer__Group_ga7c118b6a6d232b63a6500e599d2a1b47}{ecore\+\_\+timer\+\_\+del}} (\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$timer)
\begin{DoxyCompactList}\small\item\em Deletes the specified timer from the timer list. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_ga9fb759297c1c828cafe5c3ccc1a2614b}{ecore\+\_\+timer\+\_\+freeze}} (\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$timer)
\begin{DoxyCompactList}\small\item\em Pauses a running timer. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Ecore__Timer__Group_gaffb46c42b8d85ab8f2beac1a402c005b}{ecore\+\_\+timer\+\_\+freeze\+\_\+get}} (\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$timer)
\begin{DoxyCompactList}\small\item\em Return whether the timer is freezing. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_gaa026b898456329411d043f36170ad644}{ecore\+\_\+timer\+\_\+thaw}} (\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$timer)
\begin{DoxyCompactList}\small\item\em Resumes a frozen (paused) timer. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_ga4d8f44e32858827d09866efba5e0ad35}{ecore\+\_\+timer\+\_\+interval\+\_\+set}} (Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$obj, double in)
\begin{DoxyCompactList}\small\item\em Interval the timer ticks on. \end{DoxyCompactList}\item 
double \mbox{\hyperlink{group__Ecore__Timer__Group_ga2be02360c275de1390b1f602dbc307cf}{ecore\+\_\+timer\+\_\+interval\+\_\+get}} (const Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$obj)
\begin{DoxyCompactList}\small\item\em Interval the timer ticks on. \end{DoxyCompactList}\item 
double \mbox{\hyperlink{group__Ecore__Timer__Group_gae07617b24116e69c9c973387c8c5f396}{ecore\+\_\+timer\+\_\+pending\+\_\+get}} (const Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$obj)
\begin{DoxyCompactList}\small\item\em Pending time regarding a timer. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_ga0dd8ace3d3f43330b1301f5506be4f76}{ecore\+\_\+timer\+\_\+reset}} (Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$obj)
\begin{DoxyCompactList}\small\item\em Resets a timer to its full interval. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_gaa173822c3e6597571d65afc3202bcd5f}{ecore\+\_\+timer\+\_\+loop\+\_\+reset}} (Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$obj)
\begin{DoxyCompactList}\small\item\em This effectively resets a timer but based on the time when this iteration of the main loop started. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Ecore__Timer__Group_ga74a51cf0c7f07f1b48cac29cef5e8817}{ecore\+\_\+timer\+\_\+delay}} (Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$obj, double add)
\begin{DoxyCompactList}\small\item\em Adds a delay to the next occurrence of a timer. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
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\+: 
\begin{DoxyCode}{0}
\DoxyCodeLine{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}}\ my\_func(\textcolor{keywordtype}{void}\ *data)\ \{}
\DoxyCodeLine{\ \ \ do\_funky\_stuff\_with\_data(data);}
\DoxyCodeLine{\ \ \ \textcolor{keywordflow}{return}\ \mbox{\hyperlink{group__Ecore__Main__Loop__Group_ga1ee9db07f9a46a8b20fb83e1c6dbed09}{ECORE\_CALLBACK\_RENEW}};}
\DoxyCodeLine{\}}
\DoxyCodeLine{\mbox{\hyperlink{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}{ecore\_timer\_add}}(interval\_in\_seconds,\ my\_func,\ data\_given\_to\_function);}

\end{DoxyCode}
 \begin{DoxyNote}{Note}
If the function was to be executed only once simply return {\ttfamily ECORE\+\_\+\+CALLBACK\+\_\+\+CANCEL} instead.
\end{DoxyNote}
An example that shows the usage of a lot of these\+: \begin{DoxyItemize}
\item \mbox{\hyperlink{ecore_timer_example_c}{ecore timers -\/ Scheduled events}} \end{DoxyItemize}


\doxysubsection{Function Documentation}
\mbox{\Hypertarget{group__Ecore__Timer__Group_ga0045e6840c492e9aaf045fb79ac76c21}\label{group__Ecore__Timer__Group_ga0045e6840c492e9aaf045fb79ac76c21}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_precision\_get@{ecore\_timer\_precision\_get}}
\index{ecore\_timer\_precision\_get@{ecore\_timer\_precision\_get}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_precision\_get()}{ecore\_timer\_precision\_get()}}
{\footnotesize\ttfamily double ecore\+\_\+timer\+\_\+precision\+\_\+get (\begin{DoxyParamCaption}\item[{void}]{ }\end{DoxyParamCaption})}



Retrieves the current precision used by timer infrastructure. 

\begin{DoxyReturn}{Returns}
Current precision. 
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Ecore__Timer__Group_gaf7d0f56778f5614c63a69d4cfbee7b3d}{ecore\+\_\+timer\+\_\+precision\+\_\+set()}} 
\end{DoxySeeAlso}


References \mbox{\hyperlink{group__Eina__Lock__Group_ga2974eb3f18404edcc375910cc7e4859c}{EINA\+\_\+\+MAIN\+\_\+\+LOOP\+\_\+\+CHECK\+\_\+\+RETURN\+\_\+\+VAL}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_gaf7d0f56778f5614c63a69d4cfbee7b3d}\label{group__Ecore__Timer__Group_gaf7d0f56778f5614c63a69d4cfbee7b3d}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_precision\_set@{ecore\_timer\_precision\_set}}
\index{ecore\_timer\_precision\_set@{ecore\_timer\_precision\_set}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_precision\_set()}{ecore\_timer\_precision\_set()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+precision\+\_\+set (\begin{DoxyParamCaption}\item[{double}]{precision }\end{DoxyParamCaption})}



Sets the precision to be used by timer infrastructure. 


\begin{DoxyParams}{Parameters}
{\em precision} & Allowed introduced timeout delay, in seconds.\\
\hline
\end{DoxyParams}
This sets the precision for {\bfseries{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 {\bfseries{increase}} the allowed timeout and thus {\bfseries{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 other scheduler policies.

Example\+: We have 2 timers, one that expires in a 2.\+0s and another that expires in 2.\+1s, if precision is 0.\+1s, then the Ecore will request for the next expire to happen in 2.\+1s and not 2.\+0s and another one of 0.\+1 as it would before.

\begin{DoxyNote}{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. 
\end{DoxyNote}
\begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{ecore_timer_example_8c-example}{ecore\+\_\+timer\+\_\+example.\+c}}.\end{Desc}


References \mbox{\hyperlink{group__Eina__Lock__Group_ga6900a2b986f5536b73210e2560675cb0}{EINA\+\_\+\+MAIN\+\_\+\+LOOP\+\_\+\+CHECK\+\_\+\+RETURN}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_ga502ddcd427b5cddee5f5a4da251cf442}\label{group__Ecore__Timer__Group_ga502ddcd427b5cddee5f5a4da251cf442}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_dump@{ecore\_timer\_dump}}
\index{ecore\_timer\_dump@{ecore\_timer\_dump}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_dump()}{ecore\_timer\_dump()}}
{\footnotesize\ttfamily char $\ast$ ecore\+\_\+timer\+\_\+dump (\begin{DoxyParamCaption}\item[{void}]{ }\end{DoxyParamCaption})}



This function returns a human readable text-\/based log for Ecore\+\_\+\+Timer events. 

\begin{DoxyReturn}{Returns}
A heap allocated string, or NULL. It MUST be freed manually by the caller using {\ttfamily free}.
\end{DoxyReturn}
It only contains an useful implementation if EFL is built in debug build profile, but it\textquotesingle{}s safe to call it for any build profile. \mbox{\Hypertarget{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}\label{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_add@{ecore\_timer\_add}}
\index{ecore\_timer\_add@{ecore\_timer\_add}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_add()}{ecore\_timer\_add()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$ ecore\+\_\+timer\+\_\+add (\begin{DoxyParamCaption}\item[{double}]{in,  }\item[{\mbox{\hyperlink{group__Ecore__Main__Loop__Group_ga8a36ef1ac24bfa317a7826617264e530}{Ecore\+\_\+\+Task\+\_\+\+Cb}}}]{func,  }\item[{const void $\ast$}]{data }\end{DoxyParamCaption})}



Creates a timer to call the given function in the given period of time. 


\begin{DoxyParams}{Parameters}
{\em in} & The interval in seconds. \\
\hline
{\em func} & The given function. If {\ttfamily func} returns {\ttfamily 1}, the timer is rescheduled for the next interval {\ttfamily in}. \\
\hline
{\em data} & Data to pass to {\ttfamily func} when it is called. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A timer object on success, {\ttfamily NULL} on failure.
\end{DoxyReturn}
This function adds a timer and returns its handle on success and {\ttfamily NULL} on failure. The function {\ttfamily func} will be called every {\ttfamily in} seconds. The function will be passed the {\ttfamily data} pointer as its parameter.

When the timer {\ttfamily func} is called, it must return a value of either {\ttfamily 1} (or {\ttfamily ECORE\+\_\+\+CALLBACK\+\_\+\+RENEW}) or {\ttfamily 0} (or {\ttfamily ECORE\+\_\+\+CALLBACK\+\_\+\+CANCEL}). If it returns {\ttfamily 1}, it will be called again at the next tick, or if it returns {\ttfamily 0} it will be deleted automatically making any references/handles for it invalid. \begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{banshee_8c-example}{banshee.\+c}}, \mbox{\hyperlink{client_8c-example}{client.\+c}}, \mbox{\hyperlink{complex-types-client-eina-value_8c-example}{complex-\/types-\/client-\/eina-\/value.\+c}}, \mbox{\hyperlink{complex-types-server_8c-example}{complex-\/types-\/server.\+c}}, \mbox{\hyperlink{complex-types_8c-example}{complex-\/types.\+c}}, \mbox{\hyperlink{ecore_animator_example_8c-example}{ecore\+\_\+animator\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_exe_example_8c-example}{ecore\+\_\+exe\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_fd_handler_example_8c-example}{ecore\+\_\+fd\+\_\+handler\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_idler_example_8c-example}{ecore\+\_\+idler\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_thread_example_8c-example}{ecore\+\_\+thread\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_time_functions_example_8c-example}{ecore\+\_\+time\+\_\+functions\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_timer_example_8c-example}{ecore\+\_\+timer\+\_\+example.\+c}}, \mbox{\hyperlink{eina_tiler_01_8c-example}{eina\+\_\+tiler\+\_\+01.\+c}}, \mbox{\hyperlink{evas-events_8c-example}{evas-\/events.\+c}}, \mbox{\hyperlink{inwin_example_8c-example}{inwin\+\_\+example.\+c}}, \mbox{\hyperlink{map_example_01_8c-example}{map\+\_\+example\+\_\+01.\+c}}, \mbox{\hyperlink{map_example_02_8c-example}{map\+\_\+example\+\_\+02.\+c}}, \mbox{\hyperlink{map_example_03_8c-example}{map\+\_\+example\+\_\+03.\+c}}, \mbox{\hyperlink{prefs_example_01_8c-example}{prefs\+\_\+example\+\_\+01.\+c}}, \mbox{\hyperlink{prefs_example_02_8c-example}{prefs\+\_\+example\+\_\+02.\+c}}, \mbox{\hyperlink{progressbar_example_8c-example}{progressbar\+\_\+example.\+c}}, \mbox{\hyperlink{server_8c-example}{server.\+c}}, \mbox{\hyperlink{test_growing_balls_8c-example}{test\+\_\+growing\+\_\+balls.\+c}}, and \mbox{\hyperlink{test_rotating_forever_8c-example}{test\+\_\+rotating\+\_\+forever.\+c}}.\end{Desc}


References \mbox{\hyperlink{group__Eina__Lock__Group_ga2974eb3f18404edcc375910cc7e4859c}{EINA\+\_\+\+MAIN\+\_\+\+LOOP\+\_\+\+CHECK\+\_\+\+RETURN\+\_\+\+VAL}}.



Referenced by \mbox{\hyperlink{group__Ecore__Con__Url__Group_ga778fc5386bfefdaa5aede5d459a141e6}{ecore\+\_\+con\+\_\+url\+\_\+timeout\+\_\+set()}}, \mbox{\hyperlink{group__Elm__Color__Class__Group_gaf9e0a25a2cd3e57d3ff211b62d763ba8}{elm\+\_\+color\+\_\+class\+\_\+editor\+\_\+add()}}, and \mbox{\hyperlink{group__Elm__Transit_ga5f39f8f0c030eacd601c9d9c6c89ebee}{elm\+\_\+transit\+\_\+go\+\_\+in()}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_ga697f9d492879c257a123d61b41b367a3}\label{group__Ecore__Timer__Group_ga697f9d492879c257a123d61b41b367a3}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_loop\_add@{ecore\_timer\_loop\_add}}
\index{ecore\_timer\_loop\_add@{ecore\_timer\_loop\_add}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_loop\_add()}{ecore\_timer\_loop\_add()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$ ecore\+\_\+timer\+\_\+loop\+\_\+add (\begin{DoxyParamCaption}\item[{double}]{in,  }\item[{\mbox{\hyperlink{group__Ecore__Main__Loop__Group_ga8a36ef1ac24bfa317a7826617264e530}{Ecore\+\_\+\+Task\+\_\+\+Cb}}}]{func,  }\item[{const void $\ast$}]{data }\end{DoxyParamCaption})}



Creates a timer to call the given function in the given period of time. 


\begin{DoxyParams}{Parameters}
{\em in} & The interval in seconds from current loop time. \\
\hline
{\em func} & The given function. If {\ttfamily func} returns 1, the timer is rescheduled for the next interval {\ttfamily in}. \\
\hline
{\em data} & Data to pass to {\ttfamily func} when it is called. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A timer object on success, {\ttfamily NULL} on failure.
\end{DoxyReturn}
This is the same as \mbox{\hyperlink{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}{ecore\+\_\+timer\+\_\+add()}}, but \char`\"{}now\char`\"{} is the time from \mbox{\hyperlink{group__Ecore__Time__Group_gab53d952cc4c2f3ed032d535b307c43bd}{ecore\+\_\+loop\+\_\+time\+\_\+get()}} not \mbox{\hyperlink{group__Ecore__Time__Group_ga98f2439b5d3e7114a75bfe2f0c22c4e9}{ecore\+\_\+time\+\_\+get()}} as \mbox{\hyperlink{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}{ecore\+\_\+timer\+\_\+add()}} uses. See \mbox{\hyperlink{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}{ecore\+\_\+timer\+\_\+add()}} for more details. 

References \mbox{\hyperlink{group__Eina__Lock__Group_ga2974eb3f18404edcc375910cc7e4859c}{EINA\+\_\+\+MAIN\+\_\+\+LOOP\+\_\+\+CHECK\+\_\+\+RETURN\+\_\+\+VAL}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_ga7c118b6a6d232b63a6500e599d2a1b47}\label{group__Ecore__Timer__Group_ga7c118b6a6d232b63a6500e599d2a1b47}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_del@{ecore\_timer\_del}}
\index{ecore\_timer\_del@{ecore\_timer\_del}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_del()}{ecore\_timer\_del()}}
{\footnotesize\ttfamily void $\ast$ ecore\+\_\+timer\+\_\+del (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$}]{timer }\end{DoxyParamCaption})}



Deletes the specified timer from the timer list. 


\begin{DoxyParams}{Parameters}
{\em timer} & The timer to delete. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The data pointer set for the timer when \mbox{\hyperlink{group__Ecore__Timer__Group_ga926423e464d7ef71105dd822d90e1187}{ecore\+\_\+timer\+\_\+add}} was called. {\ttfamily NULL} is returned if the function is unsuccessful.
\end{DoxyReturn}
Note\+: {\ttfamily timer} must be a valid handle. If the timer function has already returned {\ttfamily 0}, the handle is no longer valid (and does not need to be delete). \begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{client_8c-example}{client.\+c}}, \mbox{\hyperlink{complex-types-server_8c-example}{complex-\/types-\/server.\+c}}, \mbox{\hyperlink{ecore_fd_handler_example_8c-example}{ecore\+\_\+fd\+\_\+handler\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_idler_example_8c-example}{ecore\+\_\+idler\+\_\+example.\+c}}, \mbox{\hyperlink{ecore_timer_example_8c-example}{ecore\+\_\+timer\+\_\+example.\+c}}, \mbox{\hyperlink{evas-events_8c-example}{evas-\/events.\+c}}, \mbox{\hyperlink{progressbar_example_8c-example}{progressbar\+\_\+example.\+c}}, \mbox{\hyperlink{test_growing_balls_8c-example}{test\+\_\+growing\+\_\+balls.\+c}}, and \mbox{\hyperlink{test_rotating_forever_8c-example}{test\+\_\+rotating\+\_\+forever.\+c}}.\end{Desc}


References \mbox{\hyperlink{group__Eina__Lock__Group_ga2974eb3f18404edcc375910cc7e4859c}{EINA\+\_\+\+MAIN\+\_\+\+LOOP\+\_\+\+CHECK\+\_\+\+RETURN\+\_\+\+VAL}}, and \mbox{\hyperlink{group__Eina__Types__Group_ga05c12dacc8b4058994df842b41be85fc}{EINA\+\_\+\+TRUE}}.



Referenced by \mbox{\hyperlink{group__Ecore__Avahi__Group_ga0492fbb19ffe376b9aabfe2a22851b27}{ecore\+\_\+avahi\+\_\+del()}}, \mbox{\hyperlink{group__Ecore__Con__Url__Group_ga778fc5386bfefdaa5aede5d459a141e6}{ecore\+\_\+con\+\_\+url\+\_\+timeout\+\_\+set()}}, \mbox{\hyperlink{group__Ecore__Wl2__Display__Group_ga73363a708c5842f7620035399ad91613}{ecore\+\_\+wl2\+\_\+display\+\_\+destroy()}}, \mbox{\hyperlink{group__Ecore__Wl__Window__Group_ga03a0baff735d8a659e9c06df34234f59}{ecore\+\_\+wl\+\_\+window\+\_\+free()}}, \mbox{\hyperlink{group__Elm__Entry__Group_ga873dc14aec6498faa47db768f8ea0028}{elm\+\_\+entry\+\_\+file\+\_\+set()}}, \mbox{\hyperlink{group__Elm__Transit_ga5d600d1d615b5136b99a180d256cb147}{elm\+\_\+transit\+\_\+go()}}, and \mbox{\hyperlink{group__Elm__Transit_ga5f39f8f0c030eacd601c9d9c6c89ebee}{elm\+\_\+transit\+\_\+go\+\_\+in()}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_ga9fb759297c1c828cafe5c3ccc1a2614b}\label{group__Ecore__Timer__Group_ga9fb759297c1c828cafe5c3ccc1a2614b}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_freeze@{ecore\_timer\_freeze}}
\index{ecore\_timer\_freeze@{ecore\_timer\_freeze}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_freeze()}{ecore\_timer\_freeze()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+freeze (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$}]{timer }\end{DoxyParamCaption})}



Pauses a running timer. 


\begin{DoxyParams}{Parameters}
{\em timer} & The timer to be paused.\\
\hline
\end{DoxyParams}
\begin{DoxyRemark}{Remarks}
The timer callback won\textquotesingle{}t be called while the timer is paused. The remaining time until the timer expires will be saved, so the timer can be resumed with that same remaining time to expire, instead of expiring instantly. Use \mbox{\hyperlink{group__Ecore__Timer__Group_gaa026b898456329411d043f36170ad644}{ecore\+\_\+timer\+\_\+thaw()}} to resume it.
\end{DoxyRemark}
\begin{DoxyNote}{Note}
Nothing happens if the timer was already paused.
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Ecore__Timer__Group_gaa026b898456329411d043f36170ad644}{ecore\+\_\+timer\+\_\+thaw()}} 
\end{DoxySeeAlso}
\begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{ecore_timer_example_8c-example}{ecore\+\_\+timer\+\_\+example.\+c}}.\end{Desc}
\mbox{\Hypertarget{group__Ecore__Timer__Group_gaffb46c42b8d85ab8f2beac1a402c005b}\label{group__Ecore__Timer__Group_gaffb46c42b8d85ab8f2beac1a402c005b}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_freeze\_get@{ecore\_timer\_freeze\_get}}
\index{ecore\_timer\_freeze\_get@{ecore\_timer\_freeze\_get}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_freeze\_get()}{ecore\_timer\_freeze\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} ecore\+\_\+timer\+\_\+freeze\+\_\+get (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$}]{timer }\end{DoxyParamCaption})}



Return whether the timer is freezing. 

\begin{DoxyReturn}{Returns}
True if the timer object is freezed, false otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Ecore__Timer__Group_ga9fb759297c1c828cafe5c3ccc1a2614b}{ecore\+\_\+timer\+\_\+freeze()}}, \mbox{\hyperlink{group__Ecore__Timer__Group_gaa026b898456329411d043f36170ad644}{ecore\+\_\+timer\+\_\+thaw()}} 
\end{DoxySeeAlso}


References \mbox{\hyperlink{group__Eina__Types__Group_ga1feb115f8e9913e806e090d9bd5a7301}{EINA\+\_\+\+FALSE}}, and \mbox{\hyperlink{group__Eina__Lock__Group_ga2974eb3f18404edcc375910cc7e4859c}{EINA\+\_\+\+MAIN\+\_\+\+LOOP\+\_\+\+CHECK\+\_\+\+RETURN\+\_\+\+VAL}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_gaa026b898456329411d043f36170ad644}\label{group__Ecore__Timer__Group_gaa026b898456329411d043f36170ad644}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_thaw@{ecore\_timer\_thaw}}
\index{ecore\_timer\_thaw@{ecore\_timer\_thaw}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_thaw()}{ecore\_timer\_thaw()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+thaw (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\+\_\+\+Timer}} $\ast$}]{timer }\end{DoxyParamCaption})}



Resumes a frozen (paused) timer. 

\begin{DoxyRemark}{Remarks}
The timer will be resumed from its previous relative position in time. That means, if it had X seconds remaining until expire when it was paused, it will be started now with those same X seconds remaining to expire again. But notice that the interval time won\textquotesingle{}t be touched by this call or by \mbox{\hyperlink{group__Ecore__Timer__Group_ga9fb759297c1c828cafe5c3ccc1a2614b}{ecore\+\_\+timer\+\_\+freeze()}}.
\end{DoxyRemark}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em timer} & The timer to be resumed.\\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Ecore__Timer__Group_ga9fb759297c1c828cafe5c3ccc1a2614b}{ecore\+\_\+timer\+\_\+freeze()}} 
\end{DoxySeeAlso}
\begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{ecore_timer_example_8c-example}{ecore\+\_\+timer\+\_\+example.\+c}}.\end{Desc}
\mbox{\Hypertarget{group__Ecore__Timer__Group_ga4d8f44e32858827d09866efba5e0ad35}\label{group__Ecore__Timer__Group_ga4d8f44e32858827d09866efba5e0ad35}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_interval\_set@{ecore\_timer\_interval\_set}}
\index{ecore\_timer\_interval\_set@{ecore\_timer\_interval\_set}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_interval\_set()}{ecore\_timer\_interval\_set()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+interval\+\_\+set (\begin{DoxyParamCaption}\item[{Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$}]{obj,  }\item[{double}]{in }\end{DoxyParamCaption})}



Interval the timer ticks on. 

If set during a timer call this will affect the next interval.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em in} & The new interval in seconds \\
\hline
\end{DoxyParams}


Referenced by \mbox{\hyperlink{group__Eio_ga589b297947c40b932e84273f089afcc6}{eio\+\_\+monitoring\+\_\+interval\+\_\+set()}}.

\mbox{\Hypertarget{group__Ecore__Timer__Group_ga2be02360c275de1390b1f602dbc307cf}\label{group__Ecore__Timer__Group_ga2be02360c275de1390b1f602dbc307cf}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_interval\_get@{ecore\_timer\_interval\_get}}
\index{ecore\_timer\_interval\_get@{ecore\_timer\_interval\_get}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_interval\_get()}{ecore\_timer\_interval\_get()}}
{\footnotesize\ttfamily double ecore\+\_\+timer\+\_\+interval\+\_\+get (\begin{DoxyParamCaption}\item[{const Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$}]{obj }\end{DoxyParamCaption})}



Interval the timer ticks on. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The new interval in seconds 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Ecore__Timer__Group_gae07617b24116e69c9c973387c8c5f396}\label{group__Ecore__Timer__Group_gae07617b24116e69c9c973387c8c5f396}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_pending\_get@{ecore\_timer\_pending\_get}}
\index{ecore\_timer\_pending\_get@{ecore\_timer\_pending\_get}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_pending\_get()}{ecore\_timer\_pending\_get()}}
{\footnotesize\ttfamily double ecore\+\_\+timer\+\_\+pending\+\_\+get (\begin{DoxyParamCaption}\item[{const Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$}]{obj }\end{DoxyParamCaption})}



Pending time regarding a timer. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Pending time 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Ecore__Timer__Group_ga0dd8ace3d3f43330b1301f5506be4f76}\label{group__Ecore__Timer__Group_ga0dd8ace3d3f43330b1301f5506be4f76}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_reset@{ecore\_timer\_reset}}
\index{ecore\_timer\_reset@{ecore\_timer\_reset}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_reset()}{ecore\_timer\_reset()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+reset (\begin{DoxyParamCaption}\item[{Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$}]{obj }\end{DoxyParamCaption})}



Resets a timer to its full interval. 

This effectively makes the timer start ticking off from zero now.

This is equal to delaying the timer by the already passed time, since the timer started ticking


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+2 
\end{DoxySince}
\mbox{\Hypertarget{group__Ecore__Timer__Group_gaa173822c3e6597571d65afc3202bcd5f}\label{group__Ecore__Timer__Group_gaa173822c3e6597571d65afc3202bcd5f}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_loop\_reset@{ecore\_timer\_loop\_reset}}
\index{ecore\_timer\_loop\_reset@{ecore\_timer\_loop\_reset}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_loop\_reset()}{ecore\_timer\_loop\_reset()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+loop\+\_\+reset (\begin{DoxyParamCaption}\item[{Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$}]{obj }\end{DoxyParamCaption})}



This effectively resets a timer but based on the time when this iteration of the main loop started. 

\begin{DoxySince}{Since}
1.\+18 
\end{DoxySince}
\mbox{\Hypertarget{group__Ecore__Timer__Group_ga74a51cf0c7f07f1b48cac29cef5e8817}\label{group__Ecore__Timer__Group_ga74a51cf0c7f07f1b48cac29cef5e8817}} 
\index{Ecore Timer functions@{Ecore Timer functions}!ecore\_timer\_delay@{ecore\_timer\_delay}}
\index{ecore\_timer\_delay@{ecore\_timer\_delay}!Ecore Timer functions@{Ecore Timer functions}}
\doxysubsubsection{\texorpdfstring{ecore\_timer\_delay()}{ecore\_timer\_delay()}}
{\footnotesize\ttfamily void ecore\+\_\+timer\+\_\+delay (\begin{DoxyParamCaption}\item[{Efl\+\_\+\+Loop\+\_\+\+Timer $\ast$}]{obj,  }\item[{double}]{add }\end{DoxyParamCaption})}



Adds a delay to the next occurrence of a timer. 

This doesn\textquotesingle{}t affect the timer interval.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em add} & The amount of time by which to delay the timer in seconds \\
\hline
\end{DoxyParams}
