SDL_TimerID SDL_AddTimer(Uint32 interval, SDL_TimerCallback callback, void* param)
| interval | callbackを呼ぶまでの時間(ミリ秒) |
| callback | 指定のintervalが経過した後に呼ばれる関数 |
| param | callbackに渡されるポインタ |
// 一定時間の経過で呼ばれる関数
Uint32 callback(Uint32 interval, void* name) {
printf("こんにちは %s!\n", (const char *)name);
return 0;
}
/* ... */
// タイマを初期化する
SDL_Init(SDL_INIT_VIDEO | SDL_INIT_TIMER);
/* ... */
// タイマを1秒に設定する
SDL_TimerID timerID = SDL_AddTimer(1000, callback, "SDL");
// メインループ
SDL_bool quit;
while(!quit) {
/* ... */
}
// メインループの後でタイマを取り除く
SDL_RemoveTimer(timerID);
この関数を使う場合, SDL_Init()にSDL_INIT_TIMERを渡している必要がある.
コールバック関数には, 第1引数に現在のタイマ間隔が, 第2引数にユーザがSDL_AddTimer()で設定したパラメータが渡される. コールバック関数は次のタイマ間隔を戻す必要がある. 0を戻すとタイマはキャンセルされる.
コールバック関数は別スレッドで実行される. メインスレッドでタイマコールバックを処理する方法が必要ならばサンプルコードを参照すること.
タイマはコールバックを実行するのにかかった時間を考慮している. 例えば, コールバックの実行に250ミリ秒かかり, 1000(ミリ秒)を戻すと, タイマは次の呼び出しまで750ミリ秒しか待たない.
間隔はOSスケジューリングで不正確になりうる. コールバック内で不正確さを補正する必要がある場合, SDL_GetTicks()またはSDL_GetPerformanceCounter()を使って現在の時刻に注目する必要がある.