/* RetroArch - A frontend for libretro. * Copyright (C) 2010-2014 - Hans-Kristian Arntzen * Copyright (C) 2011-2017 - 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 #include #include #include "input_driver.h" RETRO_BEGIN_DECLS /* 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 void *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 }; 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 }; enum overlay_visibility { OVERLAY_VISIBILITY_DEFAULT = 0, OVERLAY_VISIBILITY_VISIBLE, OVERLAY_VISIBILITY_HIDDEN }; struct overlay { bool full_screen; bool block_scale; unsigned load_images_size; unsigned id; unsigned pos_increment; size_t size; size_t pos; float mod_x, mod_y, mod_w, mod_h; float x, y, w, h; float scale; float center_x, center_y; struct overlay_desc *descs; struct texture_image *load_images; struct texture_image image; char name[64]; struct { bool normalized; float alpha_mod; float range_mod; 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; } config; }; struct overlay_desc { enum overlay_hitbox hitbox; enum overlay_type type; bool updated; bool movable; unsigned next_index; unsigned image_index; float alpha_mod; float range_mod; float analog_saturate_pct; 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; float x; float y; /* This is a retro_key value for keyboards */ unsigned retro_key_idx; /* This is a bit mask of all input binds to set with this overlay control */ input_bits_t button_mask; char next_index_name[64]; struct texture_image image; }; typedef struct overlay_desc overlay_desc_t; typedef struct input_overlay input_overlay_t; typedef struct { bool hide_in_menu; bool overlay_enable; size_t size; float overlay_opacity; float overlay_scale; struct overlay *overlays; struct overlay *active; } overlay_task_data_t; /** * input_overlay_free: * * Frees overlay handle. **/ void input_overlay_free(input_overlay_t *ol); void input_overlay_free_overlay(struct overlay *overlay); /** * input_overlay_init * * Initializes the overlay system. */ void input_overlay_init(void); /** * input_overlay_set_alpha_mod: * @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: * @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: * * Switch to the next available overlay * screen. **/ void input_overlay_next(input_overlay_t *ol, float opacity); /* * input_poll_overlay: * @ol : pointer to overlay * * Poll pressed buttons/keys on currently active overlay. **/ void input_poll_overlay(input_overlay_t *ol, float opacity, unsigned analog_dpad_mode, float axis_threshold); void input_state_overlay(input_overlay_t *ol, int16_t *ret, unsigned port, unsigned device, unsigned idx, unsigned id); bool input_overlay_key_pressed(input_overlay_t *ol, unsigned key); bool input_overlay_is_alive(input_overlay_t *ol); void input_overlay_loaded(void *task_data, void *user_data, const char *err); void input_overlay_set_visibility(int overlay_idx,enum overlay_visibility vis); /* FIXME - temporary. Globals are bad */ extern input_overlay_t *overlay_ptr; RETRO_END_DECLS #endif