2012-04-21 21:13:50 +00:00
/* RetroArch - A frontend for libretro.
2014-01-01 00:50:59 +00:00
* Copyright ( C ) 2010 - 2014 - Hans - Kristian Arntzen
2014-05-13 18:23:15 +00:00
* Copyright ( C ) 2011 - 2014 - Daniel De Matteis
2010-05-28 16:22:57 +00:00
*
2012-04-21 21:13:50 +00:00
* RetroArch is free software : you can redistribute it and / or modify it under the terms
2010-05-28 16:22:57 +00:00
* 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 .
*
2012-04-21 21:13:50 +00:00
* RetroArch is distributed in the hope that it will be useful , but WITHOUT ANY WARRANTY ;
2010-05-28 16:22:57 +00:00
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE . See the GNU General Public License for more details .
*
2012-04-21 21:31:57 +00:00
* You should have received a copy of the GNU General Public License along with RetroArch .
2010-05-28 16:22:57 +00:00
* If not , see < http : //www.gnu.org/licenses/>.
*/
# ifndef __DRIVER__H
# define __DRIVER__H
2011-01-07 11:50:14 +00:00
# include <sys/types.h>
2011-12-24 12:46:12 +00:00
# include "boolean.h"
2013-08-25 09:07:06 +00:00
# include "libretro_private.h"
2010-05-28 16:22:57 +00:00
# include <stdlib.h>
# include <stdint.h>
2011-12-24 23:59:46 +00:00
# include "msvc/msvc_compat.h"
2012-10-19 23:12:02 +00:00
# include "gfx/scaler/scaler.h"
2014-05-28 19:14:11 +00:00
# include "gfx/image/image.h"
2014-04-30 00:38:13 +00:00
# include "gfx/filters/softfilter.h"
2014-06-17 14:41:06 +00:00
# include "gfx/shader_parse.h"
2014-05-20 10:30:50 +00:00
# include "audio/dsp_filter.h"
2012-12-20 14:33:54 +00:00
# include "input/overlay.h"
2014-05-13 18:23:15 +00:00
# include "frontend/frontend_context.h"
2014-06-01 01:00:31 +00:00
# ifndef _WIN32
2014-05-31 22:24:35 +00:00
# include "miscellaneous.h"
2014-06-01 01:00:31 +00:00
# endif
2014-05-31 14:48:07 +00:00
2014-06-17 14:49:13 +00:00
# include "driver_menu.h"
2012-05-27 12:12:29 +00:00
# ifdef HAVE_CONFIG_H
# include "config.h"
# endif
2012-07-24 00:47:28 +00:00
# ifdef HAVE_COMMAND
# include "command.h"
2012-05-27 12:12:29 +00:00
# endif
2013-04-21 08:05:12 +00:00
# ifdef __cplusplus
extern " C " {
# endif
2012-10-28 11:51:02 +00:00
# define AUDIO_CHUNK_SIZE_BLOCKING 512
2011-12-24 12:46:12 +00:00
# define AUDIO_CHUNK_SIZE_NONBLOCKING 2048 // So we don't get complete line-noise when fast-forwarding audio.
# define AUDIO_MAX_RATIO 16
2013-01-11 15:23:04 +00:00
// Specialized _POINTER that targets the full screen regardless of viewport.
// Should not be used by a libretro implementation as coordinates returned make no sense.
// It is only used internally for overlays.
# define RARCH_DEVICE_POINTER_SCREEN (RETRO_DEVICE_POINTER | 0x10000)
2012-05-07 19:51:32 +00:00
// libretro has 16 buttons from 0-15 (libretro.h)
2012-06-28 15:57:50 +00:00
// Analog binds use RETRO_DEVICE_ANALOG, but we follow the same scheme internally
// in RetroArch for simplicity,
// so they are mapped into [16, 23].
2012-10-01 20:15:48 +00:00
# define RARCH_FIRST_CUSTOM_BIND 16
# define RARCH_FIRST_META_KEY RARCH_CUSTOM_BIND_LIST_END
2012-06-28 15:57:50 +00:00
enum // RetroArch specific bind IDs.
2011-01-08 17:37:45 +00:00
{
2012-10-01 20:15:48 +00:00
// Custom binds that extend the scope of RETRO_DEVICE_JOYPAD for RetroArch specifically.
2012-06-28 15:57:50 +00:00
// Analogs (RETRO_DEVICE_ANALOG)
2013-09-30 17:40:41 +00:00
RARCH_ANALOG_LEFT_X_PLUS = RARCH_FIRST_CUSTOM_BIND ,
2012-06-28 15:57:50 +00:00
RARCH_ANALOG_LEFT_X_MINUS ,
RARCH_ANALOG_LEFT_Y_PLUS ,
RARCH_ANALOG_LEFT_Y_MINUS ,
RARCH_ANALOG_RIGHT_X_PLUS ,
RARCH_ANALOG_RIGHT_X_MINUS ,
RARCH_ANALOG_RIGHT_Y_PLUS ,
RARCH_ANALOG_RIGHT_Y_MINUS ,
2013-09-30 17:40:41 +00:00
// Turbo
RARCH_TURBO_ENABLE ,
2012-10-01 20:15:48 +00:00
RARCH_CUSTOM_BIND_LIST_END ,
2012-06-28 15:57:50 +00:00
2012-10-01 20:15:48 +00:00
// Command binds. Not related to game input, only usable for port 0.
RARCH_FAST_FORWARD_KEY = RARCH_FIRST_META_KEY ,
2012-04-21 21:25:32 +00:00
RARCH_FAST_FORWARD_HOLD_KEY ,
RARCH_LOAD_STATE_KEY ,
RARCH_SAVE_STATE_KEY ,
RARCH_FULLSCREEN_TOGGLE_KEY ,
RARCH_QUIT_KEY ,
RARCH_STATE_SLOT_PLUS ,
RARCH_STATE_SLOT_MINUS ,
RARCH_REWIND ,
RARCH_MOVIE_RECORD_TOGGLE ,
RARCH_PAUSE_TOGGLE ,
RARCH_FRAMEADVANCE ,
RARCH_RESET ,
RARCH_SHADER_NEXT ,
RARCH_SHADER_PREV ,
RARCH_CHEAT_INDEX_PLUS ,
RARCH_CHEAT_INDEX_MINUS ,
RARCH_CHEAT_TOGGLE ,
RARCH_SCREENSHOT ,
RARCH_MUTE ,
RARCH_NETPLAY_FLIP ,
RARCH_SLOWMOTION ,
2012-11-02 22:24:53 +00:00
RARCH_ENABLE_HOTKEY ,
2012-11-03 13:15:03 +00:00
RARCH_VOLUME_UP ,
RARCH_VOLUME_DOWN ,
2012-12-22 14:33:28 +00:00
RARCH_OVERLAY_NEXT ,
2013-02-21 22:44:07 +00:00
RARCH_DISK_EJECT_TOGGLE ,
RARCH_DISK_NEXT ,
2013-03-29 17:53:07 +00:00
RARCH_GRAB_MOUSE_TOGGLE ,
2012-12-23 17:21:36 +00:00
2013-03-09 15:14:26 +00:00
RARCH_MENU_TOGGLE ,
2011-09-06 17:53:22 +00:00
2012-05-09 21:24:50 +00:00
RARCH_BIND_LIST_END ,
RARCH_BIND_LIST_END_NULL
2011-01-08 17:37:45 +00:00
} ;
2010-08-16 16:40:17 +00:00
2013-12-26 19:11:15 +00:00
# ifdef RARCH_CONSOLE
enum // Console specific menu bind IDs.
{
CONSOLE_MENU_FIRST = 61 ,
CONSOLE_MENU_A = CONSOLE_MENU_FIRST ,
CONSOLE_MENU_B = 62 ,
CONSOLE_MENU_X = 63 ,
CONSOLE_MENU_Y = 64 ,
CONSOLE_MENU_START = 65 ,
CONSOLE_MENU_SELECT = 66 ,
CONSOLE_MENU_UP = 67 ,
CONSOLE_MENU_DOWN = 68 ,
CONSOLE_MENU_LEFT = 69 ,
CONSOLE_MENU_RIGHT = 70 ,
CONSOLE_MENU_L = 71 ,
CONSOLE_MENU_R = 72 ,
CONSOLE_MENU_L2 = 73 ,
CONSOLE_MENU_R2 = 74 ,
CONSOLE_MENU_L3 = 75 ,
CONSOLE_MENU_R3 = 76 ,
CONSOLE_MENU_HOME = 77 ,
CONSOLE_MENU_LAST = CONSOLE_MENU_HOME ,
} ;
# endif
2012-07-07 15:19:32 +00:00
struct retro_keybind
2010-05-28 16:22:57 +00:00
{
2012-01-30 00:20:35 +00:00
bool valid ;
2013-11-16 12:56:50 +00:00
unsigned id ;
2013-01-12 17:45:01 +00:00
const char * desc ;
2012-07-28 01:21:37 +00:00
enum retro_key key ;
2012-03-09 17:17:53 +00:00
// PC only uses lower 16-bits.
// Full 64-bit can be used for port-specific purposes, like simplifying multiple binds, etc.
uint64_t joykey ;
2013-03-13 14:34:33 +00:00
// Default key binding value - for resetting bind to default
uint64_t def_joykey ;
2010-12-23 23:58:42 +00:00
uint32_t joyaxis ;
2013-12-24 00:46:25 +00:00
uint32_t def_joyaxis ;
2014-01-08 16:31:14 +00:00
uint32_t orig_joyaxis ; // Used by input_{push,pop}_analog_dpad().
2010-05-28 16:22:57 +00:00
} ;
2013-03-14 14:01:36 +00:00
struct platform_bind
{
uint64_t joykey ;
2013-03-14 20:55:10 +00:00
char desc [ 64 ] ;
2013-03-14 14:01:36 +00:00
} ;
2013-04-06 23:38:11 +00:00
# if defined(_XBOX360)
# define DEFAULT_SHADER_TYPE RARCH_SHADER_HLSL
# elif defined(__PSL1GHT__)
# define DEFAULT_SHADER_TYPE RARCH_SHADER_GLSL
# elif defined(__CELLOS_LV2__)
# define DEFAULT_SHADER_TYPE RARCH_SHADER_CG
# elif defined(HAVE_OPENGLES2)
# define DEFAULT_SHADER_TYPE RARCH_SHADER_GLSL
# else
# define DEFAULT_SHADER_TYPE RARCH_SHADER_NONE
# endif
2010-05-29 12:45:40 +00:00
typedef struct video_info
{
2011-05-05 18:23:08 +00:00
unsigned width ;
unsigned height ;
2010-05-29 12:45:40 +00:00
bool fullscreen ;
bool vsync ;
bool force_aspect ;
2014-08-10 20:45:55 +00:00
unsigned viwidth ;
2010-05-29 12:45:40 +00:00
bool smooth ;
2012-04-21 21:25:32 +00:00
unsigned input_scale ; // Maximum input size: RARCH_SCALE_BASE * input_scale
2011-03-07 16:22:03 +00:00
bool rgb32 ; // Use 32-bit RGBA rather than native XBGR1555.
2010-05-29 12:45:40 +00:00
} video_info_t ;
2010-05-28 16:22:57 +00:00
typedef struct audio_driver
{
2011-11-01 19:27:59 +00:00
void * ( * init ) ( const char * device , unsigned rate , unsigned latency ) ;
ssize_t ( * write ) ( void * data , const void * buf , size_t size ) ;
bool ( * stop ) ( void * data ) ;
bool ( * start ) ( void * data ) ;
void ( * set_nonblock_state ) ( void * data , bool toggle ) ; // Should we care about blocking in audio thread? Fast forwarding.
void ( * free ) ( void * data ) ;
2011-01-15 19:37:42 +00:00
bool ( * use_float ) ( void * data ) ; // Defines if driver will take standard floating point samples, or int16_t samples.
2010-12-29 19:05:57 +00:00
const char * ident ;
2012-02-14 00:16:37 +00:00
size_t ( * write_avail ) ( void * data ) ; // Optional
size_t ( * buffer_size ) ( void * data ) ; // Optional
2010-05-28 16:22:57 +00:00
} audio_driver_t ;
2012-01-12 19:16:47 +00:00
# define AXIS_NEG(x) (((uint32_t)(x) << 16) | UINT16_C(0xFFFF))
# define AXIS_POS(x) ((uint32_t)(x) | UINT32_C(0xFFFF0000))
# define AXIS_NONE UINT32_C(0xFFFFFFFF)
2012-03-09 17:17:53 +00:00
# define AXIS_DIR_NONE UINT16_C(0xFFFF)
2011-01-08 21:15:02 +00:00
2012-01-12 19:16:47 +00:00
# define AXIS_NEG_GET(x) (((uint32_t)(x) >> 16) & UINT16_C(0xFFFF))
# define AXIS_POS_GET(x) ((uint32_t)(x) & UINT16_C(0xFFFF))
2011-01-08 21:15:02 +00:00
2012-03-09 17:17:53 +00:00
# define NO_BTN UINT16_C(0xFFFF) // I hope no joypad will ever have this many buttons ... ;)
2011-01-08 21:15:02 +00:00
2012-09-29 19:57:03 +00:00
# define HAT_UP_SHIFT 15
# define HAT_DOWN_SHIFT 14
# define HAT_LEFT_SHIFT 13
# define HAT_RIGHT_SHIFT 12
# define HAT_UP_MASK (1 << HAT_UP_SHIFT)
# define HAT_DOWN_MASK (1 << HAT_DOWN_SHIFT)
# define HAT_LEFT_MASK (1 << HAT_LEFT_SHIFT)
# define HAT_RIGHT_MASK (1 << HAT_RIGHT_SHIFT)
2011-01-08 21:15:02 +00:00
# define HAT_MAP(x, hat) ((x & ((1 << 12) - 1)) | hat)
# define HAT_MASK (HAT_UP_MASK | HAT_DOWN_MASK | HAT_LEFT_MASK | HAT_RIGHT_MASK)
# define GET_HAT_DIR(x) (x & HAT_MASK)
# define GET_HAT(x) (x & (~HAT_MASK))
2014-01-08 16:31:14 +00:00
enum analog_dpad_mode
2013-03-14 01:24:57 +00:00
{
ANALOG_DPAD_NONE = 0 ,
ANALOG_DPAD_LSTICK ,
ANALOG_DPAD_RSTICK ,
2013-07-31 17:04:28 +00:00
ANALOG_DPAD_DUALANALOG ,
2013-03-14 01:24:57 +00:00
ANALOG_DPAD_LAST
} ;
enum keybind_set_id
{
KEYBINDS_ACTION_NONE = 0 ,
KEYBINDS_ACTION_SET_DEFAULT_BIND ,
KEYBINDS_ACTION_SET_DEFAULT_BINDS ,
KEYBINDS_ACTION_SET_ANALOG_DPAD_NONE ,
KEYBINDS_ACTION_SET_ANALOG_DPAD_LSTICK ,
KEYBINDS_ACTION_SET_ANALOG_DPAD_RSTICK ,
2013-03-14 17:02:19 +00:00
KEYBINDS_ACTION_GET_BIND_LABEL ,
2013-03-14 01:24:57 +00:00
KEYBINDS_ACTION_LAST
} ;
2013-09-29 15:58:46 +00:00
typedef struct rarch_joypad_driver rarch_joypad_driver_t ;
2010-05-28 16:22:57 +00:00
typedef struct input_driver
{
2011-11-01 19:27:59 +00:00
void * ( * init ) ( void ) ;
void ( * poll ) ( void * data ) ;
2013-04-07 12:05:39 +00:00
int16_t ( * input_state ) ( void * data , const struct retro_keybind * * retro_keybinds ,
unsigned port , unsigned device , unsigned index , unsigned id ) ;
2011-11-01 19:27:59 +00:00
bool ( * key_pressed ) ( void * data , int key ) ;
void ( * free ) ( void * data ) ;
2013-03-14 01:24:57 +00:00
void ( * set_keybinds ) ( void * data , unsigned device , unsigned port , unsigned id , unsigned keybind_action ) ;
2013-11-03 11:06:14 +00:00
bool ( * set_sensor_state ) ( void * data , unsigned port , enum retro_sensor_action action , unsigned rate ) ;
2014-01-21 23:50:46 +00:00
float ( * get_sensor_input ) ( void * data , unsigned port , unsigned id ) ;
2013-11-02 20:16:57 +00:00
uint64_t ( * get_capabilities ) ( void * data ) ;
2014-04-17 18:47:11 +00:00
unsigned ( * devices_size ) ( void * data ) ;
2010-12-29 19:05:57 +00:00
const char * ident ;
2013-03-29 17:53:07 +00:00
void ( * grab_mouse ) ( void * data , bool state ) ;
2013-09-26 10:55:05 +00:00
bool ( * set_rumble ) ( void * data , unsigned port , enum retro_rumble_effect effect , uint16_t state ) ;
2013-09-29 15:58:46 +00:00
const rarch_joypad_driver_t * ( * get_joypad_driver ) ( void * data ) ;
2010-05-28 16:22:57 +00:00
} input_driver_t ;
2013-11-12 16:16:11 +00:00
typedef struct input_osk_driver
{
void * ( * init ) ( size_t size ) ;
void ( * free ) ( void * data ) ;
bool ( * enable_key_layout ) ( void * data ) ;
void ( * oskutil_create_activation_parameters ) ( void * data ) ;
void ( * write_msg ) ( void * data , const void * msg ) ;
void ( * write_initial_msg ) ( void * data , const void * msg ) ;
bool ( * start ) ( void * data ) ;
void ( * lifecycle ) ( void * data , uint64_t status ) ;
2013-11-15 22:19:44 +00:00
void * ( * get_text_buf ) ( void * data ) ;
2013-11-12 16:16:11 +00:00
const char * ident ;
} input_osk_driver_t ;
2013-11-10 02:15:10 +00:00
typedef struct camera_driver
{
2014-05-30 16:22:49 +00:00
// FIXME: params for initialization - queries for resolution, framerate, color format
2013-11-12 15:00:18 +00:00
// which might or might not be honored
void * ( * init ) ( const char * device , uint64_t buffer_types , unsigned width , unsigned height ) ;
2013-11-10 02:15:10 +00:00
void ( * free ) ( void * data ) ;
2013-11-12 15:00:18 +00:00
bool ( * start ) ( void * data ) ;
void ( * stop ) ( void * data ) ;
// Polls the camera driver.
// Will call the appropriate callback if a new frame is ready.
// Returns true if a new frame was handled.
bool ( * poll ) ( void * data ,
retro_camera_frame_raw_framebuffer_t frame_raw_cb ,
retro_camera_frame_opengl_texture_t frame_gl_cb ) ;
2013-11-10 02:15:10 +00:00
const char * ident ;
} camera_driver_t ;
2013-12-19 00:51:51 +00:00
typedef struct location_driver
{
2013-12-19 09:15:55 +00:00
void * ( * init ) ( void ) ;
2013-12-19 00:51:51 +00:00
void ( * free ) ( void * data ) ;
bool ( * start ) ( void * data ) ;
void ( * stop ) ( void * data ) ;
2013-12-19 16:36:27 +00:00
bool ( * get_position ) ( void * data , double * lat , double * lon , double * horiz_accuracy , double * vert_accuracy ) ;
2013-12-19 09:15:55 +00:00
void ( * set_interval ) ( void * data , unsigned interval_msecs , unsigned interval_distance ) ;
2013-12-19 00:51:51 +00:00
const char * ident ;
} location_driver_t ;
2012-10-27 22:38:31 +00:00
struct rarch_viewport ;
2012-12-23 17:36:58 +00:00
# ifdef HAVE_OVERLAY
2012-12-20 10:16:22 +00:00
typedef struct video_overlay_interface
{
void ( * enable ) ( void * data , bool state ) ;
2013-12-31 18:03:58 +00:00
bool ( * load ) ( void * data , const struct texture_image * images , unsigned num_images ) ;
2013-10-15 14:06:59 +00:00
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 ) ;
2013-01-11 15:23:04 +00:00
void ( * full_screen ) ( void * data , bool enable ) ;
2013-10-15 14:06:59 +00:00
void ( * set_alpha ) ( void * data , unsigned image , float mod ) ;
2012-12-20 10:16:22 +00:00
} video_overlay_interface_t ;
2012-12-23 17:36:58 +00:00
# endif
2012-12-20 10:16:22 +00:00
2014-06-07 19:18:58 +00:00
struct font_params
{
float x ;
float y ;
float scale ;
2014-06-08 10:44:40 +00:00
float drop_mod ; // Drop shadow color multiplier.
int drop_x , drop_y ; // Drop shadow offset. If both are 0, no drop shadow will be rendered.
uint32_t color ; // ABGR. Use the macros.
2014-06-07 20:42:23 +00:00
bool full_screen ;
2014-06-07 19:18:58 +00:00
} ;
2014-06-07 20:42:23 +00:00
# define FONT_COLOR_RGBA(r, g, b, a) (((r) << 0) | ((g) << 8) | ((b) << 16) | ((a) << 24))
# define FONT_COLOR_GET_RED(col) (((col) >> 0) & 0xff)
# define FONT_COLOR_GET_GREEN(col) (((col) >> 8) & 0xff)
# define FONT_COLOR_GET_BLUE(col) (((col) >> 16) & 0xff)
# define FONT_COLOR_GET_ALPHA(col) (((col) >> 24) & 0xff)
2014-06-07 19:18:58 +00:00
2013-03-10 00:16:56 +00:00
// Optionally implemented interface to poke more deeply into video driver.
typedef struct video_poke_interface
{
void ( * set_filtering ) ( void * data , unsigned index , bool smooth ) ;
2013-03-10 19:24:19 +00:00
# ifdef HAVE_FBO
2013-03-27 15:15:15 +00:00
uintptr_t ( * get_current_framebuffer ) ( void * data ) ;
2013-03-28 00:11:32 +00:00
retro_proc_address_t ( * get_proc_address ) ( void * data , const char * sym ) ;
2013-03-10 19:24:19 +00:00
# endif
2013-03-10 00:16:56 +00:00
void ( * set_aspect_ratio ) ( void * data , unsigned aspectratio_index ) ;
2013-03-10 18:39:37 +00:00
void ( * apply_state_changes ) ( void * data ) ;
2013-03-10 18:14:28 +00:00
2013-11-08 03:36:16 +00:00
# ifdef HAVE_MENU
2013-04-07 12:05:39 +00:00
void ( * set_texture_frame ) ( void * data , const void * frame , bool rgb32 , unsigned width , unsigned height , float alpha ) ; // Update texture.
2013-04-13 14:48:03 +00:00
void ( * set_texture_enable ) ( void * data , bool enable , bool full_screen ) ; // Enable/disable rendering.
2013-03-11 20:42:02 +00:00
# endif
2014-06-07 19:18:58 +00:00
void ( * set_osd_msg ) ( void * data , const char * msg , const struct font_params * params ) ;
2013-03-29 17:53:07 +00:00
void ( * show_mouse ) ( void * data , bool state ) ;
void ( * grab_mouse_toggle ) ( void * data ) ;
2014-05-23 10:23:08 +00:00
struct gfx_shader * ( * get_current_shader ) ( void * data ) ;
2013-03-10 00:16:56 +00:00
} video_poke_interface_t ;
2010-05-28 16:22:57 +00:00
typedef struct video_driver
{
2011-11-01 19:27:59 +00:00
void * ( * init ) ( const video_info_t * video , const input_driver_t * * input , void * * input_data ) ;
2013-03-10 18:14:28 +00:00
// Should the video driver act as an input driver as well? :)
2014-05-30 16:22:49 +00:00
// The video initialization might preinitialize an input driver to override the settings in case the video driver relies on input driver for event handling, e.g.
2011-11-01 19:27:59 +00:00
bool ( * frame ) ( void * data , const void * frame , unsigned width , unsigned height , unsigned pitch , const char * msg ) ; // msg is for showing a message on the screen along with the video frame.
void ( * set_nonblock_state ) ( void * data , bool toggle ) ; // Should we care about syncing to vblank? Fast forwarding.
2011-01-06 19:01:32 +00:00
// Is the window still active?
bool ( * alive ) ( void * data ) ;
2011-02-05 20:45:44 +00:00
bool ( * focus ) ( void * data ) ; // Does the window have focus?
2013-04-07 11:00:21 +00:00
bool ( * set_shader ) ( void * data , enum rarch_shader_type type , const char * path ) ; // Sets shader. Might not be implemented. Will be moved to poke_interface later.
2011-11-01 19:27:59 +00:00
void ( * free ) ( void * data ) ;
2010-12-29 19:05:57 +00:00
const char * ident ;
2012-02-13 18:17:13 +00:00
2012-03-30 17:09:34 +00:00
void ( * set_rotation ) ( void * data , unsigned rotation ) ;
2012-10-27 22:38:31 +00:00
void ( * viewport_info ) ( void * data , struct rarch_viewport * vp ) ;
2012-06-08 20:39:18 +00:00
// Reads out in BGR byte order (24bpp).
bool ( * read_viewport ) ( void * data , uint8_t * buffer ) ;
2012-12-20 10:16:22 +00:00
2012-12-23 17:36:58 +00:00
# ifdef HAVE_OVERLAY
2012-12-20 10:16:22 +00:00
void ( * overlay_interface ) ( void * data , const video_overlay_interface_t * * iface ) ;
2012-12-23 17:36:58 +00:00
# endif
2013-03-10 00:16:56 +00:00
void ( * poke_interface ) ( void * data , const video_poke_interface_t * * iface ) ;
2010-05-28 16:22:57 +00:00
} video_driver_t ;
2012-09-28 20:38:42 +00:00
enum rarch_display_type
{
RARCH_DISPLAY_NONE = 0 , // Non-bindable types like consoles, KMS, VideoCore, etc.
RARCH_DISPLAY_X11 , // video_display => Display*, video_window => Window
RARCH_DISPLAY_WIN32 , // video_display => N/A, video_window => HWND
RARCH_DISPLAY_OSX // ?!
} ;
2010-05-28 16:22:57 +00:00
typedef struct driver
{
2014-05-13 18:23:15 +00:00
const frontend_ctx_driver_t * frontend_ctx ;
2010-05-28 16:22:57 +00:00
const audio_driver_t * audio ;
const video_driver_t * video ;
const input_driver_t * input ;
2013-11-12 23:27:31 +00:00
# ifdef HAVE_OSK
const input_osk_driver_t * osk ;
void * osk_data ;
# endif
2013-11-11 13:26:57 +00:00
# ifdef HAVE_CAMERA
const camera_driver_t * camera ;
void * camera_data ;
2013-12-19 00:51:51 +00:00
# endif
# ifdef HAVE_LOCATION
const location_driver_t * location ;
void * location_data ;
2013-11-11 13:26:57 +00:00
# endif
2010-05-28 16:22:57 +00:00
void * audio_data ;
void * video_data ;
void * input_data ;
2014-04-01 02:03:55 +00:00
# ifdef HAVE_MENU
2014-06-10 00:06:10 +00:00
menu_handle_t * menu ;
2014-04-01 02:03:55 +00:00
const menu_ctx_driver_t * menu_ctx ;
# endif
2012-05-27 12:12:29 +00:00
2013-02-16 01:21:43 +00:00
bool threaded_video ;
2013-06-23 21:01:34 +00:00
// If set during context deinit, the driver should keep
// graphics context alive to avoid having to reset all context state.
bool video_cache_context ;
bool video_cache_context_ack ; // Set to true by driver if context caching succeeded.
2014-05-30 00:37:48 +00:00
// Set this to true if the platform in question needs to 'own' the respective
// handle and therefore skip regular RetroArch driver teardown/reiniting procedure.
// If set to true, the 'free' function will get skipped. It is then up to the
// driver implementation to properly handle 'reiniting' inside the 'init' function
// and make sure it returns the existing handle instead of allocating and returning
// a pointer to a new handle.
//
// Typically, if a driver intends to make use of this, it should set this to true
// at the end of its 'init' function.
2012-12-25 22:18:19 +00:00
bool video_data_own ;
bool audio_data_own ;
bool input_data_own ;
2013-11-11 13:26:57 +00:00
# ifdef HAVE_CAMERA
bool camera_data_own ;
# endif
2013-12-19 00:51:51 +00:00
# ifdef HAVE_LOCATION
bool location_data_own ;
# endif
2013-11-12 23:27:31 +00:00
# ifdef HAVE_OSK
bool osk_data_own ;
# endif
2014-05-30 15:49:04 +00:00
# ifdef HAVE_MENU
bool menu_data_own ;
# endif
2012-12-25 22:18:19 +00:00
2012-07-24 00:47:28 +00:00
# ifdef HAVE_COMMAND
rarch_cmd_t * command ;
2012-05-27 12:12:29 +00:00
# endif
2012-07-24 00:47:28 +00:00
bool stdin_claimed ;
2012-11-02 22:24:53 +00:00
bool block_hotkey ;
2013-12-09 15:18:58 +00:00
bool block_input ;
2014-07-10 22:26:50 +00:00
bool block_libretro_input ;
2013-04-13 22:53:05 +00:00
bool nonblock_state ;
2012-09-28 20:38:42 +00:00
// Opaque handles to currently running window.
// Used by e.g. input drivers which bind to a window.
// Drivers are responsible for setting these if an input driver
// could potentially make use of this.
uintptr_t video_display ;
uintptr_t video_window ;
enum rarch_display_type display_type ;
2012-10-19 23:12:02 +00:00
2013-01-03 00:18:19 +00:00
// Used for 15-bit -> 16-bit conversions that take place before being passed to video driver.
2012-10-19 23:12:02 +00:00
struct scaler_ctx scaler ;
void * scaler_out ;
2012-12-20 14:33:54 +00:00
2013-01-03 00:18:19 +00:00
// Graphics driver requires RGBA byte order data (ABGR on little-endian) for 32-bit.
// This takes effect for overlay and shader cores that wants to load data into graphics driver.
// Kinda hackish to place it here, it is only used for GLES.
// TODO: Refactor this better.
bool gfx_use_rgba ;
2012-12-23 17:36:58 +00:00
# ifdef HAVE_OVERLAY
2012-12-20 14:33:54 +00:00
input_overlay_t * overlay ;
2013-09-05 22:19:07 +00:00
input_overlay_state_t overlay_state ;
2012-12-23 17:36:58 +00:00
# endif
2013-03-10 00:16:56 +00:00
// Interface for "poking".
const video_poke_interface_t * video_poke ;
2013-03-10 20:02:10 +00:00
// last message given to the video driver
const char * current_msg ;
2010-05-28 16:22:57 +00:00
} driver_t ;
2010-12-24 00:26:36 +00:00
void init_drivers ( void ) ;
2012-04-01 17:38:50 +00:00
void init_drivers_pre ( void ) ;
2010-12-24 00:26:36 +00:00
void uninit_drivers ( void ) ;
void init_video_input ( void ) ;
void uninit_video_input ( void ) ;
void init_audio ( void ) ;
void uninit_audio ( void ) ;
2014-02-25 02:23:50 +00:00
void find_prev_resampler_driver ( void ) ;
2013-10-30 16:50:43 +00:00
void find_prev_video_driver ( void ) ;
void find_prev_audio_driver ( void ) ;
void find_prev_input_driver ( void ) ;
void find_next_video_driver ( void ) ;
void find_next_audio_driver ( void ) ;
void find_next_input_driver ( void ) ;
2014-02-25 02:23:50 +00:00
void find_next_resampler_driver ( void ) ;
2013-10-30 16:06:50 +00:00
2013-11-11 14:39:46 +00:00
# ifdef HAVE_CAMERA
void init_camera ( void ) ;
void uninit_camera ( void ) ;
void find_prev_camera_driver ( void ) ;
void find_next_camera_driver ( void ) ;
# endif
2013-12-19 00:51:51 +00:00
# ifdef HAVE_LOCATION
void init_location ( void ) ;
void uninit_location ( void ) ;
void find_prev_location_driver ( void ) ;
void find_next_location_driver ( void ) ;
# endif
2012-12-23 18:01:48 +00:00
void driver_set_monitor_refresh_rate ( float hz ) ;
2013-06-07 12:10:42 +00:00
bool driver_monitor_fps_statistics ( double * refresh_rate , double * deviation , unsigned * sample_points ) ;
2013-04-13 22:53:05 +00:00
void driver_set_nonblock_state ( bool nonblock ) ;
2012-12-23 18:01:48 +00:00
2013-03-27 15:15:15 +00:00
// Used by RETRO_ENVIRONMENT_SET_HW_RENDER.
uintptr_t driver_get_current_framebuffer ( void ) ;
2013-03-28 00:11:32 +00:00
retro_proc_address_t driver_get_proc_address ( const char * sym ) ;
2013-03-27 15:15:15 +00:00
2013-09-25 21:21:32 +00:00
// Used by RETRO_ENVIRONMENT_GET_RUMBLE_INTERFACE
2013-09-26 10:55:05 +00:00
bool driver_set_rumble_state ( unsigned port , enum retro_rumble_effect effect , uint16_t strength ) ;
2013-11-03 11:06:14 +00:00
// Used by RETRO_ENVIRONMENT_GET_SENSOR_INTERFACE
bool driver_set_sensor_state ( unsigned port , enum retro_sensor_action action , unsigned rate ) ;
2014-02-01 20:08:10 +00:00
float driver_sensor_get_input ( unsigned port , unsigned action ) ;
2013-09-25 21:21:32 +00:00
2014-04-13 16:29:57 +00:00
# ifdef HAVE_DYLIB
void rarch_deinit_filter ( void ) ;
2014-04-15 03:13:56 +00:00
void rarch_init_filter ( enum retro_pixel_format ) ;
2014-04-28 04:45:50 +00:00
# endif
2014-04-29 19:56:50 +00:00
# ifdef HAVE_FILTERS_BUILTIN
unsigned dspfilter_get_last_idx ( void ) ;
# endif
const char * rarch_dspfilter_get_name ( void * data ) ;
2014-04-13 16:29:57 +00:00
2013-11-12 15:00:18 +00:00
// Used by RETRO_ENVIRONMENT_GET_CAMERA_INTERFACE
# ifdef HAVE_CAMERA
bool driver_camera_start ( void ) ;
void driver_camera_stop ( void ) ;
void driver_camera_poll ( void ) ;
# endif
2013-12-19 00:51:51 +00:00
// Used by RETRO_ENVIRONMENT_GET_LOCATION_INTERFACE
# ifdef HAVE_LOCATION
bool driver_location_start ( void ) ;
void driver_location_stop ( void ) ;
2013-12-19 16:36:27 +00:00
bool driver_location_get_position ( double * lat , double * lon , double * horiz_accuracy , double * vert_accuracy ) ;
2013-12-19 09:15:55 +00:00
void driver_location_set_interval ( unsigned interval_msecs , unsigned interval_distance ) ;
2013-12-19 00:51:51 +00:00
# endif
2014-04-01 02:03:55 +00:00
# ifdef HAVE_MENU
const void * menu_ctx_find_driver ( const char * ident ) ; // Finds driver with ident. Does not initialize.
void find_prev_menu_driver ( void ) ;
void find_next_menu_driver ( void ) ;
2014-05-27 19:38:30 +00:00
void find_menu_driver ( void ) ;
2014-04-01 02:03:55 +00:00
# endif
2014-02-20 21:48:31 +00:00
// Used by RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO
bool driver_update_system_av_info ( const struct retro_system_av_info * info ) ;
2010-12-24 00:26:36 +00:00
extern driver_t driver ;
//////////////////////////////////////////////// Backends
extern const audio_driver_t audio_rsound ;
extern const audio_driver_t audio_oss ;
extern const audio_driver_t audio_alsa ;
2013-01-04 19:58:34 +00:00
extern const audio_driver_t audio_alsathread ;
2010-12-24 00:26:36 +00:00
extern const audio_driver_t audio_roar ;
extern const audio_driver_t audio_openal ;
2012-10-18 03:45:21 +00:00
extern const audio_driver_t audio_opensl ;
2011-01-01 02:53:30 +00:00
extern const audio_driver_t audio_jack ;
2011-01-07 14:50:16 +00:00
extern const audio_driver_t audio_sdl ;
2011-01-27 00:46:00 +00:00
extern const audio_driver_t audio_xa ;
2011-01-29 00:15:09 +00:00
extern const audio_driver_t audio_pulse ;
2011-08-04 16:45:40 +00:00
extern const audio_driver_t audio_dsound ;
2011-08-08 15:27:52 +00:00
extern const audio_driver_t audio_coreaudio ;
2011-12-13 22:17:37 +00:00
extern const audio_driver_t audio_xenon360 ;
2011-11-30 16:11:42 +00:00
extern const audio_driver_t audio_ps3 ;
2012-08-09 01:54:27 +00:00
extern const audio_driver_t audio_gx ;
2014-02-17 13:26:03 +00:00
extern const audio_driver_t audio_psp1 ;
2013-08-28 04:03:25 +00:00
extern const audio_driver_t audio_rwebaudio ;
2012-06-19 22:43:41 +00:00
extern const audio_driver_t audio_null ;
2010-12-24 00:26:36 +00:00
extern const video_driver_t video_gl ;
2012-11-23 04:20:05 +00:00
extern const video_driver_t video_psp1 ;
2012-11-26 02:16:20 +00:00
extern const video_driver_t video_vita ;
2014-01-01 00:09:31 +00:00
extern const video_driver_t video_d3d ;
2012-08-09 01:54:27 +00:00
extern const video_driver_t video_gx ;
2011-12-15 12:54:22 +00:00
extern const video_driver_t video_xenon360 ;
2011-03-13 03:51:09 +00:00
extern const video_driver_t video_xvideo ;
2012-07-07 17:15:06 +00:00
extern const video_driver_t video_xdk_d3d ;
2011-04-21 01:23:44 +00:00
extern const video_driver_t video_sdl ;
2014-08-10 16:35:18 +00:00
extern const video_driver_t video_sdl2 ;
2012-09-24 19:19:07 +00:00
extern const video_driver_t video_vg ;
2012-06-19 22:43:41 +00:00
extern const video_driver_t video_null ;
2013-07-28 16:37:31 +00:00
extern const video_driver_t video_omap ;
2013-11-24 16:28:21 +00:00
extern const video_driver_t video_exynos ;
2012-10-16 17:46:31 +00:00
extern const input_driver_t input_android ;
2011-01-06 17:34:11 +00:00
extern const input_driver_t input_sdl ;
2012-09-30 09:26:26 +00:00
extern const input_driver_t input_dinput ;
2011-03-13 03:51:09 +00:00
extern const input_driver_t input_x ;
2014-08-09 19:35:27 +00:00
extern const input_driver_t input_wayland ;
2011-12-02 01:22:29 +00:00
extern const input_driver_t input_ps3 ;
2012-11-23 01:40:03 +00:00
extern const input_driver_t input_psp ;
2011-12-14 00:35:17 +00:00
extern const input_driver_t input_xenon360 ;
2012-08-09 01:54:27 +00:00
extern const input_driver_t input_gx ;
2012-07-07 17:56:46 +00:00
extern const input_driver_t input_xinput ;
2012-05-25 19:44:39 +00:00
extern const input_driver_t input_linuxraw ;
2013-12-07 13:13:40 +00:00
extern const input_driver_t input_udev ;
2013-07-07 20:01:58 +00:00
extern const input_driver_t input_apple ;
2013-05-10 00:46:23 +00:00
extern const input_driver_t input_qnx ;
2013-09-11 00:21:48 +00:00
extern const input_driver_t input_rwebinput ;
2012-06-19 22:43:41 +00:00
extern const input_driver_t input_null ;
2013-11-10 02:15:10 +00:00
extern const camera_driver_t camera_v4l2 ;
2013-11-17 18:47:37 +00:00
extern const camera_driver_t camera_android ;
2013-11-13 00:48:36 +00:00
extern const camera_driver_t camera_rwebcam ;
2013-12-01 13:41:18 +00:00
extern const camera_driver_t camera_ios ;
2013-12-19 01:44:21 +00:00
extern const location_driver_t location_apple ;
extern const location_driver_t location_android ;
2013-11-12 16:16:11 +00:00
extern const input_osk_driver_t input_ps3_osk ;
2012-11-26 20:23:31 +00:00
2014-04-01 02:03:55 +00:00
extern const menu_ctx_driver_t menu_ctx_rmenu ;
extern const menu_ctx_driver_t menu_ctx_rmenu_xui ;
extern const menu_ctx_driver_t menu_ctx_rgui ;
extern const menu_ctx_driver_t menu_ctx_lakka ;
2014-04-14 00:32:54 +00:00
extern const menu_ctx_driver_backend_t menu_ctx_backend_common ;
2014-05-07 18:12:51 +00:00
extern const menu_ctx_driver_backend_t menu_ctx_backend_lakka ;
2014-04-14 00:32:54 +00:00
2014-04-30 00:38:13 +00:00
# ifdef HAVE_FILTERS_BUILTIN
2014-05-01 04:09:06 +00:00
extern const struct softfilter_implementation * blargg_ntsc_snes_rf_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * blargg_ntsc_snes_composite_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * blargg_ntsc_snes_svideo_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * blargg_ntsc_snes_rgb_get_implementation ( softfilter_simd_mask_t simd ) ;
2014-05-02 19:09:59 +00:00
extern const struct softfilter_implementation * lq2x_get_implementation ( softfilter_simd_mask_t simd ) ;
2014-05-03 00:26:04 +00:00
extern const struct softfilter_implementation * phosphor2x_get_implementation ( softfilter_simd_mask_t simd ) ;
2014-04-30 00:38:13 +00:00
extern const struct softfilter_implementation * twoxbr_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * epx_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * twoxsai_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * supereagle_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * supertwoxsai_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * twoxbr_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * darken_get_implementation ( softfilter_simd_mask_t simd ) ;
extern const struct softfilter_implementation * scale2x_get_implementation ( softfilter_simd_mask_t simd ) ;
# endif
2012-11-26 20:23:31 +00:00
# include "driver_funcs.h"
2012-05-27 12:12:29 +00:00
2013-04-21 08:05:12 +00:00
# ifdef __cplusplus
}
# endif
2012-03-28 22:30:50 +00:00
# endif