RetroArch/menu/menu_setting.h
2016-09-11 17:28:57 +02:00

184 lines
6.6 KiB
C

/* RetroArch - A frontend for libretro.
* Copyright (C) 2010-2014 - Hans-Kristian Arntzen
* Copyright (C) 2011-2016 - 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 <http://www.gnu.org/licenses/>.
*/
#ifndef _MENU_SETTING_H
#define _MENU_SETTING_H
#include <stdint.h>
#include <stdlib.h>
#include <boolean.h>
#include <retro_common_api.h>
#include "../setting_list.h"
RETRO_BEGIN_DECLS
enum menu_setting_ctl_state
{
MENU_SETTING_CTL_NONE = 0,
MENU_SETTING_CTL_NEW,
MENU_SETTING_CTL_IS_OF_PATH_TYPE,
MENU_SETTING_CTL_ACTION_RIGHT
};
enum setting_list_flags
{
SL_FLAG_MAIN_MENU = (1 << 0),
SL_FLAG_SETTINGS = (1 << 1),
SL_FLAG_SETTINGS_DRIVER_OPTIONS = (1 << 2),
SL_FLAG_SETTINGS_CORE_OPTIONS = (1 << 3),
SL_FLAG_SETTINGS_CONFIGURATION_OPTIONS = (1 << 4),
SL_FLAG_SETTINGS_REWIND_OPTIONS = (1 << 5),
SL_FLAG_SETTINGS_VIDEO_OPTIONS = (1 << 6),
SL_FLAG_SETTINGS_SHADER_OPTIONS = (1 << 7),
SL_FLAG_SETTINGS_FONT_OPTIONS = (1 << 8),
SL_FLAG_SETTINGS_AUDIO_OPTIONS = (1 << 9),
SL_FLAG_SETTINGS_INPUT_OPTIONS = (1 << 10),
SL_FLAG_SETTINGS_INPUT_HOTKEY_OPTIONS = (1 << 11),
SL_FLAG_SETTINGS_OVERLAY_OPTIONS = (1 << 12),
SL_FLAG_SETTINGS_MENU_OPTIONS = (1 << 13),
SL_FLAG_SETTINGS_MULTIMEDIA_OPTIONS = (1 << 14),
SL_FLAG_SETTINGS_UI_OPTIONS = (1 << 15),
SL_FLAG_SETTINGS_CHEEVOS_OPTIONS = (1 << 16),
SL_FLAG_SETTINGS_CORE_UPDATER_OPTIONS = (1 << 17),
SL_FLAG_SETTINGS_NETPLAY_OPTIONS = (1 << 18),
SL_FLAG_SETTINGS_USER_OPTIONS = (1 << 19),
SL_FLAG_SETTINGS_DIRECTORY_OPTIONS = (1 << 20),
SL_FLAG_SETTINGS_PRIVACY_OPTIONS = (1 << 21),
SL_FLAG_SETTINGS_PLAYLIST_OPTIONS = (1 << 22),
SL_FLAG_SETTINGS_MENU_BROWSER_OPTIONS = (1 << 23),
SL_FLAG_SETTINGS_PATCH_OPTIONS = (1 << 24),
SL_FLAG_SETTINGS_RECORDING_OPTIONS = (1 << 25),
SL_FLAG_SETTINGS_FRAME_THROTTLE_OPTIONS = (1 << 26),
SL_FLAG_SETTINGS_LOGGING_OPTIONS = (1 << 27),
SL_FLAG_SETTINGS_SAVING_OPTIONS = (1 << 28),
SL_FLAG_SETTINGS_SUB_ACCOUNTS_OPTIONS = (1 << 29),
SL_FLAG_SETTINGS_ALL = (1 << 30)
};
#define SL_FLAG_SETTINGS_GROUP_ALL (SL_FLAG_SETTINGS_ALL - SL_FLAG_MAIN_MENU)
int menu_setting_generic(rarch_setting_t *setting, bool wraparound);
int menu_setting_set_flags(rarch_setting_t *setting);
int menu_setting_set(unsigned type, const char *label,
unsigned action, bool wraparound);
/**
* menu_setting_find:
* @name : name of setting to search for
*
* Search for a setting with a specified name (@name).
*
* Returns: pointer to setting if found, NULL otherwise.
**/
rarch_setting_t *menu_setting_find(const char *label);
rarch_setting_t *menu_setting_find_enum(enum msg_hash_enums enum_idx);
/**
* setting_get_string_representation:
* @setting : pointer to setting
* @s : buffer to write contents of string representation to.
* @len : size of the buffer (@s)
*
* Get a setting value's string representation.
**/
void menu_setting_get_string_representation(void *data, char *s, size_t len);
/**
* menu_setting_get_label:
* @list : File list on which to perform the search
* @s : String for the type to be represented on-screen as
* a label.
* @len : Size of @s.
* @w : Width of the string (for text label representation
* purposes in the menu display driver).
* @type : Identifier of setting.
* @menu_label : Menu Label identifier of setting.
* @label : Label identifier of setting.
* @idx : Index identifier of setting.
*
* Get associated label of a setting.
**/
void menu_setting_get_label(void *data, char *s,
size_t len, unsigned *w, unsigned type,
const char *menu_label, const char *label, unsigned idx);
int menu_action_handle_setting(rarch_setting_t *setting,
unsigned type, unsigned action, bool wraparound);
enum setting_type menu_setting_get_browser_selection_type(rarch_setting_t *setting);
enum msg_hash_enums menu_setting_get_enum_idx(rarch_setting_t *setting);
const char *menu_setting_get_values(rarch_setting_t *setting);
const char *menu_setting_get_name(rarch_setting_t *setting);
const char *menu_setting_get_short_description(rarch_setting_t *setting);
const char *menu_setting_get_parent_group(rarch_setting_t *setting);
uint32_t menu_setting_get_index(rarch_setting_t *setting);
void *setting_get_ptr(rarch_setting_t *setting);
void menu_settings_list_increment(rarch_setting_t **list);
void general_write_handler(void *data);
void general_read_handler(void *data);
void menu_settings_list_current_add_cmd(
rarch_setting_t **list,
rarch_setting_info_t *list_info,
enum event_command values);
void menu_settings_list_current_add_range(
rarch_setting_t **list,
rarch_setting_info_t *list_info,
float min, float max, float step,
bool enforce_minrange_enable, bool enforce_maxrange_enable);
void settings_data_list_current_add_flags(
rarch_setting_t **list,
rarch_setting_info_t *list_info,
unsigned values);
void settings_data_list_current_add_free_flags(
rarch_setting_t **list,
rarch_setting_info_t *list_info,
unsigned values);
void menu_settings_list_current_add_enum_idx(
rarch_setting_t **list,
rarch_setting_info_t *list_info,
enum msg_hash_enums enum_idx);
bool menu_setting_free(void *data);
bool settings_list_append(rarch_setting_t **list,
rarch_setting_info_t *list_info);
bool menu_setting_ctl(enum menu_setting_ctl_state state, void *data);
RETRO_END_DECLS
#endif