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.

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:

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.

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.

PreviousColores NextLoops (bucles)

Last updated 2 years ago

Key

Event

Key

Event

Key

Event

Mask

Description

Mask

Description

Hooking event

code

Prototype

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);

#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); }