1 /* RetroArch - A frontend for libretro.
2 * Copyright (C) 2011-2017 - Daniel De Matteis
3 * Copyright (C) 2016-2019 - Brad Parker
4 *
5 * RetroArch is free software: you can redistribute it and/or modify it under the terms
6 * of the GNU General Public License as published by the Free Software Found-
7 * ation, either version 3 of the License, or (at your option) any later version.
8 *
9 * RetroArch is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
10 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
11 * PURPOSE. See the GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License along with RetroArch.
14 * If not, see <http://www.gnu.org/licenses/>.
15 */
16
17 #include <stdio.h>
18 #include <stdint.h>
19 #include <stddef.h>
20
21 #include <compat/strl.h>
22 #include <string/stdstring.h>
23
24 #include "../msg_hash.h"
25 #include "../verbosity.h"
26
27 #ifdef RARCH_INTERNAL
28 #include "../configuration.h"
29
msg_hash_get_help_fi_enum(enum msg_hash_enums msg,char * s,size_t len)30 int msg_hash_get_help_fi_enum(enum msg_hash_enums msg, char *s, size_t len)
31 {
32 settings_t *settings = config_get_ptr();
33
34 if (msg == MENU_ENUM_LABEL_CONNECT_NETPLAY_ROOM)
35 {
36 snprintf(s, len,
37 "TODO/FIXME - Fill in message here."
38 );
39 return 0;
40 }
41 if (msg <= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_END &&
42 msg >= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN)
43 {
44 unsigned idx = msg - MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN;
45
46 switch (idx)
47 {
48 case RARCH_FAST_FORWARD_KEY:
49 snprintf(s, len,
50 "Toggles between fast-forwarding and \n"
51 "normal speed."
52 );
53 break;
54 case RARCH_FAST_FORWARD_HOLD_KEY:
55 snprintf(s, len,
56 "Hold for fast-forward. \n"
57 " \n"
58 "Releasing button disables fast-forward."
59 );
60 break;
61 case RARCH_SLOWMOTION_KEY:
62 snprintf(s, len,
63 "Toggles slowmotion.");
64 break;
65 case RARCH_SLOWMOTION_HOLD_KEY:
66 snprintf(s, len,
67 "Hold for slowmotion.");
68 break;
69 case RARCH_PAUSE_TOGGLE:
70 snprintf(s, len,
71 "Toggle between paused and non-paused state.");
72 break;
73 case RARCH_FRAMEADVANCE:
74 snprintf(s, len,
75 "Frame advance when content is paused.");
76 break;
77 case RARCH_SHADER_NEXT:
78 snprintf(s, len,
79 "Applies next shader in directory.");
80 break;
81 case RARCH_SHADER_PREV:
82 snprintf(s, len,
83 "Applies previous shader in directory.");
84 break;
85 case RARCH_CHEAT_INDEX_PLUS:
86 case RARCH_CHEAT_INDEX_MINUS:
87 case RARCH_CHEAT_TOGGLE:
88 snprintf(s, len,
89 "Cheats.");
90 break;
91 case RARCH_RESET:
92 snprintf(s, len,
93 "Reset the content.");
94 break;
95 case RARCH_SCREENSHOT:
96 snprintf(s, len,
97 "Take screenshot.");
98 break;
99 case RARCH_MUTE:
100 snprintf(s, len,
101 "Mute/unmute audio.");
102 break;
103 case RARCH_OSK:
104 snprintf(s, len,
105 "Toggles onscreen keyboard.");
106 break;
107 case RARCH_FPS_TOGGLE:
108 snprintf(s, len,
109 "Toggles frames per second counter.");
110 break;
111 case RARCH_SEND_DEBUG_INFO:
112 snprintf(s, len,
113 "Sends diagnostic info about your device and RetroArch configuration to our servers for analysis.");
114 break;
115 case RARCH_NETPLAY_HOST_TOGGLE:
116 snprintf(s, len,
117 "Toggles netplay hosting on/off.");
118 break;
119 case RARCH_NETPLAY_GAME_WATCH:
120 snprintf(s, len,
121 "Netplay toggle play/spectate mode.");
122 break;
123 case RARCH_ENABLE_HOTKEY:
124 snprintf(s, len,
125 "Enable other hotkeys. \n"
126 " \n"
127 "If this hotkey is bound to either\n"
128 "a keyboard, joybutton or joyaxis, \n"
129 "all other hotkeys will be enabled only \n"
130 "if this one is held at the same time. \n"
131 " \n"
132 "Alternatively, all hotkeys for keyboard \n"
133 "could be disabled by the user.");
134 break;
135 case RARCH_VOLUME_UP:
136 snprintf(s, len,
137 "Increases audio volume.");
138 break;
139 case RARCH_VOLUME_DOWN:
140 snprintf(s, len,
141 "Decreases audio volume.");
142 break;
143 case RARCH_OVERLAY_NEXT:
144 snprintf(s, len,
145 "Switches to next overlay. Wraps around.");
146 break;
147 case RARCH_DISK_EJECT_TOGGLE:
148 snprintf(s, len,
149 "Toggles eject for disks. \n"
150 " \n"
151 "Used for multiple-disk content.");
152 break;
153 case RARCH_DISK_NEXT:
154 case RARCH_DISK_PREV:
155 snprintf(s, len,
156 "Cycles through disk images. Use after ejecting. \n"
157 " \n"
158 "Complete by toggling eject again.");
159 break;
160 case RARCH_GRAB_MOUSE_TOGGLE:
161 snprintf(s, len,
162 "Toggles mouse grab. \n"
163 " \n"
164 "When mouse is grabbed, RetroArch hides the \n"
165 "mouse, and keeps the mouse pointer inside \n"
166 "the window to allow relative mouse input to \n"
167 "work better.");
168 break;
169 case RARCH_GAME_FOCUS_TOGGLE:
170 snprintf(s, len,
171 "Toggles game focus.\n"
172 " \n"
173 "When a game has focus, RetroArch will both disable \n"
174 "hotkeys and keep/wrap the mouse pointer inside the window.");
175 break;
176 case RARCH_MENU_TOGGLE:
177 snprintf(s, len, "Toggles menu.");
178 break;
179 case RARCH_LOAD_STATE_KEY:
180 snprintf(s, len,
181 "Loads state.");
182 break;
183 case RARCH_FULLSCREEN_TOGGLE_KEY:
184 snprintf(s, len,
185 "Toggles fullscreen.");
186 break;
187 case RARCH_CLOSE_CONTENT_KEY:
188 snprintf(s, len,
189 "Closes content.");
190 break;
191 case RARCH_QUIT_KEY:
192 snprintf(s, len,
193 "Key to exit RetroArch cleanly. \n"
194 " \n"
195 "Killing it in any hard way (SIGKILL, etc.) will \n"
196 "terminate RetroArch without saving RAM, etc."
197 #ifdef __unix__
198 "\nOn Unix-likes, SIGINT/SIGTERM allows a clean \n"
199 "deinitialization."
200 #endif
201 "");
202 break;
203 case RARCH_STATE_SLOT_PLUS:
204 case RARCH_STATE_SLOT_MINUS:
205 snprintf(s, len,
206 "State slots. \n"
207 " \n"
208 "With slot set to 0, save state name is \n"
209 "*.state (or whatever defined on commandline). \n"
210 " \n"
211 "When slot is not 0, path will be <path><d>, \n"
212 "where <d> is slot number.");
213 break;
214 case RARCH_SAVE_STATE_KEY:
215 snprintf(s, len,
216 "Saves state.");
217 break;
218 case RARCH_REWIND:
219 snprintf(s, len,
220 "Hold button down to rewind. \n"
221 " \n"
222 "Rewinding must be enabled.");
223 break;
224 case RARCH_BSV_RECORD_TOGGLE:
225 snprintf(s, len,
226 "Toggle between recording and not.");
227 break;
228 case RARCH_RUNAHEAD_TOGGLE:
229 snprintf(s, len,
230 "Toggles Run-Ahead mode on/off.");
231 break;
232 default:
233 if (string_is_empty(s))
234 strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
235 break;
236 }
237
238 return 0;
239 }
240
241 switch (msg)
242 {
243 case MENU_ENUM_LABEL_ACCOUNTS_RETRO_ACHIEVEMENTS:
244 snprintf(s, len, "Login details for your \n"
245 "Retro Achievements account. \n"
246 " \n"
247 "Visit retroachievements.org and sign up \n"
248 "for a free account. \n"
249 " \n"
250 "After you are done registering, you need \n"
251 "to input the username and password into \n"
252 "RetroArch.");
253 break;
254 case MENU_ENUM_LABEL_CHEEVOS_USERNAME:
255 snprintf(s, len, "Username for your Retro Achievements account.");
256 break;
257 case MENU_ENUM_LABEL_CHEEVOS_PASSWORD:
258 snprintf(s, len, "Password for your Retro Achievements account.");
259 break;
260 case MENU_ENUM_LABEL_USER_LANGUAGE:
261 snprintf(s, len, "Localizes the menu and all onscreen messages \n"
262 "according to the language you have selected \n"
263 "here. \n"
264 " \n"
265 "Requires a restart for the changes \n"
266 "to take effect. \n"
267 " \n"
268 "Note: not all languages might be currently \n"
269 "implemented. \n"
270 " \n"
271 "In case a language is not implemented, \n"
272 "we fallback to English.");
273 break;
274 case MENU_ENUM_LABEL_VIDEO_FONT_PATH:
275 snprintf(s, len, "Change the font that is used \n"
276 "for the Onscreen Display text.");
277 break;
278 case MENU_ENUM_LABEL_GAME_SPECIFIC_OPTIONS:
279 snprintf(s, len, "Automatically load content-specific core options.");
280 break;
281 case MENU_ENUM_LABEL_AUTO_OVERRIDES_ENABLE:
282 snprintf(s, len, "Automatically load override configurations.");
283 break;
284 case MENU_ENUM_LABEL_AUTO_REMAPS_ENABLE:
285 snprintf(s, len, "Automatically load input remapping files.");
286 break;
287 case MENU_ENUM_LABEL_SORT_SAVESTATES_ENABLE:
288 snprintf(s, len, "Sort save states in folders \n"
289 "named after the libretro core used.");
290 break;
291 case MENU_ENUM_LABEL_SORT_SAVEFILES_ENABLE:
292 snprintf(s, len, "Sort save files in folders \n"
293 "named after the libretro core used.");
294 break;
295 case MENU_ENUM_LABEL_SORT_SAVESTATES_BY_CONTENT_ENABLE:
296 snprintf(s, len, "Sort save states in folders named \n"
297 "after the folder in which the content lives.");
298 break;
299 case MENU_ENUM_LABEL_SORT_SAVEFILES_BY_CONTENT_ENABLE:
300 snprintf(s, len, "Sort save files in folders named \n"
301 "after the folder in which the content lives.");
302 break;
303 case MENU_ENUM_LABEL_SORT_SCREENSHOTS_BY_CONTENT_ENABLE:
304 snprintf(s, len, "Sort screenshots in folders named \n"
305 "after the folder in which the content lives.");
306 break;
307 case MENU_ENUM_LABEL_RESUME_CONTENT:
308 snprintf(s, len, "Exits from the menu and returns back \n"
309 "to the content.");
310 break;
311 case MENU_ENUM_LABEL_RESTART_CONTENT:
312 snprintf(s, len, "Restarts the content from the beginning.");
313 break;
314 case MENU_ENUM_LABEL_CLOSE_CONTENT:
315 snprintf(s, len, "Closes the content and unloads it from \n"
316 "memory.");
317 break;
318 case MENU_ENUM_LABEL_UNDO_LOAD_STATE:
319 snprintf(s, len, "If a state was loaded, content will \n"
320 "go back to the state prior to loading.");
321 break;
322 case MENU_ENUM_LABEL_UNDO_SAVE_STATE:
323 snprintf(s, len, "If a state was overwritten, it will \n"
324 "roll back to the previous save state.");
325 break;
326 case MENU_ENUM_LABEL_TAKE_SCREENSHOT:
327 snprintf(s, len, "Create a screenshot. \n"
328 " \n"
329 "The screenshot will be stored inside the \n"
330 "Screenshot Directory.");
331 break;
332 case MENU_ENUM_LABEL_ADD_TO_FAVORITES:
333 snprintf(s, len, "Add the entry to your Favorites.");
334 break;
335 case MENU_ENUM_LABEL_RUN:
336 snprintf(s, len, "Start the content.");
337 break;
338 case MENU_ENUM_LABEL_INFORMATION:
339 snprintf(s, len, "Show additional metadata information \n"
340 "about the content.");
341 break;
342 case MENU_ENUM_LABEL_FILE_BROWSER_CONFIG:
343 snprintf(s, len, "Configuration file.");
344 break;
345 case MENU_ENUM_LABEL_FILE_BROWSER_COMPRESSED_ARCHIVE:
346 snprintf(s, len, "Compressed archive file.");
347 break;
348 case MENU_ENUM_LABEL_FILE_BROWSER_RECORD_CONFIG:
349 snprintf(s, len, "Recording configuration file.");
350 break;
351 case MENU_ENUM_LABEL_FILE_BROWSER_CURSOR:
352 snprintf(s, len, "Database cursor file.");
353 break;
354 case MENU_ENUM_LABEL_FILE_CONFIG:
355 snprintf(s, len, "Configuration file.");
356 break;
357 case MENU_ENUM_LABEL_SCAN_THIS_DIRECTORY:
358 snprintf(s, len,
359 "Select this to scan the current directory \n"
360 "for content.");
361 break;
362 case MENU_ENUM_LABEL_USE_THIS_DIRECTORY:
363 snprintf(s, len,
364 "Select this to set this as the directory.");
365 break;
366 case MENU_ENUM_LABEL_CONTENT_DATABASE_DIRECTORY:
367 snprintf(s, len,
368 "Content Database Directory. \n"
369 " \n"
370 "Path to content database \n"
371 "directory.");
372 break;
373 case MENU_ENUM_LABEL_THUMBNAILS_DIRECTORY:
374 snprintf(s, len,
375 "Thumbnails Directory. \n"
376 " \n"
377 "To store thumbnail files.");
378 break;
379 case MENU_ENUM_LABEL_LIBRETRO_INFO_PATH:
380 snprintf(s, len,
381 "Core Info Directory. \n"
382 " \n"
383 "A directory for where to search \n"
384 "for libretro core information.");
385 break;
386 case MENU_ENUM_LABEL_PLAYLIST_DIRECTORY:
387 snprintf(s, len,
388 "Playlist Directory. \n"
389 " \n"
390 "Save all playlist files to this \n"
391 "directory.");
392 break;
393 case MENU_ENUM_LABEL_DUMMY_ON_CORE_SHUTDOWN:
394 snprintf(s, len,
395 "Some cores might have \n"
396 "a shutdown feature. \n"
397 " \n"
398 "If this option is left disabled, \n"
399 "selecting the shutdown procedure \n"
400 "would trigger RetroArch being shut \n"
401 "down. \n"
402 " \n"
403 "Enabling this option will load a \n"
404 "dummy core instead so that we remain \n"
405 "inside the menu and RetroArch won't \n"
406 "shutdown.");
407 break;
408 case MENU_ENUM_LABEL_CHECK_FOR_MISSING_FIRMWARE:
409 snprintf(s, len,
410 "Some cores might need \n"
411 "firmware or bios files. \n"
412 " \n"
413 "If this option is disabled, \n"
414 "it will try to load even if such \n"
415 "firmware is missing.");
416 break;
417 case MENU_ENUM_LABEL_PARENT_DIRECTORY:
418 snprintf(s, len,
419 "Go back to the parent directory.");
420 break;
421 case MENU_ENUM_LABEL_FILE_BROWSER_OPEN_UWP_PERMISSIONS:
422 snprintf(s, len,
423 "Open Windows permission settings to enable \n"
424 "the broadFileSystemAccess capability.");
425 break;
426 case MENU_ENUM_LABEL_FILE_BROWSER_OPEN_PICKER:
427 snprintf(s, len,
428 "Open the system file picker to access \n"
429 "additional directories.");
430 break;
431 case MENU_ENUM_LABEL_FILE_BROWSER_SHADER_PRESET:
432 snprintf(s, len,
433 "Shader preset file.");
434 break;
435 case MENU_ENUM_LABEL_FILE_BROWSER_SHADER:
436 snprintf(s, len,
437 "Shader file.");
438 break;
439 case MENU_ENUM_LABEL_FILE_BROWSER_REMAP:
440 snprintf(s, len,
441 "Remap controls file.");
442 break;
443 case MENU_ENUM_LABEL_FILE_BROWSER_CHEAT:
444 snprintf(s, len,
445 "Cheat file.");
446 break;
447 case MENU_ENUM_LABEL_FILE_BROWSER_OVERLAY:
448 snprintf(s, len,
449 "Overlay file.");
450 break;
451 case MENU_ENUM_LABEL_FILE_BROWSER_RDB:
452 snprintf(s, len,
453 "Database file.");
454 break;
455 case MENU_ENUM_LABEL_FILE_BROWSER_FONT:
456 snprintf(s, len,
457 "TrueType font file.");
458 break;
459 case MENU_ENUM_LABEL_FILE_BROWSER_PLAIN_FILE:
460 snprintf(s, len,
461 "Plain file.");
462 break;
463 case MENU_ENUM_LABEL_FILE_BROWSER_MOVIE_OPEN:
464 snprintf(s, len,
465 "Video. \n"
466 " \n"
467 "Select it to open this file with the \n"
468 "video player.");
469 break;
470 case MENU_ENUM_LABEL_FILE_BROWSER_MUSIC_OPEN:
471 snprintf(s, len,
472 "Music. \n"
473 " \n"
474 "Select it to open this file with the \n"
475 "music player.");
476 break;
477 case MENU_ENUM_LABEL_FILE_BROWSER_IMAGE:
478 snprintf(s, len,
479 "Image file.");
480 break;
481 case MENU_ENUM_LABEL_FILE_BROWSER_IMAGE_OPEN_WITH_VIEWER:
482 snprintf(s, len,
483 "Image. \n"
484 " \n"
485 "Select it to open this file with the \n"
486 "image viewer.");
487 break;
488 case MENU_ENUM_LABEL_FILE_BROWSER_CORE_SELECT_FROM_COLLECTION:
489 snprintf(s, len,
490 "Libretro core. \n"
491 " \n"
492 "Selecting this will associate this core \n"
493 "to the game.");
494 break;
495 case MENU_ENUM_LABEL_FILE_BROWSER_CORE:
496 snprintf(s, len,
497 "Libretro core. \n"
498 " \n"
499 "Select this file to have RetroArch load this core.");
500 break;
501 case MENU_ENUM_LABEL_FILE_BROWSER_DIRECTORY:
502 snprintf(s, len,
503 "Directory. \n"
504 " \n"
505 "Select it to open this directory.");
506 break;
507 case MENU_ENUM_LABEL_CACHE_DIRECTORY:
508 snprintf(s, len,
509 "Cache Directory. \n"
510 " \n"
511 "Content decompressed by RetroArch will be \n"
512 "temporarily extracted to this directory.");
513 break;
514 case MENU_ENUM_LABEL_HISTORY_LIST_ENABLE:
515 snprintf(s, len,
516 "If enabled, every content loaded \n"
517 "in RetroArch will be automatically \n"
518 "added to the recent history list.");
519 break;
520 case MENU_ENUM_LABEL_RGUI_BROWSER_DIRECTORY:
521 snprintf(s, len,
522 "File Browser Directory. \n"
523 " \n"
524 "Sets start directory for menu file browser.");
525 break;
526 case MENU_ENUM_LABEL_INPUT_POLL_TYPE_BEHAVIOR:
527 snprintf(s, len,
528 "Influence how input polling is done inside \n"
529 "RetroArch. \n"
530 " \n"
531 "Early - Input polling is performed before \n"
532 "the frame is processed. \n"
533 "Normal - Input polling is performed when \n"
534 "polling is requested. \n"
535 "Late - Input polling is performed on \n"
536 "first input state request per frame.\n"
537 " \n"
538 "Setting it to 'Early' or 'Late' can result \n"
539 "in less latency, \n"
540 "depending on your configuration.\n\n"
541 "Will be ignored when using netplay.");
542 break;
543 case MENU_ENUM_LABEL_INPUT_DESCRIPTOR_HIDE_UNBOUND:
544 snprintf(s, len,
545 "Hide input descriptors that were not set \n"
546 "by the core.");
547 break;
548 case MENU_ENUM_LABEL_VIDEO_REFRESH_RATE:
549 snprintf(s, len,
550 "Video refresh rate of your monitor. \n"
551 "Used to calculate a suitable audio input rate.");
552 break;
553 case MENU_ENUM_LABEL_VIDEO_FORCE_SRGB_DISABLE:
554 snprintf(s, len,
555 "Forcibly disable sRGB FBO support. Some Intel \n"
556 "OpenGL drivers on Windows have video problems \n"
557 "with sRGB FBO support enabled.");
558 break;
559 case MENU_ENUM_LABEL_AUDIO_ENABLE:
560 snprintf(s, len,
561 "Enable audio output.");
562 break;
563 case MENU_ENUM_LABEL_AUDIO_SYNC:
564 snprintf(s, len,
565 "Synchronize audio (recommended).");
566 break;
567 case MENU_ENUM_LABEL_AUDIO_LATENCY:
568 snprintf(s, len,
569 "Desired audio latency in milliseconds. \n"
570 "Might not be honored if the audio driver \n"
571 "can't provide given latency.");
572 break;
573 case MENU_ENUM_LABEL_VIDEO_ALLOW_ROTATE:
574 snprintf(s, len,
575 "Allow cores to set rotation. If false, \n"
576 "rotation requests are honored, but ignored.\n\n"
577 "Used for setups where one manually rotates \n"
578 "the monitor.");
579 break;
580 case MENU_ENUM_LABEL_INPUT_DESCRIPTOR_LABEL_SHOW:
581 snprintf(s, len,
582 "Show the input descriptors set by the core \n"
583 "instead of the default ones.");
584 break;
585 case MENU_ENUM_LABEL_CONTENT_HISTORY_SIZE:
586 snprintf(s, len,
587 "Number of entries that will be kept in \n"
588 "content history playlist.");
589 break;
590 case MENU_ENUM_LABEL_VIDEO_WINDOWED_FULLSCREEN:
591 snprintf(s, len,
592 "To use windowed mode or not when going \n"
593 "fullscreen.");
594 break;
595 case MENU_ENUM_LABEL_VIDEO_FONT_SIZE:
596 snprintf(s, len,
597 "Font size for on-screen messages.");
598 break;
599 case MENU_ENUM_LABEL_SAVESTATE_AUTO_INDEX:
600 snprintf(s, len,
601 "Automatically increment slot index on each save, \n"
602 "generating multiple savestate files. \n"
603 "When the content is loaded, state slot will be \n"
604 "set to the highest existing value (last savestate).");
605 break;
606 case MENU_ENUM_LABEL_FPS_SHOW:
607 snprintf(s, len,
608 "Enables displaying the current frames \n"
609 "per second.");
610 break;
611 case MENU_ENUM_LABEL_MEMORY_SHOW:
612 snprintf(s, len,
613 "Includes displaying the current memory \n"
614 "usage/total with FPS/Frames.");
615 break;
616 case MENU_ENUM_LABEL_VIDEO_FONT_ENABLE:
617 snprintf(s, len,
618 "Show and/or hide onscreen messages.");
619 break;
620 case MENU_ENUM_LABEL_VIDEO_MESSAGE_POS_X:
621 case MENU_ENUM_LABEL_VIDEO_MESSAGE_POS_Y:
622 snprintf(s, len,
623 "Offset for where messages will be placed \n"
624 "onscreen. Values are in range [0.0, 1.0].");
625 break;
626 case MENU_ENUM_LABEL_INPUT_OVERLAY_ENABLE:
627 snprintf(s, len,
628 "Enable or disable the current overlay.");
629 break;
630 case MENU_ENUM_LABEL_INPUT_OVERLAY_HIDE_IN_MENU:
631 snprintf(s, len,
632 "Hide the current overlay from appearing \n"
633 "inside the menu.");
634 break;
635 case MENU_ENUM_LABEL_INPUT_OVERLAY_SHOW_PHYSICAL_INPUTS:
636 snprintf(s, len,
637 "Show keyboard/controller button presses on \n"
638 "the onscreen overlay.");
639 break;
640 case MENU_ENUM_LABEL_INPUT_OVERLAY_SHOW_PHYSICAL_INPUTS_PORT:
641 snprintf(s, len,
642 "Select the port to listen for controller input \n"
643 "to display on the onscreen overlay.");
644 break;
645 case MENU_ENUM_LABEL_OVERLAY_PRESET:
646 snprintf(s, len,
647 "Path to input overlay.");
648 break;
649 case MENU_ENUM_LABEL_OVERLAY_OPACITY:
650 snprintf(s, len,
651 "Overlay opacity.");
652 break;
653 case MENU_ENUM_LABEL_VIDEO_LAYOUT_ENABLE:
654 snprintf(s, len,
655 "Enable or disable the current video layout.");
656 break;
657 case MENU_ENUM_LABEL_VIDEO_LAYOUT_PATH:
658 snprintf(s, len,
659 "Path to video layout.");
660 break;
661 case MENU_ENUM_LABEL_VIDEO_LAYOUT_SELECTED_VIEW:
662 snprintf(s, len,
663 "Layouts can contain multiple views. \n"
664 "Select a view.");
665 break;
666 case MENU_ENUM_LABEL_INPUT_BIND_TIMEOUT:
667 snprintf(s, len,
668 "Input bind timer timeout (in seconds). \n"
669 "Amount of seconds to wait until proceeding \n"
670 "to the next bind.");
671 break;
672 case MENU_ENUM_LABEL_INPUT_BIND_HOLD:
673 snprintf(s, len,
674 "Input bind hold time (in seconds). \n"
675 "Amount of seconds to hold an input to bind it.");
676 break;
677 case MENU_ENUM_LABEL_AUDIO_OUTPUT_RATE:
678 snprintf(s, len,
679 "Audio output samplerate.");
680 break;
681 case MENU_ENUM_LABEL_VIDEO_SHARED_CONTEXT:
682 snprintf(s, len,
683 "Set to true if hardware-rendered cores \n"
684 "should get their private context. \n"
685 "Avoids having to assume hardware state changes \n"
686 "inbetween frames.");
687 break;
688 case MENU_ENUM_LABEL_CORE_LIST:
689 snprintf(s, len,
690 "Load Core. \n"
691 " \n"
692 "Browse for a libretro core \n"
693 "implementation. Where the browser \n"
694 "starts depends on your Core Directory \n"
695 "path. If blank, it will start in root. \n"
696 " \n"
697 "If Core Directory is a directory, the menu \n"
698 "will use that as top folder. If Core \n"
699 "Directory is a full path, it will start \n"
700 "in the folder where the file is.");
701 break;
702 case MENU_ENUM_LABEL_VALUE_MENU_ENUM_CONTROLS_PROLOG:
703 snprintf(s, len,
704 "You can use the following controls below \n"
705 "on either your gamepad or keyboard in order\n"
706 "to control the menu: \n"
707 " \n");
708 break;
709 case MENU_ENUM_LABEL_WELCOME_TO_RETROARCH:
710 snprintf(s, len,
711 "Welcome to RetroArch\n");
712 break;
713 case MENU_ENUM_LABEL_VALUE_HELP_AUDIO_VIDEO_TROUBLESHOOTING_DESC:
714 {
715 /* Work around C89 limitations */
716 char u[501];
717 const char *t =
718 "RetroArch relies on an unique form of\n"
719 "audio/video synchronization where it needs to be\n"
720 "calibrated against the refresh rate of your\n"
721 "display for best performance results.\n"
722 " \n"
723 "If you experience any audio crackling or video\n"
724 "tearing, usually it means that you need to\n"
725 "calibrate the settings. Some choices below:\n"
726 " \n";
727 snprintf(u, sizeof(u), /* can't inline this due to the printf arguments */
728 "a) Go to '%s' -> '%s', and enable\n"
729 "'Threaded Video'. Refresh rate will not matter\n"
730 "in this mode, framerate will be higher,\n"
731 "but video might be less smooth.\n"
732 "b) Go to '%s' -> '%s', and look at\n"
733 "'%s'. Let it run for\n"
734 "2048 frames, then press 'OK'.",
735 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SETTINGS),
736 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_VIDEO_SETTINGS),
737 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SETTINGS),
738 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_VIDEO_SETTINGS),
739 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_VIDEO_REFRESH_RATE_AUTO));
740 strlcpy(s, t, len);
741 strlcat(s, u, len);
742 }
743 break;
744 case MENU_ENUM_LABEL_VALUE_HELP_SCANNING_CONTENT_DESC:
745 snprintf(s, len,
746 "To scan for content, go to '%s' and\n"
747 "select either '%s' or %s'.\n"
748 "\n"
749 "Files will be compared to database entries.\n"
750 "If there is a match, it will add an entry\n"
751 "to a playlist.\n"
752 "\n"
753 "You can then easily access this content by\n"
754 "going to '%s' ->\n"
755 "'%s'\n"
756 "instead of having to go through the\n"
757 "file browser every time.\n"
758 "\n"
759 "NOTE: Content for some cores might still not be\n"
760 "scannable.",
761 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_ADD_CONTENT_LIST),
762 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SCAN_DIRECTORY),
763 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SCAN_FILE),
764 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_LOAD_CONTENT_LIST),
765 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_PLAYLISTS_TAB));
766 break;
767 case MENU_ENUM_LABEL_VALUE_EXTRACTING_PLEASE_WAIT:
768 snprintf(s, len,
769 "Welcome to RetroArch\n"
770 "\n"
771 "Extracting assets, please wait.\n"
772 "This might take a while...\n");
773 break;
774 case MENU_ENUM_LABEL_INPUT_DRIVER:
775 {
776 const char *lbl = settings ? settings->arrays.input_driver : NULL;
777
778 if (string_is_equal(lbl, msg_hash_to_str(MENU_ENUM_LABEL_INPUT_DRIVER_UDEV)))
779 snprintf(s, len,
780 "udev Input driver. \n"
781 " \n"
782 "It uses the recent evdev joypad API \n"
783 "for joystick support. It supports \n"
784 "hotplugging and force feedback. \n"
785 " \n"
786 "The driver reads evdev events for keyboard \n"
787 "support. It also supports keyboard callback, \n"
788 "mice and touchpads. \n"
789 " \n"
790 "By default in most distros, /dev/input nodes \n"
791 "are root-only (mode 600). You can set up a udev \n"
792 "rule which makes these accessible to non-root.");
793 else if (string_is_equal(lbl,
794 msg_hash_to_str(MENU_ENUM_LABEL_INPUT_DRIVER_LINUXRAW)))
795 snprintf(s, len,
796 "linuxraw Input driver. \n"
797 " \n"
798 "This driver requires an active TTY. Keyboard \n"
799 "events are read directly from the TTY which \n"
800 "makes it simpler, but not as flexible as udev. \n" "Mice, etc, are not supported at all. \n"
801 " \n"
802 "This driver uses the older joystick API \n"
803 "(/dev/input/js*).");
804 else
805 snprintf(s, len,
806 "Input driver.\n"
807 " \n"
808 "Depending on video driver, it might \n"
809 "force a different input driver.");
810 }
811 break;
812 case MENU_ENUM_LABEL_LOAD_CONTENT_LIST:
813 snprintf(s, len,
814 "Load Content. \n"
815 "Browse for content. \n"
816 " \n"
817 "To load content, you need a \n"
818 "'Core' to use, and a content file. \n"
819 " \n"
820 "To control where the menu starts \n"
821 "to browse for content, set \n"
822 "'File Browser Directory'. \n"
823 "If not set, it will start in root. \n"
824 " \n"
825 "The browser will filter out \n"
826 "extensions for the last core set \n"
827 "in 'Load Core', and use that core \n"
828 "when content is loaded.");
829 break;
830 case MENU_ENUM_LABEL_LOAD_CONTENT_HISTORY:
831 snprintf(s, len,
832 "Loading content from history. \n"
833 " \n"
834 "As content is loaded, content and libretro \n"
835 "core combinations are saved to history. \n"
836 " \n"
837 "The history is saved to a file in the same \n"
838 "directory as the RetroArch config file. If \n"
839 "no config file was loaded in startup, history \n"
840 "will not be saved or loaded, and will not exist \n"
841 "in the main menu.");
842 break;
843 case MENU_ENUM_LABEL_VIDEO_DRIVER:
844 {
845 const char *video_driver = settings->arrays.video_driver;
846
847 snprintf(s, len,
848 "Current Video driver.");
849
850 if (string_is_equal(video_driver, "gl"))
851 {
852 snprintf(s, len,
853 "OpenGL Video driver. \n"
854 " \n"
855 "This driver allows libretro GL cores to \n"
856 "be used in addition to software-rendered \n"
857 "core implementations.\n"
858 " \n"
859 "Performance for software-rendered and \n"
860 "libretro GL core implementations is \n"
861 "dependent on your graphics card's \n"
862 "underlying GL driver).");
863 }
864 else if (string_is_equal(video_driver, "sdl2"))
865 {
866 snprintf(s, len,
867 "SDL 2 Video driver.\n"
868 " \n"
869 "This is an SDL 2 software-rendered video \n"
870 "driver.\n"
871 " \n"
872 "Performance for software-rendered libretro \n"
873 "core implementations is dependent \n"
874 "on your platform SDL implementation.");
875 }
876 else if (string_is_equal(video_driver, "sdl1"))
877 {
878 snprintf(s, len,
879 "SDL Video driver.\n"
880 " \n"
881 "This is an SDL 1.2 software-rendered video \n"
882 "driver.\n"
883 " \n"
884 "Performance is considered to be suboptimal. \n"
885 "Consider using it only as a last resort.");
886 }
887 else if (string_is_equal(video_driver, "d3d"))
888 {
889 snprintf(s, len,
890 "Direct3D Video driver. \n"
891 " \n"
892 "Performance for software-rendered cores \n"
893 "is dependent on your graphic card's \n"
894 "underlying D3D driver).");
895 }
896 else if (string_is_equal(video_driver, "exynos"))
897 {
898 snprintf(s, len,
899 "Exynos-G2D Video Driver. \n"
900 " \n"
901 "This is a low-level Exynos video driver. \n"
902 "Uses the G2D block in Samsung Exynos SoC \n"
903 "for blit operations. \n"
904 " \n"
905 "Performance for software rendered cores \n"
906 "should be optimal.");
907 }
908 else if (string_is_equal(video_driver, "drm"))
909 {
910 snprintf(s, len,
911 "Plain DRM Video Driver. \n"
912 " \n"
913 "This is a low-level video driver using. \n"
914 "libdrm for hardware scaling using \n"
915 "GPU overlays.");
916 }
917 else if (string_is_equal(video_driver, "sunxi"))
918 {
919 snprintf(s, len,
920 "Sunxi-G2D Video Driver. \n"
921 " \n"
922 "This is a low-level Sunxi video driver. \n"
923 "Uses the G2D block in Allwinner SoCs.");
924 }
925 }
926 break;
927 case MENU_ENUM_LABEL_AUDIO_DSP_PLUGIN:
928 snprintf(s, len,
929 "Audio DSP plugin.\n"
930 " Processes audio before it's sent to \n"
931 "the driver.");
932 break;
933 case MENU_ENUM_LABEL_AUDIO_RESAMPLER_DRIVER:
934 {
935 const char *lbl = settings ? settings->arrays.audio_resampler : NULL;
936
937 if (string_is_equal(lbl, msg_hash_to_str(
938 MENU_ENUM_LABEL_AUDIO_RESAMPLER_DRIVER_SINC)))
939 strlcpy(s,
940 "Windowed SINC implementation.", len);
941 else if (string_is_equal(lbl, msg_hash_to_str(
942 MENU_ENUM_LABEL_AUDIO_RESAMPLER_DRIVER_CC)))
943 strlcpy(s,
944 "Convoluted Cosine implementation.", len);
945 else if (string_is_empty(s))
946 strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
947 }
948 break;
949
950 case MENU_ENUM_LABEL_CRT_SWITCH_RESOLUTION: snprintf(s, len, "SET CRT");
951 break;
952
953 case MENU_ENUM_LABEL_CRT_SWITCH_RESOLUTION_SUPER: snprintf(s, len, "SET CRT SUPER");
954 break;
955
956 case MENU_ENUM_LABEL_VIDEO_SHADER_PRESET:
957 snprintf(s, len,
958 "Load Shader Preset. \n"
959 " \n"
960 " Load a shader preset directly. \n"
961 "The menu shader menu is updated accordingly. \n"
962 " \n"
963 "If the CGP uses scaling methods which are not \n"
964 "simple, (i.e. source scaling, same scaling \n"
965 "factor for X/Y), the scaling factor displayed \n"
966 "in the menu might not be correct.");
967 break;
968 case MENU_ENUM_LABEL_VIDEO_SHADER_SCALE_PASS:
969 snprintf(s, len,
970 "Scale for this pass. \n"
971 " \n"
972 "The scale factor accumulates, i.e. 2x \n"
973 "for first pass and 2x for second pass \n"
974 "will give you a 4x total scale. \n"
975 " \n"
976 "If there is a scale factor for last \n"
977 "pass, the result is stretched to \n"
978 "screen with the filter specified in \n"
979 "'Default Filter'. \n"
980 " \n"
981 "If 'Don't Care' is set, either 1x \n"
982 "scale or stretch to fullscreen will \n"
983 "be used depending if it's not the last \n"
984 "pass or not.");
985 break;
986 case MENU_ENUM_LABEL_VIDEO_SHADER_NUM_PASSES:
987 snprintf(s, len,
988 "Shader Passes. \n"
989 " \n"
990 "RetroArch allows you to mix and match various \n"
991 "shaders with arbitrary shader passes, with \n"
992 "custom hardware filters and scale factors. \n"
993 " \n"
994 "This option specifies the number of shader \n"
995 "passes to use. If you set this to 0, and use \n"
996 "Apply Shader Changes, you use a 'blank' shader. \n"
997 " \n"
998 "The Default Filter option will affect the \n"
999 "stretching filter.");
1000 break;
1001 case MENU_ENUM_LABEL_VIDEO_SHADER_PARAMETERS:
1002 snprintf(s, len,
1003 "Shader Parameters. \n"
1004 " \n"
1005 "Modifies current shader directly. Will not be \n"
1006 "saved to CGP/GLSLP preset file.");
1007 break;
1008 case MENU_ENUM_LABEL_VIDEO_SHADER_PRESET_PARAMETERS:
1009 snprintf(s, len,
1010 "Shader Preset Parameters. \n"
1011 " \n"
1012 "Modifies shader preset currently in menu.");
1013 break;
1014 case MENU_ENUM_LABEL_VIDEO_SHADER_PASS:
1015 snprintf(s, len,
1016 "Path to shader. \n"
1017 " \n"
1018 "All shaders must be of the same \n"
1019 "type (i.e. CG, GLSL or HLSL). \n"
1020 " \n"
1021 "Set Shader Directory to set where \n"
1022 "the browser starts to look for \n"
1023 "shaders.");
1024 break;
1025 case MENU_ENUM_LABEL_CONFIGURATION_SETTINGS:
1026 snprintf(s, len,
1027 "Determines how configuration files \n"
1028 "are loaded and prioritized.");
1029 break;
1030 case MENU_ENUM_LABEL_CONFIG_SAVE_ON_EXIT:
1031 snprintf(s, len,
1032 "Saves config to disk on exit.\n"
1033 "Useful for menu as settings can be\n"
1034 "modified. Overwrites the config.\n"
1035 " \n"
1036 "#include's and comments are not \n"
1037 "preserved. \n"
1038 " \n"
1039 "By design, the config file is \n"
1040 "considered immutable as it is \n"
1041 "likely maintained by the user, \n"
1042 "and should not be overwritten \n"
1043 "behind the user's back."
1044 #if defined(RARCH_CONSOLE) || defined(RARCH_MOBILE)
1045 "\nThis is not not the case on \n"
1046 "consoles however, where \n"
1047 "looking at the config file \n"
1048 "manually isn't really an option."
1049 #endif
1050 );
1051 break;
1052 case MENU_ENUM_LABEL_CONFIRM_ON_EXIT:
1053 snprintf(s, len, "Are you sure you want to quit?");
1054 break;
1055 case MENU_ENUM_LABEL_SHOW_HIDDEN_FILES:
1056 snprintf(s, len, "Show hidden files\n"
1057 "and folders.");
1058 break;
1059 case MENU_ENUM_LABEL_VIDEO_SHADER_FILTER_PASS:
1060 snprintf(s, len,
1061 "Hardware filter for this pass. \n"
1062 " \n"
1063 "If 'Don't Care' is set, 'Default \n"
1064 "Filter' will be used.");
1065 break;
1066 case MENU_ENUM_LABEL_AUTOSAVE_INTERVAL:
1067 snprintf(s, len,
1068 "Autosaves the non-volatile SRAM \n"
1069 "at a regular interval.\n"
1070 " \n"
1071 "This is disabled by default unless set \n"
1072 "otherwise. The interval is measured in \n"
1073 "seconds. \n"
1074 " \n"
1075 "A value of 0 disables autosave.");
1076 break;
1077 case MENU_ENUM_LABEL_INPUT_BIND_DEVICE_TYPE:
1078 snprintf(s, len,
1079 "Input Device Type. \n"
1080 " \n"
1081 "Picks which device type to use. This is \n"
1082 "relevant for the libretro core itself.");
1083 break;
1084 case MENU_ENUM_LABEL_LIBRETRO_LOG_LEVEL:
1085 snprintf(s, len,
1086 "Sets log level for libretro cores \n"
1087 "(GET_LOG_INTERFACE). \n"
1088 " \n"
1089 " If a log level issued by a libretro \n"
1090 " core is below libretro_log level, it \n"
1091 " is ignored.\n"
1092 " \n"
1093 " DEBUG logs are always ignored unless \n"
1094 " verbose mode is activated (--verbose).\n"
1095 " \n"
1096 " DEBUG = 0\n"
1097 " INFO = 1\n"
1098 " WARN = 2\n"
1099 " ERROR = 3");
1100 break;
1101 case MENU_ENUM_LABEL_STATE_SLOT_INCREASE:
1102 case MENU_ENUM_LABEL_STATE_SLOT_DECREASE:
1103 snprintf(s, len,
1104 "State slots.\n"
1105 " \n"
1106 " With slot set to 0, save state name is *.state \n"
1107 " (or whatever defined on commandline).\n"
1108 "When slot is != 0, path will be (path)(d), \n"
1109 "where (d) is slot number.");
1110 break;
1111 case MENU_ENUM_LABEL_SHADER_APPLY_CHANGES:
1112 snprintf(s, len,
1113 "Apply Shader Changes. \n"
1114 " \n"
1115 "After changing shader settings, use this to \n"
1116 "apply changes. \n"
1117 " \n"
1118 "Changing shader settings is a somewhat \n"
1119 "expensive operation so it has to be \n"
1120 "done explicitly. \n"
1121 " \n"
1122 "When you apply shaders, the menu shader \n"
1123 "settings are saved to a temporary file (either \n"
1124 "menu.cgp or menu.glslp) and loaded. The file \n"
1125 "persists after RetroArch exits. The file is \n"
1126 "saved to Shader Directory.");
1127 break;
1128 case MENU_ENUM_LABEL_SHADER_WATCH_FOR_CHANGES:
1129 snprintf(s, len,
1130 "Watch shader files for new changes. \n"
1131 " \n"
1132 "After saving changes to a shader on disk, \n"
1133 "it will automatically be recompiled \n"
1134 "and applied to the running content.");
1135 break;
1136 case MENU_ENUM_LABEL_MENU_TOGGLE:
1137 snprintf(s, len,
1138 "Toggles menu.");
1139 break;
1140 case MENU_ENUM_LABEL_GRAB_MOUSE_TOGGLE:
1141 snprintf(s, len,
1142 "Toggles mouse grab.\n"
1143 " \n"
1144 "When mouse is grabbed, RetroArch hides the \n"
1145 "mouse, and keeps the mouse pointer inside \n"
1146 "the window to allow relative mouse input to \n"
1147 "work better.");
1148 break;
1149 case MENU_ENUM_LABEL_GAME_FOCUS_TOGGLE:
1150 snprintf(s, len,
1151 "Toggles game focus.\n"
1152 " \n"
1153 "When a game has focus, RetroArch will both disable \n"
1154 "hotkeys and keep/wrap the mouse pointer inside the window.");
1155 break;
1156 case MENU_ENUM_LABEL_DISK_NEXT:
1157 snprintf(s, len,
1158 "Cycles through disk images. Use after \n"
1159 "ejecting. \n"
1160 " \n"
1161 " Complete by toggling eject again.");
1162 break;
1163 case MENU_ENUM_LABEL_VIDEO_FILTER:
1164 #ifdef HAVE_FILTERS_BUILTIN
1165 snprintf(s, len,
1166 "CPU-based video filter.");
1167 #else
1168 snprintf(s, len,
1169 "CPU-based video filter.\n"
1170 " \n"
1171 "Path to a dynamic library.");
1172 #endif
1173 break;
1174 case MENU_ENUM_LABEL_AUDIO_DEVICE:
1175 snprintf(s, len,
1176 "Override the default audio device \n"
1177 "the audio driver uses.\n"
1178 "This is driver dependent. E.g.\n"
1179 #ifdef HAVE_ALSA
1180 " \n"
1181 "ALSA wants a PCM device."
1182 #endif
1183 #ifdef HAVE_OSS
1184 " \n"
1185 "OSS wants a path (e.g. /dev/dsp)."
1186 #endif
1187 #ifdef HAVE_JACK
1188 " \n"
1189 "JACK wants portnames (e.g. system:playback1\n"
1190 ",system:playback_2)."
1191 #endif
1192 #ifdef HAVE_RSOUND
1193 " \n"
1194 "RSound wants an IP address to an RSound \n"
1195 "server."
1196 #endif
1197 );
1198 break;
1199 case MENU_ENUM_LABEL_DISK_EJECT_TOGGLE:
1200 snprintf(s, len,
1201 "Toggles eject for disks.\n"
1202 " \n"
1203 "Used for multiple-disk content.");
1204 break;
1205 case MENU_ENUM_LABEL_ENABLE_HOTKEY:
1206 snprintf(s, len,
1207 "Enable other hotkeys.\n"
1208 " \n"
1209 " If this hotkey is bound to either keyboard, \n"
1210 "joybutton or joyaxis, all other hotkeys will \n"
1211 "be disabled unless this hotkey is also held \n"
1212 "at the same time. \n"
1213 " \n"
1214 "This is useful for RETRO_KEYBOARD centric \n"
1215 "implementations which query a large area of \n"
1216 "the keyboard, where it is not desirable that \n"
1217 "hotkeys get in the way.");
1218 break;
1219 case MENU_ENUM_LABEL_REWIND_ENABLE:
1220 snprintf(s, len,
1221 "Enable rewinding.\n"
1222 " \n"
1223 "This will take a performance hit, \n"
1224 "so it is disabled by default.");
1225 break;
1226 case MENU_ENUM_LABEL_CHEAT_APPLY_AFTER_TOGGLE:
1227 snprintf(s, len,
1228 "Apply cheat immediately after toggling.");
1229 break;
1230 case MENU_ENUM_LABEL_CHEAT_APPLY_AFTER_LOAD:
1231 snprintf(s, len,
1232 "Auto-apply cheats when game loads.");
1233 break;
1234 case MENU_ENUM_LABEL_LIBRETRO_DIR_PATH:
1235 snprintf(s, len,
1236 "Core Directory. \n"
1237 " \n"
1238 "A directory for where to search for \n"
1239 "libretro core implementations.");
1240 break;
1241 case MENU_ENUM_LABEL_VIDEO_REFRESH_RATE_AUTO:
1242 snprintf(s, len,
1243 "Refresh Rate Auto.\n"
1244 " \n"
1245 "The accurate refresh rate of our monitor (Hz).\n"
1246 "This is used to calculate audio input rate with \n"
1247 "the formula: \n"
1248 " \n"
1249 "audio_input_rate = game input rate * display \n"
1250 "refresh rate / game refresh rate\n"
1251 " \n"
1252 "If the implementation does not report any \n"
1253 "values, NTSC defaults will be assumed for \n"
1254 "compatibility.\n"
1255 " \n"
1256 "This value should stay close to 60Hz to avoid \n"
1257 "large pitch changes. If your monitor does \n"
1258 "not run at 60Hz, or something close to it, \n"
1259 "disable VSync, and leave this at its default.");
1260 break;
1261 case MENU_ENUM_LABEL_VIDEO_REFRESH_RATE_POLLED:
1262 snprintf(s, len,
1263 "Set Polled Refresh Rate\n"
1264 " \n"
1265 "Sets the refresh rate to the actual value\n"
1266 "polled from the display driver.");
1267 break;
1268 case MENU_ENUM_LABEL_VIDEO_ROTATION:
1269 snprintf(s, len,
1270 "Forces a certain rotation \n"
1271 "of the screen.\n"
1272 " \n"
1273 "The rotation is added to rotations which\n"
1274 "the libretro core sets (see Video Allow\n"
1275 "Rotate).");
1276 break;
1277 case MENU_ENUM_LABEL_VIDEO_SCALE:
1278 snprintf(s, len,
1279 "Fullscreen resolution.\n"
1280 " \n"
1281 "Resolution of 0 uses the \n"
1282 "resolution of the environment.\n");
1283 break;
1284 case MENU_ENUM_LABEL_FASTFORWARD_RATIO:
1285 snprintf(s, len,
1286 "Fastforward ratio.\n"
1287 " \n"
1288 "The maximum rate at which content will\n"
1289 "be run when using fast forward.\n"
1290 " \n"
1291 " (E.g. 5.0 for 60 fps content => 300 fps \n"
1292 "cap).\n"
1293 " \n"
1294 "RetroArch will go to sleep to ensure that \n"
1295 "the maximum rate will not be exceeded.\n"
1296 "Do not rely on this cap to be perfectly \n"
1297 "accurate.");
1298 break;
1299 case MENU_ENUM_LABEL_VRR_RUNLOOP_ENABLE:
1300 snprintf(s, len,
1301 "Sync to Exact Content Framerate.\n"
1302 " \n"
1303 "This option is the equivalent of forcing x1 speed\n"
1304 "while still allowing fast forward.\n"
1305 "No deviation from the core requested refresh rate,\n"
1306 "no sound Dynamic Rate Control.");
1307 break;
1308 case MENU_ENUM_LABEL_VIDEO_MONITOR_INDEX:
1309 snprintf(s, len,
1310 "Which monitor to prefer.\n"
1311 " \n"
1312 "0 (default) means no particular monitor \n"
1313 "is preferred, 1 and up (1 being first \n"
1314 "monitor), suggests RetroArch to use that \n"
1315 "particular monitor.");
1316 break;
1317 case MENU_ENUM_LABEL_VIDEO_CROP_OVERSCAN:
1318 snprintf(s, len,
1319 "Forces cropping of overscanned \n"
1320 "frames.\n"
1321 " \n"
1322 "Exact behavior of this option is \n"
1323 "core-implementation specific.");
1324 break;
1325 case MENU_ENUM_LABEL_VIDEO_SCALE_INTEGER:
1326 snprintf(s, len,
1327 "Only scales video in integer \n"
1328 "steps.\n"
1329 " \n"
1330 "The base size depends on system-reported \n"
1331 "geometry and aspect ratio.\n"
1332 " \n"
1333 "If Force Aspect is not set, X/Y will be \n"
1334 "integer scaled independently.");
1335 break;
1336 case MENU_ENUM_LABEL_AUDIO_VOLUME:
1337 snprintf(s, len,
1338 "Audio volume, expressed in dB.\n"
1339 " \n"
1340 " 0 dB is normal volume. No gain will be applied.\n"
1341 "Gain can be controlled in runtime with Input\n"
1342 "Volume Up / Input Volume Down.");
1343 break;
1344 case MENU_ENUM_LABEL_AUDIO_RATE_CONTROL_DELTA:
1345 snprintf(s, len,
1346 "Audio rate control.\n"
1347 " \n"
1348 "Setting this to 0 disables rate control.\n"
1349 "Any other value controls audio rate control \n"
1350 "delta.\n"
1351 " \n"
1352 "Defines how much input rate can be adjusted \n"
1353 "dynamically.\n"
1354 " \n"
1355 " Input rate is defined as: \n"
1356 " input rate * (1.0 +/- (rate control delta))");
1357 break;
1358 case MENU_ENUM_LABEL_AUDIO_MAX_TIMING_SKEW:
1359 snprintf(s, len,
1360 "Maximum audio timing skew.\n"
1361 " \n"
1362 "Defines the maximum change in input rate.\n"
1363 "You may want to increase this to enable\n"
1364 "very large changes in timing, for example\n"
1365 "running PAL cores on NTSC displays, at the\n"
1366 "cost of inaccurate audio pitch.\n"
1367 " \n"
1368 " Input rate is defined as: \n"
1369 " input rate * (1.0 +/- (max timing skew))");
1370 break;
1371 case MENU_ENUM_LABEL_OVERLAY_NEXT:
1372 snprintf(s, len,
1373 "Toggles to next overlay.\n"
1374 " \n"
1375 "Wraps around.");
1376 break;
1377 case MENU_ENUM_LABEL_LOG_VERBOSITY:
1378 snprintf(s, len,
1379 "Enable or disable verbosity level \n"
1380 "of frontend.");
1381 break;
1382 case MENU_ENUM_LABEL_VOLUME_UP:
1383 snprintf(s, len,
1384 "Increases audio volume.");
1385 break;
1386 case MENU_ENUM_LABEL_VOLUME_DOWN:
1387 snprintf(s, len,
1388 "Decreases audio volume.");
1389 break;
1390 case MENU_ENUM_LABEL_VIDEO_DISABLE_COMPOSITION:
1391 snprintf(s, len,
1392 "Forcibly disable composition.\n"
1393 "Only valid on Windows Vista/7 for now.");
1394 break;
1395 case MENU_ENUM_LABEL_PERFCNT_ENABLE:
1396 snprintf(s, len,
1397 "Enable or disable frontend \n"
1398 "performance counters.");
1399 break;
1400 case MENU_ENUM_LABEL_SYSTEM_DIRECTORY:
1401 snprintf(s, len,
1402 "System Directory. \n"
1403 " \n"
1404 "Sets the 'system' directory.\n"
1405 "Cores can query for this\n"
1406 "directory to load BIOSes, \n"
1407 "system-specific configs, etc.");
1408 break;
1409 case MENU_ENUM_LABEL_SAVESTATE_AUTO_SAVE:
1410 case MENU_ENUM_LABEL_SAVESTATE_AUTO_LOAD:
1411 snprintf(s, len,
1412 "Automatically saves a savestate at the \n"
1413 "end of RetroArch's lifetime.\n"
1414 " \n"
1415 "RetroArch will automatically load any savestate\n"
1416 "with this path on startup if 'Auto Load State\n"
1417 "is enabled.");
1418 break;
1419 case MENU_ENUM_LABEL_VIDEO_THREADED:
1420 snprintf(s, len,
1421 "Use threaded video driver.\n"
1422 " \n"
1423 "Using this might improve performance at the \n"
1424 "possible cost of latency and more video \n"
1425 "stuttering.");
1426 break;
1427 case MENU_ENUM_LABEL_VIDEO_VSYNC:
1428 snprintf(s, len,
1429 "Video V-Sync.\n");
1430 break;
1431 case MENU_ENUM_LABEL_VIDEO_HARD_SYNC:
1432 snprintf(s, len,
1433 "Attempts to hard-synchronize \n"
1434 "CPU and GPU.\n"
1435 " \n"
1436 "Can reduce latency at the cost of \n"
1437 "performance.");
1438 break;
1439 case MENU_ENUM_LABEL_REWIND_GRANULARITY:
1440 snprintf(s, len,
1441 "Rewind granularity.\n"
1442 " \n"
1443 " When rewinding defined number of \n"
1444 "frames, you can rewind several frames \n"
1445 "at a time, increasing the rewinding \n"
1446 "speed.");
1447 break;
1448 case MENU_ENUM_LABEL_REWIND_BUFFER_SIZE:
1449 snprintf(s, len,
1450 "Rewind buffer size (MB).\n"
1451 " \n"
1452 " The amount of memory in MB to reserve \n"
1453 "for rewinding. Increasing this value \n"
1454 "increases the rewind history length.\n");
1455 break;
1456 case MENU_ENUM_LABEL_REWIND_BUFFER_SIZE_STEP:
1457 snprintf(s, len,
1458 "Rewind buffer size step (MB).\n"
1459 " \n"
1460 " Each time you increase or decrease \n"
1461 "the rewind buffer size value via this \n"
1462 "UI it will change by this amount.\n");
1463 break;
1464 case MENU_ENUM_LABEL_SCREENSHOT:
1465 snprintf(s, len,
1466 "Take screenshot.");
1467 break;
1468 case MENU_ENUM_LABEL_VIDEO_FRAME_DELAY:
1469 snprintf(s, len,
1470 "Sets how many milliseconds to delay\n"
1471 "after VSync before running the core.\n"
1472 "\n"
1473 "Can reduce latency at the cost of\n"
1474 "higher risk of stuttering.\n"
1475 " \n"
1476 "Maximum is 15.");
1477 break;
1478 case MENU_ENUM_LABEL_VIDEO_SHADER_DELAY:
1479 snprintf(s, len,
1480 "Sets by how many milliseconds auto-loading shaders\n"
1481 "are delayed.\n"
1482 "\n"
1483 "Can work around graphical glitches due to using\n"
1484 "'screen grabbing' software like streaming software.");
1485 break;
1486 case MENU_ENUM_LABEL_VIDEO_HARD_SYNC_FRAMES:
1487 snprintf(s, len,
1488 "Sets how many frames CPU can \n"
1489 "run ahead of GPU when using 'GPU \n"
1490 "Hard Sync'.\n"
1491 " \n"
1492 "Maximum is 3.\n"
1493 " \n"
1494 " 0: Syncs to GPU immediately.\n"
1495 " 1: Syncs to previous frame.\n"
1496 " 2: Etc ...");
1497 break;
1498 case MENU_ENUM_LABEL_VIDEO_BLACK_FRAME_INSERTION:
1499 snprintf(s, len,
1500 "Inserts a black frame inbetween \n"
1501 "frames.\n"
1502 " \n"
1503 "Useful for 120 Hz monitors who want to \n"
1504 "play 60 Hz material with eliminated \n"
1505 "ghosting.\n"
1506 " \n"
1507 "Video refresh rate should still be \n"
1508 "configured as if it is a 60 Hz monitor \n"
1509 "(divide refresh rate by 2).");
1510 break;
1511 case MENU_ENUM_LABEL_RGUI_SHOW_START_SCREEN:
1512 snprintf(s, len,
1513 "Show startup screen in menu.\n"
1514 "Is automatically set to false when seen\n"
1515 "for the first time.\n"
1516 " \n"
1517 "This is only updated in config if\n"
1518 "'Save Configuration on Exit' is enabled.\n");
1519 break;
1520 case MENU_ENUM_LABEL_VIDEO_FULLSCREEN:
1521 snprintf(s, len, "Toggles fullscreen.");
1522 break;
1523 case MENU_ENUM_LABEL_BLOCK_SRAM_OVERWRITE:
1524 snprintf(s, len,
1525 "Block SRAM from being overwritten \n"
1526 "when loading save states.\n"
1527 " \n"
1528 "Might potentially lead to buggy games.");
1529 break;
1530 case MENU_ENUM_LABEL_PAUSE_NONACTIVE:
1531 snprintf(s, len,
1532 "Pause gameplay when window focus \n"
1533 "is lost.");
1534 break;
1535 case MENU_ENUM_LABEL_VIDEO_GPU_SCREENSHOT:
1536 snprintf(s, len,
1537 "Screenshots output of GPU shaded \n"
1538 "material if available.");
1539 break;
1540 case MENU_ENUM_LABEL_SCREENSHOT_DIRECTORY:
1541 snprintf(s, len,
1542 "Screenshot Directory. \n"
1543 " \n"
1544 "Directory to dump screenshots to.");
1545 break;
1546 case MENU_ENUM_LABEL_VIDEO_SWAP_INTERVAL:
1547 snprintf(s, len,
1548 "VSync Swap Interval.\n"
1549 " \n"
1550 "Uses a custom swap interval for VSync. Set this \n"
1551 "to effectively halve monitor refresh rate.");
1552 break;
1553 case MENU_ENUM_LABEL_SAVEFILE_DIRECTORY:
1554 snprintf(s, len,
1555 "Savefile Directory. \n"
1556 " \n"
1557 "Save all save files (*.srm) to this \n"
1558 "directory. This includes related files like \n"
1559 ".bsv, .rt, .psrm, etc...\n"
1560 " \n"
1561 "This will be overridden by explicit command line\n"
1562 "options.");
1563 break;
1564 case MENU_ENUM_LABEL_SAVESTATE_DIRECTORY:
1565 snprintf(s, len,
1566 "Savestate Directory. \n"
1567 " \n"
1568 "Save all save states (*.state) to this \n"
1569 "directory.\n"
1570 " \n"
1571 "This will be overridden by explicit command line\n"
1572 "options.");
1573 break;
1574 case MENU_ENUM_LABEL_ASSETS_DIRECTORY:
1575 snprintf(s, len,
1576 "Assets Directory. \n"
1577 " \n"
1578 " This location is queried by default when \n"
1579 "menu interfaces try to look for loadable \n"
1580 "assets, etc.");
1581 break;
1582 case MENU_ENUM_LABEL_DYNAMIC_WALLPAPERS_DIRECTORY:
1583 snprintf(s, len,
1584 "Dynamic Wallpapers Directory. \n"
1585 " \n"
1586 " The place to store backgrounds that will \n"
1587 "be loaded dynamically by the menu depending \n"
1588 "on context.");
1589 break;
1590 case MENU_ENUM_LABEL_SLOWMOTION_RATIO:
1591 snprintf(s, len,
1592 "Slowmotion ratio."
1593 " \n"
1594 "When slowmotion, content will slow\n"
1595 "down by factor.");
1596 break;
1597 case MENU_ENUM_LABEL_INPUT_BUTTON_AXIS_THRESHOLD:
1598 snprintf(s, len,
1599 "Defines the axis threshold.\n"
1600 " \n"
1601 "How far an axis must be tilted to result\n"
1602 "in a button press.\n"
1603 " Possible values are [0.0, 1.0].");
1604 break;
1605 case MENU_ENUM_LABEL_INPUT_TURBO_PERIOD:
1606 snprintf(s, len,
1607 "Turbo period.\n"
1608 " \n"
1609 "Describes the period of which turbo-enabled\n"
1610 "buttons toggle.\n"
1611 " \n"
1612 "Numbers are described in frames.");
1613 break;
1614 case MENU_ENUM_LABEL_INPUT_TURBO_MODE:
1615 snprintf(s, len,
1616 "Turbo Mode.\n"
1617 " \n"
1618 "Selects the general behavior of turbo mode.");
1619 break;
1620 case MENU_ENUM_LABEL_INPUT_TURBO_DEFAULT_BUTTON:
1621 snprintf(s, len,
1622 "Turbo Default Button.\n"
1623 " \n"
1624 "Default active button for Turbo Mode 'Single Button'.\n");
1625 break;
1626 case MENU_ENUM_LABEL_INPUT_DUTY_CYCLE:
1627 snprintf(s, len,
1628 "Duty cycle.\n"
1629 " \n"
1630 "Describes how long the period of a turbo-enabled\n"
1631 "should be.\n"
1632 " \n"
1633 "Numbers are described in frames.");
1634 break;
1635 case MENU_ENUM_LABEL_INPUT_TOUCH_ENABLE:
1636 snprintf(s, len, "Enable touch support.");
1637 break;
1638 case MENU_ENUM_LABEL_INPUT_PREFER_FRONT_TOUCH:
1639 snprintf(s, len, "Use front instead of back touch.");
1640 break;
1641 case MENU_ENUM_LABEL_MOUSE_ENABLE:
1642 snprintf(s, len, "Enable mouse input inside the menu.");
1643 break;
1644 case MENU_ENUM_LABEL_POINTER_ENABLE:
1645 snprintf(s, len, "Enable touch input inside the menu.");
1646 break;
1647 case MENU_ENUM_LABEL_MENU_WALLPAPER:
1648 snprintf(s, len, "Path to an image to set as the background.");
1649 break;
1650 case MENU_ENUM_LABEL_NAVIGATION_WRAPAROUND:
1651 snprintf(s, len,
1652 "Wrap-around to beginning and/or end \n"
1653 "if boundary of list is reached \n"
1654 "horizontally and/or vertically.");
1655 break;
1656 case MENU_ENUM_LABEL_PAUSE_LIBRETRO:
1657 snprintf(s, len,
1658 "If disabled, the game will keep \n"
1659 "running in the background when we are in the \n"
1660 "menu.");
1661 break;
1662 case MENU_ENUM_LABEL_SUSPEND_SCREENSAVER_ENABLE:
1663 snprintf(s, len,
1664 "Suspends the screensaver. Is a hint that \n"
1665 "does not necessarily have to be \n"
1666 "honored by the video driver.");
1667 break;
1668 case MENU_ENUM_LABEL_NETPLAY_MODE:
1669 snprintf(s, len,
1670 "Netplay client mode for the current user. \n"
1671 "Will be 'Server' mode if disabled.");
1672 break;
1673 case MENU_ENUM_LABEL_NETPLAY_DELAY_FRAMES:
1674 snprintf(s, len,
1675 "The amount of delay frames to use for netplay. \n"
1676 " \n"
1677 "Increasing this value will increase \n"
1678 "performance, but introduce more latency.");
1679 break;
1680 case MENU_ENUM_LABEL_NETPLAY_PUBLIC_ANNOUNCE:
1681 snprintf(s, len,
1682 "Whether to announce netplay games publicly. \n"
1683 " \n"
1684 "If set to false, clients must manually connect \n"
1685 "rather than using the public lobby.");
1686 break;
1687 case MENU_ENUM_LABEL_NETPLAY_START_AS_SPECTATOR:
1688 snprintf(s, len,
1689 "Whether to start netplay in spectator mode. \n"
1690 " \n"
1691 "If set to true, netplay will be in spectator mode \n"
1692 "on start. It's always possible to change mode \n"
1693 "later.");
1694 break;
1695 case MENU_ENUM_LABEL_NETPLAY_ALLOW_SLAVES:
1696 snprintf(s, len,
1697 "Whether to allow connections in slave mode. \n"
1698 " \n"
1699 "Slave-mode clients require very little processing \n"
1700 "power on either side, but will suffer \n"
1701 "significantly from network latency.");
1702 break;
1703 case MENU_ENUM_LABEL_NETPLAY_REQUIRE_SLAVES:
1704 snprintf(s, len,
1705 "Whether to disallow connections not in slave mode. \n"
1706 " \n"
1707 "Not recommended except for very fast networks \n"
1708 "with very weak machines.");
1709 break;
1710 case MENU_ENUM_LABEL_NETPLAY_STATELESS_MODE:
1711 snprintf(s, len,
1712 "Whether to run netplay in a mode not requiring"
1713 "save states. \n"
1714 " \n"
1715 "If set to true, a very fast network is required, \n"
1716 "but no rewinding is performed, so there will be \n"
1717 "no netplay jitter. \n");
1718 break;
1719 case MENU_ENUM_LABEL_NETPLAY_CHECK_FRAMES:
1720 snprintf(s, len,
1721 "The frequency in frames with which netplay \n"
1722 "will verify that the host and client are in \n"
1723 "sync. \n"
1724 " \n"
1725 "With most cores, this value will have no \n"
1726 "visible effect and can be ignored. With \n"
1727 "nondeterminstic cores, this value determines \n"
1728 "how often the netplay peers will be brought \n"
1729 "into sync. With buggy cores, setting this \n"
1730 "to any non-zero value will cause severe \n"
1731 "performance issues. Set to zero to perform \n"
1732 "no checks. This value is only used on the \n"
1733 "netplay host. \n");
1734 break;
1735 case MENU_ENUM_LABEL_NETPLAY_INPUT_LATENCY_FRAMES_MIN:
1736 snprintf(s, len,
1737 "The number of frames of input latency for \n"
1738 "netplay to use to hide network latency. \n"
1739 " \n"
1740 "When in netplay, this option delays local \n"
1741 "input, so that the frame being run is \n"
1742 "closer to the frames being received from \n"
1743 "the network. This reduces jitter and makes \n"
1744 "netplay less CPU-intensive, but at the \n"
1745 "price of noticeable input lag. \n");
1746 break;
1747 case MENU_ENUM_LABEL_NETPLAY_INPUT_LATENCY_FRAMES_RANGE:
1748 snprintf(s, len,
1749 "The range of frames of input latency that \n"
1750 "may be used by netplay to hide network \n"
1751 "latency. \n"
1752 "\n"
1753 "If set, netplay will adjust the number of \n"
1754 "frames of input latency dynamically to \n"
1755 "balance CPU time, input latency and \n"
1756 "network latency. This reduces jitter and \n"
1757 "makes netplay less CPU-intensive, but at \n"
1758 "the price of unpredictable input lag. \n");
1759 break;
1760 case MENU_ENUM_LABEL_NETPLAY_NAT_TRAVERSAL:
1761 snprintf(s, len,
1762 "When hosting, attempt to listen for\n"
1763 "connections from the public internet, using\n"
1764 "UPnP or similar technologies to escape LANs. \n");
1765 break;
1766 case MENU_ENUM_LABEL_NETPLAY_USE_MITM_SERVER:
1767 snprintf(s, len,
1768 "When hosting a netplay session, relay connection through a \n"
1769 "man-in-the-middle server \n"
1770 "to get around firewalls or NAT/UPnP issues. \n");
1771 break;
1772 case MENU_ENUM_LABEL_NETPLAY_MITM_SERVER:
1773 snprintf(s, len,
1774 "Specifies the man-in-the-middle server \n"
1775 "to use for netplay. A server that is \n"
1776 "located closer to you may have less latency. \n");
1777 break;
1778 case MENU_ENUM_LABEL_VIDEO_MAX_SWAPCHAIN_IMAGES:
1779 snprintf(s, len,
1780 "Maximum amount of swapchain images. This \n"
1781 "can tell the video driver to use a specific \n"
1782 "video buffering mode. \n"
1783 " \n"
1784 "Single buffering - 1\n"
1785 "Double buffering - 2\n"
1786 "Triple buffering - 3\n"
1787 " \n"
1788 "Setting the right buffering mode can have \n"
1789 "a big impact on latency.");
1790 break;
1791 case MENU_ENUM_LABEL_VIDEO_SMOOTH:
1792 snprintf(s, len,
1793 "Smoothens picture with bilinear filtering. \n"
1794 "Should be disabled if using shaders.");
1795 break;
1796 case MENU_ENUM_LABEL_VIDEO_CTX_SCALING:
1797 snprintf(s, len,
1798 #ifdef HAVE_ODROIDGO2
1799 "RGA scaling and bicubic filtering. May break widgets."
1800 #else
1801 "Hardware context scaling (if available)."
1802 #endif
1803 );
1804 break;
1805 case MENU_ENUM_LABEL_TIMEDATE_ENABLE:
1806 snprintf(s, len,
1807 "Shows current date and/or time inside menu.");
1808 break;
1809 case MENU_ENUM_LABEL_TIMEDATE_STYLE:
1810 snprintf(s, len,
1811 "Style to show the current date and/or time in.");
1812 break;
1813 case MENU_ENUM_LABEL_BATTERY_LEVEL_ENABLE:
1814 snprintf(s, len,
1815 "Shows current battery level inside menu.");
1816 break;
1817 case MENU_ENUM_LABEL_CORE_ENABLE:
1818 snprintf(s, len,
1819 "Shows current core inside menu.");
1820 break;
1821 case MENU_ENUM_LABEL_NETPLAY_ENABLE_HOST:
1822 snprintf(s, len,
1823 "Enables Netplay in host (server) mode.");
1824 break;
1825 case MENU_ENUM_LABEL_NETPLAY_ENABLE_CLIENT:
1826 snprintf(s, len,
1827 "Enables Netplay in client mode.");
1828 break;
1829 case MENU_ENUM_LABEL_NETPLAY_DISCONNECT:
1830 snprintf(s, len,
1831 "Disconnects an active Netplay connection.");
1832 break;
1833 case MENU_ENUM_LABEL_NETPLAY_LAN_SCAN_SETTINGS:
1834 snprintf(s, len,
1835 "Search for and connect to netplay hosts on the local network.");
1836 break;
1837 case MENU_ENUM_LABEL_NETPLAY_SETTINGS:
1838 snprintf(s, len,
1839 "Setting related to Netplay.");
1840 break;
1841 case MENU_ENUM_LABEL_DYNAMIC_WALLPAPER:
1842 snprintf(s, len,
1843 "Dynamically load a new background \n"
1844 "depending on context.");
1845 break;
1846 case MENU_ENUM_LABEL_CORE_UPDATER_BUILDBOT_URL:
1847 snprintf(s, len,
1848 "URL to core updater directory on the \n"
1849 "Libretro buildbot.");
1850 break;
1851 case MENU_ENUM_LABEL_BUILDBOT_ASSETS_URL:
1852 snprintf(s, len,
1853 "URL to assets updater directory on the \n"
1854 "Libretro buildbot.");
1855 break;
1856 case MENU_ENUM_LABEL_INPUT_REMAP_BINDS_ENABLE:
1857 snprintf(s, len,
1858 "if enabled, overrides the input binds \n"
1859 "with the remapped binds set for the \n"
1860 "current core.");
1861 break;
1862 case MENU_ENUM_LABEL_OVERLAY_DIRECTORY:
1863 snprintf(s, len,
1864 "Overlay Directory. \n"
1865 " \n"
1866 "Defines a directory where overlays are \n"
1867 "kept for easy access.");
1868 break;
1869 case MENU_ENUM_LABEL_VIDEO_LAYOUT_DIRECTORY:
1870 snprintf(s, len,
1871 "Video Layout Directory. \n"
1872 " \n"
1873 "Defines a directory where video layouts are \n"
1874 "kept for easy access.");
1875 break;
1876 case MENU_ENUM_LABEL_INPUT_MAX_USERS:
1877 snprintf(s, len,
1878 "Maximum amount of users supported by \n"
1879 "RetroArch.");
1880 break;
1881 case MENU_ENUM_LABEL_CORE_UPDATER_AUTO_EXTRACT_ARCHIVE:
1882 snprintf(s, len,
1883 "After downloading, automatically extract \n"
1884 "archives that the downloads are contained \n"
1885 "inside.");
1886 break;
1887 case MENU_ENUM_LABEL_NAVIGATION_BROWSER_FILTER_SUPPORTED_EXTENSIONS_ENABLE:
1888 snprintf(s, len,
1889 "Filter files being shown by \n"
1890 "supported extensions.");
1891 break;
1892 case MENU_ENUM_LABEL_NETPLAY_NICKNAME:
1893 snprintf(s, len,
1894 "The username of the person running RetroArch. \n"
1895 "This will be used for playing online games.");
1896 break;
1897 case MENU_ENUM_LABEL_NETPLAY_TCP_UDP_PORT:
1898 snprintf(s, len,
1899 "The port of the host IP address. \n"
1900 "Can be either a TCP or UDP port.");
1901 break;
1902 case MENU_ENUM_LABEL_NETPLAY_SPECTATOR_MODE_ENABLE:
1903 snprintf(s, len,
1904 "Enable or disable spectator mode for \n"
1905 "the user during netplay.");
1906 break;
1907 case MENU_ENUM_LABEL_NETPLAY_IP_ADDRESS:
1908 snprintf(s, len,
1909 "The address of the host to connect to.");
1910 break;
1911 case MENU_ENUM_LABEL_NETPLAY_PASSWORD:
1912 snprintf(s, len,
1913 "The password for connecting to the netplay \n"
1914 "host. Used only in host mode.");
1915 break;
1916 case MENU_ENUM_LABEL_NETPLAY_SPECTATE_PASSWORD:
1917 snprintf(s, len,
1918 "The password for connecting to the netplay \n"
1919 "host with only spectator privileges. Used \n"
1920 "only in host mode.");
1921 break;
1922 case MENU_ENUM_LABEL_STDIN_CMD_ENABLE:
1923 snprintf(s, len,
1924 "Enable stdin command interface.");
1925 break;
1926 case MENU_ENUM_LABEL_UI_COMPANION_START_ON_BOOT:
1927 snprintf(s, len,
1928 "Start User Interface companion driver \n"
1929 "on boot (if available).");
1930 break;
1931 case MENU_ENUM_LABEL_MENU_DRIVER:
1932 snprintf(s, len, "Menu driver to use.");
1933 break;
1934 case MENU_ENUM_LABEL_INPUT_MENU_ENUM_TOGGLE_GAMEPAD_COMBO:
1935 snprintf(s, len,
1936 "Gamepad button combination to toggle menu. \n"
1937 " \n"
1938 "0 - None \n"
1939 "1 - Press L + R + Y + D-Pad Down \n"
1940 "simultaneously. \n"
1941 "2 - Press L3 + R3 simultaneously. \n"
1942 "3 - Press Start + Select simultaneously.");
1943 break;
1944 case MENU_ENUM_LABEL_INPUT_ALL_USERS_CONTROL_MENU:
1945 snprintf(s, len, "Allows any user to control the menu. \n"
1946 " \n"
1947 "When disabled, only user 1 can control the menu.");
1948 break;
1949 case MENU_ENUM_LABEL_INPUT_AUTODETECT_ENABLE:
1950 snprintf(s, len,
1951 "Enable input auto-detection.\n"
1952 " \n"
1953 "Will attempt to auto-configure \n"
1954 "joypads, Plug-and-Play style.");
1955 break;
1956 case MENU_ENUM_LABEL_CAMERA_ALLOW:
1957 snprintf(s, len,
1958 "Allow or disallow camera access by \n"
1959 "cores.");
1960 break;
1961 case MENU_ENUM_LABEL_LOCATION_ALLOW:
1962 snprintf(s, len,
1963 "Allow or disallow location services \n"
1964 "access by cores.");
1965 break;
1966 case MENU_ENUM_LABEL_TURBO:
1967 snprintf(s, len,
1968 "Turbo enable.\n"
1969 " \n"
1970 "Holding the turbo while pressing another \n"
1971 "button will let the button enter a turbo \n"
1972 "mode where the button state is modulated \n"
1973 "with a periodic signal. \n"
1974 " \n"
1975 "The modulation stops when the button \n"
1976 "itself (not turbo button) is released.");
1977 break;
1978 case MENU_ENUM_LABEL_OSK_ENABLE:
1979 snprintf(s, len,
1980 "Enable/disable on-screen keyboard.");
1981 break;
1982 case MENU_ENUM_LABEL_AUDIO_MUTE:
1983 snprintf(s, len,
1984 "Mute/unmute audio.");
1985 break;
1986 case MENU_ENUM_LABEL_REWIND:
1987 snprintf(s, len,
1988 "Hold button down to rewind.\n"
1989 " \n"
1990 "Rewind must be enabled.");
1991 break;
1992 case MENU_ENUM_LABEL_EXIT_EMULATOR:
1993 snprintf(s, len,
1994 "Key to exit RetroArch cleanly."
1995 #if !defined(RARCH_MOBILE) && !defined(RARCH_CONSOLE)
1996 "\nKilling it in any hard way (SIGKILL, \n"
1997 "etc) will terminate without saving\n"
1998 "RAM, etc. On Unix-likes,\n"
1999 "SIGINT/SIGTERM allows\n"
2000 "a clean deinitialization."
2001 #endif
2002 );
2003 break;
2004 case MENU_ENUM_LABEL_LOAD_STATE:
2005 snprintf(s, len,
2006 "Loads state.");
2007 break;
2008 case MENU_ENUM_LABEL_SAVE_STATE:
2009 snprintf(s, len,
2010 "Saves state.");
2011 break;
2012 case MENU_ENUM_LABEL_NETPLAY_GAME_WATCH:
2013 snprintf(s, len,
2014 "Netplay toggle play/spectate mode.");
2015 break;
2016 case MENU_ENUM_LABEL_CHEAT_INDEX_PLUS:
2017 snprintf(s, len,
2018 "Increase cheat index.");
2019 break;
2020 case MENU_ENUM_LABEL_CHEAT_INDEX_MINUS:
2021 snprintf(s, len,
2022 "Decrease cheat index.");
2023 break;
2024 case MENU_ENUM_LABEL_SHADER_PREV:
2025 snprintf(s, len,
2026 "Applies previous shader in directory.");
2027 break;
2028 case MENU_ENUM_LABEL_SHADER_NEXT:
2029 snprintf(s, len,
2030 "Applies next shader in directory.");
2031 break;
2032 case MENU_ENUM_LABEL_RESET:
2033 snprintf(s, len,
2034 "Reset the content.");
2035 break;
2036 case MENU_ENUM_LABEL_PAUSE_TOGGLE:
2037 snprintf(s, len,
2038 "Toggle between paused and non-paused state.");
2039 break;
2040 case MENU_ENUM_LABEL_CHEAT_TOGGLE:
2041 snprintf(s, len,
2042 "Toggle cheat index.");
2043 break;
2044 case MENU_ENUM_LABEL_CHEAT_IDX:
2045 snprintf(s, len,
2046 "Index position in list.");
2047 break;
2048 case MENU_ENUM_LABEL_CHEAT_ADDRESS_BIT_POSITION:
2049 snprintf(s, len,
2050 "Address bitmask when Memory Search Size < 8-bit.");
2051 break;
2052 case MENU_ENUM_LABEL_CHEAT_REPEAT_COUNT:
2053 snprintf(s, len,
2054 "The number of times the cheat will be applied.\nUse with the other two Iteration options to affect large areas of memory.");
2055 break;
2056 case MENU_ENUM_LABEL_CHEAT_REPEAT_ADD_TO_ADDRESS:
2057 snprintf(s, len,
2058 "After each 'Number of Iterations' the Memory Address will be increased by this number times the 'Memory Search Size'.");
2059 break;
2060 case MENU_ENUM_LABEL_CHEAT_REPEAT_ADD_TO_VALUE:
2061 snprintf(s, len,
2062 "After each 'Number of Iterations' the Value will be increased by this amount.");
2063 break;
2064 case MENU_ENUM_LABEL_CHEAT_MATCH_IDX:
2065 snprintf(s, len,
2066 "Select the match to view.");
2067 break;
2068 case MENU_ENUM_LABEL_CHEAT_START_OR_CONT:
2069 snprintf(s, len,
2070 "Scan memory to create new cheats.");
2071 break;
2072 case MENU_ENUM_LABEL_CHEAT_START_OR_RESTART:
2073 snprintf(s, len,
2074 "Left/Right to change bit-size.");
2075 break;
2076 case MENU_ENUM_LABEL_CHEAT_SEARCH_EXACT:
2077 snprintf(s, len,
2078 "Left/Right to change value.");
2079 break;
2080 case MENU_ENUM_LABEL_CHEAT_SEARCH_LT:
2081 snprintf(s, len,
2082 " ");
2083 break;
2084 case MENU_ENUM_LABEL_CHEAT_SEARCH_GT:
2085 snprintf(s, len,
2086 " ");
2087 break;
2088 case MENU_ENUM_LABEL_CHEAT_SEARCH_EQ:
2089 snprintf(s, len,
2090 " ");
2091 break;
2092 case MENU_ENUM_LABEL_CHEAT_SEARCH_NEQ:
2093 snprintf(s, len,
2094 " ");
2095 break;
2096 case MENU_ENUM_LABEL_CHEAT_SEARCH_EQPLUS:
2097 snprintf(s, len,
2098 "Left/Right to change value.");
2099 break;
2100 case MENU_ENUM_LABEL_CHEAT_SEARCH_EQMINUS:
2101 snprintf(s, len,
2102 "Left/Right to change value.");
2103 break;
2104 case MENU_ENUM_LABEL_CHEAT_ADD_MATCHES:
2105 snprintf(s, len,
2106 " ");
2107 break;
2108 case MENU_ENUM_LABEL_CHEAT_VIEW_MATCHES:
2109 snprintf(s, len,
2110 " ");
2111 break;
2112 case MENU_ENUM_LABEL_CHEAT_CREATE_OPTION:
2113 snprintf(s, len,
2114 " ");
2115 break;
2116 case MENU_ENUM_LABEL_CHEAT_DELETE_OPTION:
2117 snprintf(s, len,
2118 " ");
2119 break;
2120 case MENU_ENUM_LABEL_CHEAT_ADD_NEW_TOP:
2121 snprintf(s, len,
2122 " ");
2123 break;
2124 case MENU_ENUM_LABEL_CHEAT_RELOAD_CHEATS:
2125 snprintf(s, len,
2126 " ");
2127 break;
2128 case MENU_ENUM_LABEL_CHEAT_ADD_NEW_BOTTOM:
2129 snprintf(s, len,
2130 " ");
2131 break;
2132 case MENU_ENUM_LABEL_CHEAT_DELETE_ALL:
2133 snprintf(s, len,
2134 " ");
2135 break;
2136 case MENU_ENUM_LABEL_CHEAT_BIG_ENDIAN:
2137 snprintf(s, len,
2138 "Big endian : 258 = 0x0102\n"
2139 "Little endian : 258 = 0x0201");
2140 break;
2141 case MENU_ENUM_LABEL_HOLD_FAST_FORWARD:
2142 snprintf(s, len,
2143 "Hold for fast-forward. Releasing button \n"
2144 "disables fast-forward.");
2145 break;
2146 case MENU_ENUM_LABEL_SLOWMOTION_HOLD:
2147 snprintf(s, len,
2148 "Hold for slowmotion.");
2149 break;
2150 case MENU_ENUM_LABEL_FRAME_ADVANCE:
2151 snprintf(s, len,
2152 "Frame advance when content is paused.");
2153 break;
2154 case MENU_ENUM_LABEL_BSV_RECORD_TOGGLE:
2155 snprintf(s, len,
2156 "Toggle between recording and not.");
2157 break;
2158 case MENU_ENUM_LABEL_L_X_PLUS:
2159 case MENU_ENUM_LABEL_L_X_MINUS:
2160 case MENU_ENUM_LABEL_L_Y_PLUS:
2161 case MENU_ENUM_LABEL_L_Y_MINUS:
2162 case MENU_ENUM_LABEL_R_X_PLUS:
2163 case MENU_ENUM_LABEL_R_X_MINUS:
2164 case MENU_ENUM_LABEL_R_Y_PLUS:
2165 case MENU_ENUM_LABEL_R_Y_MINUS:
2166 snprintf(s, len,
2167 "Axis for analog stick (DualShock-esque).\n"
2168 " \n"
2169 "Bound as usual, however, if a real analog \n"
2170 "axis is bound, it can be read as a true analog.\n"
2171 " \n"
2172 "Positive X axis is right. \n"
2173 "Positive Y axis is down.");
2174 break;
2175 case MENU_ENUM_LABEL_VALUE_WHAT_IS_A_CORE_DESC:
2176 snprintf(s, len,
2177 "RetroArch by itself does nothing. \n"
2178 " \n"
2179 "To make it do things, you need to \n"
2180 "load a program into it. \n"
2181 "\n"
2182 "We call such a program 'Libretro core', \n"
2183 "or 'core' in short. \n"
2184 " \n"
2185 "To load a core, select one from\n"
2186 "'Load Core'.\n"
2187 " \n"
2188 #ifdef HAVE_NETWORKING
2189 "You can obtain cores in several ways: \n"
2190 "* Download them by going to\n"
2191 "'%s' -> '%s'.\n"
2192 "* Manually move them over to\n"
2193 "'%s'.",
2194 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_ONLINE_UPDATER),
2195 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_CORE_UPDATER_LIST),
2196 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_LIBRETRO_DIR_PATH)
2197 #else
2198 "You can obtain cores by\n"
2199 "manually moving them over to\n"
2200 "'%s'.",
2201 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_LIBRETRO_DIR_PATH)
2202 #endif
2203 );
2204 break;
2205 case MENU_ENUM_LABEL_VALUE_HELP_CHANGE_VIRTUAL_GAMEPAD_DESC:
2206 snprintf(s, len,
2207 "You can change the virtual gamepad overlay\n"
2208 "by going to '%s' -> '%s'."
2209 " \n"
2210 "From there you can change the overlay,\n"
2211 "change the size and opacity of the buttons, etc.\n"
2212 " \n"
2213 "NOTE: By default, virtual gamepad overlays are\n"
2214 "hidden when in the menu.\n"
2215 "If you'd like to change this behavior,\n"
2216 "you can set '%s' to false.",
2217 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_SETTINGS),
2218 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_OVERLAY_SETTINGS),
2219 msg_hash_to_str(MENU_ENUM_LABEL_VALUE_INPUT_OVERLAY_HIDE_IN_MENU));
2220 break;
2221 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_BGCOLOR_ENABLE:
2222 snprintf(s, len,
2223 "Enables a background color for the OSD.");
2224 break;
2225 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_BGCOLOR_RED:
2226 snprintf(s, len,
2227 "Sets the red value of the OSD background color. Valid values are between 0 and 255.");
2228 break;
2229 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_BGCOLOR_GREEN:
2230 snprintf(s, len,
2231 "Sets the green value of the OSD background color. Valid values are between 0 and 255.");
2232 break;
2233 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_BGCOLOR_BLUE:
2234 snprintf(s, len,
2235 "Sets the blue value of the OSD background color. Valid values are between 0 and 255.");
2236 break;
2237 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_BGCOLOR_OPACITY:
2238 snprintf(s, len,
2239 "Sets the opacity of the OSD background color. Valid values are between 0.0 and 1.0.");
2240 break;
2241 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_COLOR_RED:
2242 snprintf(s, len,
2243 "Sets the red value of the OSD text color. Valid values are between 0 and 255.");
2244 break;
2245 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_COLOR_GREEN:
2246 snprintf(s, len,
2247 "Sets the green value of the OSD text color. Valid values are between 0 and 255.");
2248 break;
2249 case MENU_ENUM_LABEL_VALUE_VIDEO_MESSAGE_COLOR_BLUE:
2250 snprintf(s, len,
2251 "Sets the blue value of the OSD text color. Valid values are between 0 and 255.");
2252 break;
2253 case MENU_ENUM_LABEL_MIDI_DRIVER:
2254 snprintf(s, len,
2255 "MIDI driver to use.");
2256 break;
2257 case MENU_ENUM_LABEL_MIDI_INPUT:
2258 snprintf(s, len,
2259 "Sets the input device (driver specific).\n"
2260 "When set to \"Off\", MIDI input will be disabled.\n"
2261 "Device name can also be typed in.");
2262 break;
2263 case MENU_ENUM_LABEL_MIDI_OUTPUT:
2264 snprintf(s, len,
2265 "Sets the output device (driver specific).\n"
2266 "When set to \"Off\", MIDI output will be disabled.\n"
2267 "Device name can also be typed in.\n"
2268 " \n"
2269 "When MIDI output is enabled and core and game/app support MIDI output,\n"
2270 "some or all sounds (depends on game/app) will be generated by MIDI device.\n"
2271 "In case of \"null\" MIDI driver this means that those sounds won't be audible.");
2272 break;
2273 case MENU_ENUM_LABEL_MIDI_VOLUME:
2274 snprintf(s, len,
2275 "Sets the master volume of the output device.");
2276 break;
2277 default:
2278 if (string_is_empty(s))
2279 strlcpy(s, msg_hash_to_str(MENU_ENUM_LABEL_VALUE_NO_INFORMATION_AVAILABLE), len);
2280 return -1;
2281 }
2282
2283 return 0;
2284 }
2285 #endif
2286
2287 #ifdef HAVE_MENU
menu_hash_to_str_fi_label_enum(enum msg_hash_enums msg)2288 static const char *menu_hash_to_str_fi_label_enum(enum msg_hash_enums msg)
2289 {
2290 if (msg <= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_END &&
2291 msg >= MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN)
2292 {
2293 static char hotkey_lbl[128] = {0};
2294 unsigned idx = msg - MENU_ENUM_LABEL_INPUT_HOTKEY_BIND_BEGIN;
2295 snprintf(hotkey_lbl, sizeof(hotkey_lbl), "input_hotkey_binds_%d", idx);
2296 return hotkey_lbl;
2297 }
2298
2299 switch (msg)
2300 {
2301 #include "msg_hash_lbl.h"
2302 default:
2303 #if 0
2304 RARCH_LOG("Unimplemented: [%d]\n", msg);
2305 #endif
2306 break;
2307 }
2308
2309 return "null";
2310 }
2311 #endif
2312
msg_hash_to_str_fi(enum msg_hash_enums msg)2313 const char *msg_hash_to_str_fi(enum msg_hash_enums msg)
2314 {
2315 #ifdef HAVE_MENU
2316 const char *ret = menu_hash_to_str_fi_label_enum(msg);
2317
2318 if (ret && !string_is_equal(ret, "null"))
2319 return ret;
2320 #endif
2321
2322 switch (msg)
2323 {
2324 #include "msg_hash_fi.h"
2325 default:
2326 #if 0
2327 RARCH_LOG("Unimplemented: [%d]\n", msg);
2328 {
2329 RARCH_LOG("[%d] : %s\n", msg - 1, msg_hash_to_str(((enum msg_hash_enums)(msg - 1))));
2330 }
2331 #endif
2332 break;
2333 }
2334
2335 return "null";
2336 }
2337