04. Zdarzenia

[lekcja]

Zdarzenia (ang. events) są to komunikaty informujące program o tym, że użytkownik wykonał jakąś
akcję lub że w oknie aplikacji zaszła określona zmiana. Przykładem zdarzenia może być naciśnięcie klawisza,
kliknięcie przyciskiem myszy lub zamknięcie okna.

Poniżej przedstawiam kod programu, który reaguje na zamknięcie okna. Jak zapewne zauważyłeś w poprzednich przykładach,
okno można było zamknąć jedynie poprzez zatrzymanie programu w środowisku programistycznym.
Teraz dodajemy obsługę zdarzenia zamknięcia okna, dzięki czemu po kliknięciu przycisku X aplikacja zostanie poprawnie zamknięta.
Dodatkowo system operacyjny rozpoznaje, że okno prawidłowo obsługuje komunikaty, dlatego kursor myszy nie zmienia się już
na ikonę informującą o braku odpowiedzi programu.

#include <SFML/Graphics.hpp>

int main() {
sf::RenderWindow window = sf::RenderWindow( sf::VideoMode( sf::Vector2u( 800u, 600u ) ), "Hello SFML 3.0" );

while( window.isOpen() ) {

while( const std::optional event = window.pollEvent() ) {
if( event->is < sf::Event::Closed >() )
window.close();

}

window.clear( sf::Color::Black ); // wyczyść ekran czarnym kolorem
// cokolwiek do narysowania
window.display(); // wyświetl
}
}

W bibliotece SFML wszystkie zdarzenia są przechowywane w kolejce zdarzeń.
Funkcja

window.pollEvent()

pobiera kolejne zdarzenia z tej kolejki aż do momentu, gdy będzie ona pusta.
Następnie możemy sprawdzić typ zdarzenia i odpowiednio na nie zareagować.

Poniżej przedstawiam kilka podstawowych zdarzeń związanych z obsługą myszy.
Program będzie wypisywał informacje o naciśnięciu przycisku myszy, zwolnieniu przycisku oraz ruchu kursora.

W podobny sposób można obsługiwać zdarzenia związane z klawiaturą.
SFML udostępnia zdarzenie

sf::Event::KeyPressed()

, które jest generowane w momencie naciśnięcia klawisza.
Po pobraniu zdarzenia za pomocą funkcji

getIf < sf::Event::KeyPressed >()

możemy sprawdzić,
który klawisz został naciśnięty, porównując jego kod z wartościami z wyliczenia

sf::Keyboard::Key

.

W poniższym przykładzie program reaguje na naciśnięcie klawiszy W, A, S, D oraz klawiszy kierunkowych.
Po wykryciu odpowiedniego zdarzenia informacja jest wypisywana do konsoli.
W praktycznych zastosowaniach w miejscu funkcji

std::cout

można umieścić dowolną logikę programu,
na przykład sterowanie postacią, przewijanie kamery lub wywoływanie określonych funkcji.

Warto pamiętać, że zdarzenie

sf::Event::KeyPressed

jest wywoływane tylko w momencie naciśnięcia klawisza.
Jeżeli chcemy sprawdzać, czy klawisz jest aktualnie przytrzymywany, należy skorzystać z mechanizmu odpytywania stanu klawiatury,
który poznamy w dalszej części poradnika.

#include <SFML/Graphics.hpp>
#include <iostream>

int main() {
sf::RenderWindow window = sf::RenderWindow( sf::VideoMode( sf::Vector2u( 800u, 600u ) ), "Hello SFML 3.0" );

while( window.isOpen() ) {

while( const std::optional event = window.pollEvent() ) {

if( event->is < sf::Event::Closed >() )
window.close();

// Klwisze WASD
if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::W ) {
std::cout << "Naciśnięto klawisz W" << std::endl;
}

if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::A ) {
std::cout << "Naciśnięto klawisz A" << std::endl;
}

if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::S ) {
std::cout << "Naciśnięto klawisz S" << std::endl;
}

if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::D ) {
std::cout << "Naciśnięto klawisz D" << std::endl;
}

// Klawisze kierunkowe
if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::Up ) {
std::cout << "Naciśnięto klawisz ze strzałką w górę" << std::endl;
}

if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::Left ) {
std::cout << "Naciśnięto klawisz ze strzałką w lewo" << std::endl;
}

if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::Down ) {
std::cout << "Naciśnięto klawisz ze strzałką w dół" << std::endl;
}

if( const auto * kp = event->getIf < sf::Event::KeyPressed >(); kp && kp->code == sf::Keyboard::Key::Right ) {
std::cout << "Naciśnięto klawisz ze strzałką w prawo" << std::endl;
}

}

// rysowanie
window.clear( sf::Color::Black ); // wyczyść ekran i wypełnij czarnym kolorem
// cokolwiek do narysowania
window.display(); // wyświetl
}

return 0;
}

Można również sprawdzać moment zwolnienia klawisza za pomocą zdarzenia

sf::Event::KeyReleased

.
Jest to przydatne w sytuacjach, gdy akcja powinna zostać wykonana dopiero po puszczeniu klawisza, a nie w chwili jego naciśnięcia.

Obsługa zdarzenia

sf::Event::KeyPressed

jest wykorzystywana na przykład podczas implementacji
obsługi skrótów klawiszowych, takich jak Ctrl+C, Ctrl+X, Ctrl+V. Program może sprawdzić, czy w momencie
naciśnięcia klawisza C, X lub V wciśnięty jest również klawisz Ctrl, a następnie wykonać
odpowiednią operację kopiowania, wycinania lub wklejania. Dzięki temu użytkownik może wygodnie korzystać ze standardowych skrótów
klawiaturowych znanych z większości aplikacji.

Oczywiście, podobnie jak w przypadku zdarzeń związanych z myszą, również dla klawiatury można obsługiwać
zdarzenie zwolnienia klawisza za pomocą funkcji

event->getIf < sf::Event::KeyReleased >()

.
Dzięki temu program może reagować nie tylko na moment naciśnięcia klawisza, ale również na jego puszczenie.

Poprzedni dokument	Następny dokument
03. Prymitywy czyli Podstawowe kształty w SFML	05. Bezpośredni Dostęp do Klawiatury i Myszy

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.