emulate/app/src/main/cpp/libretro.h

/* Minimal vendored libretro.h - stable C API for emulator cores.
 * Based on the canonical libretro API specification.
 * Only includes types/constants needed by our frontend. */

#ifndef LIBRETRO_H__
#define LIBRETRO_H__

#include <stdint.h>
#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif

#define RETRO_API_VERSION 1

/* Pixel formats */
#define RETRO_PIXEL_FORMAT_0RGB1555  0
#define RETRO_PIXEL_FORMAT_XRGB8888  1
#define RETRO_PIXEL_FORMAT_RGB565    2

/* Device types */
#define RETRO_DEVICE_NONE     0
#define RETRO_DEVICE_JOYPAD   1
#define RETRO_DEVICE_MOUSE    2
#define RETRO_DEVICE_KEYBOARD 3
#define RETRO_DEVICE_LIGHTGUN 4
#define RETRO_DEVICE_ANALOG   5

/* Joypad button IDs */
#define RETRO_DEVICE_ID_JOYPAD_B        0
#define RETRO_DEVICE_ID_JOYPAD_Y        1
#define RETRO_DEVICE_ID_JOYPAD_SELECT   2
#define RETRO_DEVICE_ID_JOYPAD_START    3
#define RETRO_DEVICE_ID_JOYPAD_UP       4
#define RETRO_DEVICE_ID_JOYPAD_DOWN     5
#define RETRO_DEVICE_ID_JOYPAD_LEFT     6
#define RETRO_DEVICE_ID_JOYPAD_RIGHT    7
#define RETRO_DEVICE_ID_JOYPAD_A        8
#define RETRO_DEVICE_ID_JOYPAD_X        9
#define RETRO_DEVICE_ID_JOYPAD_L       10
#define RETRO_DEVICE_ID_JOYPAD_R       11
#define RETRO_DEVICE_ID_JOYPAD_L2      12
#define RETRO_DEVICE_ID_JOYPAD_R2      13
#define RETRO_DEVICE_ID_JOYPAD_L3      14
#define RETRO_DEVICE_ID_JOYPAD_R3      15

/* Analog indices */
#define RETRO_DEVICE_INDEX_ANALOG_LEFT   0
#define RETRO_DEVICE_INDEX_ANALOG_RIGHT  1
#define RETRO_DEVICE_ID_ANALOG_X         0
#define RETRO_DEVICE_ID_ANALOG_Y         1

/* Memory types */
#define RETRO_MEMORY_SAVE_RAM    0
#define RETRO_MEMORY_RTC         1
#define RETRO_MEMORY_SYSTEM_RAM  2
#define RETRO_MEMORY_VIDEO_RAM   3

/* Environment callback commands */
#define RETRO_ENVIRONMENT_SET_ROTATION                  1
#define RETRO_ENVIRONMENT_GET_OVERSCAN                  2
#define RETRO_ENVIRONMENT_GET_CAN_DUPE                  3
#define RETRO_ENVIRONMENT_SET_MESSAGE                   6
#define RETRO_ENVIRONMENT_SHUTDOWN                      7
#define RETRO_ENVIRONMENT_SET_PERFORMANCE_LEVEL         8
#define RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY          9
#define RETRO_ENVIRONMENT_SET_PIXEL_FORMAT             10
#define RETRO_ENVIRONMENT_SET_INPUT_DESCRIPTORS        11
#define RETRO_ENVIRONMENT_SET_KEYBOARD_CALLBACK        12
#define RETRO_ENVIRONMENT_SET_DISK_CONTROL_INTERFACE   13
#define RETRO_ENVIRONMENT_SET_HW_RENDER                14
#define RETRO_ENVIRONMENT_GET_VARIABLE                 15
#define RETRO_ENVIRONMENT_SET_VARIABLES                16
#define RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE          17
#define RETRO_ENVIRONMENT_SET_SUPPORT_NO_GAME          18
#define RETRO_ENVIRONMENT_GET_LIBRETRO_PATH            19
#define RETRO_ENVIRONMENT_SET_FRAME_TIME_CALLBACK      21
#define RETRO_ENVIRONMENT_SET_AUDIO_CALLBACK           22
#define RETRO_ENVIRONMENT_GET_RUMBLE_INTERFACE         23
#define RETRO_ENVIRONMENT_GET_INPUT_DEVICE_CAPABILITIES 24
#define RETRO_ENVIRONMENT_GET_LOG_INTERFACE            27
#define RETRO_ENVIRONMENT_GET_PERF_INTERFACE           28
#define RETRO_ENVIRONMENT_GET_CORE_ASSETS_DIRECTORY    30
#define RETRO_ENVIRONMENT_GET_SAVE_DIRECTORY           31
#define RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO           32
#define RETRO_ENVIRONMENT_SET_SUBSYSTEM_INFO           34
#define RETRO_ENVIRONMENT_SET_CONTROLLER_INFO          35
#define RETRO_ENVIRONMENT_SET_MEMORY_MAPS              36
#define RETRO_ENVIRONMENT_SET_GEOMETRY                 37
#define RETRO_ENVIRONMENT_GET_USERNAME                 38
#define RETRO_ENVIRONMENT_GET_LANGUAGE                 39
#define RETRO_ENVIRONMENT_SET_SUPPORT_ACHIEVEMENTS     42
#define RETRO_ENVIRONMENT_SET_SERIALIZATION_QUIRKS     44
#define RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE       47
#define RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION     52
#define RETRO_ENVIRONMENT_SET_CORE_OPTIONS             53
#define RETRO_ENVIRONMENT_SET_CORE_OPTIONS_INTL        54
#define RETRO_ENVIRONMENT_SET_CORE_OPTIONS_DISPLAY     55
#define RETRO_ENVIRONMENT_GET_PREFERRED_HW_RENDER      56
#define RETRO_ENVIRONMENT_SET_CORE_OPTIONS_V2          67
#define RETRO_ENVIRONMENT_SET_CORE_OPTIONS_V2_INTL     68
#define RETRO_ENVIRONMENT_SET_CORE_OPTIONS_UPDATE_DISPLAY_CALLBACK 69

/* Log levels */
enum retro_log_level {
    RETRO_LOG_DEBUG = 0,
    RETRO_LOG_INFO,
    RETRO_LOG_WARN,
    RETRO_LOG_ERROR
};

typedef void (*retro_log_printf_t)(enum retro_log_level level, const char *fmt, ...);

struct retro_log_callback {
    retro_log_printf_t log;
};

struct retro_variable {
    const char *key;
    const char *value;
};

struct retro_game_info {
    const char *path;
    const void *data;
    size_t      size;
    const char *meta;
};

struct retro_system_timing {
    double fps;
    double sample_rate;
};

struct retro_game_geometry {
    unsigned base_width;
    unsigned base_height;
    unsigned max_width;
    unsigned max_height;
    float    aspect_ratio;
};

struct retro_system_av_info {
    struct retro_game_geometry geometry;
    struct retro_system_timing timing;
};

struct retro_system_info {
    const char *library_name;
    const char *library_version;
    const char *valid_extensions;
    bool        need_fullpath;
    bool        block_extract;
};

struct retro_message {
    const char *msg;
    unsigned    frames;
};

struct retro_input_descriptor {
    unsigned    port;
    unsigned    device;
    unsigned    index;
    unsigned    id;
    const char *description;
};

struct retro_core_option_value {
    const char *value;
    const char *label;
};

struct retro_core_option_definition {
    const char *key;
    const char *desc;
    const char *info;
    struct retro_core_option_value values[128];
    const char *default_value;
};

struct retro_core_option_v2_category {
    const char *key;
    const char *desc;
    const char *info;
};

struct retro_core_option_v2_definition {
    const char *key;
    const char *desc;
    const char *desc_categorized;
    const char *info;
    const char *info_categorized;
    const char *category_key;
    struct retro_core_option_value values[128];
    const char *default_value;
};

struct retro_core_options_v2 {
    struct retro_core_option_v2_category *categories;
    struct retro_core_option_v2_definition *definitions;
};

struct retro_core_options_v2_intl {
    struct retro_core_options_v2 *us;
    struct retro_core_options_v2 *local;
};

/* Callback types */
typedef bool (*retro_environment_t)(unsigned cmd, void *data);
typedef void (*retro_video_refresh_t)(const void *data, unsigned width, unsigned height, size_t pitch);
typedef void (*retro_audio_sample_t)(int16_t left, int16_t right);
typedef size_t (*retro_audio_sample_batch_t)(const int16_t *data, size_t frames);
typedef void (*retro_input_poll_t)(void);
typedef int16_t (*retro_input_state_t)(unsigned port, unsigned device, unsigned index, unsigned id);

/* Core function pointer types */
typedef void (*retro_set_environment_t)(retro_environment_t);
typedef void (*retro_set_video_refresh_t)(retro_video_refresh_t);
typedef void (*retro_set_audio_sample_t)(retro_audio_sample_t);
typedef void (*retro_set_audio_sample_batch_t)(retro_audio_sample_batch_t);
typedef void (*retro_set_input_poll_t)(retro_input_poll_t);
typedef void (*retro_set_input_state_t)(retro_input_state_t);
typedef void (*retro_init_t)(void);
typedef void (*retro_deinit_t)(void);
typedef unsigned (*retro_api_version_t)(void);
typedef void (*retro_get_system_info_t)(struct retro_system_info *info);
typedef void (*retro_get_system_av_info_t)(struct retro_system_av_info *info);
typedef void (*retro_set_controller_port_device_t)(unsigned port, unsigned device);
typedef void (*retro_reset_t)(void);
typedef void (*retro_run_t)(void);
typedef bool (*retro_load_game_t)(const struct retro_game_info *game);
typedef void (*retro_unload_game_t)(void);
typedef size_t (*retro_serialize_size_t)(void);
typedef bool (*retro_serialize_t)(void *data, size_t size);
typedef bool (*retro_unserialize_t)(const void *data, size_t size);
typedef void *(*retro_get_memory_data_t)(unsigned id);
typedef size_t (*retro_get_memory_size_t)(unsigned id);

#ifdef __cplusplus
}
#endif

#endif /* LIBRETRO_H__ */