

This example shows how to setup timer callbacks. It starts a timer that will tick (expire) every 1 second, and then setup other timers that will expire only once, but each of them will affect the first timer still executing with a different A\+P\+I, to demonstrate its usage. To see the full code for this example, click \hyperlink{ecore_timer_example_8c-example}{here}.

To demonstrate this, let's define some constants that will determine at which time each timer will expire\+:


\begin{DoxyCodeInclude}
\textcolor{comment}{//Compile with:}
\textcolor{comment}{// gcc -o ecore\_timer\_example ecore\_timer\_example.c `pkg-config --libs --cflags ecore`}

\textcolor{preprocessor}{#include <Ecore.h>}
\textcolor{preprocessor}{#include <unistd.h>}

\textcolor{preprocessor}{#define TIMEOUT\_1 1.0 // interval for timer1}
\textcolor{preprocessor}{#define TIMEOUT\_2 3.0 // timer2 - delay timer1}
\textcolor{preprocessor}{#define TIMEOUT\_3 8.2 // timer3 - pause timer1}
\textcolor{preprocessor}{#define TIMEOUT\_4 11.0 // timer4 - resume timer1}
\textcolor{preprocessor}{#define TIMEOUT\_5 14.0 // timer5 - change interval of timer1}
\textcolor{preprocessor}{#define TIMEOUT\_6 18.0 // top timer1 and start timer7 and timer8 with changed precision}
\textcolor{preprocessor}{#define TIMEOUT\_7 1.1 // interval for timer7}
\textcolor{preprocessor}{#define TIMEOUT\_8 1.2 // interval for timer8}
\textcolor{preprocessor}{#define DELAY\_1   3.0 // delay time for timer1 - used by timer2}
\textcolor{preprocessor}{#define INTERVAL1 2.0 // new interval for timer1 - used by timer5}

\end{DoxyCodeInclude}


These constants should tell by themselves what will be the behavior of the program, but I'll explain it anyway. The first timer is set to tick every 1 second, but all the other timers until the 6th one will be started concurrently at the beginning of the program. Each of them will expire at the specified time in these constants\+:

\begin{DoxyItemize}
\item The timer2, after 3 seconds of the program being executed, will add a delay of 3 seconds to timer1; \item The timer3 will pause timer1 at 8.\+2 seconds; \item timer4 will resume timer1 at 11.\+0 seconds; \item timer5 will will change the interval of timer1 to 2 seconds; \item timer6 will stop timer1 and start timer7 and timer8, with 1.\+1 and 1.\+2 seconds of interval, respectively; it also sets the precision to 0.\+2 seconds; \item timer7 and timer8 will just print their expiration time.\end{DoxyItemize}

\begin{DoxyCodeInclude}

\textcolor{keyword}{static} \textcolor{keywordtype}{double} \_initial\_time = 0;

\textcolor{keyword}{struct }context   \textcolor{comment}{// helper struct to give some context to the callbacks}
\{
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer1;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer2;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer3;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer4;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer5;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer6;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer7;
   \hyperlink{group__Ecore__Timer__Group_gaf96ffb609956658ec038e54bd39f46f0}{Ecore\_Timer} *timer8;
\};

\textcolor{keyword}{static} \textcolor{keywordtype}{double}
\_get\_current\_time(\textcolor{keywordtype}{void})
\{
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Time__Group_ga98f2439b5d3e7114a75bfe2f0c22c4e9}{ecore\_time\_get}() - \_initial\_time;
\}

\end{DoxyCodeInclude}


As almost all the other examples, we create a context structure to pass to our callbacks, so they can have access to the other timers. We also store the time of the program start in {\ttfamily \+\_\+initial\+\_\+time}, and use the function {\ttfamily \+\_\+get\+\_\+current\+\_\+time} to retrieve the current time relative to that time. This will help demonstrate what is going on.

Now, the behavior and relationship between the timers that was described above is dictated by the following timer callbacks\+:


\begin{DoxyCodeInclude}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer1\_cb(\textcolor{keywordtype}{void} *data EINA\_UNUSED)
\{
   printf(\textcolor{stringliteral}{"Timer1 expired after %0.3f seconds.\(\backslash\)n"}, \_get\_current\_time());
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_ga1ee9db07f9a46a8b20fb83e1c6dbed09}{ECORE\_CALLBACK\_RENEW};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer2\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   printf(\textcolor{stringliteral}{"Timer2 expired after %0.3f seconds. "}
          \textcolor{stringliteral}{"Adding delay of %0.3f seconds to timer1.\(\backslash\)n"},
          \_get\_current\_time(), DELAY\_1);

   ecore\_timer\_delay(ctxt->timer1, DELAY\_1);

   ctxt->timer2 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer3\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   printf(\textcolor{stringliteral}{"Timer3 expired after %0.3f seconds. "}
          \textcolor{stringliteral}{"Freezing timer1.\(\backslash\)n"}, \_get\_current\_time());

   ecore\_timer\_freeze(ctxt->timer1);

   ctxt->timer3 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer4\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   printf(\textcolor{stringliteral}{"Timer4 expired after %0.3f seconds. "}
          \textcolor{stringliteral}{"Resuming timer1, which has %0.3f seconds left to expire.\(\backslash\)n"},
          \_get\_current\_time(), ecore\_timer\_pending\_get(ctxt->timer1));

   ecore\_timer\_thaw(ctxt->timer1);

   ctxt->timer4 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer5\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   \textcolor{keywordtype}{double} interval = ecore\_timer\_interval\_get(ctxt->timer1);

   printf(\textcolor{stringliteral}{"Timer5 expired after %0.3f seconds. "}
          \textcolor{stringliteral}{"Changing interval of timer1 from %0.3f to %0.3f seconds.\(\backslash\)n"},
          \_get\_current\_time(), interval, INTERVAL1);

   ecore\_timer\_interval\_set(ctxt->timer1, INTERVAL1);

   ctxt->timer5 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer7\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   printf(\textcolor{stringliteral}{"Timer7 expired after %0.3f seconds.\(\backslash\)n"}, \_get\_current\_time());

   ctxt->timer7 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer8\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   printf(\textcolor{stringliteral}{"Timer8 expired after %0.3f seconds.\(\backslash\)n"}, \_get\_current\_time());

   ctxt->timer8 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_timer6\_cb(\textcolor{keywordtype}{void} *data)
\{
   \textcolor{keyword}{struct }context *ctxt = data;
   printf(\textcolor{stringliteral}{"Timer6 expired after %0.3f seconds.\(\backslash\)n"}, \_get\_current\_time());

   printf(\textcolor{stringliteral}{"Stopping timer1.\(\backslash\)n"});

   \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt->timer1);
   ctxt->timer1 = NULL;

   printf(\textcolor{stringliteral}{"Starting timer7 (%0.3fs) and timer8 (%0.3fs).\(\backslash\)n"},
          TIMEOUT\_7, TIMEOUT\_8);

   ctxt->timer7 = ecore\_timer\_add(TIMEOUT\_7, \_timer7\_cb, ctxt);
   ctxt->timer8 = ecore\_timer\_add(TIMEOUT\_8, \_timer8\_cb, ctxt);

   \hyperlink{group__Ecore__Timer__Group_gaf7d0f56778f5614c63a69d4cfbee7b3d}{ecore\_timer\_precision\_set}(0.2);

   ctxt->timer6 = NULL;
   \textcolor{keywordflow}{return} \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{ECORE\_CALLBACK\_CANCEL};
\}

\end{DoxyCodeInclude}


It's possible to see the same behavior as other Ecore callbacks here, returning \hyperlink{group__Ecore__Main__Loop__Group_ga1ee9db07f9a46a8b20fb83e1c6dbed09}{E\+C\+O\+R\+E\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+R\+E\+N\+E\+W} when the timer needs to continue ticking, and \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{E\+C\+O\+R\+E\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+C\+A\+N\+C\+E\+L} when it needs to stop its execution. Also notice that later on our program we are checking for the timers pointers in the context to see if they are still executing before deleting them, so we need to set these timer pointers to {\ttfamily N\+U\+L\+L} when we are returning \hyperlink{group__Ecore__Main__Loop__Group_gae0c653baad8836232c0dc27f91f875d6}{E\+C\+O\+R\+E\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+C\+A\+N\+C\+E\+L}. Otherwise the pointer would still be not {\ttfamily N\+U\+L\+L}, but pointing to something that is invalid, since the timer would have already expired without renewing.

Now the main code, which will start the timers\+:


\begin{DoxyCodeInclude}

\textcolor{keywordtype}{int}
main(\textcolor{keywordtype}{void})
\{
   \textcolor{keyword}{struct }context ctxt = \{0\};

   \textcolor{keywordflow}{if} (!\hyperlink{group__Ecore__Init__Group_ga77757609684a2c922dc5ec398274751b}{ecore\_init}())
     \{
        printf(\textcolor{stringliteral}{"ERROR: Cannot init Ecore!\(\backslash\)n"});
        \textcolor{keywordflow}{return} -1;
     \}

   \_initial\_time = \hyperlink{group__Ecore__Time__Group_ga98f2439b5d3e7114a75bfe2f0c22c4e9}{ecore\_time\_get}();

   ctxt.timer1 = ecore\_timer\_add(TIMEOUT\_1, \_timer1\_cb, &ctxt);
   ctxt.timer2 = ecore\_timer\_add(TIMEOUT\_2, \_timer2\_cb, &ctxt);
   ctxt.timer3 = ecore\_timer\_add(TIMEOUT\_3, \_timer3\_cb, &ctxt);
   ctxt.timer4 = ecore\_timer\_add(TIMEOUT\_4, \_timer4\_cb, &ctxt);
   ctxt.timer5 = ecore\_timer\_add(TIMEOUT\_5, \_timer5\_cb, &ctxt);
   ctxt.timer6 = ecore\_timer\_add(TIMEOUT\_6, \_timer6\_cb, &ctxt);

   printf(\textcolor{stringliteral}{"start the main loop.\(\backslash\)n"});

   \hyperlink{group__Ecore__Main__Loop__Group_gaf103b9f668bb3e4fed12e52c6180132d}{ecore\_main\_loop\_begin}();

   \textcolor{keywordflow}{if} (ctxt.timer1)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer1);
   \textcolor{keywordflow}{if} (ctxt.timer2)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer2);
   \textcolor{keywordflow}{if} (ctxt.timer3)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer3);
   \textcolor{keywordflow}{if} (ctxt.timer4)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer4);
   \textcolor{keywordflow}{if} (ctxt.timer5)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer5);
   \textcolor{keywordflow}{if} (ctxt.timer6)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer6);
   \textcolor{keywordflow}{if} (ctxt.timer7)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer7);
   \textcolor{keywordflow}{if} (ctxt.timer8)
     \hyperlink{group__Ecore__Timer__Group_gaba2b599c7aabe3ab664dc3d47f62a33a}{ecore\_timer\_del}(ctxt.timer8);

   \hyperlink{group__Ecore__Init__Group_ga768298b932f18d7e7593a447493e5cde}{ecore\_shutdown}();

   \textcolor{keywordflow}{return} 0;
\}

\end{DoxyCodeInclude}


This code is very simple. Just after starting the library, it will save the current time to {\ttfamily \+\_\+initial\+\_\+time}, start all timers from 1 to 6, and begin the main loop. Everything should be running right now, displaying the time which each timer is expiring, and what it is doing to affect the other timers.

After returning from the main loop, every timer is checked to see if it's still alive and, in that case, deleted, before finalizing the library. This is not really necessary, since \hyperlink{group__Ecore__Init__Group_ga768298b932f18d7e7593a447493e5cde}{ecore\+\_\+shutdown()} will already delete them for you, but it's good practice if you have other things going on after this point that could restart the main loop. 