SDL 2.0
testautomation_timer.c
Go to the documentation of this file.
1/**
2 * Timer test suite
3 */
4
5#include <stdio.h>
6
7#include "SDL.h"
8#include "SDL_test.h"
9
10/* Flag indicating if the param should be checked */
12
13/* Userdata value to check */
15
16/* Flag indicating that the callback was called */
18
19/* Fixture */
20
21void
22_timerSetUp(void *arg)
23{
24 /* Start SDL timer subsystem */
26 SDLTest_AssertPass("Call to SDL_InitSubSystem(SDL_INIT_TIMER)");
27 SDLTest_AssertCheck(ret==0, "Check result from SDL_InitSubSystem(SDL_INIT_TIMER)");
28 if (ret != 0) {
30 }
31}
32
33/* Test case functions */
34
35/**
36 * @brief Call to SDL_GetPerformanceCounter
37 */
38int
40{
42
44 SDLTest_AssertPass("Call to SDL_GetPerformanceCounter()");
45 SDLTest_AssertCheck(result > 0, "Check result value, expected: >0, got: %"SDL_PRIu64, result);
46
47 return TEST_COMPLETED;
48}
49
50/**
51 * @brief Call to SDL_GetPerformanceFrequency
52 */
53int
55{
57
59 SDLTest_AssertPass("Call to SDL_GetPerformanceFrequency()");
60 SDLTest_AssertCheck(result > 0, "Check result value, expected: >0, got: %"SDL_PRIu64, result);
61
62 return TEST_COMPLETED;
63}
64
65/**
66 * @brief Call to SDL_Delay and SDL_GetTicks
67 */
68int
70{
71 const Uint32 testDelay = 100;
72 const Uint32 marginOfError = 25;
74 Uint32 result2;
75 Uint32 difference;
76
77 /* Zero delay */
78 SDL_Delay(0);
79 SDLTest_AssertPass("Call to SDL_Delay(0)");
80
81 /* Non-zero delay */
82 SDL_Delay(1);
83 SDLTest_AssertPass("Call to SDL_Delay(1)");
84
86 SDLTest_AssertPass("Call to SDL_Delay()");
87
88 /* Get ticks count - should be non-zero by now */
90 SDLTest_AssertPass("Call to SDL_GetTicks()");
91 SDLTest_AssertCheck(result > 0, "Check result value, expected: >0, got: %d", result);
92
93 /* Delay a bit longer and measure ticks and verify difference */
94 SDL_Delay(testDelay);
95 SDLTest_AssertPass("Call to SDL_Delay(%d)", testDelay);
96 result2 = SDL_GetTicks();
97 SDLTest_AssertPass("Call to SDL_GetTicks()");
98 SDLTest_AssertCheck(result2 > 0, "Check result value, expected: >0, got: %d", result2);
99 difference = result2 - result;
100 SDLTest_AssertCheck(difference > (testDelay - marginOfError), "Check difference, expected: >%d, got: %d", testDelay - marginOfError, difference);
101 SDLTest_AssertCheck(difference < (testDelay + marginOfError), "Check difference, expected: <%d, got: %d", testDelay + marginOfError, difference);
102
103 return TEST_COMPLETED;
104}
105
106/* Test callback */
108{
110
111 if (_paramCheck != 0) {
112 SDLTest_AssertCheck(param != NULL, "Check param pointer, expected: non-NULL, got: %s", (param != NULL) ? "non-NULL" : "NULL");
113 if (param != NULL) {
114 SDLTest_AssertCheck(*(int *)param == _paramValue, "Check param value, expected: %i, got: %i", _paramValue, *(int *)param);
115 }
116 }
117
118 return 0;
119}
120
121/**
122 * @brief Call to SDL_AddTimer and SDL_RemoveTimer
123 */
124int
126{
129 int param;
130
131 /* Reset state */
132 _paramCheck = 0;
134
135 /* Set timer with a long delay */
137 SDLTest_AssertPass("Call to SDL_AddTimer(10000,...)");
138 SDLTest_AssertCheck(id > 0, "Check result value, expected: >0, got: %d", id);
139
140 /* Remove timer again and check that callback was not called */
142 SDLTest_AssertPass("Call to SDL_RemoveTimer()");
143 SDLTest_AssertCheck(result == SDL_TRUE, "Check result value, expected: %i, got: %i", SDL_TRUE, result);
144 SDLTest_AssertCheck(_timerCallbackCalled == 0, "Check callback WAS NOT called, expected: 0, got: %i", _timerCallbackCalled);
145
146 /* Try to remove timer again (should be a NOOP) */
148 SDLTest_AssertPass("Call to SDL_RemoveTimer()");
149 SDLTest_AssertCheck(result == SDL_FALSE, "Check result value, expected: %i, got: %i", SDL_FALSE, result);
150
151 /* Reset state */
152 param = SDLTest_RandomIntegerInRange(-1024, 1024);
153 _paramCheck = 1;
156
157 /* Set timer with a short delay */
158 id = SDL_AddTimer(10, _timerTestCallback, (void *)&param);
159 SDLTest_AssertPass("Call to SDL_AddTimer(10, param)");
160 SDLTest_AssertCheck(id > 0, "Check result value, expected: >0, got: %d", id);
161
162 /* Wait to let timer trigger callback */
163 SDL_Delay(100);
164 SDLTest_AssertPass("Call to SDL_Delay(100)");
165
166 /* Remove timer again and check that callback was called */
168 SDLTest_AssertPass("Call to SDL_RemoveTimer()");
169 SDLTest_AssertCheck(result == SDL_FALSE, "Check result value, expected: %i, got: %i", SDL_FALSE, result);
170 SDLTest_AssertCheck(_timerCallbackCalled == 1, "Check callback WAS called, expected: 1, got: %i", _timerCallbackCalled);
171
172 return TEST_COMPLETED;
173}
174
175/* ================= Test References ================== */
176
177/* Timer test cases */
179 { (SDLTest_TestCaseFp)timer_getPerformanceCounter, "timer_getPerformanceCounter", "Call to SDL_GetPerformanceCounter", TEST_ENABLED };
180
182 { (SDLTest_TestCaseFp)timer_getPerformanceFrequency, "timer_getPerformanceFrequency", "Call to SDL_GetPerformanceFrequency", TEST_ENABLED };
183
185 { (SDLTest_TestCaseFp)timer_delayAndGetTicks, "timer_delayAndGetTicks", "Call to SDL_Delay and SDL_GetTicks", TEST_ENABLED };
186
188 { (SDLTest_TestCaseFp)timer_addRemoveTimer, "timer_addRemoveTimer", "Call to SDL_AddTimer and SDL_RemoveTimer", TEST_ENABLED };
189
190/* Sequence of Timer test cases */
193};
194
195/* Timer test suite (global) */
197 "Timer",
200 NULL
201};
#define SDL_INIT_TIMER
Definition: SDL.h:77
#define SDL_InitSubSystem
#define SDL_GetError
#define SDL_AddTimer
#define SDL_RemoveTimer
#define SDL_GetPerformanceCounter
#define SDL_Delay
#define SDLCALL
Definition: SDL_internal.h:49
GLuint64EXT * result
GLuint id
GLfloat param
SDL_bool
Definition: SDL_stdinc.h:162
@ SDL_TRUE
Definition: SDL_stdinc.h:164
@ SDL_FALSE
Definition: SDL_stdinc.h:163
#define SDL_PRIu64
Definition: SDL_stdinc.h:238
uint32_t Uint32
Definition: SDL_stdinc.h:203
uint64_t Uint64
Definition: SDL_stdinc.h:216
void SDLTest_AssertPass(SDL_PRINTF_FORMAT_STRING const char *assertDescription,...) SDL_PRINTF_VARARG_FUNC(1)
Explicitly pass without checking an assertion condition. Updates assertion counter.
int SDLTest_AssertCheck(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription,...) SDL_PRINTF_VARARG_FUNC(2)
Assert for test cases that logs but does not break execution flow on failures. Updates assertion coun...
Sint32 SDLTest_RandomIntegerInRange(Sint32 min, Sint32 max)
#define TEST_ENABLED
#define TEST_COMPLETED
int(* SDLTest_TestCaseFp)(void *arg)
void SDLTest_LogError(SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(1)
Prints given message with a timestamp in the TEST category and the ERROR priority.
Definition: SDL_test_log.c:103
Uint32 SDL_GetTicks(void)
Get the number of milliseconds since the SDL library initialization.
Uint64 SDL_GetPerformanceFrequency(void)
Get the count per second of the high resolution counter.
int SDL_TimerID
Definition: SDL_timer.h:86
#define NULL
Definition: begin_code.h:167
int timer_delayAndGetTicks(void *arg)
Call to SDL_Delay and SDL_GetTicks.
static const SDLTest_TestCaseReference timerTest3
static const SDLTest_TestCaseReference timerTest2
int _timerCallbackCalled
static const SDLTest_TestCaseReference * timerTests[]
int _paramValue
SDLTest_TestSuiteReference timerTestSuite
int timer_addRemoveTimer(void *arg)
Call to SDL_AddTimer and SDL_RemoveTimer.
void _timerSetUp(void *arg)
static const SDLTest_TestCaseReference timerTest1
int timer_getPerformanceCounter(void *arg)
Call to SDL_GetPerformanceCounter.
int timer_getPerformanceFrequency(void *arg)
Call to SDL_GetPerformanceFrequency.
static const SDLTest_TestCaseReference timerTest4
int _paramCheck
Uint32 _timerTestCallback(Uint32 interval, void *param)