/* 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_DRIVER__H #define __INPUT_DRIVER__H #include #include #include #include #include #include "input_joypad_driver.h" #include "input_defines.h" #include "../msg_hash.h" RETRO_BEGIN_DECLS enum input_device_type { INPUT_DEVICE_TYPE_NONE = 0, INPUT_DEVICE_TYPE_KEYBOARD, INPUT_DEVICE_TYPE_JOYPAD }; enum input_toggle_type { INPUT_TOGGLE_NONE = 0, INPUT_TOGGLE_DOWN_Y_L_R, INPUT_TOGGLE_L3_R3, INPUT_TOGGLE_L1_R1_START_SELECT, INPUT_TOGGLE_START_SELECT, INPUT_TOGGLE_LAST }; struct retro_keybind { bool valid; unsigned id; enum msg_hash_enums enum_idx; enum retro_key key; /* Joypad key. Joypad POV (hats) * are embedded into this key as well. */ uint64_t joykey; /* Default key binding value - * for resetting bind to default */ uint64_t def_joykey; /* Joypad axis. Negative and positive axes * are embedded into this variable. */ uint32_t joyaxis; /* Default joy axis binding value - * for resetting bind to default */ uint32_t def_joyaxis; /* Used by input_{push,pop}_analog_dpad(). */ uint32_t orig_joyaxis; char joykey_label[256]; char joyaxis_label[256]; }; typedef struct input_driver { /* Inits input driver. */ void *(*init)(const char *joypad_driver); /* Polls input. Called once every frame. */ void (*poll)(void *data); /* Queries input state for a certain key on a certain player. * Players are 1 - MAX_USERS. * For digital inputs, pressed key is 1, not pressed key is 0. * Analog values have same range as a signed 16-bit integer. */ int16_t (*input_state)(void *data, rarch_joypad_info_t joypad_info, const struct retro_keybind **retro_keybinds, unsigned port, unsigned device, unsigned index, unsigned id); bool (*meta_key_pressed)(void *data, int key); /* Frees the input struct. */ void (*free)(void *data); bool (*set_sensor_state)(void *data, unsigned port, enum retro_sensor_action action, unsigned rate); float (*get_sensor_input)(void *data, unsigned port, unsigned id); uint64_t (*get_capabilities)(void *data); const char *ident; void (*grab_mouse)(void *data, bool state); bool (*grab_stdin)(void *data); bool (*set_rumble)(void *data, unsigned port, enum retro_rumble_effect effect, uint16_t state); const input_device_driver_t *(*get_joypad_driver)(void *data); const input_device_driver_t *(*get_sec_joypad_driver)(void *data); bool (*keyboard_mapping_is_blocked)(void *data); void (*keyboard_mapping_set_block)(void *data, bool value); } input_driver_t; extern const input_driver_t *current_input; extern void *current_input_data; /** * input_driver_find_handle: * @index : index of driver to get handle to. * * Returns: handle to input driver at index. Can be NULL * if nothing found. **/ const void *input_driver_find_handle(int index); /** * input_driver_find_ident: * @index : index of driver to get handle to. * * Returns: Human-readable identifier of input driver at index. Can be NULL * if nothing found. **/ const char *input_driver_find_ident(int index); /** * config_get_input_driver_options: * * Get an enumerated list of all input driver names, separated by '|'. * * Returns: string listing of all input driver names, separated by '|'. **/ const char* config_get_input_driver_options(void); /** * input_driver_set_rumble_state: * @port : User number. * @effect : Rumble effect. * @strength : Strength of rumble effect. * * Sets the rumble state. * Used by RETRO_ENVIRONMENT_GET_RUMBLE_INTERFACE. **/ bool input_driver_set_rumble_state(unsigned port, enum retro_rumble_effect effect, uint16_t strength); uint64_t input_driver_get_capabilities(void); const input_device_driver_t * input_driver_get_joypad_driver(void); const input_device_driver_t * input_driver_get_sec_joypad_driver(void); void input_driver_keyboard_mapping_set_block(bool value); void input_driver_set(const input_driver_t **input, void **input_data); /** * input_sensor_set_state: * @port : User number. * @effect : Sensor action. * @rate : Sensor rate update. * * Sets the sensor state. * Used by RETRO_ENVIRONMENT_GET_SENSOR_INTERFACE. **/ bool input_sensor_set_state(unsigned port, enum retro_sensor_action action, unsigned rate); float input_sensor_get_input(unsigned port, unsigned id); #define inherit_joyaxis(binds) (((binds)[x_plus].joyaxis == (binds)[x_minus].joyaxis) || ( (binds)[y_plus].joyaxis == (binds)[y_minus].joyaxis)) /** * input_pop_analog_dpad: * @binds : Binds to modify. * * Restores binds temporarily overridden by input_push_analog_dpad(). **/ #define input_pop_analog_dpad(binds) \ { \ unsigned j; \ for (j = RETRO_DEVICE_ID_JOYPAD_UP; j <= RETRO_DEVICE_ID_JOYPAD_RIGHT; j++) \ (binds)[j].joyaxis = (binds)[j].orig_joyaxis; \ } /** * input_push_analog_dpad: * @binds : Binds to modify. * @mode : Which analog stick to bind D-Pad to. * E.g: * ANALOG_DPAD_LSTICK * ANALOG_DPAD_RSTICK * * Push analog to D-Pad mappings to binds. **/ #define input_push_analog_dpad(binds, mode) \ { \ unsigned k; \ unsigned x_plus = RARCH_ANALOG_RIGHT_X_PLUS; \ unsigned y_plus = RARCH_ANALOG_RIGHT_Y_PLUS; \ unsigned x_minus = RARCH_ANALOG_RIGHT_X_MINUS; \ unsigned y_minus = RARCH_ANALOG_RIGHT_Y_MINUS; \ if ((mode) == ANALOG_DPAD_LSTICK) \ { \ x_plus = RARCH_ANALOG_LEFT_X_PLUS; \ y_plus = RARCH_ANALOG_LEFT_Y_PLUS; \ x_minus = RARCH_ANALOG_LEFT_X_MINUS; \ y_minus = RARCH_ANALOG_LEFT_Y_MINUS; \ } \ for (k = RETRO_DEVICE_ID_JOYPAD_UP; k <= RETRO_DEVICE_ID_JOYPAD_RIGHT; k++) \ (binds)[k].orig_joyaxis = (binds)[k].joyaxis; \ if (!inherit_joyaxis(binds)) \ { \ unsigned j = x_plus + 3; \ /* Inherit joyaxis from analogs. */ \ for (k = RETRO_DEVICE_ID_JOYPAD_UP; k <= RETRO_DEVICE_ID_JOYPAD_RIGHT; k++) \ (binds)[k].joyaxis = (binds)[j--].joyaxis; \ } \ } /** * input_poll: * * Input polling callback function. **/ void input_poll(void); /** * input_state: * @port : user number. * @device : device identifier of user. * @idx : index value of user. * @id : identifier of key pressed by user. * * Input state callback function. * * Returns: Non-zero if the given key (identified by @id) was pressed by the user * (assigned to @port). **/ int16_t input_state(unsigned port, unsigned device, unsigned idx, unsigned id); uint64_t input_keys_pressed( uint64_t old_input, uint64_t *last_input, uint64_t *trigger_input, bool runloop_paused, bool *nonblock_state); #ifdef HAVE_MENU uint64_t input_menu_keys_pressed( uint64_t old_input, uint64_t *last_input, uint64_t *trigger_input, bool runloop_paused, bool *nonblock_state); #endif void *input_driver_get_data(void); const input_driver_t *input_get_ptr(void); const input_driver_t **input_get_double_ptr(void); void **input_driver_get_data_ptr(void); bool input_driver_has_capabilities(void); void input_driver_poll(void); bool input_driver_init(void); void input_driver_deinit(void); void input_driver_destroy_data(void); void input_driver_destroy(void); bool input_driver_grab_stdin(void); bool input_driver_keyboard_mapping_is_blocked(void); bool input_driver_find_driver(void); void input_driver_set_flushing_input(void); void input_driver_unset_hotkey_block(void); void input_driver_set_hotkey_block(void); void input_driver_set_libretro_input_blocked(void); void input_driver_unset_libretro_input_blocked(void); bool input_driver_is_libretro_input_blocked(void); void input_driver_set_nonblock_state(void); void input_driver_unset_nonblock_state(void); bool input_driver_is_nonblock_state(void); void input_driver_set_own_driver(void); void input_driver_unset_own_driver(void); bool input_driver_owns_driver(void); void input_driver_deinit_command(void); bool input_driver_init_command(void); void input_driver_deinit_remote(void); bool input_driver_init_remote(void); bool input_driver_grab_mouse(void); bool input_driver_ungrab_mouse(void); bool input_driver_is_data_ptr_same(void *data); extern input_driver_t input_android; extern input_driver_t input_sdl; extern input_driver_t input_dinput; extern input_driver_t input_x; extern input_driver_t input_ps3; extern input_driver_t input_psp; extern input_driver_t input_ctr; extern input_driver_t input_xenon360; extern input_driver_t input_gx; extern input_driver_t input_wiiu; extern input_driver_t input_xinput; extern input_driver_t input_linuxraw; extern input_driver_t input_udev; extern input_driver_t input_cocoa; extern input_driver_t input_qnx; extern input_driver_t input_rwebinput; extern input_driver_t input_dos; extern input_driver_t input_null; RETRO_END_DECLS #endif