Eventos

Los eventos son la base para escribir aplicaciones interactivas en MiniLibX. Todos los hooks en MiniLibX no son más que una función que se llama cada vez que se dispara un evento. Dominar todos estos eventos no será necesario, sin embargo, repasaremos rápidamente cada uno de los eventos de X11.

Tanto X-Window como MacOSX son sistemas gráficos bidireccionales. Por un lado, el programa envía órdenes a la pantalla para mostrar píxeles, imágenes, etc. Por otro lado, puede obtener información del teclado y del ratón asociada a la pantalla. Para ello, el programa recibe "eventos" del teclado o del ratón.

Interfaz X11

X11 es la biblioteca que se utiliza junto a MiniLibX. Por lo tanto, no es un secreto que esta cabecera es muy útil para encontrar todos los eventos correspondientes de MiniLibX. Para poder utilizar estos eventos y mascaras es necesaria la siguiente libreria: 

#include <X11/X.h>

En MacOS - Cocoa (AppKit) y OpenGL - versión, minilibx tiene soporte parcial de eventos X11 y no soporta la máscara X11 (el argumento x_mask de mlx_hook es inútil, manténgalo en 0).

Eventos del X1

Hay una serie de eventos que se pueden describir.

Key
Event
Key
Event
Key
Event

02

KeyPress

14

NoExpose

26

CirculateNotify

03

KeyRelease

15

VisibilityNotify

27

CirculateRequest

04

ButtonPress

16

CreateNotify

28

PropertyNotify

05

ButtonRelease

17

DestroyNotify

29

SelectionClear

06

MotionNotify

18

UnmapNotify

30

SelectionRequest

07

EnterNotify

19

MapNotify

31

SelectionNotify

08

LeaveNotify

20

MapRequest

32

ColormapNotify

09

FocusIn

21

ReparentNotify

33

ClientMessage

10

FocusOut

22

ConfigureNotify

34

MappingNotify

11

KeymapNotify

23

ConfigureRequest

35

GenericEvent

12

Expose

24

GravityNotify

36

LASTEvent

13

GraphicsExpose

25

ResizeRequest

Mascaras X11

Cada evento X11, también tiene una máscara correspondiente. De este modo, puedes registrar sólo una tecla cuando se dispara, o todas las teclas si dejas tu máscara por defecto. Las máscaras de teclas, por lo tanto, le permiten poner en una lista blanca o negra los eventos de sus suscripciones a eventos. Se permiten las siguientes máscaras:

Mask
Description
Mask
Description

0L

NoEventMask

(1L<<12)

Button5MotionMask

(1L<<0)

KeyPressMask

(1L<<13)

ButtonMotionMask

(1L<<1)

KeyReleaseMask

(1L<<14)

KeymapStateMask

(1L<<2)

ButtonPressMask

(1L<<15)

ExposureMask

(1L<<3)

ButtonReleaseMask

(1L<<16)

VisibilityChangeMask

(1L<<4)

EnterWindowMask

(1L<<17)

StructureNotifyMask

(1L<<5)

LeaveWindowMask

(1L<<18)

ResizeRedirectMask

(1L<<6)

PointerMotionMask

(1L<<19)

SubstructureNotifyMask

(1L<<7)

PointerMotionHintMask

(1L<<20)

SubstructureRedirectMask

(1L<<8)

Button1MotionMask

(1L<<21)

FocusChangeMask

(1L<<9)

Button2MotionMask

(1L<<22)

PropertyChangeMask

(1L<<10)

Button3MotionMask

(1L<<23)

ColormapChangeMask

(1L<<11)

Button4MotionMask

(1L<<24)

OwnerGrabButtonMask

AppleScript key codes

Todo accion realizada a traves del teclado o el mouse tiene un numero de referencia, de esta manera mediante los eventos que nos facilita MiniLibX podremos saber en todo momento que informacion no esta enviando el usuario de nuestro programa. Para asi si lo deseasmos estabelcerle a ciertas acciones una funcion o accion corespondiente.

La key codes del teclado de mac son las siguientes:

Tipos de eventos

Para que podamos registrar eventos, el minilibx nos proporciona un conjunto de funciones llamadas hooks que podremos utilizar para registrar eventos antes de que se llame a mlx_loop. Esta funcion deja el programa en un bucle infinito, para asi poder recibir los datos de entrada a traves del teclado y asi ejecutar las funciones correspodientes.

int    mlx_loop ( void *mlx_ptr );

mlx_hook

El estar a la escucha de eventos es una de las herramientas más potentes que proporciona MiniLibX. Permite registrarse a cualquiera de los eventos mencionados con la llamada de una simple función de registro de eventos.

Para ello, llamamos a la función mlx_hook.

void mlx_hook(mlx_win_list_t *win_ptr, int x_event, int x_mask, int (*f)(), void *param)

Alguna versión de mlbx no implementa x_mask y sea cual sea el valor no habrá máscara.

Prototipo de las funciones de evento

Las funciones de evento tienen un prototipo diferente dependiendo del evento de enganche.

Hooking event
code
Prototype

ON_KEYDOWN

2

int (*f)(int keycode, void *param)

ON_KEYUP*

3

int (*f)(int keycode, void *param)

ON_MOUSEDOWN*

4

int (*f)(int button, int x, int y, void *param)

ON_MOUSEUP

5

int (*f)(int button, int x, int y, void *param)

ON_MOUSEMOVE

6

int (*f)(int x, int y, void *param)

ON_EXPOSE*

12

int (*f)(void *param)

ON_DESTROY

17

int (*f)(void *param)

El prototipo hacer referencia al prototipo de la funcion que le pasamos como parametro ( int *f() ) a mlx_hook o a cualquiera de sus alias.

Alias para registro de eventos

Para facilitar el trabajo Minilibx tiene algunas funciones que realizan el mismo trabajo que mlx_hook con ciertos parametros:

  • mlx_expose_hook Una parte de la ventana debe ser redibujada (esto se llama un evento de "exposición", y es su programa manejarlo). Evento (12).

  • mlx_key_hook Una tecla es presionada. Evento (3).

  • mlx_mouse_hook Se pulsa el botón del ratón. Evento (4)

int	mlx_mouse_hook (void *win_ptr, int (*funct_ptr)(), void *param);
int	mlx_key_hook (void *win_ptr, int (*funct_ptr)(), void *param);
int	mlx_expose_hook (void *win_ptr, int (*funct_ptr)(), void *param);

mlx_key_hook

mlx_key_hook registra cada tecla que pulsemos y enviara como parametros a la funcion que le hayamos especifciado *funct_ptr)() el numero correspondiente de cada tecla. Para poder acceder a este valor lo haremos mediante el argumento keycode de la fucnion *fuct_ptr().

mlx_key_hook se acciona al soltar la tecla pulsada, mientras este pulsada no se activara el evento.

Este es uno entre los dos argumentos que tendremos que declarar a la funcion que utilicemos para pasar como parametro a mlx_key_hook. El otro es void *param que sirve para pasar como parametro la estrcutura que hayameos creado para guardar las vairables de mlx. Este parametro luego habra que castearlo.

int    funct_ptr(int keycode, void *param);

mlx_mouse_hook

Con respecto a los eventos de raton cada accion qque podenmos ralizar con el raton tambien tiene un numero asginado:

Keycode del ratón para MacOS:

  • Left click: 1

  • Right click: 2

  • Middle click: 3

  • Scroll up: 4

  • Scroll down : 5

Ejemplo

#include <mlx.h>
#include <stdio.h>

typedef struct	s_vars {
	void	*mlx;
	void	*win;
}				t_vars;

int	key_hook(int keycode, t_vars *vars)
{
	printf("The key pressed is: %d\n", keycode);
	return (0);
}

int	main(void)
{
	t_vars	vars;

	vars.mlx = mlx_init();
	vars.win = mlx_new_window(vars.mlx, 640, 480, "Hello world!");
	mlx_key_hook(vars.win, key_hook, &vars);
	mlx_loop(vars.mlx);
}

Esta funcion escribira en pantalla el keycode de cada teclas pulsada por el usuario en el a traves del teclado.

PreviousColoresNextLoops (bucles)

Last updated