mirror of
https://github.com/libretro/RetroArch
synced 2025-02-01 00:32:46 +00:00
9efc1f500d
When running on Android, RetroArch considers most devices that emit dpad events as gamepads, even if they also emit other keyboard events; this is usually the right thing to do, but it has the side effect of not letting some actual keyboards (e.g.: Logitech K480) act as such inside RetroArch. This configuration option allows users to manually select a specific input device to act as a physical keyboard instead of a gamepad, which is handy when emulating computers as opposed to consoles.
738 lines
33 KiB
C
738 lines
33 KiB
C
/* RetroArch - A frontend for libretro.
|
|
* Copyright (C) 2011-2017 - 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 <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
|
|
#include <compat/strl.h>
|
|
#include <string/stdstring.h>
|
|
|
|
#include "../msg_hash.h"
|
|
#include "../verbosity.h"
|
|
|
|
#ifdef RARCH_INTERNAL
|
|
#include "../configuration.h"
|
|
#include "../config.def.h"
|
|
|
|
int msg_hash_get_help_us_enum(enum msg_hash_enums msg, char *s, size_t len)
|
|
{
|
|
settings_t *settings = config_get_ptr();
|
|
|
|
if (msg <= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_END &&
|
|
msg >= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN)
|
|
{
|
|
unsigned idx = msg - MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN;
|
|
|
|
switch (idx)
|
|
{
|
|
case RARCH_QUIT_KEY:
|
|
snprintf(s, len,
|
|
"Key to exit RetroArch cleanly. \n"
|
|
" \n"
|
|
"Killing it in any hard way (SIGKILL, etc.) will \n"
|
|
"terminate RetroArch without saving RAM, etc."
|
|
#ifdef __unix__
|
|
"\nOn Unix-likes, SIGINT/SIGTERM allows a clean \n"
|
|
"deinitialization."
|
|
#endif
|
|
"");
|
|
break;
|
|
case RARCH_STATE_SLOT_PLUS:
|
|
case RARCH_STATE_SLOT_MINUS:
|
|
snprintf(s, len,
|
|
"State slots. \n"
|
|
" \n"
|
|
"With slot set to 0, save state name is \n"
|
|
"*.state (or whatever defined on commandline). \n"
|
|
" \n"
|
|
"When slot is not 0, path will be <path><d>, \n"
|
|
"where <d> is slot number.");
|
|
break;
|
|
case RARCH_ENABLE_HOTKEY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_ENABLE_HOTKEY), len);
|
|
break;
|
|
default:
|
|
if (string_is_empty(s))
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
|
|
break;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
switch (msg)
|
|
{
|
|
case MENU_ENUM_LABEL_ACCOUNTS_RETRO_ACHIEVEMENTS:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_ACCOUNTS_RETRO_ACHIEVEMENTS), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_USER_LANGUAGE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_USER_LANGUAGE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_CONFIG:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_CONFIG), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_COMPRESSED_ARCHIVE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_COMPRESSED_ARCHIVE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_RECORD_CONFIG:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_RECORD_CONFIG), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_CURSOR:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_CURSOR), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_CONFIG:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_CONFIG), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_SCAN_THIS_DIRECTORY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_SCAN_THIS_DIRECTORY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_USE_THIS_DIRECTORY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_USE_THIS_DIRECTORY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_DUMMY_ON_CORE_SHUTDOWN:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_DUMMY_ON_CORE_SHUTDOWN), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_CHECK_FOR_MISSING_FIRMWARE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_CHECK_FOR_MISSING_FIRMWARE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_PARENT_DIRECTORY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_PARENT_DIRECTORY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_OPEN_UWP_PERMISSIONS:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_OPEN_UWP_PERMISSIONS), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_SHADER_PRESET:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_SHADER_PRESET), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_SHADER:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_SHADER), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_REMAP:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_REMAP), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_CHEAT:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_CHEAT), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_OVERLAY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_OVERLAY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_RDB:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_RDB), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_FONT:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_FONT), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_PLAIN_FILE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_PLAIN_FILE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_MOVIE_OPEN:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_MOVIE_OPEN), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_MUSIC_OPEN:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_MUSIC_OPEN), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_IMAGE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_IMAGE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_IMAGE_OPEN_WITH_VIEWER:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_IMAGE_OPEN_WITH_VIEWER), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_CORE_SELECT_FROM_COLLECTION:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_CORE_SELECT_FROM_COLLECTION), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_CORE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_CORE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FILE_BROWSER_DIRECTORY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FILE_BROWSER_DIRECTORY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_INPUT_POLL_TYPE_BEHAVIOR:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_INPUT_POLL_TYPE_BEHAVIOR), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_CORE_LIST:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_CORE_LIST), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_MENU_ENUM_CONTROLS_PROLOG:
|
|
snprintf(s, len,
|
|
"You can use the following controls below \n"
|
|
"on either your gamepad or keyboard in order\n"
|
|
"to control the menu: \n"
|
|
" \n");
|
|
break;
|
|
case MENU_ENUM_LABEL_WELCOME_TO_RETROARCH:
|
|
snprintf(s, len,
|
|
"Welcome to RetroArch\n");
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_HELP_AUDIO_VIDEO_TROUBLESHOOTING_DESC:
|
|
{
|
|
/* Work around C89 limitations */
|
|
char u[501];
|
|
const char *t =
|
|
"RetroArch relies on an unique form of\n"
|
|
"audio/video synchronization where it needs to be\n"
|
|
"calibrated against the refresh rate of your\n"
|
|
"display for best performance results.\n"
|
|
" \n"
|
|
"If you experience any audio crackling or video\n"
|
|
"tearing, usually it means that you need to\n"
|
|
"calibrate the settings. Some choices below:\n"
|
|
" \n";
|
|
snprintf(u, sizeof(u), /* can't inline this due to the printf arguments */
|
|
"a) Go to '%s' -> '%s', and enable\n"
|
|
"'Threaded Video'. Refresh rate will not matter\n"
|
|
"in this mode, framerate will be higher,\n"
|
|
"but video might be less smooth.\n"
|
|
"b) Go to '%s' -> '%s', and look at\n"
|
|
"'%s'. Let it run for\n"
|
|
"2048 frames, then press 'OK'.",
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SETTINGS),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_VIDEO_SETTINGS),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SETTINGS),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_VIDEO_SETTINGS),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_VIDEO_REFRESH_RATE_AUTO));
|
|
strlcpy(s, t, len);
|
|
strlcat(s, u, len);
|
|
}
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_HELP_SCANNING_CONTENT_DESC:
|
|
snprintf(s, len,
|
|
"To scan for content, go to '%s' and\n"
|
|
"select either '%s' or %s'.\n"
|
|
"\n"
|
|
"Files will be compared to database entries.\n"
|
|
"If there is a match, it will add an entry\n"
|
|
"to a playlist.\n"
|
|
"\n"
|
|
"You can then easily access this content by\n"
|
|
"going to '%s' ->\n"
|
|
"'%s'\n"
|
|
"instead of having to go through the\n"
|
|
"file browser every time.\n"
|
|
"\n"
|
|
"NOTE: Content for some cores might still not be\n"
|
|
"scannable.",
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_ADD_CONTENT_LIST),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SCAN_DIRECTORY),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SCAN_FILE),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_LOAD_CONTENT_LIST),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_PLAYLISTS_TAB));
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_EXTRACTING_PLEASE_WAIT:
|
|
snprintf(s, len,
|
|
"Welcome to RetroArch\n"
|
|
"\n"
|
|
"Extracting assets, please wait.\n"
|
|
"This might take a while...\n");
|
|
break;
|
|
case MENU_ENUM_LABEL_INPUT_DRIVER:
|
|
{
|
|
const char *lbl = settings ? settings->arrays.input_driver : NULL;
|
|
|
|
if (string_is_equal(lbl, msg_hash_to_str(MENU_ENUM_LABEL_INPUT_DRIVER_UDEV)))
|
|
snprintf(s, len,
|
|
"udev Input driver. \n"
|
|
" \n"
|
|
"It uses the recent evdev joypad API \n"
|
|
"for joystick support. It supports \n"
|
|
"hotplugging and force feedback. \n"
|
|
" \n"
|
|
"The driver reads evdev events for keyboard \n"
|
|
"support. It also supports keyboard callback, \n"
|
|
"mice and touchpads. \n"
|
|
" \n"
|
|
"By default in most distros, /dev/input nodes \n"
|
|
"are root-only (mode 600). You can set up a udev \n"
|
|
"rule which makes these accessible to non-root.");
|
|
else if (string_is_equal(lbl,
|
|
msg_hash_to_str(MENU_ENUM_LABEL_INPUT_DRIVER_LINUXRAW)))
|
|
snprintf(s, len,
|
|
"linuxraw Input driver. \n"
|
|
" \n"
|
|
"This driver requires an active TTY. Keyboard \n"
|
|
"events are read directly from the TTY which \n"
|
|
"makes it simpler, but not as flexible as udev. \n" "Mice, etc, are not supported at all. \n"
|
|
" \n"
|
|
"This driver uses the older joystick API \n"
|
|
"(/dev/input/js*).");
|
|
else
|
|
snprintf(s, len,
|
|
"Input driver.\n"
|
|
" \n"
|
|
"Depending on video driver, it might \n"
|
|
"force a different input driver.");
|
|
}
|
|
break;
|
|
case MENU_ENUM_LABEL_LOAD_CONTENT_LIST:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_LOAD_CONTENT_LIST), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_LOAD_CONTENT_HISTORY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_LOAD_CONTENT_HISTORY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_DRIVER:
|
|
{
|
|
const char *video_driver = settings->arrays.video_driver;
|
|
|
|
snprintf(s, len,
|
|
"Current Video driver.");
|
|
|
|
if (string_is_equal(video_driver, "gl"))
|
|
{
|
|
snprintf(s, len,
|
|
"OpenGL Video driver. \n"
|
|
" \n"
|
|
"This driver allows libretro GL cores to \n"
|
|
"be used in addition to software-rendered \n"
|
|
"core implementations.\n"
|
|
" \n"
|
|
"Performance for software-rendered and \n"
|
|
"libretro GL core implementations is \n"
|
|
"dependent on your graphics card's \n"
|
|
"underlying GL driver).");
|
|
}
|
|
else if (string_is_equal(video_driver, "sdl2"))
|
|
{
|
|
snprintf(s, len,
|
|
"SDL 2 Video driver.\n"
|
|
" \n"
|
|
"This is an SDL 2 software-rendered video \n"
|
|
"driver.\n"
|
|
" \n"
|
|
"Performance for software-rendered libretro \n"
|
|
"core implementations is dependent \n"
|
|
"on your platform SDL implementation.");
|
|
}
|
|
else if (string_is_equal(video_driver, "sdl1"))
|
|
{
|
|
snprintf(s, len,
|
|
"SDL Video driver.\n"
|
|
" \n"
|
|
"This is an SDL 1.2 software-rendered video \n"
|
|
"driver.\n"
|
|
" \n"
|
|
"Performance is considered to be suboptimal. \n"
|
|
"Consider using it only as a last resort.");
|
|
}
|
|
else if (string_is_equal(video_driver, "d3d"))
|
|
{
|
|
snprintf(s, len,
|
|
"Direct3D Video driver. \n"
|
|
" \n"
|
|
"Performance for software-rendered cores \n"
|
|
"is dependent on your graphic card's \n"
|
|
"underlying D3D driver).");
|
|
}
|
|
else if (string_is_equal(video_driver, "exynos"))
|
|
{
|
|
snprintf(s, len,
|
|
"Exynos-G2D Video Driver. \n"
|
|
" \n"
|
|
"This is a low-level Exynos video driver. \n"
|
|
"Uses the G2D block in Samsung Exynos SoC \n"
|
|
"for blit operations. \n"
|
|
" \n"
|
|
"Performance for software rendered cores \n"
|
|
"should be optimal.");
|
|
}
|
|
else if (string_is_equal(video_driver, "drm"))
|
|
{
|
|
snprintf(s, len,
|
|
"Plain DRM Video Driver. \n"
|
|
" \n"
|
|
"This is a low-level video driver using. \n"
|
|
"libdrm for hardware scaling using \n"
|
|
"GPU overlays.");
|
|
}
|
|
else if (string_is_equal(video_driver, "sunxi"))
|
|
{
|
|
snprintf(s, len,
|
|
"Sunxi-G2D Video Driver. \n"
|
|
" \n"
|
|
"This is a low-level Sunxi video driver. \n"
|
|
"Uses the G2D block in Allwinner SoCs.");
|
|
}
|
|
}
|
|
break;
|
|
case MENU_ENUM_LABEL_AUDIO_RESAMPLER_DRIVER:
|
|
{
|
|
const char *lbl = settings ? settings->arrays.audio_resampler : NULL;
|
|
|
|
if (string_is_equal(lbl, msg_hash_to_str(
|
|
MENU_ENUM_LABEL_AUDIO_RESAMPLER_DRIVER_SINC)))
|
|
strlcpy(s,
|
|
"Windowed SINC implementation.", len);
|
|
else if (string_is_equal(lbl, msg_hash_to_str(
|
|
MENU_ENUM_LABEL_AUDIO_RESAMPLER_DRIVER_CC)))
|
|
strlcpy(s,
|
|
"Convoluted Cosine implementation.", len);
|
|
else if (string_is_empty(s))
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
|
|
}
|
|
break;
|
|
|
|
case MENU_ENUM_LABEL_VIDEO_SHADER_PRESET:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_SHADER_PRESET), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_SHADER_SCALE_PASS:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_SHADER_SCALE_PASS), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_SHADER_NUM_PASSES:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_SHADER_NUM_PASSES), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_SHADER_PASS:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_SHADER_PASS), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_CONFIG_SAVE_ON_EXIT:
|
|
snprintf(s, len,
|
|
"Saves config to disk on exit.\n"
|
|
"Useful for menu as settings can be\n"
|
|
"modified. Overwrites the config.\n"
|
|
" \n"
|
|
"#include's and comments are not \n"
|
|
"preserved. \n"
|
|
" \n"
|
|
"By design, the config file is \n"
|
|
"considered immutable as it is \n"
|
|
"likely maintained by the user, \n"
|
|
"and should not be overwritten \n"
|
|
"behind the user's back."
|
|
#if defined(RARCH_CONSOLE) || defined(RARCH_MOBILE)
|
|
"\nThis is not not the case on \n"
|
|
"consoles however, where \n"
|
|
"looking at the config file \n"
|
|
"manually isn't really an option."
|
|
#endif
|
|
);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_SHADER_FILTER_PASS:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_SHADER_FILTER_PASS), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_AUTOSAVE_INTERVAL:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_AUTOSAVE_INTERVAL), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_INPUT_ADC_TYPE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_INPUT_ADC_TYPE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_LIBRETRO_LOG_LEVEL:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_LIBRETRO_LOG_LEVEL), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_SHADER_APPLY_CHANGES:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_SHADER_APPLY_CHANGES), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_SHADER_WATCH_FOR_CHANGES:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_SHADER_WATCH_FOR_CHANGES), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_FILTER:
|
|
#ifdef HAVE_FILTERS_BUILTIN
|
|
snprintf(s, len,
|
|
"CPU-based video filter.");
|
|
#else
|
|
snprintf(s, len,
|
|
"CPU-based video filter.\n"
|
|
" \n"
|
|
"Path to a dynamic library.");
|
|
#endif
|
|
break;
|
|
case MENU_ENUM_LABEL_AUDIO_DEVICE:
|
|
snprintf(s, len,
|
|
"Override the default audio device \n"
|
|
"the audio driver uses.\n"
|
|
"This is driver dependent. E.g.\n"
|
|
#ifdef HAVE_ALSA
|
|
" \n"
|
|
"ALSA wants a PCM device."
|
|
#endif
|
|
#ifdef HAVE_OSS
|
|
" \n"
|
|
"OSS wants a path (e.g. /dev/dsp)."
|
|
#endif
|
|
#ifdef HAVE_JACK
|
|
" \n"
|
|
"JACK wants portnames (e.g. system:playback1\n"
|
|
",system:playback_2)."
|
|
#endif
|
|
#ifdef HAVE_RSOUND
|
|
" \n"
|
|
"RSound wants an IP address to an RSound \n"
|
|
"server."
|
|
#endif
|
|
);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_REFRESH_RATE_AUTO:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_REFRESH_RATE_AUTO), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_FASTFORWARD_RATIO:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_FASTFORWARD_RATIO), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VRR_RUNLOOP_ENABLE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VRR_RUNLOOP_ENABLE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MONITOR_INDEX:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_MONITOR_INDEX), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_AUDIO_VOLUME:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_AUDIO_VOLUME), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_AUDIO_RATE_CONTROL_DELTA:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_AUDIO_RATE_CONTROL_DELTA), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_AUDIO_MAX_TIMING_SKEW:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_AUDIO_MAX_TIMING_SKEW), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_DISABLE_COMPOSITION:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_DISABLE_COMPOSITION), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_THREADED:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_THREADED), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_FRAME_DELAY:
|
|
snprintf(s, len,
|
|
"Sets how many milliseconds to delay\n"
|
|
"after VSync before running the core.\n"
|
|
"\n"
|
|
"Can reduce latency at the cost of\n"
|
|
"higher risk of stuttering.\n"
|
|
" \n"
|
|
"Maximum is %d.", MAXIMUM_FRAME_DELAY);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_FRAME_DELAY_AUTO:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_FRAME_DELAY_AUTO), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_HARD_SYNC_FRAMES:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_HARD_SYNC_FRAMES), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_BLACK_FRAME_INSERTION:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_BLACK_FRAME_INSERTION), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_SAVEFILE_DIRECTORY:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_SAVEFILE_DIRECTORY), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_INPUT_PREFER_FRONT_TOUCH:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_INPUT_PREFER_FRONT_TOUCH), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_SUSPEND_SCREENSAVER_ENABLE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_SUSPEND_SCREENSAVER_ENABLE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_NETPLAY_START_AS_SPECTATOR:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_NETPLAY_START_AS_SPECTATOR), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_NETPLAY_CHECK_FRAMES:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_NETPLAY_CHECK_FRAMES), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_NETPLAY_INPUT_LATENCY_FRAMES_MIN:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_NETPLAY_INPUT_LATENCY_FRAMES_MIN), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_NETPLAY_INPUT_LATENCY_FRAMES_RANGE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_NETPLAY_INPUT_LATENCY_FRAMES_RANGE), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MAX_SWAPCHAIN_IMAGES:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_VIDEO_MAX_SWAPCHAIN_IMAGES), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_CTX_SCALING:
|
|
snprintf(s, len,
|
|
#ifdef HAVE_ODROIDGO2
|
|
"RGA scaling and bicubic filtering. May break widgets."
|
|
#else
|
|
"Hardware context scaling (if available)."
|
|
#endif
|
|
);
|
|
break;
|
|
case MENU_ENUM_LABEL_UI_COMPANION_START_ON_BOOT:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_UI_COMPANION_START_ON_BOOT), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_EXIT_EMULATOR:
|
|
snprintf(s, len,
|
|
"Key to exit RetroArch cleanly."
|
|
#if !defined(RARCH_MOBILE) && !defined(RARCH_CONSOLE)
|
|
"\nKilling it in any hard way (SIGKILL, \n"
|
|
"etc) will terminate without saving\n"
|
|
"RAM, etc. On Unix-likes,\n"
|
|
"SIGINT/SIGTERM allows\n"
|
|
"a clean deinitialization."
|
|
#endif
|
|
);
|
|
break;
|
|
case MENU_ENUM_LABEL_CHEAT_START_OR_CONT:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_CHEAT_START_OR_CONT), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_WHAT_IS_A_CORE_DESC:
|
|
snprintf(s, len,
|
|
"RetroArch by itself does nothing. \n"
|
|
" \n"
|
|
"To make it do things, you need to \n"
|
|
"load a program into it. \n"
|
|
"\n"
|
|
"We call such a program 'Libretro core', \n"
|
|
"or 'core' in short. \n"
|
|
" \n"
|
|
"To load a core, select one from\n"
|
|
"'Load Core'.\n"
|
|
" \n"
|
|
#ifdef HAVE_NETWORKING
|
|
"You can obtain cores in several ways: \n"
|
|
"* Download them by going to\n"
|
|
"'%s' -> '%s'.\n"
|
|
"* Manually move them over to\n"
|
|
"'%s'.",
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_ONLINE_UPDATER),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_CORE_UPDATER_LIST),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_LIBRETRO_DIR_PATH)
|
|
#else
|
|
"You can obtain cores by\n"
|
|
"manually moving them over to\n"
|
|
"'%s'.",
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_LIBRETRO_DIR_PATH)
|
|
#endif
|
|
);
|
|
break;
|
|
case MENU_ENUM_LABEL_VALUE_HELP_CHANGE_VIRTUAL_GAMEPAD_DESC:
|
|
snprintf(s, len,
|
|
"You can change the virtual gamepad overlay\n"
|
|
"by going to '%s' -> '%s'."
|
|
" \n"
|
|
"From there you can change the overlay,\n"
|
|
"change the size and opacity of the buttons, etc.\n"
|
|
" \n"
|
|
"NOTE: By default, virtual gamepad overlays are\n"
|
|
"hidden when in the menu.\n"
|
|
"If you'd like to change this behavior,\n"
|
|
"you can set '%s' to false.",
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SETTINGS),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_OVERLAY_SETTINGS),
|
|
msg_hash_to_str(MENU_ENUM_LABEL_VALUE_INPUT_OVERLAY_HIDE_IN_MENU));
|
|
break;
|
|
/* TODO/FIXME: move these VIDEO_MESSAGE related help texts to sublabels. */
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_BGCOLOR_ENABLE:
|
|
snprintf(s, len,
|
|
"Enables a background color for the OSD.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_BGCOLOR_RED:
|
|
snprintf(s, len,
|
|
"Sets the red value of the OSD background color. Valid values are between 0 and 255.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_BGCOLOR_GREEN:
|
|
snprintf(s, len,
|
|
"Sets the green value of the OSD background color. Valid values are between 0 and 255.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_BGCOLOR_BLUE:
|
|
snprintf(s, len,
|
|
"Sets the blue value of the OSD background color. Valid values are between 0 and 255.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_BGCOLOR_OPACITY:
|
|
snprintf(s, len,
|
|
"Sets the opacity of the OSD background color. Valid values are between 0.0 and 1.0.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_COLOR_RED:
|
|
snprintf(s, len,
|
|
"Sets the red value of the OSD text color. Valid values are between 0 and 255.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_COLOR_GREEN:
|
|
snprintf(s, len,
|
|
"Sets the green value of the OSD text color. Valid values are between 0 and 255.");
|
|
break;
|
|
case MENU_ENUM_LABEL_VIDEO_MESSAGE_COLOR_BLUE:
|
|
snprintf(s, len,
|
|
"Sets the blue value of the OSD text color. Valid values are between 0 and 255.");
|
|
break;
|
|
#ifdef HAVE_LAKKA
|
|
case MENU_ENUM_LABEL_TIMEZONE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_TIMEZONE), len);
|
|
break;
|
|
#endif
|
|
case MENU_ENUM_LABEL_MIDI_INPUT:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_MIDI_INPUT), len);
|
|
break;
|
|
case MENU_ENUM_LABEL_MIDI_OUTPUT:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_MIDI_OUTPUT), len);
|
|
break;
|
|
#ifdef __linux__
|
|
case MENU_ENUM_LABEL_GAMEMODE_ENABLE:
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_HELP_GAMEMODE_ENABLE), len);
|
|
break;
|
|
#endif
|
|
|
|
#ifdef ANDROID
|
|
case MENU_ENUM_LABEL_INPUT_SELECT_PHYSICAL_KEYBOARD:
|
|
snprintf(s, len,
|
|
"If RetroArch identifies a hardware keyboard as some kind of\n"
|
|
"gamepad, this setting can be used to force RetroArch to treat\n"
|
|
"the misidentified device as a keyboard.\n"
|
|
"This can be useful if you are trying to emulate a computer in some\n"
|
|
"Android TV device and also own a physical keyboard that can be\n"
|
|
"attached to the box.\n");
|
|
break;
|
|
#endif
|
|
default:
|
|
if (string_is_empty(s))
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
|
|
return -1;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
#endif
|
|
|
|
#ifdef HAVE_MENU
|
|
static const char *menu_hash_to_str_us_label_enum(enum msg_hash_enums msg)
|
|
{
|
|
if (msg <= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_END &&
|
|
msg >= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN)
|
|
{
|
|
static char hotkey_lbl[128] = {0};
|
|
unsigned idx = msg - MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN;
|
|
snprintf(hotkey_lbl, sizeof(hotkey_lbl), "input_hotkey_binds_%d", idx);
|
|
return hotkey_lbl;
|
|
}
|
|
|
|
switch (msg)
|
|
{
|
|
#include "msg_hash_lbl.h"
|
|
default:
|
|
#if 0
|
|
RARCH_LOG("Unimplemented: [%d]\n", msg);
|
|
#endif
|
|
break;
|
|
}
|
|
|
|
return "null";
|
|
}
|
|
#endif
|
|
|
|
const char *msg_hash_to_str_us(enum msg_hash_enums msg)
|
|
{
|
|
#ifdef HAVE_MENU
|
|
const char *ret = menu_hash_to_str_us_label_enum(msg);
|
|
|
|
if (ret && !string_is_equal(ret, "null"))
|
|
return ret;
|
|
#endif
|
|
|
|
switch (msg)
|
|
{
|
|
#include "msg_hash_us.h"
|
|
default:
|
|
#if 0
|
|
RARCH_LOG("Unimplemented: [%d]\n", msg);
|
|
{
|
|
RARCH_LOG("[%d] : %s\n", msg - 1, msg_hash_to_str(((enum msg_hash_enums)(msg - 1))));
|
|
}
|
|
#endif
|
|
break;
|
|
}
|
|
|
|
return "null";
|
|
}
|