RetroArch/core_info.h

226 lines
6.4 KiB
C
Raw Normal View History

/* RetroArch - A frontend for libretro.
2014-01-01 00:50:59 +00:00
* Copyright (C) 2010-2014 - Hans-Kristian Arntzen
2017-03-22 02:09:18 +00:00
* Copyright (C) 2011-2017 - Daniel De Matteis
2019-02-22 21:31:54 +00:00
* 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 <http://www.gnu.org/licenses/>.
*/
#ifndef CORE_INFO_H_
#define CORE_INFO_H_
#include <stddef.h>
2016-03-22 03:09:46 +00:00
#include <lists/string_list.h>
#include <retro_common_api.h>
2016-03-22 03:09:46 +00:00
RETRO_BEGIN_DECLS
typedef struct
{
char *path;
char *desc;
2014-09-02 14:13:42 +00:00
/* Set missing once to avoid opening
* the same file several times. */
2014-09-02 03:10:54 +00:00
bool missing;
bool optional;
} core_info_firmware_t;
/* Simple container/convenience struct for
* holding the 'id' of a core file
* > 'id' is the filename without extension or
* platform-specific suffix
* > 'id' is used for core info searches - enables
* matching regardless of core file base path,
* and is platform-independent (e.g. an Android
* core file will be correctly identified on Linux)
* > 'len' is used to cache the length of 'str', for
* improved performance when performing string
* comparisons */
typedef struct
{
char *str;
size_t len;
} core_file_id_t;
typedef struct
{
2017-09-28 07:32:23 +00:00
bool supports_no_game;
bool database_match_archive_member;
2020-05-27 16:00:47 +00:00
bool is_experimental;
bool is_locked;
2017-09-28 07:32:23 +00:00
size_t firmware_count;
char *path;
2015-12-06 19:44:21 +00:00
void *config_data;
char *display_name;
2018-04-30 18:33:05 +00:00
char *display_version;
char *core_name;
char *system_manufacturer;
char *systemname;
2018-08-21 14:41:16 +00:00
char *system_id;
char *supported_extensions;
2013-11-07 23:30:00 +00:00
char *authors;
2013-12-14 18:29:14 +00:00
char *permissions;
2014-09-08 18:18:36 +00:00
char *licenses;
char *categories;
2015-01-25 07:21:02 +00:00
char *databases;
2014-03-03 05:22:28 +00:00
char *notes;
char *required_hw_api;
2020-05-27 16:00:47 +00:00
char *description;
struct string_list *categories_list;
2015-01-25 07:21:02 +00:00
struct string_list *databases_list;
struct string_list *note_list;
struct string_list *supported_extensions_list;
2013-11-07 23:30:00 +00:00
struct string_list *authors_list;
2013-12-14 18:29:14 +00:00
struct string_list *permissions_list;
2014-09-08 18:18:36 +00:00
struct string_list *licenses_list;
struct string_list *required_hw_api_list;
core_info_firmware_t *firmware;
core_file_id_t core_file_id;
2014-11-11 15:28:40 +00:00
void *userdata;
} core_info_t;
2020-05-27 16:00:47 +00:00
/* A subset of core_info parameters required for
* core updater tasks */
typedef struct
{
bool is_experimental;
char *display_name;
char *description;
char *licenses;
} core_updater_info_t;
typedef struct
{
core_info_t *list;
size_t count;
char *all_ext;
} core_info_list_t;
typedef struct core_info_ctx_firmware
{
const char *path;
2016-04-28 17:26:02 +00:00
struct
{
const char *system;
} directory;
} core_info_ctx_firmware_t;
2016-02-07 01:50:16 +00:00
typedef struct core_info_ctx_find
{
core_info_t *inf;
const char *path;
} core_info_ctx_find_t;
enum core_info_list_qsort_type
{
CORE_INFO_LIST_SORT_PATH = 0,
CORE_INFO_LIST_SORT_DISPLAY_NAME,
CORE_INFO_LIST_SORT_CORE_NAME,
CORE_INFO_LIST_SORT_SYSTEM_NAME
};
struct core_info_state
{
#ifdef HAVE_COMPRESSION
const struct string_list *tmp_list;
#endif
const char *tmp_path;
core_info_t *current;
core_info_list_t *curr_list;
};
typedef struct core_info_state core_info_state_t;
size_t core_info_list_num_info_files(core_info_list_t *list);
2014-09-02 03:10:54 +00:00
/* Non-reentrant, does not allocate. Returns pointer to internal state. */
void core_info_list_get_supported_cores(core_info_list_t *list,
const char *path, const core_info_t **infos, size_t *num_infos);
bool core_info_list_get_display_name(core_info_list_t *list,
2016-02-07 12:38:23 +00:00
const char *path, char *s, size_t len);
2015-07-04 17:58:43 +00:00
bool core_info_get_display_name(const char *path, char *s, size_t len);
2020-05-27 16:00:47 +00:00
/* Returns core_info parameters required for
* core updater tasks, read from specified file.
* Returned core_updater_info_t object must be
* freed using core_info_free_core_updater_info().
* Returns NULL if 'path' is invalid. */
core_updater_info_t *core_info_get_core_updater_info(const char *path);
void core_info_free_core_updater_info(core_updater_info_t *info);
void core_info_get_name(const char *path, char *s, size_t len,
const char *path_info, const char *dir_cores,
const char *exts, bool show_hidden_files,
bool get_display_name);
2015-07-04 18:17:59 +00:00
2015-11-19 22:20:13 +00:00
core_info_t *core_info_get(core_info_list_t *list, size_t i);
void core_info_free_current_core(core_info_state_t *p_coreinfo);
2016-05-09 16:11:17 +00:00
bool core_info_init_current_core(void);
bool core_info_get_current_core(core_info_t **core);
void core_info_deinit_list(void);
bool core_info_init_list(const char *path_info, const char *dir_cores,
const char *exts, bool show_hidden_files);
2016-05-09 16:11:17 +00:00
bool core_info_get_list(core_info_list_t **core);
bool core_info_list_update_missing_firmware(core_info_ctx_firmware_t *info,
bool *set_missing_bios);
2016-05-09 16:11:17 +00:00
bool core_info_find(core_info_ctx_find_t *info);
2016-05-09 16:11:17 +00:00
bool core_info_load(
core_info_ctx_find_t *info,
core_info_state_t *p_coreinfo);
2016-02-07 01:18:26 +00:00
bool core_info_database_supports_content_path(const char *database_path, const char *path);
bool core_info_database_match_archive_member(const char *database_path);
bool core_info_unsupported_content_path(const char *path);
void core_info_qsort(core_info_list_t *core_info_list, enum core_info_list_qsort_type qsort_type);
bool core_info_list_get_info(core_info_list_t *core_info_list,
core_info_t *out_info, const char *path);
bool core_info_hw_api_supported(core_info_t *info);
/* Sets 'locked' status of specified core
* > Returns true if successful
* > Like all functions that access the cached
* core info list this is *not* thread safe */
bool core_info_set_core_lock(const char *core_path, bool lock);
/* Fetches 'locked' status of specified core
* > If 'validate_path' is 'true', will search
* cached core info list for a corresponding
* 'sanitised' core file path. This is *not*
* thread safe
* > If 'validate_path' is 'false', performs a
* direct filesystem check. This *is* thread
* safe, but validity of specified core path
* must be checked externally */
bool core_info_get_core_lock(const char *core_path, bool validate_path);
core_info_state_t *coreinfo_get_ptr(void);
RETRO_END_DECLS
#endif /* CORE_INFO_H_ */