/* RetroArch - A frontend for libretro. * Copyright (C) 2010-2014 - Hans-Kristian Arntzen * Copyright (C) 2011-2015 - Daniel De Matteis * * RetroArch is free software: you can redistribute it and/or modify it under the terms * of the GNU General Public License as published by the Free Software Found- * ation, either version 3 of the License, or (at your option) any later version. * * RetroArch is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along with RetroArch. * If not, see . */ #ifndef INPUT_OVERLAY_H__ #define INPUT_OVERLAY_H__ #include #include #include "../libretro.h" #include #include #include #ifdef __cplusplus extern "C" { #endif #define OVERLAY_GET_KEY(state, key) (((state)->keys[(key) / 32] >> ((key) % 32)) & 1) #define OVERLAY_SET_KEY(state, key) (state)->keys[(key) / 32] |= 1 << ((key) % 32) #define OVERLAY_CLEAR_KEY(state, key) (state)->keys[(key) / 32] &= ~(1 << ((key) % 32)) /* Overlay driver acts as a medium between input drivers * and video driver. * * Coordinates are fetched from input driver, and an * overlay with pressable actions are displayed on-screen. * * This interface requires that the video driver has support * for the overlay interface. */ typedef struct video_overlay_interface { void (*enable)(void *data, bool state); bool (*load)(void *data, const struct texture_image *images, unsigned num_images); void (*tex_geom)(void *data, unsigned image, float x, float y, float w, float h); void (*vertex_geom)(void *data, unsigned image, float x, float y, float w, float h); void (*full_screen)(void *data, bool enable); void (*set_alpha)(void *data, unsigned image, float mod); } video_overlay_interface_t; enum overlay_hitbox { OVERLAY_HITBOX_RADIAL = 0, OVERLAY_HITBOX_RECT }; enum overlay_type { OVERLAY_TYPE_BUTTONS = 0, OVERLAY_TYPE_ANALOG_LEFT, OVERLAY_TYPE_ANALOG_RIGHT, OVERLAY_TYPE_KEYBOARD }; enum overlay_status { OVERLAY_STATUS_NONE = 0, OVERLAY_STATUS_DEFERRED_LOAD, OVERLAY_STATUS_DEFERRED_LOADING_IMAGE, OVERLAY_STATUS_DEFERRED_LOADING_IMAGE_PROCESS, OVERLAY_STATUS_DEFERRED_LOADING, OVERLAY_STATUS_DEFERRED_LOADING_RESOLVE, OVERLAY_STATUS_DEFERRED_DONE, OVERLAY_STATUS_DEFERRED_ERROR, OVERLAY_STATUS_ALIVE, }; enum overlay_image_transfer_status { OVERLAY_IMAGE_TRANSFER_NONE = 0, OVERLAY_IMAGE_TRANSFER_BUSY, OVERLAY_IMAGE_TRANSFER_DONE, OVERLAY_IMAGE_TRANSFER_DESC_IMAGE_ITERATE, OVERLAY_IMAGE_TRANSFER_DESC_ITERATE, OVERLAY_IMAGE_TRANSFER_DESC_DONE, OVERLAY_IMAGE_TRANSFER_ERROR, }; struct overlay_desc { float x; float y; enum overlay_hitbox hitbox; float range_x, range_y; float range_x_mod, range_y_mod; float mod_x, mod_y, mod_w, mod_h; float delta_x, delta_y; enum overlay_type type; uint64_t key_mask; float analog_saturate_pct; unsigned next_index; char next_index_name[64]; struct texture_image image; unsigned image_index; float alpha_mod; float range_mod; bool updated; bool movable; }; struct overlay { struct overlay_desc *descs; size_t size; size_t pos; unsigned pos_increment; struct texture_image image; bool block_scale; float mod_x, mod_y, mod_w, mod_h; float x, y, w, h; float scale; float center_x, center_y; bool full_screen; char name[64]; struct { struct { char key[64]; char path[PATH_MAX_LENGTH]; } paths; struct { char key[64]; } names; struct { char array[256]; char key[64]; } rect; struct { char key[64]; unsigned size; } descs; bool normalized; float alpha_mod; float range_mod; } config; struct texture_image *load_images; unsigned load_images_size; }; struct input_overlay { void *iface_data; const video_overlay_interface_t *iface; bool enable; enum overlay_image_transfer_status loading_status; bool blocked; struct overlay *overlays; const struct overlay *active; size_t index; size_t size; unsigned pos; size_t resolve_pos; size_t pos_increment; unsigned next_index; char *overlay_path; config_file_t *conf; enum overlay_status state; struct { struct { unsigned size; } overlays; } config; struct { bool enable; float opacity; float scale_factor; } deferred; }; typedef struct input_overlay input_overlay_t; typedef struct input_overlay_state { /* This is a bitmask of (1 << key_bind_id). */ uint64_t buttons; /* Left X, Left Y, Right X, Right Y */ int16_t analog[4]; uint32_t keys[RETROK_LAST / 32 + 1]; } input_overlay_state_t; /** * input_overlay_new: * @path : Path to overlay file. * @enable : Enable the overlay after initializing it? * * Creates and initializes an overlay handle. * * Returns: Overlay handle on success, otherwise NULL. **/ input_overlay_t *input_overlay_new(const char *path, bool enable, float alpha_mod, float scale_factor); bool input_overlay_load_overlays(input_overlay_t *ol); bool input_overlay_load_overlays_image_iterate(input_overlay_t *ol); bool input_overlay_load_overlays_iterate(input_overlay_t *ol); bool input_overlay_load_overlays_resolve_iterate(input_overlay_t *ol); bool input_overlay_new_done(input_overlay_t *ol); /** * input_overlay_free: * @ol : Overlay handle. * * Frees overlay handle. **/ void input_overlay_free(input_overlay_t *ol); /** * input_overlay_enable: * @ol : Overlay handle. * @enable : Enable or disable the overlay * * Enable or disable the overlay. **/ void input_overlay_enable(input_overlay_t *ol, bool enable); /** * input_overlay_full_screen: * @ol : Overlay handle. * * Checks if the overlay is fullscreen. * * Returns: true (1) if overlay is fullscreen, otherwise false (0). **/ bool input_overlay_full_screen(input_overlay_t *ol); /** * input_overlay_poll: * @ol : Overlay handle. * @out : Polled output data. * @norm_x : Normalized X coordinate. * @norm_y : Normalized Y coordinate. * * Polls input overlay. * * @norm_x and @norm_y are the result of * input_translate_coord_viewport(). **/ void input_overlay_poll(input_overlay_t *ol, input_overlay_state_t *out, int16_t norm_x, int16_t norm_y); /** * input_overlay_post_poll: * @ol : overlay handle * * * Called after all the input_overlay_poll() calls to * update the range modifiers for pressed/unpressed regions * and alpha mods. **/ void input_overlay_post_poll(input_overlay_t *ol, float opacity); /** * input_overlay_poll_clear: * @ol : overlay handle * @opacity : Opacity of overlay. * * Call when there is nothing to poll. Allows overlay to * clear certain state. **/ void input_overlay_poll_clear(input_overlay_t *ol, float opacity); /** * input_overlay_set_alpha_mod: * @ol : Overlay handle. * @mod : New modulating factor to apply. * * Sets a modulating factor for alpha channel. Default is 1.0. * The alpha factor is applied for all overlays. **/ void input_overlay_set_alpha_mod(input_overlay_t *ol, float mod); /** * input_overlay_set_scale_factor: * @ol : Overlay handle. * @scale : Factor of scale to apply. * * Scales the overlay by a factor of scale. **/ void input_overlay_set_scale_factor(input_overlay_t *ol, float scale); /** * input_overlay_next: * @ol : Overlay handle. * * Switch to the next available overlay * screen. **/ void input_overlay_next(input_overlay_t *ol, float opacity); #ifdef __cplusplus } #endif #endif