Struktura SDL_Event posiada dwa zastosowania:

• Odczytywanie zdarzeń z kolejki zdarzeń.
• Umieszczanie zdarzeń w kolejce zdarzeń.

Odczytywanie zdarzeń z kolejki zdarzeń

Dokonywane jest to albo za pomocą SDL_PollEvent(), albo SDL_PeepEvents(). Użyjemy SDL_PollEvent() i przejdziemy krok po kroku przez przykład.

Najpierw tworzymy pustą strukturę SDL_Event.

SDL_Event test_event; 

SDL_PollEvent() usuwa kolejne zdarzenie z kolejki zdarzeń. Jeśli w kolejce nie ma zdarzeń, zwraca 0, w przeciwnym razie zwraca 1. Do przetwarzania zdarzeń po kolei używamy pętli while.

while (SDL_PollEvent(&test_event)) { 

Funkcja SDL_PollEvent() przyjmuje jako parametr wskaźnik do struktury SDL_Event, która ma zostać wypełniona informacjami o zdarzeniu. Wiemy, że przy usunięciu przez SDL_PollEvent() zdarzenia z kolejki, informacja o nim zostanie umieszczona w naszej strukturze test_event, wiemy również, że rodzaj zdarzenia zostanie umieszczony w polu type struktury test_event. Zatem do osobnej obsługi każdego zdarzenia, stosujemy polecenie switch.

switch (test_event.type) { 

Musimy wiedzieć, jakiego rodzaju zdarzeń poszukujemy oraz musimy znać ich typ. Zatem załóżmy, że chcemy wykryć, gdzie użytkownik przesunął kursor myszki w aplikacji. Przeglądamy typy zdarzeń i zauważamy, że SDL_MOUSEMOTION jest prawdopodobnie tym zdarzeniem, którego szukamy. Spojrzenie na tabelę poniżej mówi nam, że zdarzenia SDL_MOUSEMOTION są obsługiwane wewnątrz struktury SDL_MouseMotionEvent, która należy do unii SDL_Event. Możemy sprawdzić wystąpienie zdarzenia typu SDL_MOUSEMOTION wewnątrz polecenia switch w sposób następujący:

case SDL_MOUSEMOTION:  

Teraz wystarczy nam odczytać informację z pola motion struktury test_event.

      printf("We got a motion event.\n");
      printf("Current mouse position is: (%d, %d)\n", test_event.motion.x, test_event.motion.y);
      break;
    default:
      printf("Unhandled Event!\n");
      break;
  }
}
printf("Event queue empty.\n");

Umieszczanie zdarzeń w kolejce zdarzeń

Możliwe jest również wstawianie zdarzeń do kolejki zdarzeń i wykorzystywanie jej w ten sposób do obustronnej komunikacji. Obie funkcje SDL_PushEvent() i SDL_PeepEvents() pozwalają ci na umieszczanie zdarzeń w kolejce. Zwykle używa się ich ze zdarzeniem SDL_USEREVENT, jednakże możesz również wstawiać fałszywe zdarzenia, jeśli chcesz. Tworzenie własnych zdarzeń polega po prostu na wybraniu pożądanego rodzaju zdarzenia, ustawieniu pola type oraz wypełnienia odpowiednich pól struktury informacjami.

SDL_Event user_event;

user_event.type = SDL_USEREVENT;
user_event.user.code = 2;
user_event.user.data1 = NULL;
user_event.user.data2 = NULL;
SDL_PushEvent(&user_event);

Związek pomiędzy rodzajami zdarzeń a polami unii