SDL_Event

ヘッダ

フィールド

詳細

SDL_Eventは全てのSDLイベント処理の中核で, SDLで使われる全てのイベント構造体の共用体である.

バージョン

イベントの使用法

• キューからイベントを読み込む
• キューにイベントを書き込む

キューからイベントを読み込む

SDL_PollEvent()またはSDL_PeepEvents()でキューからイベントを得られる. SDL_PollEvent()を例に説明する.

まず始めに, 空のSDL_Eventを生成する.

SDL_Event test_event;

SDL_PollEvent()はイベントを読み込み, キューから削除する. もしキューにイベントがなければ0を, あれば1を戻す. whileループを使い, 全てのイベントを処理する.

while (SDL_PollEvent(&test_event)) {

SDL_PollEvent()は引数のSDL_Eventへのポインタにイベント情報を代入する. SDL_PollEvent()はイベントをキューから取り除き, その後test_eventに書き込む. しかし, test_eventのtypeメンバにはイベントの種類も書き込まれている. よって, 種類に応じてイベントを処理するためにはswitch文を使う.

switch (test_event.type) {

得られたイベントが何であるか, そしてそのイベントの種類は何であるかを知る必要がある. ここでは, アプリケーションでユーザがマウスを動かしたことを検知したいと想定する. イベント種類を見渡すと, SDL_EVENT_MOUSE_MOTIONに気がつく. これが探しているイベントだろう. 後の表を見ると, SDL_EVENT_MOUSE_MOTIONイベントはSDL_EventのメンバのSDL_MouseMotionEventで処理することが分かる. SDL_EVENT_MOUSE_MOTIONのイベントの種類はswitch文の内部で次のようにチェックできる.

	case SDL_EVENT_MOUSE_MOTION:

test_eventのmotionメンバの情報を全て表示したいとすると

		SDL_Log("マウス移動イベントを得た.¥n");
		SDL_Log("現在の位置は(%f, %f)¥n", test_event.motion.x, test_event.motion.y);
		break;
	default:
		SDL_Log("処理されないイベント!¥n");
		break;
	}
}
printf("イベントキューは空.¥n");

キューにイベントを書き込む

SDL_Event user_event;
SDL_zero(user_event);  /* SDLはこの構造体全体をコピーする. メモリチェッカーが機嫌よくふるまうように初期化する */
user_event.type = SDL_EVENT_USER;
user_event.user.code = 2;
user_event.user.data1 = NULL;
user_event.user.data2 = NULL;
SDL_PushEvent(&user_event);

SDL_EVENT_USERはSDLが使用しないイベント番号の先頭に過ぎないので注意すること. アプリケーションの他の部分でも使用されないユニークな番号を得るにはSDL_RegisterEventsを使う必要がある.

イベントの種類と共用体のメンバの関係

SDL Wikiへのリンク