Grafika komputerowa: SDL

Użyj tej funkcji, aby pobrać z kolejki zdarzeń oczekujące tam zdarzenie.

Składnia

int SDL_PollEvent(SDL_Event* event)

Parametry funkcji

event

struktura SDL_Event do wypełnienia zdarzeniem pobranym z kolejki lub NULL

Wartość zwracana

Zwraca 1, jeśli zostało pobrane zdarzenie z kolejki do struktury event, lub 0, jeśli kolejka zdarzeń była pusta.

Przykładowy kod

while (1) // Pętla nieskończona
{
    SDL_Event event;
    while (SDL_PollEvent(&event))
    {
        /* tutaj obsłuż pobrane zdarzenie */
    }
    /* tutaj zrób coś innego - narysuj coś, itp. */
}

Uwagi

Jeśli parametr event jest różny od NULL, to z kolejki zostanie pobrane i usunięte następne oczekujące tam zdarzenie, po czym zdarzenie będzie umieszczone w strukturze wskazanej przez event.

Jeśli parametr event ma wartość NULL, to po prostu funkcja zwróci 1, jeśli w kolejce zdarzeń oczekuje zdarzenie, lecz nie usunie go z tej kolejki. Jeśli kolejka będzie pusta, to funkcja zwróci 0.

Ponieważ funkcja ta niejawnie wywołuje SDL_PumpEvents(), możesz ją wywołać tylko w wątku, który ustawił tryb wyświetlania.

SDL_PollEvent() jest ulubionym sposobem otrzymywania zdarzeń systemowych, ponieważ można to zrobić z pętli głównej bez zawieszania jej działania podczas oczekiwania na wysłanie zdarzenia.

Powiązane funkcje

SDL_GetEventFilter
SDL_PeepEvents
SDL_PushEvent
SDL_SetEventFilter
SDL_WaitEvent
SDL_WaitEventTimeout

SDL2