目次 - API(機能別) - タイマ - SDL_AddTimer

SDL_AddTimer

指定のミリ秒が経過した後に別スレッドのコールバック関数を呼ぶように設定する

構文

SDL_TimerID SDL_AddTimer(Uint32 interval, SDL_TimerCallback callback, void* param)

引数

intervalcallbackを呼ぶまでの時間(ミリ秒)
callback指定のintervalが経過した後に呼ばれる関数
paramcallbackに渡されるポインタ

戻り値

成功のときタイマID, 失敗のとき0を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

この関数を使う場合, SDL_Init()にSDL_INIT_TIMERを渡している必要がある.

コールバック関数は, 第1引数にSDL_AddTimer()で設定したintervalを, 第2引数にparamを取る. そして, 戻り値(Uint32)は次に呼ぶまでの時間(ミリ秒)である. コールバック関数が0を戻すと, タイマはキャンセルされる.

コールバック関数は別スレッドで実行される. メインスレッドでタイマコールバックを処理する方法が必要ならばサンプルコードを参照すること.

関連項目(関数)

SDL_RemoveTimer

SDL Wikiへのリンク

SDL_AddTimer - SDL Wiki