Touch input
- ALLEGRO_TOUCH_INPUT
- ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT
- ALLEGRO_TOUCH_STATE
- ALLEGRO_TOUCH_INPUT_STATE
- ALLEGRO_MOUSE_EMULATION_MODE
- al_install_touch_input
- al_uninstall_touch_input
- al_is_touch_input_installed
- al_get_touch_input_state
- al_set_mouse_emulation_mode
- al_get_mouse_emulation_mode
- al_get_touch_input_event_source
- al_get_touch_input_mouse_emulation_event_source
These functions are declared in the main Allegro header file:
#include <allegro5/allegro.h>ALLEGRO_TOUCH_INPUT
typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT;An abstract data type representing a physical touch screen or touch pad.
Since: 5.1.0
ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT
#define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT 16The maximum amount of simultaneous touches that can be detected.
Since: 5.1.0
ALLEGRO_TOUCH_STATE
typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE;This is a structure that is used to hold a "snapshot" of a touch at a particular instant.
Public fields (read only):
- id - identifier of the touch. If the touch is valid, this is positive.
- x - touch x position
- y - touch y position
- dx - touch relative x position
- dy - touch relative y position
- primary - TRUE if this touch is the primary one (usually the first one).
- display - The ALLEGRO_DISPLAY that was touched.
Since: 5.1.0
ALLEGRO_TOUCH_INPUT_STATE
typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE;This is a structure that holds a snapshot of all simultaneous touches at a particular instant.
Public fields (read only):
- touches - an array of ALLEGRO_TOUCH_STATE
Since: 5.1.0
ALLEGRO_MOUSE_EMULATION_MODE
typedef enum ALLEGRO_MOUSE_EMULATION_MODEType of mouse emulation to apply.
- ALLEGRO_MOUSE_EMULATION_NONE
Disables mouse emulation.
- ALLEGRO_MOUSE_EMULATION_TRANSPARENT
Enables transparent mouse emulation.
- ALLEGRO_MOUSE_EMULATION_INCLUSIVE
Enable inclusive mouse emulation.
- ALLEGRO_MOUSE_EMULATION_EXCLUSIVE
Enables exclusive mouse emulation.
- ALLEGRO_MOUSE_EMULATION_5_0_x
Enables mouse emulation that is backwards compatible with Allegro 5.0.x.
Since: 5.1.0
Unstable API: Seems of limited value, as touch input tends to have different semantics compared to mouse input.
al_install_touch_input
bool al_install_touch_input(void)Install a touch input driver, returning true if successful. If a touch input driver was already installed, returns true immediately.
Since: 5.1.0
See also: al_uninstall_touch_input
al_uninstall_touch_input
void al_uninstall_touch_input(void)Uninstalls the active touch input driver. If no touch input driver was active, this function does nothing.
This function is automatically called when Allegro is shut down.
Since: 5.1.0
See also: al_install_touch_input
al_is_touch_input_installed
bool al_is_touch_input_installed(void)Returns true if al_install_touch_input was called successfully.
Since: 5.1.0
al_get_touch_input_state
void al_get_touch_input_state(ALLEGRO_TOUCH_INPUT_STATE *ret_state)Gets the current touch input state. The touch information is copied into the ALLEGRO_TOUCH_INPUT_STATE you provide to this function.
Since: 5.1.0
al_set_mouse_emulation_mode
void al_set_mouse_emulation_mode(int mode)Sets the kind of mouse emulation for the touch input subsystem to perform.
Since: 5.1.0
Unstable API: Seems of limited value, as touch input tends to have different semantics compared to mouse input.
See also: ALLEGRO_MOUSE_EMULATION_MODE, al_get_mouse_emulation_mode.
al_get_mouse_emulation_mode
int al_get_mouse_emulation_mode(void)Returns the kind of mouse emulation which the touch input subsystem is set to perform.
Since: 5.1.0
Unstable API: Seems of limited value, as touch input tends to have different semantics compared to mouse input.
See also: ALLEGRO_MOUSE_EMULATION_MODE, al_set_mouse_emulation_mode.
al_get_touch_input_event_source
ALLEGRO_EVENT_SOURCE *al_get_touch_input_event_source(void)Returns the global touch input event source. This event source generates touch input events.
Since: 5.1.0
See also: ALLEGRO_EVENT_SOURCE, al_register_event_source
al_get_touch_input_mouse_emulation_event_source
ALLEGRO_EVENT_SOURCE *al_get_touch_input_mouse_emulation_event_source(void)Returns the global touch input event source for emulated mouse events. This event source generates emulated mouse events that are based on touch events.
See also: ALLEGRO_EVENT_SOURCE, al_register_event_source
Since: 5.1.0
Unstable API: Seems of limited value, as touch input tends to have different semantics compared to mouse input.