Curso de introducción a videojuegos multiplataforma con SDL

Curso de introducción a videojuegos multiplataforma con SDL
Curso de introducción a videojuegos
multiplataforma con SDL
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
Subsistema de Eventos
Bruno González y Pablo Orduña
-aka StenyaK y NcTrunstenyak@gmx.net
- pablo@ordunya.com
http://kwh.iespana.es
Julio 2004 – e-ghost
ESIDE – Universidad de Deusto
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License. To view a copy of this license, visit
http://creativecommons.org/licenses/by-nc-sa/2.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
Introducción
● La SDL nos proporciona un subsistema
de eventos
– Con él, podremos manejar con facilidad el
ratón y teclado (entre otros)
● Este subsistema se inicializa de manera
automática con la inicialización de la
librería
– SDL_Init(); //no hace falta ningún flag
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
Eventos - I
● Como dijimos en la introducción, el
subsistema de Joystick (y trackball...) es
independiente
– Tiene sus propias funciones independientes
– Sin embargo, la gestión de los eventos
producidos puede ser incluida en este
subsistema
● También manejaremos los eventos
producidos por el gestor de ventanas
● También manejaremos “eventos
especiales”
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
Eventos - II
● Un “evento” será un SDL_Event
– Este tipo es una unión que tendrá:
● Un dato “Uint8 type”, que nos indicará el tipo
de evento
● Uno de los posibles tipos de datos de
diferentes eventos (SDL_KeyboardEvent,
SDL_MouseMotionEvent...)
– Es una unión, por lo que sólo se almacena
uno de los datos.
● Pero todos los posibles tipos de datos de
diferentes eventos tienen como primer dato un
“Uint8” -> con ev.type sabemos el tipo.
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
Eventos - III
Definición de SDL_Event:
typedef union{
Uint8 type;
SDL_ActiveEvent active;
SDL_KeyboardEvent key;
SDL_MouseMotionEvent motion;
SDL_MouseButtonEvent button;
SDL_JoyAxisEvent jaxis;
SDL_JoyBallEvent jball;
SDL_JoyHatEvent jhat;
SDL_JoyButtonEvent jbutton;
SDL_ResizeEvent resize;
SDL_ExposeEvent expose;
SDL_QuitEvent quit;
SDL_UserEvent user;
SDL_SywWMEvent syswm;
} SDL_Event;
(Explicamos más adelante cada punto)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Tipos de eventos – teclado - I
● De teclado (SDL_KeyboardEvent)
– Tiene 3 datos:
1)Uint8 type: SDL_KEYDOWN o SDL_KEYUP (si
ha pulsado o soltado una tecla)
2)Uint8 state: SDL_PRESSED o
SDL_RELEASED (redundante)
3)SDL_keysym keysym: Con lo que sabemos qué
tecla concreta ha pulsado
– Tiene 4 datos:
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
1)Uint8 scancode: código específico del hardware
2)SDLKey sym: tecla pulsada
3)SDLMod mod: modificadores pulsados (shift...)
4)Uint16 unicode: el carácter UNICODE
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Tipos de eventos – teclado - II
Ejemplo:
void procesaEvento(const SDL_Event& evento)
{
switch(evento.type){
case SDL_KEYDOWN:
if(evento.key.keysym.sym == SDL_K_a
&& evento.key.keysym.mod & SDL_RCTRL)
std::cout

Curso de introducción a videojuegos multiplataforma con SDL
Tipos de eventos – teclado -
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
III
● Como vemos, los valores de sym son
constantes tipo SDLK_a, o
SDLK_LEFT...
● En el campo mod, se pueden poner
varios a la vez mediante ORs
● Adjuntamos “cod_teclas.html” con
todos los códigos
● Para hacer uso de caracteres Unicode,
hay que especificarlo previamente
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Tipos de eventos – ratón - I
● Para controlar el ratón hay dos tipos de
eventos:
– SDL_MouseMotionEvent
● Se activa al mover el ratón
● Datos:
– Uint8 type (siempre SDL_MouseMotionEvent)
– Uint8 state (estado de las teclas)
● Es igual que el estado en SDL_MouseButtonEvent,
que se explica en la siguiente transparencia
– Uint16 x,y (posición actual del cursor)
– Uint16 xrel, yrel (movimiento del ratón)
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Tipos de eventos – ratón - II
– SDL_MouseButtonEvent
● Se activa cuando se pulsa una tecla del ratón
● Datos:
– Uint8 type (siempre SDL_MouseButtonEvent)
– Uint8 button (qué botón ha provocado el evento)
● Una OR de:
● SDL_BUTTON_LEFT
● SDL_BUTTON_RIGHT
● SDL_BUTTON_MIDDLE
– Uint8 state (si se ha pulsado o se ha soltado)
● SDL_PRESSED o SDL_RELEASED
– Uint16 x,y (en qué posición está el ratón)
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Tipos de eventos – ratón - III
Ejemplo:
void procesarEvento(const SDL_Event& evento){
switch(evento.type){
case SDL_MouseMotionEvent:
std::cout

Curso de introducción a videojuegos multiplataforma con SDL
Cola de eventos - I
● El Sistema Operativo almacena una
serie de eventos dirigidos a nuestro
programa
● La SDL cuenta con una cola interna
para almacenarlos
● Cada cierto tiempo, nosotros pediremos
a la SDL que actualice su cola con lo
que haya ocurrido desde la última
actualización
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Cola de eventos - II
● Para acceder a la cola de eventos, lo
que haremos será:
– Actualizarla con respecto al SO
– Ir tomando eventos de la cola
● Para actualizarla, haremos una llamada
simple a:
– void SDL_PumpEvents();
– No se suele hacer, porque su función está
contenida implícitamente en otras
funciones.
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Cola de eventos - III
● Para tomar el primer evento de la cola,
se llama a la función:
– int SDL_PollEvent(SDL_Event *ev);
● Esta función llama primero a
SDL_PumpEvents
● Si ev es distinto de 0, almacena en su
dirección el primer evento que haya en cola, y
lo elimina de la misma.
● Si ev es igual a 0, ni almacena ni elimina dicho
evento
● Devolverá 1 si hay eventos pendientes en la
cola, y 0 en caso contrario
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Ejemplo:
Cola de eventos - IV
void actualizarPosicion(void)
{
SDL_Event evento;
while(SDL_PollEvent(&evento))
procesarEvento(evento);
}
● Con esto procesamos todos los eventos
que haya en cola hasta haber procesado
todos los que se han dado mientras
haciámos otra cosa
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Otro ejemplo:
Cola de eventos - V
void hazAlgo()
{
bool fin = false;
while (!fin){
SDL_Event evento;
SDL_PollEvent(&evento);
switch(evento.type){
case SDL_KEYDOWN:
if (evento.key.keysym.sym == SDLK_ESCAPE)
fin = true;
if(evento.key.keysym.sym == SDLK_a)
std::cout

Curso de introducción a videojuegos multiplataforma con SDL
Cola de eventos - VI
● Pero este código no mola mucho:
– Hay un bucle que termina cuando pulsas la
tecla q, y que muestra un mensaje cuando
pulsas la tecla a
– El tema está en que en este caso concreto
(al igual que por ejemplo en juegos por
turnos), te interesa simplemente “esperar”
a que haya un evento, y no tienes por qué
desperdiciar tanta CPU como estamos
haciendo en el ejemplo
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Cola de eventos - VII
● Soluciones:
– int SDL_WaitEvent(SDL_Event *ev);
● Simplemente, espera a q haya algo en la cola y
no hace nada mientras (sólo útil a veces)
● Al igual que SDL_PollEvent, si su parámetro es
distinto de cero se almacena el evento y se
borra de la cola, y si es cero, no se almacena
ni se borra.
– void SDL_Delay(Uint32 ms);
● Espera los milisegundos que se le pasa como
parámetro
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Utilizando los eventos - I
● Un evento sólo se produce cuando algo
cambia
● Pulsar una tecla y mantenerla produce
únicamente 1 evento al pulsarla y otro
cuando se deje de pulsar
● Por tanto en principio se debe hacer
uso de flags o variables de velocidad
para que, al mantener una tecla
pulsada, siga manteniéndose una
acción (pulsar izqda y q siga
moviéndose)
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Utilizando los eventos - II
● Aunque lo anterior sea lo más usado al
ser lo más cómodo, existen dos
alternativas:
– int SDL_EnableKeyRepeat(int espera, int
intervalo)
● Si delay = 0, se deshabilita
● si delay != 0, a partir de “espera”
milisegundos, cada “intervalo” milisegundos,
se produce un nuevo evento de tipo
SDL_KEYDOWN sin necesidad de soltar y
volver a pulsar
● Con SDL_WaitEvent (SDL_PollEvent no
respeta los intervalos y esperas)
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Utilizando los eventos - III
– Uint8 *SDL_GetKeyState(int * numTeclas);
● Esta función devuelve el estado actual del
teclado.
● Devuelve un array de (*numTeclas) posiciones
● Las posiciones están indexadas por código de
la tecla (SDLK_a, etc)
● Una posición a 1 significa que está pulsada, a
0 significa que no
● Para ir actualizando este array, tendremos que
llamar a SDL_PumpEvents();
● IMPORTANTE: No liberar el valor devuelto
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Utilizando los eventos - IV
Ejemplo:
Uint8 * estadoTeclado = SDL_GetKeyState(0);
if (estadoTeclado[SDLK_a])
std::cout

Curso de introducción a videojuegos multiplataforma con SDL
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
Otros eventos
● Hasta ahora hemos visto eventos de
teclado y ratón, que son los más
utilizados
● Sin embargo, también pueden resultar
interesantes los eventos del gestor de
ventanas y del Joystick (este último no
vamos a verlo)
● También veremos los eventos que
nosotros provocaremos
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos del gestor de
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
ventanas - I
● Nuestro programa puede estar en:
– modo pantalla completa
– una ventana.
● En caso de estar en una ventana,
interactuará con el gestor de ventanas
con diferentes eventos, ya que puede:
– que el usuario decida cambiar el tamaño de
la ventana
– que el usuario decida cerrar la ventana
– que el usuario decida cambiar de ventana
– etc
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos del gestor de
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
ventanas - II
● Para que el usuario cambie el tamaño
de la ventana, debemos haber indicado
que queremos que pueda:
– Al llamar a SDL_SetVideoMode, tendremos
que haber pasado el flag SDL_RESIZABLE
● Al cambiar, producirá un SDL_Event
cuyo type será SDL_ResizeEvent, y
tendrá dos atributos w y h, que serán la
altura y anchura actualizados.
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos del gestor de
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
ventanas - III
● Si el usuario intenta cerrar la ventana:
– la SDL lo traduce a un SDL_Event cuyo
type es SDL_QUIT.
– Será un SDL_QuitEvent, pero no tendrá
ningún dato salvo el campo type
● La SDL también traduce a eventos el
que el ratón esté o no encima de la
ventana del programa, o que el usuario
esté mirando otra ventana.
– Para ello está el SDL_ActiveEvent
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos del gestor de
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
ventanas - IV
● El SDL_ActiveEvent tiene 3 datos:
– Uint8 type (siempre SDL_ACTIVEEVENT)
– Uint8 gain (1 = gana, 0 = pierde)
– Uint8 state (SDL_APPMOUSEFOCUS es si
el ratón apunta o no a la ventana,
SDL_APPINPUTFOCUS es si la ventana
activa es la de nuestro programa)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos generados por el
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
programador - I
● En determinados casos, puede sernos
de utilidad generar nosotros un evento
cuando ocurra algo, para que algo se
produzca.
● La forma más “lógica” de añadir un
evento a la cola es utilizando la función:
– int SDL_PushEvent(SDL_Event *ev);
● Primero definimos un evento, y luego
simplemente lo añadimos al final de la cola.
● Retorna 0 si ha podido o -1 si no.
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos generados por el
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
programador - II
● Otra forma de manejar la cola de
eventos es la función
– int SDL_PeepEvents(SDL_Event* evs, int
numEvs, SDL_eventaction ac,Uint32 masc);
● donde evs es un array de “SDL_Event”s
● numEvs es el número de eventos contenidos
en el array
● ac es un enumerado que puede ser:
– SDL_ADDEVENT: introducirá los eventos del array en
la cola
– SDL_PEEKEVENT: introducirá en el array numEvs
eventos, sin borrarlos de la cola de la SDL
– SDL_GETEVENT: lo anterior, pero borrándolos
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Eventos generados por el
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
programador - III
● masc es una especie de “filtro” para elegir
sólo unos determinados tipos de eventos
– se eligen con ORs, el resultado de la macro
SDL_EVENTMASK(tipoEvento);
● Por último, el introducir un evento de
ratón para posicionarlo en un sitio
concreto se facilita con la función:
– void SDL_WarpMouse(Uint16 x, Uint16 y);
● Introduce un evento con el que el ratón se
posiciona en la posición (x,y)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Filtrado de eventos - I
● Para terminar con el subsistema de
eventos, comentar que podemos aplicar
filtrados a los mismos
● En un juego, dependiendo del mismo,
nos interesará escuchar únicamente
eventos que cumplan unas condiciones
concretas.
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Filtrado de eventos - II
● Podemos definir una función tal que:
– int miFuncion(const SDL_Event * ev);
● que devuelva 1 cuando queramos que se
incluya en la cola
● que devuelva 0 cuando NO queremos que sea
incluida.
● Y luego establecerla como filtro con:
– void SDL_SetEventFilter(SDL_EventFilter filtro);
– typedef (*SDL_EventFilter)(const SDL_Event*ev);
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto

Curso de introducción a videojuegos multiplataforma con SDL
Filtrado de eventos - II
● De esta manera, podemos hacer algo tal
que:
int filtro(const SDL_Event*ev)
{
}
//...
return ev.type == SDL_KEYDOWN || ev.type == SDL_KEYUP;
SDL_SetFilter(filtro);
//...
– Puede resultarnos útil para asegurarnos que no
procesamos / almacenamos con PeepEvents
eventos que no sean otra cosa que teclado.
© 2004 – Bruno González (STenyaK)
Pablo Orduña (NcTrun)
e-ghost – ESIDE – Universidad de Deusto