/* 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 #include "input_types.h" #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 MAX_VISIBILITY 32 #define CUSTOM_BINDS_U32_COUNT ((RARCH_CUSTOM_BIND_LIST_END - 1) / 32 + 1) #define OVERLAY_MAX_TOUCH 16 #define OVERLAY_LIGHTGUN_TRIG_MAX_DELAY 15 RETRO_BEGIN_DECLS enum overlay_hitbox { OVERLAY_HITBOX_RADIAL = 0, OVERLAY_HITBOX_RECT, OVERLAY_HITBOX_NONE }; enum overlay_type { OVERLAY_TYPE_BUTTONS = 0, OVERLAY_TYPE_ANALOG_LEFT, OVERLAY_TYPE_ANALOG_RIGHT, OVERLAY_TYPE_DPAD_AREA, OVERLAY_TYPE_ABXY_AREA, OVERLAY_TYPE_KEYBOARD, OVERLAY_TYPE_LAST }; /* Superset of overlay_type for menu entries */ enum overlay_menu_type { OVERLAY_TYPE_OSK_TOGGLE = OVERLAY_TYPE_LAST }; 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 }; enum overlay_orientation { OVERLAY_ORIENTATION_NONE = 0, OVERLAY_ORIENTATION_LANDSCAPE, OVERLAY_ORIENTATION_PORTRAIT }; enum overlay_show_input_type { OVERLAY_SHOW_INPUT_NONE = 0, OVERLAY_SHOW_INPUT_TOUCHED, OVERLAY_SHOW_INPUT_PHYSICAL, OVERLAY_SHOW_INPUT_LAST }; enum OVERLAY_LOADER_FLAGS { OVERLAY_LOADER_RGBA_SUPPORT = (1 << 0), OVERLAY_LOADER_IS_OSK = (1 << 1) }; enum INPUT_OVERLAY_FLAGS { INPUT_OVERLAY_ENABLE = (1 << 0), INPUT_OVERLAY_ALIVE = (1 << 1), INPUT_OVERLAY_BLOCKED = (1 << 2), INPUT_OVERLAY_IS_OSK = (1 << 3) }; enum OVERLAY_FLAGS { OVERLAY_FULL_SCREEN = (1 << 0), OVERLAY_BLOCK_SCALE = (1 << 1), OVERLAY_BLOCK_X_SEPARATION = (1 << 2), OVERLAY_BLOCK_Y_SEPARATION = (1 << 3), OVERLAY_AUTO_X_SEPARATION = (1 << 4), OVERLAY_AUTO_Y_SEPARATION = (1 << 5) }; enum OVERLAY_DESC_FLAGS { OVERLAY_DESC_MOVABLE = (1 << 0), /* If true, blocks input from overlapped hitboxes */ OVERLAY_DESC_EXCLUSIVE = (1 << 1), /* Similar, but only applies after range_mod takes effect */ OVERLAY_DESC_RANGE_MOD_EXCLUSIVE = (1 << 2) }; enum overlay_lightgun_action { OVERLAY_LIGHTGUN_ACTION_NONE = 0, OVERLAY_LIGHTGUN_ACTION_TRIGGER, OVERLAY_LIGHTGUN_ACTION_RELOAD, OVERLAY_LIGHTGUN_ACTION_AUX_A, OVERLAY_LIGHTGUN_ACTION_AUX_B, OVERLAY_LIGHTGUN_ACTION_AUX_C, OVERLAY_LIGHTGUN_ACTION_START, OVERLAY_LIGHTGUN_ACTION_SELECT, OVERLAY_LIGHTGUN_ACTION_DPAD_UP, OVERLAY_LIGHTGUN_ACTION_DPAD_DOWN, OVERLAY_LIGHTGUN_ACTION_DPAD_LEFT, OVERLAY_LIGHTGUN_ACTION_DPAD_RIGHT, OVERLAY_LIGHTGUN_ACTION_END }; /* 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; typedef struct overlay_eightway_config { input_bits_t up; input_bits_t right; input_bits_t down; input_bits_t left; input_bits_t up_right; input_bits_t up_left; input_bits_t down_right; input_bits_t down_left; /* diagonal sensitivity */ float* slope_high; float* slope_low; } overlay_eightway_config_t; struct overlay_desc { struct texture_image image; enum overlay_hitbox hitbox; enum overlay_type type; 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; /* These are 'raw' x/y values shifted * by a user-configured offset (c.f. * OVERLAY_X/Y_SEPARATION). Used to determine * correct hitbox locations. By default, * will be equal to x/y */ float x_shift; float y_shift; /* These values are used only for hitbox * detection. A hitbox can be stretched in * any direction(s) by its 'reach' values */ float x_hitbox; float y_hitbox; float range_x_hitbox, range_y_hitbox; float reach_right, reach_left, reach_up, reach_down; /* 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; overlay_eightway_config_t *eightway_config; char next_index_name[64]; /* Nonzero if pressed. Lower bits used for pointer indexes */ uint32_t touch_mask; uint32_t old_touch_mask; uint8_t flags; }; struct overlay { struct overlay_desc *descs; struct texture_image *load_images; struct texture_image image; 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 center_x, center_y; float aspect_ratio; struct { float alpha_mod; float range_mod; struct { unsigned size; char key[64]; } descs; struct { char key[64]; char path[PATH_MAX_LENGTH]; } paths; struct { char key[64]; } names; struct { char array[256]; char key[64]; } rect; bool normalized; } config; char name[64]; uint8_t flags; }; typedef struct input_overlay_state { uint32_t keys[RETROK_LAST / 32 + 1]; /* Left X, Left Y, Right X, Right Y */ int16_t analog[4]; /* This is a bitmask of (1 << key_bind_id). */ input_bits_t buttons; /* Input pointers from input_state */ struct { int16_t x; int16_t y; } touch[OVERLAY_MAX_TOUCH]; int touch_count; } input_overlay_state_t; /* Non-hitbox input state for pointer, mouse, and lightgun */ typedef struct input_overlay_pointer_state { /* Input pointers that missed every hitbox */ struct { int16_t x; int16_t y; } ptr[OVERLAY_MAX_TOUCH]; unsigned count; /* Main pointer, full screen */ int16_t screen_x; int16_t screen_y; struct input_overlay_lightgun_state { /* Input ID based on pointer count */ unsigned multitouch_id; } lightgun; struct input_overlay_mouse_state { float scale_x; float scale_y; int16_t prev_screen_x; int16_t prev_screen_y; /* Bits 0-2 used for LMB, RMB, MMB */ uint8_t click; uint8_t hold; } mouse; /* Mask of requested devices * to avoid unnecessary polling */ uint8_t device_mask; } input_overlay_pointer_state_t; struct input_overlay { struct overlay *overlays; const struct overlay *active; char *path; void *iface_data; const video_overlay_interface_t *iface; input_overlay_state_t overlay_state; input_overlay_pointer_state_t pointer_state; size_t index; size_t size; unsigned next_index; uint8_t flags; }; /* Holds general layout information for an * overlay (overall scaling + positional * offset factors) */ typedef struct { float scale_landscape; float aspect_adjust_landscape; float x_separation_landscape; float y_separation_landscape; float x_offset_landscape; float y_offset_landscape; float scale_portrait; float aspect_adjust_portrait; float x_separation_portrait; float y_separation_portrait; float x_offset_portrait; float y_offset_portrait; float touch_scale; bool auto_scale; } overlay_layout_desc_t; /* Holds derived overlay layout information * for a specific display orientation */ typedef struct { float x_scale; float y_scale; float x_separation; float y_separation; float x_offset; float y_offset; } overlay_layout_t; typedef struct overlay_desc overlay_desc_t; typedef struct input_overlay input_overlay_t; typedef struct { char *overlay_path; struct overlay *overlays; struct overlay *active; size_t size; uint16_t overlay_types; uint8_t flags; } overlay_task_data_t; void input_overlay_free_overlay(struct overlay *overlay); void input_overlay_set_visibility(int overlay_idx,enum overlay_visibility vis); /* Attempts to automatically rotate the specified overlay. * Depends upon proper naming conventions in overlay * config file. */ void input_overlay_auto_rotate_( unsigned video_driver_width, unsigned video_driver_height, bool input_overlay_enable, input_overlay_t *ol); void input_overlay_load_active( enum overlay_visibility *visibility, input_overlay_t *ol, float opacity); /** * input_overlay_set_scale_factor: * @ol : Overlay handle. * @layout_desc : Scale + offset factors. * * Scales the overlay and applies any aspect ratio/ * offset factors. **/ void input_overlay_set_scale_factor( input_overlay_t *ol, const overlay_layout_desc_t *layout_desc, unsigned video_driver_width, unsigned video_driver_height); /** * 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( enum overlay_visibility *visibility, input_overlay_t *ol, float mod); /** * input_overlay_set_eightway_diagonal_sensitivity: * * Gets the slope limits defining each eightway type's diagonal zones. */ void input_overlay_set_eightway_diagonal_sensitivity(void); RETRO_END_DECLS #endif