1100 lines
41 KiB
C
1100 lines
41 KiB
C
/* RetroArch - A frontend for libretro.
|
|
* 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/>.
|
|
*/
|
|
|
|
#include <stdint.h>
|
|
#include <string.h>
|
|
|
|
#include <compat/strl.h>
|
|
#include <string/stdstring.h>
|
|
|
|
#include "../menu_hash.h"
|
|
#include "../../msg_hash.h"
|
|
#include "../../configuration.h"
|
|
|
|
int menu_hash_get_help_us(uint32_t hash, char *s, size_t len)
|
|
{
|
|
uint32_t driver_hash = 0;
|
|
settings_t *settings = config_get_ptr();
|
|
|
|
switch (hash)
|
|
{
|
|
case MENU_LABEL_VALUE_HELP_AUDIO_VIDEO_TROUBLESHOOTING_DESC:
|
|
{
|
|
/* Work around C89 limitations */
|
|
char u[501];
|
|
char t[501];
|
|
|
|
strlcpy(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", sizeof(t));
|
|
snprintf(u, sizeof(u),
|
|
"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));
|
|
strlcat(s, t, len);
|
|
strlcat(s, u, len);
|
|
}
|
|
break;
|
|
case MENU_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 collection.\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"
|
|
"filebrowser everytime.\n"
|
|
" \n"
|
|
"NOTE: Content for some cores might still not be\n"
|
|
"scannable. Examples include: \n"
|
|
"MAME, FBA, and maybe others."
|
|
,
|
|
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_CONTENT_COLLECTION_LIST)
|
|
);
|
|
break;
|
|
case MENU_LABEL_VALUE_MENU_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_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_LABEL_WELCOME_TO_RETROARCH:
|
|
snprintf(s, len,
|
|
"Welcome to RetroArch\n"
|
|
);
|
|
break;
|
|
case MENU_LABEL_INPUT_DRIVER:
|
|
driver_hash = menu_hash_calculate(settings->input.driver);
|
|
|
|
switch (driver_hash)
|
|
{
|
|
case MENU_LABEL_INPUT_DRIVER_UDEV:
|
|
snprintf(s, len,
|
|
"udev Input driver. \n"
|
|
" \n"
|
|
"This driver can run without X. \n"
|
|
" \n"
|
|
"It uses the recent evdev joypad API \n"
|
|
"for joystick support. It supports \n"
|
|
"hotplugging and force feedback (if \n"
|
|
"supported by device). \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."
|
|
);
|
|
break;
|
|
case MENU_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*).");
|
|
break;
|
|
default:
|
|
snprintf(s, len,
|
|
"Input driver.\n"
|
|
" \n"
|
|
"Depending on video driver, it might \n"
|
|
"force a different input driver.");
|
|
break;
|
|
}
|
|
break;
|
|
case MENU_LABEL_LOAD_CONTENT:
|
|
snprintf(s, len,
|
|
"Load Content. \n"
|
|
"Browse for content. \n"
|
|
" \n"
|
|
"To load content, you need a \n"
|
|
"'Core' to use, and a content file.\n"
|
|
" \n"
|
|
"To control where the menu starts \n"
|
|
" to browse for content, set \n"
|
|
"'File Browser Directory'. \n"
|
|
"If not set, it will start in root. \n"
|
|
" \n"
|
|
"The browser will filter out \n"
|
|
"extensions for the last core set \n"
|
|
"in 'Load Core', and use that core \n"
|
|
"when content is loaded."
|
|
);
|
|
break;
|
|
case MENU_LABEL_CORE_LIST:
|
|
snprintf(s, len,
|
|
"Load Core. \n"
|
|
" \n"
|
|
"Browse for a libretro core \n"
|
|
"implementation. Where the browser \n"
|
|
"starts depends on your Core Directory \n"
|
|
"path. If blank, it will start in root. \n"
|
|
" \n"
|
|
"If Core Directory is a directory, the menu \n"
|
|
"will use that as top folder. If Core \n"
|
|
"Directory is a full path, it will start \n"
|
|
"in the folder where the file is.");
|
|
break;
|
|
case MENU_LABEL_LOAD_CONTENT_HISTORY:
|
|
snprintf(s, len,
|
|
"Loading content from history. \n"
|
|
" \n"
|
|
"As content is loaded, content and libretro \n"
|
|
"core combinations are saved to history. \n"
|
|
" \n"
|
|
"The history is saved to a file in the same \n"
|
|
"directory as the RetroArch config file. If \n"
|
|
"no config file was loaded in startup, history \n"
|
|
"will not be saved or loaded, and will not exist \n"
|
|
"in the main menu."
|
|
);
|
|
break;
|
|
case MENU_LABEL_VIDEO_DRIVER:
|
|
driver_hash = menu_hash_calculate(settings->video.driver);
|
|
|
|
switch (driver_hash)
|
|
{
|
|
case MENU_LABEL_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).");
|
|
break;
|
|
case MENU_LABEL_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.");
|
|
break;
|
|
case MENU_LABEL_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.");
|
|
break;
|
|
case MENU_LABEL_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).");
|
|
break;
|
|
case MENU_LABEL_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.");
|
|
break;
|
|
case MENU_LABEL_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;
|
|
default:
|
|
snprintf(s, len,
|
|
"Current Video driver.");
|
|
break;
|
|
}
|
|
break;
|
|
case MENU_LABEL_AUDIO_DSP_PLUGIN:
|
|
snprintf(s, len,
|
|
"Audio DSP plugin.\n"
|
|
" Processes audio before it's sent to \n"
|
|
"the driver."
|
|
);
|
|
break;
|
|
case MENU_LABEL_AUDIO_RESAMPLER_DRIVER:
|
|
driver_hash = menu_hash_calculate(settings->audio.resampler);
|
|
|
|
switch (driver_hash)
|
|
{
|
|
case MENU_LABEL_AUDIO_RESAMPLER_DRIVER_SINC:
|
|
snprintf(s, len,
|
|
"Windowed SINC implementation.");
|
|
break;
|
|
case MENU_LABEL_AUDIO_RESAMPLER_DRIVER_CC:
|
|
snprintf(s, len,
|
|
"Convoluted Cosine implementation.");
|
|
break;
|
|
}
|
|
break;
|
|
case MENU_LABEL_VIDEO_SHADER_PRESET:
|
|
snprintf(s, len,
|
|
"Load Shader Preset. \n"
|
|
" \n"
|
|
" Load a "
|
|
#ifdef HAVE_CG
|
|
"Cg"
|
|
#endif
|
|
#ifdef HAVE_GLSL
|
|
#ifdef HAVE_CG
|
|
"/"
|
|
#endif
|
|
"GLSL"
|
|
#endif
|
|
#ifdef HAVE_HLSL
|
|
#if defined(HAVE_CG) || defined(HAVE_HLSL)
|
|
"/"
|
|
#endif
|
|
"HLSL"
|
|
#endif
|
|
" preset directly. \n"
|
|
"The menu shader menu is updated accordingly. \n"
|
|
" \n"
|
|
"If the CGP uses scaling methods which are not \n"
|
|
"simple, (i.e. source scaling, same scaling \n"
|
|
"factor for X/Y), the scaling factor displayed \n"
|
|
"in the menu might not be correct."
|
|
);
|
|
break;
|
|
case MENU_LABEL_VIDEO_SHADER_SCALE_PASS:
|
|
snprintf(s, len,
|
|
"Scale for this pass. \n"
|
|
" \n"
|
|
"The scale factor accumulates, i.e. 2x \n"
|
|
"for first pass and 2x for second pass \n"
|
|
"will give you a 4x total scale. \n"
|
|
" \n"
|
|
"If there is a scale factor for last \n"
|
|
"pass, the result is stretched to \n"
|
|
"screen with the filter specified in \n"
|
|
"'Default Filter'. \n"
|
|
" \n"
|
|
"If 'Don't Care' is set, either 1x \n"
|
|
"scale or stretch to fullscreen will \n"
|
|
"be used depending if it's not the last \n"
|
|
"pass or not."
|
|
);
|
|
break;
|
|
case MENU_LABEL_VIDEO_SHADER_NUM_PASSES:
|
|
snprintf(s, len,
|
|
"Shader Passes. \n"
|
|
" \n"
|
|
"RetroArch allows you to mix and match various \n"
|
|
"shaders with arbitrary shader passes, with \n"
|
|
"custom hardware filters and scale factors. \n"
|
|
" \n"
|
|
"This option specifies the number of shader \n"
|
|
"passes to use. If you set this to 0, and use \n"
|
|
"Apply Shader Changes, you use a 'blank' shader. \n"
|
|
" \n"
|
|
"The Default Filter option will affect the \n"
|
|
"stretching filter.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_SHADER_PARAMETERS:
|
|
snprintf(s, len,
|
|
"Shader Parameters. \n"
|
|
" \n"
|
|
"Modifies current shader directly. Will not be \n"
|
|
"saved to CGP/GLSLP preset file.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_SHADER_PRESET_PARAMETERS:
|
|
snprintf(s, len,
|
|
"Shader Preset Parameters. \n"
|
|
" \n"
|
|
"Modifies shader preset currently in menu."
|
|
);
|
|
break;
|
|
case MENU_LABEL_VIDEO_SHADER_PASS:
|
|
snprintf(s, len,
|
|
"Path to shader. \n"
|
|
" \n"
|
|
"All shaders must be of the same \n"
|
|
"type (i.e. CG, GLSL or HLSL). \n"
|
|
" \n"
|
|
"Set Shader Directory to set where \n"
|
|
"the browser starts to look for \n"
|
|
"shaders."
|
|
);
|
|
break;
|
|
case MENU_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_LABEL_VIDEO_SHADER_FILTER_PASS:
|
|
snprintf(s, len,
|
|
"Hardware filter for this pass. \n"
|
|
" \n"
|
|
"If 'Don't Care' is set, 'Default \n"
|
|
"Filter' will be used."
|
|
);
|
|
break;
|
|
case MENU_LABEL_AUTOSAVE_INTERVAL:
|
|
snprintf(s, len,
|
|
"Autosaves the non-volatile SRAM \n"
|
|
"at a regular interval.\n"
|
|
" \n"
|
|
"This is disabled by default unless set \n"
|
|
"otherwise. The interval is measured in \n"
|
|
"seconds. \n"
|
|
" \n"
|
|
"A value of 0 disables autosave.");
|
|
break;
|
|
case MENU_LABEL_INPUT_BIND_DEVICE_TYPE:
|
|
snprintf(s, len,
|
|
"Input Device Type. \n"
|
|
" \n"
|
|
"Picks which device type to use. This is \n"
|
|
"relevant for the libretro core itself."
|
|
);
|
|
break;
|
|
case MENU_LABEL_LIBRETRO_LOG_LEVEL:
|
|
snprintf(s, len,
|
|
"Sets log level for libretro cores \n"
|
|
"(GET_LOG_INTERFACE). \n"
|
|
" \n"
|
|
" If a log level issued by a libretro \n"
|
|
" core is below libretro_log level, it \n"
|
|
" is ignored.\n"
|
|
" \n"
|
|
" DEBUG logs are always ignored unless \n"
|
|
" verbose mode is activated (--verbose).\n"
|
|
" \n"
|
|
" DEBUG = 0\n"
|
|
" INFO = 1\n"
|
|
" WARN = 2\n"
|
|
" ERROR = 3"
|
|
);
|
|
break;
|
|
case MENU_LABEL_STATE_SLOT_INCREASE:
|
|
case MENU_LABEL_STATE_SLOT_DECREASE:
|
|
snprintf(s, len,
|
|
"State slots.\n"
|
|
" \n"
|
|
" With slot set to 0, save state name is *.state \n"
|
|
" (or whatever defined on commandline).\n"
|
|
"When slot is != 0, path will be (path)(d), \n"
|
|
"where (d) is slot number.");
|
|
break;
|
|
case MENU_LABEL_SHADER_APPLY_CHANGES:
|
|
snprintf(s, len,
|
|
"Apply Shader Changes. \n"
|
|
" \n"
|
|
"After changing shader settings, use this to \n"
|
|
"apply changes. \n"
|
|
" \n"
|
|
"Changing shader settings is a somewhat \n"
|
|
"expensive operation so it has to be \n"
|
|
"done explicitly. \n"
|
|
" \n"
|
|
"When you apply shaders, the menu shader \n"
|
|
"settings are saved to a temporary file (either \n"
|
|
"menu.cgp or menu.glslp) and loaded. The file \n"
|
|
"persists after RetroArch exits. The file is \n"
|
|
"saved to Shader Directory."
|
|
);
|
|
break;
|
|
case MENU_LABEL_INPUT_BIND_DEVICE_ID:
|
|
snprintf(s, len,
|
|
"Input Device. \n"
|
|
" \n"
|
|
"Picks which gamepad to use for user N. \n"
|
|
"The name of the pad is available."
|
|
);
|
|
break;
|
|
case MENU_LABEL_MENU_TOGGLE:
|
|
snprintf(s, len,
|
|
"Toggles menu.");
|
|
break;
|
|
case MENU_LABEL_GRAB_MOUSE_TOGGLE:
|
|
snprintf(s, len,
|
|
"Toggles mouse grab.\n"
|
|
" \n"
|
|
"When mouse is grabbed, RetroArch hides the \n"
|
|
"mouse, and keeps the mouse pointer inside \n"
|
|
"the window to allow relative mouse input to \n"
|
|
"work better.");
|
|
break;
|
|
case MENU_LABEL_DISK_NEXT:
|
|
snprintf(s, len,
|
|
"Cycles through disk images. Use after \n"
|
|
"ejecting. \n"
|
|
" \n"
|
|
" Complete by toggling eject again.");
|
|
break;
|
|
case MENU_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_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_LABEL_DISK_EJECT_TOGGLE:
|
|
snprintf(s, len,
|
|
"Toggles eject for disks.\n"
|
|
" \n"
|
|
"Used for multiple-disk content.");
|
|
break;
|
|
case MENU_LABEL_ENABLE_HOTKEY:
|
|
snprintf(s, len,
|
|
"Enable other hotkeys.\n"
|
|
" \n"
|
|
" If this hotkey is bound to either keyboard, \n"
|
|
"joybutton or joyaxis, all other hotkeys will \n"
|
|
"be disabled unless this hotkey is also held \n"
|
|
"at the same time. \n"
|
|
" \n"
|
|
"This is useful for RETRO_KEYBOARD centric \n"
|
|
"implementations which query a large area of \n"
|
|
"the keyboard, where it is not desirable that \n"
|
|
"hotkeys get in the way.");
|
|
break;
|
|
case MENU_LABEL_REWIND_ENABLE:
|
|
snprintf(s, len,
|
|
"Enable rewinding.\n"
|
|
" \n"
|
|
"This will take a performance hit, \n"
|
|
"so it is disabled by default.");
|
|
break;
|
|
case MENU_LABEL_LIBRETRO_DIR_PATH:
|
|
snprintf(s, len,
|
|
"Core Directory. \n"
|
|
" \n"
|
|
"A directory for where to search for \n"
|
|
"libretro core implementations.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_REFRESH_RATE_AUTO:
|
|
snprintf(s, len,
|
|
"Refresh Rate Auto.\n"
|
|
" \n"
|
|
"The accurate refresh rate of our monitor (Hz).\n"
|
|
"This is used to calculate audio input rate with \n"
|
|
"the formula: \n"
|
|
" \n"
|
|
"audio_input_rate = game input rate * display \n"
|
|
"refresh rate / game refresh rate\n"
|
|
" \n"
|
|
"If the implementation does not report any \n"
|
|
"values, NTSC defaults will be assumed for \n"
|
|
"compatibility.\n"
|
|
" \n"
|
|
"This value should stay close to 60Hz to avoid \n"
|
|
"large pitch changes. If your monitor does \n"
|
|
"not run at 60Hz, or something close to it, \n"
|
|
"disable VSync, and leave this at its default.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_ROTATION:
|
|
snprintf(s, len,
|
|
"Forces a certain rotation \n"
|
|
"of the screen.\n"
|
|
" \n"
|
|
"The rotation is added to rotations which\n"
|
|
"the libretro core sets (see Video Allow\n"
|
|
"Rotate).");
|
|
break;
|
|
case MENU_LABEL_VIDEO_SCALE:
|
|
snprintf(s, len,
|
|
"Fullscreen resolution.\n"
|
|
" \n"
|
|
"Resolution of 0 uses the \n"
|
|
"resolution of the environment.\n");
|
|
break;
|
|
case MENU_LABEL_FASTFORWARD_RATIO:
|
|
snprintf(s, len,
|
|
"Fastforward ratio."
|
|
" \n"
|
|
"The maximum rate at which content will\n"
|
|
"be run when using fast forward.\n"
|
|
" \n"
|
|
" (E.g. 5.0 for 60 fps content => 300 fps \n"
|
|
"cap).\n"
|
|
" \n"
|
|
"RetroArch will go to sleep to ensure that \n"
|
|
"the maximum rate will not be exceeded.\n"
|
|
"Do not rely on this cap to be perfectly \n"
|
|
"accurate.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_MONITOR_INDEX:
|
|
snprintf(s, len,
|
|
"Which monitor to prefer.\n"
|
|
" \n"
|
|
"0 (default) means no particular monitor \n"
|
|
"is preferred, 1 and up (1 being first \n"
|
|
"monitor), suggests RetroArch to use that \n"
|
|
"particular monitor.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_CROP_OVERSCAN:
|
|
snprintf(s, len,
|
|
"Forces cropping of overscanned \n"
|
|
"frames.\n"
|
|
" \n"
|
|
"Exact behavior of this option is \n"
|
|
"core-implementation specific.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_SCALE_INTEGER:
|
|
snprintf(s, len,
|
|
"Only scales video in integer \n"
|
|
"steps.\n"
|
|
" \n"
|
|
"The base size depends on system-reported \n"
|
|
"geometry and aspect ratio.\n"
|
|
" \n"
|
|
"If Force Aspect is not set, X/Y will be \n"
|
|
"integer scaled independently.");
|
|
break;
|
|
case MENU_LABEL_AUDIO_VOLUME:
|
|
snprintf(s, len,
|
|
"Audio volume, expressed in dB.\n"
|
|
" \n"
|
|
" 0 dB is normal volume. No gain will be applied.\n"
|
|
"Gain can be controlled in runtime with Input\n"
|
|
"Volume Up / Input Volume Down.");
|
|
break;
|
|
case MENU_LABEL_AUDIO_RATE_CONTROL_DELTA:
|
|
snprintf(s, len,
|
|
"Audio rate control.\n"
|
|
" \n"
|
|
"Setting this to 0 disables rate control.\n"
|
|
"Any other value controls audio rate control \n"
|
|
"delta.\n"
|
|
" \n"
|
|
"Defines how much input rate can be adjusted \n"
|
|
"dynamically.\n"
|
|
" \n"
|
|
" Input rate is defined as: \n"
|
|
" input rate * (1.0 +/- (rate control delta))");
|
|
break;
|
|
case MENU_LABEL_AUDIO_MAX_TIMING_SKEW:
|
|
snprintf(s, len,
|
|
"Maximum audio timing skew.\n"
|
|
" \n"
|
|
"Defines the maximum change in input rate.\n"
|
|
"You may want to increase this to enable\n"
|
|
"very large changes in timing, for example\n"
|
|
"running PAL cores on NTSC displays, at the\n"
|
|
"cost of inaccurate audio pitch.\n"
|
|
" \n"
|
|
" Input rate is defined as: \n"
|
|
" input rate * (1.0 +/- (max timing skew))");
|
|
break;
|
|
case MENU_LABEL_OVERLAY_NEXT:
|
|
snprintf(s, len,
|
|
"Toggles to next overlay.\n"
|
|
" \n"
|
|
"Wraps around.");
|
|
break;
|
|
case MENU_LABEL_LOG_VERBOSITY:
|
|
snprintf(s, len,
|
|
"Enable or disable verbosity level \n"
|
|
"of frontend.");
|
|
break;
|
|
case MENU_LABEL_VOLUME_UP:
|
|
snprintf(s, len,
|
|
"Increases audio volume.");
|
|
break;
|
|
case MENU_LABEL_VOLUME_DOWN:
|
|
snprintf(s, len,
|
|
"Decreases audio volume.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_DISABLE_COMPOSITION:
|
|
snprintf(s, len,
|
|
"Forcibly disable composition.\n"
|
|
"Only valid on Windows Vista/7 for now.");
|
|
break;
|
|
case MENU_LABEL_PERFCNT_ENABLE:
|
|
snprintf(s, len,
|
|
"Enable or disable frontend \n"
|
|
"performance counters.");
|
|
break;
|
|
case MENU_LABEL_SYSTEM_DIRECTORY:
|
|
snprintf(s, len,
|
|
"System Directory. \n"
|
|
" \n"
|
|
"Sets the 'system' directory.\n"
|
|
"Cores can query for this\n"
|
|
"directory to load BIOSes, \n"
|
|
"system-specific configs, etc.");
|
|
break;
|
|
case MENU_LABEL_SAVESTATE_AUTO_SAVE:
|
|
snprintf(s, len,
|
|
"Automatically saves a savestate at the \n"
|
|
"end of RetroArch's lifetime.\n"
|
|
" \n"
|
|
"RetroArch will automatically load any savestate\n"
|
|
"with this path on startup if 'Auto Load State\n"
|
|
"is enabled.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_THREADED:
|
|
snprintf(s, len,
|
|
"Use threaded video driver.\n"
|
|
" \n"
|
|
"Using this might improve performance at \n"
|
|
"possible cost of latency and more video \n"
|
|
"stuttering.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_VSYNC:
|
|
snprintf(s, len,
|
|
"Video V-Sync.\n");
|
|
break;
|
|
case MENU_LABEL_VIDEO_HARD_SYNC:
|
|
snprintf(s, len,
|
|
"Attempts to hard-synchronize \n"
|
|
"CPU and GPU.\n"
|
|
" \n"
|
|
"Can reduce latency at cost of \n"
|
|
"performance.");
|
|
break;
|
|
case MENU_LABEL_REWIND_GRANULARITY:
|
|
snprintf(s, len,
|
|
"Rewind granularity.\n"
|
|
" \n"
|
|
" When rewinding defined number of \n"
|
|
"frames, you can rewind several frames \n"
|
|
"at a time, increasing the rewinding \n"
|
|
"speed.");
|
|
break;
|
|
case MENU_LABEL_SCREENSHOT:
|
|
snprintf(s, len,
|
|
"Take screenshot.");
|
|
break;
|
|
case MENU_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 cost of\n"
|
|
"higher risk of stuttering.\n"
|
|
" \n"
|
|
"Maximum is 15.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_HARD_SYNC_FRAMES:
|
|
snprintf(s, len,
|
|
"Sets how many frames CPU can \n"
|
|
"run ahead of GPU when using 'GPU \n"
|
|
"Hard Sync'.\n"
|
|
" \n"
|
|
"Maximum is 3.\n"
|
|
" \n"
|
|
" 0: Syncs to GPU immediately.\n"
|
|
" 1: Syncs to previous frame.\n"
|
|
" 2: Etc ...");
|
|
break;
|
|
case MENU_LABEL_VIDEO_BLACK_FRAME_INSERTION:
|
|
snprintf(s, len,
|
|
"Inserts a black frame inbetween \n"
|
|
"frames.\n"
|
|
" \n"
|
|
"Useful for 120 Hz monitors who want to \n"
|
|
"play 60 Hz material with eliminated \n"
|
|
"ghosting.\n"
|
|
" \n"
|
|
"Video refresh rate should still be \n"
|
|
"configured as if it is a 60 Hz monitor \n"
|
|
"(divide refresh rate by 2).");
|
|
break;
|
|
case MENU_LABEL_RGUI_SHOW_START_SCREEN:
|
|
snprintf(s, len,
|
|
"Show startup screen in menu.\n"
|
|
"Is automatically set to false when seen\n"
|
|
"for the first time.\n"
|
|
" \n"
|
|
"This is only updated in config if\n"
|
|
"'Save Configuration on Exit' is enabled.\n");
|
|
break;
|
|
case MENU_LABEL_CORE_SPECIFIC_CONFIG:
|
|
snprintf(s, len,
|
|
"Load up a specific config file \n"
|
|
"based on the core being used.\n");
|
|
break;
|
|
case MENU_LABEL_VIDEO_FULLSCREEN:
|
|
snprintf(s, len, "Toggles fullscreen.");
|
|
break;
|
|
case MENU_LABEL_BLOCK_SRAM_OVERWRITE:
|
|
snprintf(s, len,
|
|
"Block SRAM from being overwritten \n"
|
|
"when loading save states.\n"
|
|
" \n"
|
|
"Might potentially lead to buggy games.");
|
|
break;
|
|
case MENU_LABEL_PAUSE_NONACTIVE:
|
|
snprintf(s, len,
|
|
"Pause gameplay when window focus \n"
|
|
"is lost.");
|
|
break;
|
|
case MENU_LABEL_VIDEO_GPU_SCREENSHOT:
|
|
snprintf(s, len,
|
|
"Screenshots output of GPU shaded \n"
|
|
"material if available.");
|
|
break;
|
|
case MENU_LABEL_SCREENSHOT_DIRECTORY:
|
|
snprintf(s, len,
|
|
"Screenshot Directory. \n"
|
|
" \n"
|
|
"Directory to dump screenshots to."
|
|
);
|
|
break;
|
|
case MENU_LABEL_VIDEO_SWAP_INTERVAL:
|
|
snprintf(s, len,
|
|
"VSync Swap Interval.\n"
|
|
" \n"
|
|
"Uses a custom swap interval for VSync. Set this \n"
|
|
"to effectively halve monitor refresh rate.");
|
|
break;
|
|
case MENU_LABEL_SAVEFILE_DIRECTORY:
|
|
snprintf(s, len,
|
|
"Savefile Directory. \n"
|
|
" \n"
|
|
"Save all save files (*.srm) to this \n"
|
|
"directory. This includes related files like \n"
|
|
".bsv, .rt, .psrm, etc...\n"
|
|
" \n"
|
|
"This will be overridden by explicit command line\n"
|
|
"options.");
|
|
break;
|
|
case MENU_LABEL_SAVESTATE_DIRECTORY:
|
|
snprintf(s, len,
|
|
"Savestate Directory. \n"
|
|
" \n"
|
|
"Save all save states (*.state) to this \n"
|
|
"directory.\n"
|
|
" \n"
|
|
"This will be overridden by explicit command line\n"
|
|
"options.");
|
|
break;
|
|
case MENU_LABEL_ASSETS_DIRECTORY:
|
|
snprintf(s, len,
|
|
"Assets Directory. \n"
|
|
" \n"
|
|
" This location is queried by default when \n"
|
|
"menu interfaces try to look for loadable \n"
|
|
"assets, etc.");
|
|
break;
|
|
case MENU_LABEL_DYNAMIC_WALLPAPERS_DIRECTORY:
|
|
snprintf(s, len,
|
|
"Dynamic Wallpapers Directory. \n"
|
|
" \n"
|
|
" The place to store wallpapers that will \n"
|
|
"be loaded dynamically by the menu depending \n"
|
|
"on context.");
|
|
break;
|
|
case MENU_LABEL_SLOWMOTION_RATIO:
|
|
snprintf(s, len,
|
|
"Slowmotion ratio."
|
|
" \n"
|
|
"When slowmotion, content will slow\n"
|
|
"down by factor.");
|
|
break;
|
|
case MENU_LABEL_INPUT_AXIS_THRESHOLD:
|
|
snprintf(s, len,
|
|
"Defines axis threshold.\n"
|
|
" \n"
|
|
"How far an axis must be tilted to result\n"
|
|
"in a button press.\n"
|
|
" Possible values are [0.0, 1.0].");
|
|
break;
|
|
case MENU_LABEL_INPUT_TURBO_PERIOD:
|
|
snprintf(s, len,
|
|
"Turbo period.\n"
|
|
" \n"
|
|
"Describes speed of which turbo-enabled\n"
|
|
"buttons toggle."
|
|
);
|
|
break;
|
|
case MENU_LABEL_INPUT_AUTODETECT_ENABLE:
|
|
snprintf(s, len,
|
|
"Enable input auto-detection.\n"
|
|
" \n"
|
|
"Will attempt to auto-configure \n"
|
|
"joypads, Plug-and-Play style.");
|
|
break;
|
|
case MENU_LABEL_CAMERA_ALLOW:
|
|
snprintf(s, len,
|
|
"Allow or disallow camera access by \n"
|
|
"cores.");
|
|
break;
|
|
case MENU_LABEL_LOCATION_ALLOW:
|
|
snprintf(s, len,
|
|
"Allow or disallow location services \n"
|
|
"access by cores.");
|
|
break;
|
|
case MENU_LABEL_TURBO:
|
|
snprintf(s, len,
|
|
"Turbo enable.\n"
|
|
" \n"
|
|
"Holding the turbo while pressing another \n"
|
|
"button will let the button enter a turbo \n"
|
|
"mode where the button state is modulated \n"
|
|
"with a periodic signal. \n"
|
|
" \n"
|
|
"The modulation stops when the button \n"
|
|
"itself (not turbo button) is released.");
|
|
break;
|
|
case MENU_LABEL_OSK_ENABLE:
|
|
snprintf(s, len,
|
|
"Enable/disable on-screen keyboard.");
|
|
break;
|
|
case MENU_LABEL_AUDIO_MUTE:
|
|
snprintf(s, len,
|
|
"Mute/unmute audio.");
|
|
break;
|
|
case MENU_LABEL_REWIND:
|
|
snprintf(s, len,
|
|
"Hold button down to rewind.\n"
|
|
" \n"
|
|
"Rewind must be enabled.");
|
|
break;
|
|
case MENU_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_LABEL_LOAD_STATE:
|
|
snprintf(s, len,
|
|
"Loads state.");
|
|
break;
|
|
case MENU_LABEL_SAVE_STATE:
|
|
snprintf(s, len,
|
|
"Saves state.");
|
|
break;
|
|
case MENU_LABEL_NETPLAY_FLIP_PLAYERS:
|
|
snprintf(s, len,
|
|
"Netplay flip users.");
|
|
break;
|
|
case MENU_LABEL_CHEAT_INDEX_PLUS:
|
|
snprintf(s, len,
|
|
"Increment cheat index.\n");
|
|
break;
|
|
case MENU_LABEL_CHEAT_INDEX_MINUS:
|
|
snprintf(s, len,
|
|
"Decrement cheat index.\n");
|
|
break;
|
|
case MENU_LABEL_SHADER_PREV:
|
|
snprintf(s, len,
|
|
"Applies previous shader in directory.");
|
|
break;
|
|
case MENU_LABEL_SHADER_NEXT:
|
|
snprintf(s, len,
|
|
"Applies next shader in directory.");
|
|
break;
|
|
case MENU_LABEL_RESET:
|
|
snprintf(s, len,
|
|
"Reset the content.\n");
|
|
break;
|
|
case MENU_LABEL_PAUSE_TOGGLE:
|
|
snprintf(s, len,
|
|
"Toggle between paused and non-paused state.");
|
|
break;
|
|
case MENU_LABEL_CHEAT_TOGGLE:
|
|
snprintf(s, len,
|
|
"Toggle cheat index.\n");
|
|
break;
|
|
case MENU_LABEL_HOLD_FAST_FORWARD:
|
|
snprintf(s, len,
|
|
"Hold for fast-forward. Releasing button \n"
|
|
"disables fast-forward.");
|
|
break;
|
|
case MENU_LABEL_SLOWMOTION:
|
|
snprintf(s, len,
|
|
"Hold for slowmotion.");
|
|
break;
|
|
case MENU_LABEL_FRAME_ADVANCE:
|
|
snprintf(s, len,
|
|
"Frame advance when content is paused.");
|
|
break;
|
|
case MENU_LABEL_MOVIE_RECORD_TOGGLE:
|
|
snprintf(s, len,
|
|
"Toggle between recording and not.");
|
|
break;
|
|
case MENU_LABEL_L_X_PLUS:
|
|
case MENU_LABEL_L_X_MINUS:
|
|
case MENU_LABEL_L_Y_PLUS:
|
|
case MENU_LABEL_L_Y_MINUS:
|
|
case MENU_LABEL_R_X_PLUS:
|
|
case MENU_LABEL_R_X_MINUS:
|
|
case MENU_LABEL_R_Y_PLUS:
|
|
case MENU_LABEL_R_Y_MINUS:
|
|
snprintf(s, len,
|
|
"Axis for analog stick (DualShock-esque).\n"
|
|
" \n"
|
|
"Bound as usual, however, if a real analog \n"
|
|
"axis is bound, it can be read as a true analog.\n"
|
|
" \n"
|
|
"Positive X axis is right. \n"
|
|
"Positive Y axis is down.");
|
|
break;
|
|
case MENU_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_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)
|
|
);
|
|
default:
|
|
if (string_is_empty(s))
|
|
strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
|
|
return -1;
|
|
}
|
|
|
|
return 0;
|
|
}
|