/* RetroArch - A frontend for libretro. * Copyright (C) 2010-2014 - Hans-Kristian Arntzen * Copyright (C) 2011-2021 - Daniel De Matteis * Copyright (C) 2016-2019 - Brad Parker * * 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 __RETROARCH_H #define __RETROARCH_H #include #include #include #include #include #include #include #ifdef HAVE_CONFIG_H #include "config.h" #endif #include #include #include #include "gfx/video_driver.h" #include "core.h" #include "runloop.h" #include "retroarch_types.h" RETRO_BEGIN_DECLS #define RETRO_ENVIRONMENT_RETROARCH_START_BLOCK 0x800000 #define RETRO_ENVIRONMENT_SET_SAVE_STATE_IN_BACKGROUND (2 | RETRO_ENVIRONMENT_RETROARCH_START_BLOCK) /* bool * -- * Boolean value that tells the front end to save states in the * background or not. */ #define RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB (3 | RETRO_ENVIRONMENT_RETROARCH_START_BLOCK) /* retro_environment_t * -- * Provides the callback to the frontend method which will cancel * all currently waiting threads. Used when coordination is needed * between the core and the frontend to gracefully stop all threads. */ #define RETRO_ENVIRONMENT_POLL_TYPE_OVERRIDE (4 | RETRO_ENVIRONMENT_RETROARCH_START_BLOCK) /* unsigned * -- * Tells the frontend to override the poll type behavior. * Allows the frontend to influence the polling behavior of the * frontend. * * Will be unset when retro_unload_game is called. * * 0 - Don't Care, no changes, frontend still determines polling type behavior. * 1 - Early * 2 - Normal * 3 - Late */ #define DRIVERS_CMD_ALL \ ( DRIVER_AUDIO_MASK \ | DRIVER_VIDEO_MASK \ | DRIVER_INPUT_MASK \ | DRIVER_CAMERA_MASK \ | DRIVER_LOCATION_MASK \ | DRIVER_MENU_MASK \ | DRIVERS_VIDEO_INPUT_MASK \ | DRIVER_BLUETOOTH_MASK \ | DRIVER_WIFI_MASK \ | DRIVER_LED_MASK \ | DRIVER_MIDI_MASK ) bool retroarch_ctl(enum rarch_ctl_state state, void *data); int retroarch_get_capabilities(enum rarch_capabilities type, char *s, size_t len); void retroarch_override_setting_set(enum rarch_override_setting enum_idx, void *data); void retroarch_override_setting_unset(enum rarch_override_setting enum_idx, void *data); bool retroarch_override_setting_is_set(enum rarch_override_setting enum_idx, void *data); const char* retroarch_get_shader_preset(void); /** * retroarch_main_init: * @argc : Count of (commandline) arguments. * @argv : (Commandline) arguments. * * Initializes the program. * * Returns: 1 (true) on success, otherwise false (0) if there was an error. **/ bool retroarch_main_init(int argc, char *argv[]); bool retroarch_main_quit(void); global_t *global_get_ptr(void); content_state_t *content_state_get_ptr(void); unsigned content_get_subsystem_rom_id(void); int content_get_subsystem(void); void retroarch_menu_running(void); void retroarch_path_set_redirect(settings_t *settings); void retroarch_menu_running_finished(bool quit); enum retro_language rarch_get_language_from_iso(const char *lang); void rarch_favorites_init(void); void rarch_favorites_deinit(void); /* Audio */ /** * config_get_audio_driver_options: * * Get an enumerated list of all audio driver names, separated by '|'. * * Returns: string listing of all audio driver names, separated by '|'. **/ const char* config_get_audio_driver_options(void); /* BSV Movie */ void bsv_movie_frame_rewind(void); /* Camera */ unsigned int retroarch_get_rotation(void); void retroarch_init_task_queue(void); /* Human readable order of input binds */ static const unsigned input_config_bind_order[] = { RETRO_DEVICE_ID_JOYPAD_UP, RETRO_DEVICE_ID_JOYPAD_DOWN, RETRO_DEVICE_ID_JOYPAD_LEFT, RETRO_DEVICE_ID_JOYPAD_RIGHT, RETRO_DEVICE_ID_JOYPAD_A, RETRO_DEVICE_ID_JOYPAD_B, RETRO_DEVICE_ID_JOYPAD_X, RETRO_DEVICE_ID_JOYPAD_Y, RETRO_DEVICE_ID_JOYPAD_SELECT, RETRO_DEVICE_ID_JOYPAD_START, RETRO_DEVICE_ID_JOYPAD_L, RETRO_DEVICE_ID_JOYPAD_R, RETRO_DEVICE_ID_JOYPAD_L2, RETRO_DEVICE_ID_JOYPAD_R2, RETRO_DEVICE_ID_JOYPAD_L3, RETRO_DEVICE_ID_JOYPAD_R3, 19, /* Left Analog Up */ 18, /* Left Analog Down */ 17, /* Left Analog Left */ 16, /* Left Analog Right */ 23, /* Right Analog Up */ 22, /* Right Analog Down */ 21, /* Right Analog Left */ 20, /* Right Analog Right */ }; /* Creates folder and core options stub file for subsequent runs */ bool core_options_create_override(bool game_specific); bool core_options_remove_override(bool game_specific); void core_options_reset(void); void core_options_flush(void); typedef enum apple_view_type { APPLE_VIEW_TYPE_NONE = 0, APPLE_VIEW_TYPE_OPENGL_ES, APPLE_VIEW_TYPE_OPENGL, APPLE_VIEW_TYPE_VULKAN, APPLE_VIEW_TYPE_METAL } apple_view_type_t; bool retroarch_get_current_savestate_path(char *path, size_t len); bool retroarch_get_entry_state_path(char *path, size_t len, unsigned slot); /** * retroarch_fail: * @error_code : Error code. * @error : Error message to show. * * Sanely kills the program. **/ void retroarch_fail(int error_code, const char *error); RETRO_END_DECLS #endif