25b2da4c3420ff4793b0fdf0aebed574a31303ba
[pcsx_rearmed.git] / frontend / libretro_core_options.h
1 #ifndef LIBRETRO_CORE_OPTIONS_H__
2 #define LIBRETRO_CORE_OPTIONS_H__
3
4 #include <stdlib.h>
5 #include <string.h>
6
7 #include <libretro.h>
8 #include <retro_inline.h>
9
10 #ifndef HAVE_NO_LANGEXTRA
11 #include "libretro_core_options_intl.h"
12 #endif
13
14 /*
15  ********************************
16  * VERSION: 2.0
17  ********************************
18  *
19  * - 2.0: Add support for core options v2 interface
20  * - 1.3: Move translations to libretro_core_options_intl.h
21  *        - libretro_core_options_intl.h includes BOM and utf-8
22  *          fix for MSVC 2010-2013
23  *        - Added HAVE_NO_LANGEXTRA flag to disable translations
24  *          on platforms/compilers without BOM support
25  * - 1.2: Use core options v1 interface when
26  *        RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION is >= 1
27  *        (previously required RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION == 1)
28  * - 1.1: Support generation of core options v0 retro_core_option_value
29  *        arrays containing options with a single value
30  * - 1.0: First commit
31 */
32
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36
37 /*
38  ********************************
39  * Core Option Definitions
40  ********************************
41 */
42
43 /* RETRO_LANGUAGE_ENGLISH */
44
45 /* Default language:
46  * - All other languages must include the same keys and values
47  * - Will be used as a fallback in the event that frontend language
48  *   is not available
49  * - Will be used as a fallback for any missing entries in
50  *   frontend language definition
51  */
52
53 struct retro_core_option_v2_category option_cats_us[] = {
54    {
55       "system",
56       "System",
57       "Configure base hardware parameters: region, BIOS selection, memory cards, etc."
58    },
59    {
60       "video",
61       "Video",
62       "Configure base display parameters."
63    },
64 #ifdef GPU_NEON
65    {
66       "gpu_neon",
67       "GPU Plugin",
68       "Configure low-level settings of the NEON GPU plugin."
69    },
70 #endif
71 #ifdef GPU_PEOPS
72    {
73       "gpu_peops",
74       "GPU Plugin (Advanced)",
75       "Configure low-level settings of the P.E.Op.S. GPU plugin."
76    },
77 #endif
78 #ifdef GPU_UNAI
79    {
80       "gpu_unai",
81       "GPU Plugin (Advanced)",
82       "Configure low-level settings of the UNAI GPU plugin."
83    },
84 #endif
85    {
86       "audio",
87       "Audio",
88       "Configure sound emulation: reverb, interpolation, CD audio decoding."
89    },
90    {
91       "input",
92       "Input",
93       "Configure input devices: analog response, haptic feedback, Multitaps, light guns, etc."
94    },
95    {
96       "compat_hack",
97       "Compatibility Fixes",
98       "Configure settings/workarounds required for correct operation of specific games."
99    },
100 #if !defined(DRC_DISABLE) && !defined(LIGHTREC)
101    {
102       "speed_hack",
103       "Speed Hacks (Advanced)",
104       "Configure hacks that may improve performance at the expense of decreased accuracy/stability."
105    },
106 #endif
107    { NULL, NULL, NULL },
108 };
109
110 struct retro_core_option_v2_definition option_defs_us[] = {
111    {
112       "pcsx_rearmed_region",
113       "Region",
114       NULL,
115       "Specify which region the system is from. 'NTSC' is 60 Hz while 'PAL' is 50 Hz. 'Auto' will detect the region of the currently loaded content. Games may run faster or slower than normal if the incorrect region is selected.",
116       NULL,
117       "system",
118       {
119          { "auto", "Auto" },
120          { "NTSC", NULL },
121          { "PAL",  NULL },
122          { NULL, NULL },
123       },
124       "auto",
125    },
126    {
127       "pcsx_rearmed_bios",
128       "BIOS Selection",
129       NULL,
130       "Specify which BIOS to use. 'Auto' will attempt to load a real bios file from the frontend 'system' directory, falling back to high level emulation if unavailable. 'HLE' forces high level BIOS emulation. It is recommended to use an official bios file for better compatibility.",
131       NULL,
132       "system",
133       {
134          { "auto", "Auto" },
135          { "HLE",  NULL },
136          { NULL, NULL },
137       },
138       "auto",
139    },
140    {
141       "pcsx_rearmed_show_bios_bootlogo",
142       "Show BIOS Boot Logo",
143       NULL,
144       "When using an official BIOS file, specify whether to show the PlayStation logo upon starting or resetting content. Warning: Enabling the boot logo may reduce game compatibility.",
145       NULL,
146       "system",
147       {
148          { "disabled", NULL },
149          { "enabled",  NULL },
150          { NULL, NULL },
151       },
152       "disabled",
153    },
154    {
155       "pcsx_rearmed_memcard2",
156       "Enable Second Memory Card (Shared)",
157       NULL,
158       "Emulate a second memory card in slot 2. This will be shared by all games.",
159       NULL,
160       "system",
161       {
162          { "disabled", NULL },
163          { "enabled",  NULL },
164          { NULL, NULL },
165       },
166       "disabled",
167    },
168 #ifndef _WIN32
169    {
170       "pcsx_rearmed_async_cd",
171       "CD Access Method (Restart)",
172       NULL,
173       "Select method used to read data from content disk images. 'Synchronous' mimics original hardware. 'Asynchronous' can reduce stuttering on devices with slow storage. 'Pre-Cache (CHD)' loads disk image into memory for faster access (CHD files only).",
174       NULL,
175       "system",
176       {
177          { "sync",     "Synchronous" },
178          { "async",    "Asynchronous" },
179          { "precache", "Pre-Cache (CHD)" },
180          { NULL, NULL},
181       },
182       "sync",
183    },
184 #endif
185 #ifndef DRC_DISABLE
186    {
187       "pcsx_rearmed_drc",
188       "Dynamic Recompiler",
189       NULL,
190       "Dynamically recompile PSX CPU instructions to native instructions. Much faster than using an interpreter, but may be less accurate on some platforms.",
191       NULL,
192       "system",
193       {
194          { "disabled", NULL },
195          { "enabled",  NULL },
196          { NULL, NULL },
197       },
198       "enabled",
199    },
200 #endif
201    {
202       "pcsx_rearmed_psxclock",
203       "PSX CPU Clock Speed",
204       NULL,
205       "Overclock or under-clock the PSX CPU. Try adjusting this if the game is too slow, too fast or hangs."
206 #if defined(HAVE_PRE_ARMV7) && !defined(_3DS)
207       " Default is 50."
208 #else
209       " Default is 57."
210 #endif
211       ,
212       NULL,
213       "system",
214       {
215          { "30",  NULL },
216          { "31",  NULL },
217          { "32",  NULL },
218          { "33",  NULL },
219          { "34",  NULL },
220          { "35",  NULL },
221          { "36",  NULL },
222          { "37",  NULL },
223          { "38",  NULL },
224          { "39",  NULL },
225          { "40",  NULL },
226          { "41",  NULL },
227          { "42",  NULL },
228          { "43",  NULL },
229          { "44",  NULL },
230          { "45",  NULL },
231          { "46",  NULL },
232          { "47",  NULL },
233          { "48",  NULL },
234          { "49",  NULL },
235          { "50",  NULL },
236          { "51",  NULL },
237          { "52",  NULL },
238          { "53",  NULL },
239          { "54",  NULL },
240          { "55",  NULL },
241          { "56",  NULL },
242          { "57",  NULL },
243          { "58",  NULL },
244          { "59",  NULL },
245          { "60",  NULL },
246          { "61",  NULL },
247          { "62",  NULL },
248          { "63",  NULL },
249          { "64",  NULL },
250          { "65",  NULL },
251          { "66",  NULL },
252          { "67",  NULL },
253          { "68",  NULL },
254          { "69",  NULL },
255          { "70",  NULL },
256          { "71",  NULL },
257          { "72",  NULL },
258          { "73",  NULL },
259          { "74",  NULL },
260          { "75",  NULL },
261          { "76",  NULL },
262          { "77",  NULL },
263          { "78",  NULL },
264          { "79",  NULL },
265          { "80",  NULL },
266          { "81",  NULL },
267          { "82",  NULL },
268          { "83",  NULL },
269          { "84",  NULL },
270          { "85",  NULL },
271          { "86",  NULL },
272          { "87",  NULL },
273          { "88",  NULL },
274          { "89",  NULL },
275          { "90",  NULL },
276          { "91",  NULL },
277          { "92",  NULL },
278          { "93",  NULL },
279          { "94",  NULL },
280          { "95",  NULL },
281          { "96",  NULL },
282          { "97",  NULL },
283          { "98",  NULL },
284          { "99",  NULL },
285          { "100", NULL },
286          { NULL, NULL },
287       },
288 #if defined(HAVE_PRE_ARMV7) && !defined(_3DS)
289       "50",
290 #else
291       "57",
292 #endif
293    },
294    {
295       "pcsx_rearmed_dithering",
296       "Dithering Pattern",
297       NULL,
298       "Enable emulation of the dithering technique used by the PSX to smooth out color banding artifacts. Increases performance requirements.",
299       NULL,
300       "video",
301       {
302          { "disabled", NULL },
303          { "enabled",  NULL },
304          { NULL, NULL },
305       },
306 #if defined HAVE_LIBNX || defined _3DS
307       "disabled",
308 #else
309       "enabled",
310 #endif
311    },
312 #ifdef THREAD_RENDERING
313    {
314       "pcsx_rearmed_gpu_thread_rendering",
315       "Threaded Rendering",
316       NULL,
317       "When enabled, runs GPU commands in a secondary thread. 'Synchronous' improves performance while maintaining proper frame pacing. 'Asynchronous' improves performance even further, but may cause dropped frames and increased latency. Produces best results with games that run natively at less than 60 frames per second.",
318       NULL,
319       "video",
320       {
321          { "disabled", NULL },
322          { "sync",     "Synchronous" },
323          { "async",    "Asynchronous" },
324          { NULL, NULL},
325       },
326       "disabled",
327    },
328 #endif
329    {
330       "pcsx_rearmed_frameskip_type",
331       "Frameskip",
332       NULL,
333       "Skip frames to avoid audio buffer under-run (crackling). Improves performance at the expense of visual smoothness. 'Auto' skips frames when advised by the frontend. 'Auto (Threshold)' utilises the 'Frameskip Threshold (%)' setting. 'Fixed Interval' utilises the 'Frameskip Interval' setting.",
334       NULL,
335       "video",
336       {
337          { "disabled",       NULL },
338          { "auto",           "Auto" },
339          { "auto_threshold", "Auto (Threshold)" },
340          { "fixed_interval", "Fixed Interval" },
341          { NULL, NULL },
342       },
343       "disabled"
344    },
345    {
346       "pcsx_rearmed_frameskip_threshold",
347       "Frameskip Threshold (%)",
348       NULL,
349       "When 'Frameskip' is set to 'Auto (Threshold)', specifies the audio buffer occupancy threshold (percentage) below which frames will be skipped. Higher values reduce the risk of crackling by causing frames to be dropped more frequently.",
350       NULL,
351       "video",
352       {
353          { "15", NULL },
354          { "18", NULL },
355          { "21", NULL },
356          { "24", NULL },
357          { "27", NULL },
358          { "30", NULL },
359          { "33", NULL },
360          { "36", NULL },
361          { "39", NULL },
362          { "42", NULL },
363          { "45", NULL },
364          { "48", NULL },
365          { "51", NULL },
366          { "54", NULL },
367          { "57", NULL },
368          { "60", NULL },
369          { NULL, NULL },
370       },
371       "33"
372    },
373    {
374       "pcsx_rearmed_frameskip_interval",
375       "Frameskip Interval",
376       NULL,
377       "Specify the maximum number of frames that can be skipped before a new frame is rendered.",
378       NULL,
379       "video",
380       {
381          { "1",  NULL },
382          { "2",  NULL },
383          { "3",  NULL },
384          { "4",  NULL },
385          { "5",  NULL },
386          { "6",  NULL },
387          { "7",  NULL },
388          { "8",  NULL },
389          { "9",  NULL },
390          { "10", NULL },
391          { NULL, NULL },
392       },
393       "3"
394    },
395    {
396       "pcsx_rearmed_display_internal_fps",
397       "Display Internal FPS",
398       NULL,
399       "Show the internal frame rate at which the emulated PlayStation system is rendering content. Note: Requires on-screen notifications to be enabled in the libretro frontend.",
400       NULL,
401       "video",
402       {
403          { "disabled", NULL },
404          { "enabled",  NULL },
405          { NULL, NULL },
406       },
407       "disabled",
408    },
409    {
410       "pcsx_rearmed_gpu_slow_llists",
411       "(GPU) Slow linked list processing",
412       NULL,
413       "Slower but more accurate GPU linked list processing. Needed by only a few games like Vampire Hunter D. Should be autodetected in most cases.",
414       NULL,
415       "video",
416       {
417          { "auto", NULL },
418          { "disabled", NULL },
419          { "enabled",  NULL },
420          { NULL, NULL },
421       },
422       "auto",
423    },
424    {
425       "pcsx_rearmed_screen_centering",
426       "(GPU) Screen centering",
427       NULL,
428       "The PSX has a feature allowing it to shift the image position on screen. Some (mostly PAL) games used this feature in a strange way making the image miscentered and causing uneven borders to appear. With 'Auto' the emulator tries to correct this miscentering automatically. 'Game-controlled' uses the settings supplied by the game. 'Manual' allows to override those values with the settings below.",
429       NULL,
430       "video",
431       {
432          { "auto", "Auto" },
433          { "game", "Game-controlled" },
434          { "borderless", "Borderless" },
435          { "manual", "Manual" },
436          { NULL, NULL },
437       },
438       "auto",
439    },
440 #define V(x) { #x, NULL }
441    {
442       "pcsx_rearmed_screen_centering_x",
443       "(GPU) Manual screen centering X",
444       NULL,
445       "X offset of the frame buffer. Only effective when 'Screen centering' is set to 'Manual'.",
446       NULL,
447       "video",
448       {
449          V(-16), V(-14), V(-12), V(-10), V(-8), V(-6), V(-4), V(-2), V(0), V(2), V(4), V(6), V(8), V(10), V(12), V(14), V(16),
450          { NULL, NULL },
451       },
452       "0",
453    },
454    {
455       "pcsx_rearmed_screen_centering_y",
456       "(GPU) Manual screen centering Y",
457       NULL,
458       "Y offset of the frame buffer. Only effective when 'Screen centering' is set to 'Manual'.",
459       NULL,
460       "video",
461       {
462          V(-16), V(-15), V(-14), V(-13), V(-12), V(-11), V(-10), V(-9), V(-8), V(-7), V(-6), V(-5), V(-4), V(-3), V(-2), V(-1),
463          V(0), V(1), V(2), V(3), V(4), V(5), V(6), V(7), V(8), V(9), V(10), V(11), V(12), V(13), V(14), V(15), V(16),
464          { NULL, NULL },
465       },
466       "0",
467    },
468 #undef V
469 #ifdef GPU_NEON
470    {
471       "pcsx_rearmed_neon_interlace_enable_v2",
472       "(GPU) Show Interlaced Video",
473       "Show Interlaced Video",
474       "When enabled, games that run in high resolution video modes (480i, 512i) will produced interlaced video output. While this displays correctly on CRT televisions, it will produce artifacts on modern displays. When disabled, all video is output in progressive format. Note: there are games that will glitch is this is off.",
475       NULL,
476       "gpu_neon",
477       {
478          { "auto", NULL },
479          { "disabled", NULL },
480          { "enabled",  NULL },
481          { NULL, NULL },
482       },
483       "auto",
484    },
485    {
486       "pcsx_rearmed_neon_enhancement_enable",
487       "(GPU) Enhanced Resolution",
488       "Enhanced Resolution",
489       "Render games that do not already run in high resolution video modes (480i, 512i) at twice the native internal resolution. Improves the fidelity of 3D models at the expense of increased performance requirements. 2D elements are generally unaffected by this setting.",
490       NULL,
491       "gpu_neon",
492       {
493          { "disabled", NULL },
494          { "enabled",  NULL },
495          { NULL, NULL },
496       },
497       "disabled",
498    },
499    {
500       "pcsx_rearmed_neon_enhancement_no_main",
501       "(GPU) Enhanced Resolution Speed Hack",
502       "Enhanced Resolution Speed Hack",
503       "Improves performance when 'Enhanced Resolution' is enabled, but reduces compatibility and may cause rendering errors.",
504       NULL,
505       "gpu_neon",
506       {
507          { "disabled", NULL },
508          { "enabled",  NULL },
509          { NULL, NULL },
510       },
511       "disabled",
512    },
513 #endif /* GPU_NEON */
514 #ifdef GPU_PEOPS
515    {
516       "pcsx_rearmed_show_gpu_peops_settings",
517       "Show Advanced P.E.Op.S. GPU Settings",
518       NULL,
519       "Show low-level configuration options for the P.E.Op.S. GPU plugin. Quick Menu may need to be toggled for this setting to take effect.",
520       NULL,
521       NULL,
522       {
523          { "disabled", NULL },
524          { "enabled",  NULL },
525          { NULL, NULL },
526       },
527       "disabled",
528    },
529    {
530       "pcsx_rearmed_gpu_peops_odd_even_bit",
531       "(GPU) Odd/Even Bit Hack",
532       "Odd/Even Bit Hack",
533       "A hack fix used to correct lock-ups that may occur in games such as Chrono Cross. Disable unless required.",
534       NULL,
535       "gpu_peops",
536       {
537          { "disabled", NULL },
538          { "enabled",  NULL },
539          { NULL, NULL },
540       },
541       "disabled",
542    },
543    {
544       "pcsx_rearmed_gpu_peops_expand_screen_width",
545       "(GPU) Expand Screen Width",
546       "Expand Screen Width",
547       "Intended for use only with Capcom 2D fighting games. Enlarges the display area at the right side of the screen to show all background elements without cut-off. May cause rendering errors.",
548       NULL,
549       "gpu_peops",
550       {
551          { "disabled", NULL },
552          { "enabled",  NULL },
553          { NULL, NULL },
554       },
555       "disabled",
556    },
557    {
558       "pcsx_rearmed_gpu_peops_ignore_brightness",
559       "(GPU) Ignore Brightness Color",
560       "Ignore Brightness Color",
561       "A hack fix used to repair black screens in Lunar Silver Star Story Complete when entering a house or a menu. Disable unless required.",
562       NULL,
563       "gpu_peops",
564       {
565          { "disabled", NULL },
566          { "enabled",  NULL },
567          { NULL, NULL },
568       },
569       "disabled",
570    },
571    {
572       "pcsx_rearmed_gpu_peops_disable_coord_check",
573       "(GPU) Disable Coordinate Check",
574       "Disable Coordinate Check",
575       "Legacy compatibility mode. May improve games that fail to run correctly on newer GPU hardware. Disable unless required.",
576       NULL,
577       "gpu_peops",
578       {
579          { "disabled", NULL },
580          { "enabled",  NULL },
581          { NULL, NULL },
582       },
583       "disabled",
584    },
585    {
586       "pcsx_rearmed_gpu_peops_lazy_screen_update",
587       "(GPU) Lazy Screen Update",
588       "Lazy Screen Update",
589       "A partial fix to prevent text box flickering in Dragon Warrior VII. May also improve Pandemonium 2. Disable unless required.",
590       NULL,
591       "gpu_peops",
592       {
593          { "disabled", NULL },
594          { "enabled",  NULL },
595          { NULL, NULL },
596       },
597       "disabled",
598    },
599    {
600       "pcsx_rearmed_gpu_peops_repeated_triangles",
601       "(GPU) Repeat Flat Tex Triangles",
602       "Repeat Flat Tex Triangles",
603       "A hack fix used to correct rendering errors in Star Wars: Dark Forces. Disable unless required.",
604       NULL,
605       "gpu_peops",
606       {
607          { "disabled", NULL },
608          { "enabled",  NULL },
609          { NULL, NULL },
610       },
611       "disabled",
612    },
613    {
614       "pcsx_rearmed_gpu_peops_quads_with_triangles",
615       "(GPU) Draw Tex-Quads as Triangles",
616       "Draw Tex-Quads as Triangles",
617       "Corrects graphical distortions that may occur when games utilize Gouraud Shading, at the expense of reduced texture quality. Disable unless required.",
618       NULL,
619       "gpu_peops",
620       {
621          { "disabled", NULL },
622          { "enabled",  NULL },
623          { NULL, NULL },
624       },
625       "disabled",
626    },
627    {
628       "pcsx_rearmed_gpu_peops_fake_busy_state",
629       "(GPU) Fake 'GPU Busy' States",
630       "Fake 'GPU Busy' States",
631       "Emulate the 'GPU is busy' (drawing primitives) status flag of the original hardware instead of assuming the GPU is always ready for commands. May improve compatibility at the expense of reduced performance. Disable unless required.",
632       NULL,
633       "gpu_peops",
634       {
635          { "disabled", NULL },
636          { "enabled",  NULL },
637          { NULL, NULL },
638       },
639       "disabled",
640    },
641 #endif /* GPU_PEOPS */
642 #ifdef GPU_UNAI
643    {
644       "pcsx_rearmed_show_gpu_unai_settings",
645       "Show Advanced UNAI GPU Settings",
646       NULL,
647       "Show low-level configuration options for the UNAI GPU plugin. Quick Menu may need to be toggled for this setting to take effect.",
648       NULL,
649       NULL,
650       {
651          { "disabled", NULL },
652          { "enabled",  NULL },
653          { NULL, NULL},
654       },
655       "disabled",
656    },
657    {
658       "pcsx_rearmed_gpu_unai_blending",
659       "(GPU) Texture Blending",
660       "Texture Blending",
661       "Enable alpha-based (and additive) texture blending. Required for various rendering effects, including transparency (e.g. water, shadows). Can be disabled to improve performance at the expense of severe display errors/inaccuracies.",
662       NULL,
663       "gpu_unai",
664       {
665          { "disabled", NULL },
666          { "enabled",  NULL },
667          { NULL, NULL},
668       },
669       "enabled",
670    },
671    {
672       "pcsx_rearmed_gpu_unai_lighting",
673       "(GPU) Lighting Effects",
674       "Lighting Effects",
675       "Enable simulated lighting effects (via vertex coloring combined with texture mapping). Required by almost all 3D games. Can be disabled to improve performance at the expense of severe display errors/inaccuracies (missing shadows, flat textures, etc.).",
676       NULL,
677       "gpu_unai",
678       {
679          { "disabled", NULL },
680          { "enabled",  NULL },
681          { NULL, NULL},
682       },
683       "enabled",
684    },
685    {
686       "pcsx_rearmed_gpu_unai_fast_lighting",
687       "(GPU) Fast Lighting",
688       "Fast Lighting",
689       "Improves performance when 'Lighting Effects' are enabled, but may cause moderate/severe rendering errors.",
690       NULL,
691       "gpu_unai",
692       {
693          { "disabled", NULL },
694          { "enabled",  NULL },
695          { NULL, NULL},
696       },
697       "disabled",
698    },
699    {
700       "pcsx_rearmed_gpu_unai_scale_hires",
701       "(GPU) Hi-Res Downscaling",
702       "Hi-Res Downscaling",
703       "When enabled, games that run in high resolution video modes (480i, 512i) will be downscaled to 320x240. Can improve performance, and is recommended on devices with native 240p display resolutions.",
704       NULL,
705       "gpu_unai",
706       {
707          { "disabled", NULL },
708          { "enabled",  NULL },
709          { NULL, NULL},
710       },
711 #ifdef _MIYOO
712       "enabled",
713 #else
714       "disabled",
715 #endif
716    },
717 #endif /* GPU_UNAI */
718    {
719       "pcsx_rearmed_spu_reverb",
720       "Audio Reverb Effects",
721       "Reverb Effects",
722       "Enable emulation of the reverb feature provided by the PSX SPU. Can be disabled to improve performance at the expense of reduced audio quality/authenticity.",
723       NULL,
724       "audio",
725       {
726          { "disabled", NULL },
727          { "enabled",  NULL },
728          { NULL, NULL },
729       },
730 #ifdef HAVE_PRE_ARMV7
731       "disabled",
732 #else
733       "enabled",
734 #endif
735    },
736    {
737       "pcsx_rearmed_spu_interpolation",
738       "Sound Interpolation",
739       NULL,
740       "Enable emulation of the in-built audio interpolation provided by the PSX SPU. 'Gaussian' sounds closest to original hardware. 'Simple' improves performance but reduces quality. 'Cubic' has the highest performance requirements but produces increased clarity. Can be disabled entirely for maximum performance, at the expense of greatly reduced audio quality.",
741       NULL,
742       "audio",
743       {
744          { "simple",   "Simple" },
745          { "gaussian", "Gaussian" },
746          { "cubic",    "Cubic" },
747          { "off",      "disabled" },
748          { NULL, NULL },
749       },
750 #ifdef HAVE_PRE_ARMV7
751       "off",
752 #else
753       "simple",
754 #endif
755    },
756    {
757       "pcsx_rearmed_nocdaudio",
758       "CD Audio",
759       NULL,
760       "Enable playback of CD (CD-DA) audio tracks. Can be disabled to improve performance in games that include CD audio, at the expense of missing music.",
761       NULL,
762       "audio",
763       {
764          { "disabled", NULL },
765          { "enabled",  NULL },
766          { NULL, NULL },
767       },
768       "enabled",
769    },
770    {
771       "pcsx_rearmed_noxadecoding",
772       "XA Decoding",
773       NULL,
774       "Enable playback of XA (eXtended Architecture ADPCM) audio tracks. Can be disabled to improve performance in games that include XA audio, at the expense of missing music.",
775       NULL,
776       "audio",
777       {
778          { "disabled", NULL },
779          { "enabled",  NULL },
780          { NULL, NULL },
781       },
782       "enabled",
783    },
784 #if P_HAVE_PTHREAD
785    {
786       "pcsx_rearmed_spu_thread",
787       "Threaded SPU",
788       NULL,
789       "Emulates the PSX SPU on another CPU thread. May cause audio glitches in some games.",
790       NULL,
791       "audio",
792       {
793          { "disabled", NULL },
794          { "enabled",  NULL },
795          { NULL, NULL },
796       },
797       "disabled",
798    },
799 #endif // P_HAVE_PTHREAD
800    {
801       "pcsx_rearmed_show_input_settings",
802       "Show Input Settings",
803       NULL,
804       "Show configuration options for all input devices: analog response, Multitaps, light guns, etc. Quick Menu may need to be toggled for this setting to take effect.",
805       NULL,
806       NULL,
807       {
808          { "disabled", NULL },
809          { "enabled",  NULL },
810          { NULL, NULL },
811       },
812       "disabled",
813    },
814    {
815       "pcsx_rearmed_analog_axis_modifier",
816       "Analog Axis Bounds",
817       NULL,
818       "Specify range limits for the left and right analog sticks when input device is set to 'analog' or 'dualshock'. 'Square' bounds improve input response when using controllers with highly circular ranges that are unable to fully saturate the X and Y axes at 45 degree deflections.",
819       NULL,
820       "input",
821       {
822          { "circle", "Circle" },
823          { "square", "Square" },
824          { NULL, NULL },
825       },
826       "circle",
827    },
828    {
829       "pcsx_rearmed_vibration",
830       "Rumble Effects",
831       NULL,
832       "Enable haptic feedback when using a rumble-equipped gamepad with input device set to 'dualshock'.",
833       NULL,
834       "input",
835       {
836          { "disabled", NULL },
837          { "enabled",  NULL },
838          { NULL, NULL },
839       },
840       "enabled",
841    },
842    {
843       "pcsx_rearmed_analog_combo",
844       "DualShock Analog Mode Toggle Key Combo",
845       NULL,
846       "When the input device type is DualShock, this option allows the emulated DualShock to be toggled between DIGITAL and ANALOG mode like original hardware. You can select the button combination for this.",
847       NULL,
848       "input",
849       {
850          { "disabled", NULL },
851          { "l1+r1+select",             "L1 + R1 + Select" },
852          { "l1+r1+start",              "L1 + R1 + Start" },
853          { "l1+r1+l3",                 "L1 + R1 + L3" },
854          { "l1+r1+r3",                 "L1 + R1 + R3" },
855          { "l3+r3",                    "L3 + R3" },
856          { NULL, NULL },
857       },
858       "l1+r1+select"
859    },
860    {
861       "pcsx_rearmed_multitap",
862       "Multitap Mode",
863       NULL,
864       "Connect a virtual PSX Multitap peripheral to either controller 'Port 1' or controller 'Port 2' for 5 player simultaneous input, or to both 'Ports 1 and 2' for 8 player input. Mutlitap usage requires compatible games.",
865       NULL,
866       "input",
867       {
868          { "disabled",      NULL },
869          { "port 1",        "Port 1" },
870          { "port 2",        "Port 2" },
871          { "ports 1 and 2", "Ports 1 and 2" },
872          { NULL, NULL },
873       },
874       "disabled",
875    },
876    {
877       "pcsx_rearmed_negcon_deadzone",
878       "NegCon Twist Deadzone",
879       NULL,
880       "Set the deadzone of the RetroPad left analog stick when simulating the 'twist' action of emulated neGcon Controllers. Used to eliminate drift/unwanted input.",
881       NULL,
882       "input",
883       {
884          { "0",  "0%" },
885          { "3",  "3%" },
886          { "5",  "5%" },
887          { "7",  "7%" },
888          { "10", "10%" },
889          { "13", "13%" },
890          { "15", "15%" },
891          { "17", "17%" },
892          { "20", "20%" },
893          { "23", "23%" },
894          { "25", "25%" },
895          { "27", "27%" },
896          { "30", "30%" },
897          { NULL, NULL },
898       },
899       "0",
900    },
901    {
902       "pcsx_rearmed_negcon_response",
903       "NegCon Twist Response",
904       NULL,
905       "Specify the analog response when using a RetroPad left analog stick to simulate the 'twist' action of emulated neGcon Controllers.",
906       NULL,
907       "input",
908       {
909          { "linear",    "Linear" },
910          { "quadratic", "Quadratic" },
911          { "cubic",     "Cubic" },
912          { NULL, NULL },
913       },
914       "linear",
915    },
916    {
917       "pcsx_rearmed_input_sensitivity",
918       "Mouse Sensitivity",
919       NULL,
920       "Adjust responsiveness of emulated 'mouse' input devices.",
921       NULL,
922       "input",
923       {
924          { "0.05", NULL },
925          { "0.10", NULL },
926          { "0.15", NULL },
927          { "0.20", NULL },
928          { "0.25", NULL },
929          { "0.30", NULL },
930          { "0.35", NULL },
931          { "0.40", NULL },
932          { "0.45", NULL },
933          { "0.50", NULL },
934          { "0.55", NULL },
935          { "0.60", NULL },
936          { "0.65", NULL },
937          { "0.70", NULL },
938          { "0.75", NULL },
939          { "0.80", NULL },
940          { "0.85", NULL },
941          { "0.90", NULL },
942          { "0.95", NULL },
943          { "1.00", NULL },
944          { "1.05", NULL },
945          { "1.10", NULL },
946          { "1.15", NULL },
947          { "1.20", NULL },
948          { "1.25", NULL },
949          { "1.30", NULL },
950          { "1.35", NULL },
951          { "1.40", NULL },
952          { "1.45", NULL },
953          { "1.50", NULL },
954          { "1.55", NULL },
955          { "1.60", NULL },
956          { "1.65", NULL },
957          { "1.70", NULL },
958          { "1.75", NULL },
959          { "1.80", NULL },
960          { "1.85", NULL },
961          { "1.90", NULL },
962          { "1.95", NULL },
963          { "2.00", NULL },
964       },
965       "1.00",
966    },
967    {
968       "pcsx_rearmed_crosshair1",
969       "Player 1 Lightgun Crosshair",
970       NULL,
971       "Toggle player 1's crosshair for the Guncon or Konami Gun",
972       NULL,
973       "input",
974       {
975          { "disabled", NULL },
976          { "blue",  NULL },
977          { "green",  NULL },
978          { "red",  NULL },
979          { "white",  NULL },
980          { NULL, NULL },
981       },
982       "disabled",
983    },
984    {
985       "pcsx_rearmed_crosshair2",
986       "Player 2 Lightgun Crosshair",
987       NULL,
988       "Toggle player 2's crosshair for the Guncon or Konami Gun",
989       NULL,
990       "input",
991       {
992          { "disabled", NULL },
993          { "blue",  NULL },
994          { "green",  NULL },
995          { "red",  NULL },
996          { "white",  NULL },
997          { NULL, NULL },
998       },
999       "disabled",
1000    },
1001    {
1002       "pcsx_rearmed_konamigunadjustx",
1003       "Konami Gun X Axis Offset",
1004       NULL,
1005       "Apply an X axis offset to light gun input when emulating a Konami Gun (Hyper Blaster / Justifier) device. Can be used to correct aiming misalignments.",
1006       NULL,
1007       "input",
1008       {
1009          { "-40", NULL },
1010          { "-39", NULL },
1011          { "-38", NULL },
1012          { "-37", NULL },
1013          { "-36", NULL },
1014          { "-35", NULL },
1015          { "-34", NULL },
1016          { "-33", NULL },
1017          { "-32", NULL },
1018          { "-31", NULL },
1019          { "-30", NULL },
1020          { "-29", NULL },
1021          { "-28", NULL },
1022          { "-27", NULL },
1023          { "-26", NULL },
1024          { "-25", NULL },
1025          { "-24", NULL },
1026          { "-23", NULL },
1027          { "-22", NULL },
1028          { "-21", NULL },
1029          { "-20", NULL },
1030          { "-19", NULL },
1031          { "-18", NULL },
1032          { "-17", NULL },
1033          { "-16", NULL },
1034          { "-15", NULL },
1035          { "-14", NULL },
1036          { "-13", NULL },
1037          { "-12", NULL },
1038          { "-11", NULL },
1039          { "-10", NULL },
1040          { "-9",  NULL },
1041          { "-8",  NULL },
1042          { "-7",  NULL },
1043          { "-6",  NULL },
1044          { "-5",  NULL },
1045          { "-4",  NULL },
1046          { "-3",  NULL },
1047          { "-2",  NULL },
1048          { "-1",  NULL },
1049          { "0",   NULL },
1050          { "1",   NULL },
1051          { "2",   NULL },
1052          { "3",   NULL },
1053          { "4",   NULL },
1054          { "5",   NULL },
1055          { "6",   NULL },
1056          { "7",   NULL },
1057          { "8",   NULL },
1058          { "9",   NULL },
1059          { "10",  NULL },
1060          { "11",  NULL },
1061          { "12",  NULL },
1062          { "13",  NULL },
1063          { "14",  NULL },
1064          { "15",  NULL },
1065          { "16",  NULL },
1066          { "17",  NULL },
1067          { "18",  NULL },
1068          { "19",  NULL },
1069          { "20",  NULL },
1070          { "21",  NULL },
1071          { "22",  NULL },
1072          { "23",  NULL },
1073          { "24",  NULL },
1074          { "25",  NULL },
1075          { "26",  NULL },
1076          { "27",  NULL },
1077          { "28",  NULL },
1078          { "29",  NULL },
1079          { "30",  NULL },
1080          { "31",  NULL },
1081          { "32",  NULL },
1082          { "33",  NULL },
1083          { "34",  NULL },
1084          { "35",  NULL },
1085          { "36",  NULL },
1086          { "37",  NULL },
1087          { "38",  NULL },
1088          { "39",  NULL },
1089          { "40",  NULL },
1090          { NULL, NULL },
1091       },
1092       "0",
1093    },
1094    {
1095       "pcsx_rearmed_konamigunadjusty",
1096       "Konami Gun Y Axis Offset",
1097       NULL,
1098       "Apply a Y axis offset to light gun input when emulating a Konami Gun (Hyper Blaster / Justifier) device. Can be used to correct aiming misalignments.",
1099       NULL,
1100       "input",
1101       {
1102          { "-40", NULL },
1103          { "-39", NULL },
1104          { "-38", NULL },
1105          { "-37", NULL },
1106          { "-36", NULL },
1107          { "-35", NULL },
1108          { "-34", NULL },
1109          { "-33", NULL },
1110          { "-32", NULL },
1111          { "-31", NULL },
1112          { "-30", NULL },
1113          { "-29", NULL },
1114          { "-28", NULL },
1115          { "-27", NULL },
1116          { "-26", NULL },
1117          { "-25", NULL },
1118          { "-24", NULL },
1119          { "-23", NULL },
1120          { "-22", NULL },
1121          { "-21", NULL },
1122          { "-20", NULL },
1123          { "-19", NULL },
1124          { "-18", NULL },
1125          { "-17", NULL },
1126          { "-16", NULL },
1127          { "-15", NULL },
1128          { "-14", NULL },
1129          { "-13", NULL },
1130          { "-12", NULL },
1131          { "-11", NULL },
1132          { "-10", NULL },
1133          { "-9",  NULL },
1134          { "-8",  NULL },
1135          { "-7",  NULL },
1136          { "-6",  NULL },
1137          { "-5",  NULL },
1138          { "-4",  NULL },
1139          { "-3",  NULL },
1140          { "-2",  NULL },
1141          { "-1",  NULL },
1142          { "0",   NULL },
1143          { "1",   NULL },
1144          { "2",   NULL },
1145          { "3",   NULL },
1146          { "4",   NULL },
1147          { "5",   NULL },
1148          { "6",   NULL },
1149          { "7",   NULL },
1150          { "8",   NULL },
1151          { "9",   NULL },
1152          { "10",  NULL },
1153          { "11",  NULL },
1154          { "12",  NULL },
1155          { "13",  NULL },
1156          { "14",  NULL },
1157          { "15",  NULL },
1158          { "16",  NULL },
1159          { "17",  NULL },
1160          { "18",  NULL },
1161          { "19",  NULL },
1162          { "20",  NULL },
1163          { "21",  NULL },
1164          { "22",  NULL },
1165          { "23",  NULL },
1166          { "24",  NULL },
1167          { "25",  NULL },
1168          { "26",  NULL },
1169          { "27",  NULL },
1170          { "28",  NULL },
1171          { "29",  NULL },
1172          { "30",  NULL },
1173          { "31",  NULL },
1174          { "32",  NULL },
1175          { "33",  NULL },
1176          { "34",  NULL },
1177          { "35",  NULL },
1178          { "36",  NULL },
1179          { "37",  NULL },
1180          { "38",  NULL },
1181          { "39",  NULL },
1182          { "40",  NULL },
1183          { NULL, NULL },
1184       },
1185       "0",
1186    },
1187    {
1188       "pcsx_rearmed_gunconadjustx",
1189       "Guncon X Axis Offset",
1190       NULL,
1191       "Apply an X axis offset to light gun input when emulating a Guncon device. Can be used to correct aiming misalignments.",
1192       NULL,
1193       "input",
1194       {
1195          { "-40", NULL },
1196          { "-39", NULL },
1197          { "-38", NULL },
1198          { "-37", NULL },
1199          { "-36", NULL },
1200          { "-35", NULL },
1201          { "-34", NULL },
1202          { "-33", NULL },
1203          { "-32", NULL },
1204          { "-31", NULL },
1205          { "-30", NULL },
1206          { "-29", NULL },
1207          { "-28", NULL },
1208          { "-27", NULL },
1209          { "-26", NULL },
1210          { "-25", NULL },
1211          { "-24", NULL },
1212          { "-23", NULL },
1213          { "-22", NULL },
1214          { "-21", NULL },
1215          { "-20", NULL },
1216          { "-19", NULL },
1217          { "-18", NULL },
1218          { "-17", NULL },
1219          { "-16", NULL },
1220          { "-15", NULL },
1221          { "-14", NULL },
1222          { "-13", NULL },
1223          { "-12", NULL },
1224          { "-11", NULL },
1225          { "-10", NULL },
1226          { "-9",  NULL },
1227          { "-8",  NULL },
1228          { "-7",  NULL },
1229          { "-6",  NULL },
1230          { "-5",  NULL },
1231          { "-4",  NULL },
1232          { "-3",  NULL },
1233          { "-2",  NULL },
1234          { "-1",  NULL },
1235          { "0",   NULL },
1236          { "1",   NULL },
1237          { "2",   NULL },
1238          { "3",   NULL },
1239          { "4",   NULL },
1240          { "5",   NULL },
1241          { "6",   NULL },
1242          { "7",   NULL },
1243          { "8",   NULL },
1244          { "9",   NULL },
1245          { "10",  NULL },
1246          { "11",  NULL },
1247          { "12",  NULL },
1248          { "13",  NULL },
1249          { "14",  NULL },
1250          { "15",  NULL },
1251          { "16",  NULL },
1252          { "17",  NULL },
1253          { "18",  NULL },
1254          { "19",  NULL },
1255          { "20",  NULL },
1256          { "21",  NULL },
1257          { "22",  NULL },
1258          { "23",  NULL },
1259          { "24",  NULL },
1260          { "25",  NULL },
1261          { "26",  NULL },
1262          { "27",  NULL },
1263          { "28",  NULL },
1264          { "29",  NULL },
1265          { "30",  NULL },
1266          { "31",  NULL },
1267          { "32",  NULL },
1268          { "33",  NULL },
1269          { "34",  NULL },
1270          { "35",  NULL },
1271          { "36",  NULL },
1272          { "37",  NULL },
1273          { "38",  NULL },
1274          { "39",  NULL },
1275          { "40",  NULL },
1276          { NULL, NULL },
1277       },
1278       "0",
1279    },
1280    {
1281       "pcsx_rearmed_gunconadjusty",
1282       "Guncon Y Axis Offset",
1283       NULL,
1284       "Apply a Y axis offset to light gun input when emulating a Guncon device. Can be used to correct aiming misalignments.",
1285       NULL,
1286       "input",
1287       {
1288          { "-40", NULL },
1289          { "-39", NULL },
1290          { "-38", NULL },
1291          { "-37", NULL },
1292          { "-36", NULL },
1293          { "-35", NULL },
1294          { "-34", NULL },
1295          { "-33", NULL },
1296          { "-32", NULL },
1297          { "-31", NULL },
1298          { "-30", NULL },
1299          { "-29", NULL },
1300          { "-28", NULL },
1301          { "-27", NULL },
1302          { "-26", NULL },
1303          { "-25", NULL },
1304          { "-24", NULL },
1305          { "-23", NULL },
1306          { "-22", NULL },
1307          { "-21", NULL },
1308          { "-20", NULL },
1309          { "-19", NULL },
1310          { "-18", NULL },
1311          { "-17", NULL },
1312          { "-16", NULL },
1313          { "-15", NULL },
1314          { "-14", NULL },
1315          { "-13", NULL },
1316          { "-12", NULL },
1317          { "-11", NULL },
1318          { "-10", NULL },
1319          { "-9",  NULL },
1320          { "-8",  NULL },
1321          { "-7",  NULL },
1322          { "-6",  NULL },
1323          { "-5",  NULL },
1324          { "-4",  NULL },
1325          { "-3",  NULL },
1326          { "-2",  NULL },
1327          { "-1",  NULL },
1328          { "0",   NULL },
1329          { "1",   NULL },
1330          { "2",   NULL },
1331          { "3",   NULL },
1332          { "4",   NULL },
1333          { "5",   NULL },
1334          { "6",   NULL },
1335          { "7",   NULL },
1336          { "8",   NULL },
1337          { "9",   NULL },
1338          { "10",  NULL },
1339          { "11",  NULL },
1340          { "12",  NULL },
1341          { "13",  NULL },
1342          { "14",  NULL },
1343          { "15",  NULL },
1344          { "16",  NULL },
1345          { "17",  NULL },
1346          { "18",  NULL },
1347          { "19",  NULL },
1348          { "20",  NULL },
1349          { "21",  NULL },
1350          { "22",  NULL },
1351          { "23",  NULL },
1352          { "24",  NULL },
1353          { "25",  NULL },
1354          { "26",  NULL },
1355          { "27",  NULL },
1356          { "28",  NULL },
1357          { "29",  NULL },
1358          { "30",  NULL },
1359          { "31",  NULL },
1360          { "32",  NULL },
1361          { "33",  NULL },
1362          { "34",  NULL },
1363          { "35",  NULL },
1364          { "36",  NULL },
1365          { "37",  NULL },
1366          { "38",  NULL },
1367          { "39",  NULL },
1368          { "40",  NULL },
1369          { NULL, NULL },
1370       },
1371       "0",
1372    },
1373    {
1374       "pcsx_rearmed_gunconadjustratiox",
1375       "Guncon X Axis Response",
1376       NULL,
1377       "Adjust relative magnitude of horizontal light gun motion when emulating a Guncon device. Can be used to correct aiming misalignments.",
1378       NULL,
1379       "input",
1380       {
1381          { "0.75", NULL },
1382          { "0.76", NULL },
1383          { "0.77", NULL },
1384          { "0.78", NULL },
1385          { "0.79", NULL },
1386          { "0.80", NULL },
1387          { "0.81", NULL },
1388          { "0.82", NULL },
1389          { "0.83", NULL },
1390          { "0.84", NULL },
1391          { "0.85", NULL },
1392          { "0.86", NULL },
1393          { "0.87", NULL },
1394          { "0.88", NULL },
1395          { "0.89", NULL },
1396          { "0.90", NULL },
1397          { "0.91", NULL },
1398          { "0.92", NULL },
1399          { "0.93", NULL },
1400          { "0.94", NULL },
1401          { "0.95", NULL },
1402          { "0.96", NULL },
1403          { "0.97", NULL },
1404          { "0.98", NULL },
1405          { "0.99", NULL },
1406          { "1.00", NULL },
1407          { "1.01", NULL },
1408          { "1.02", NULL },
1409          { "1.03", NULL },
1410          { "1.04", NULL },
1411          { "1.05", NULL },
1412          { "1.06", NULL },
1413          { "1.07", NULL },
1414          { "1.08", NULL },
1415          { "1.09", NULL },
1416          { "1.10", NULL },
1417          { "1.11", NULL },
1418          { "1.12", NULL },
1419          { "1.13", NULL },
1420          { "1.14", NULL },
1421          { "1.15", NULL },
1422          { "1.16", NULL },
1423          { "1.17", NULL },
1424          { "1.18", NULL },
1425          { "1.19", NULL },
1426          { "1.20", NULL },
1427          { "1.21", NULL },
1428          { "1.22", NULL },
1429          { "1.23", NULL },
1430          { "1.24", NULL },
1431          { "1.25", NULL },
1432          { NULL, NULL },
1433       },
1434       "1.00",
1435    },
1436    {
1437       "pcsx_rearmed_gunconadjustratioy",
1438       "Guncon Y Axis Response",
1439       NULL,
1440       "Adjust relative magnitude of vertical light gun motion when emulating a Guncon device. Can be used to correct aiming misalignments.",
1441       NULL,
1442       "input",
1443       {
1444          { "0.75", NULL },
1445          { "0.76", NULL },
1446          { "0.77", NULL },
1447          { "0.78", NULL },
1448          { "0.79", NULL },
1449          { "0.80", NULL },
1450          { "0.81", NULL },
1451          { "0.82", NULL },
1452          { "0.83", NULL },
1453          { "0.84", NULL },
1454          { "0.85", NULL },
1455          { "0.86", NULL },
1456          { "0.87", NULL },
1457          { "0.88", NULL },
1458          { "0.89", NULL },
1459          { "0.90", NULL },
1460          { "0.91", NULL },
1461          { "0.92", NULL },
1462          { "0.93", NULL },
1463          { "0.94", NULL },
1464          { "0.95", NULL },
1465          { "0.96", NULL },
1466          { "0.97", NULL },
1467          { "0.98", NULL },
1468          { "0.99", NULL },
1469          { "1.00", NULL },
1470          { "1.01", NULL },
1471          { "1.02", NULL },
1472          { "1.03", NULL },
1473          { "1.04", NULL },
1474          { "1.05", NULL },
1475          { "1.06", NULL },
1476          { "1.07", NULL },
1477          { "1.08", NULL },
1478          { "1.09", NULL },
1479          { "1.10", NULL },
1480          { "1.11", NULL },
1481          { "1.12", NULL },
1482          { "1.13", NULL },
1483          { "1.14", NULL },
1484          { "1.15", NULL },
1485          { "1.16", NULL },
1486          { "1.17", NULL },
1487          { "1.18", NULL },
1488          { "1.19", NULL },
1489          { "1.20", NULL },
1490          { "1.21", NULL },
1491          { "1.22", NULL },
1492          { "1.23", NULL },
1493          { "1.24", NULL },
1494          { "1.25", NULL },
1495          { NULL, NULL },
1496       },
1497       "1.00",
1498    },
1499    {
1500       "pcsx_rearmed_icache_emulation",
1501       "Instruction Cache Emulation",
1502       NULL,
1503       "Enable emulation of the PSX CPU instruction cache. Improves accuracy at the expense of increased performance overheads. Required for Formula One 2001, Formula One Arcade and Formula One 99. [Interpreter only; partial on lightrec and ARM dynarecs]",
1504       NULL,
1505       "compat_hack",
1506       {
1507          { "enabled",  NULL },
1508          { "disabled", NULL },
1509          { NULL, NULL },
1510       },
1511       "enabled",
1512    },
1513    {
1514       "pcsx_rearmed_exception_emulation",
1515       "Exception and Breakpoint Emulation",
1516       NULL,
1517       "Enable emulation of some almost never used PSX's debug features. This causes a performance hit, is not useful for games and is intended for PSX homebrew and romhack developers only. Only enable if you know what you are doing. [Interpreter only]",
1518       NULL,
1519       "compat_hack",
1520       {
1521          { "disabled", NULL },
1522          { "enabled",  NULL },
1523          { NULL, NULL },
1524       },
1525       "disabled",
1526    },
1527 #if !defined(DRC_DISABLE) && !defined(LIGHTREC)
1528    {
1529       "pcsx_rearmed_nocompathacks",
1530       "Disable Automatic Compatibility Hacks",
1531       NULL,
1532       "By default, PCSX-ReARMed will apply auxiliary compatibility hacks automatically, based on the currently loaded content. This behaviour is required for correct operation, but may be disabled if desired.",
1533       NULL,
1534       "compat_hack",
1535       {
1536          { "disabled", NULL },
1537          { "enabled",  NULL },
1538          { NULL, NULL },
1539       },
1540       "disabled",
1541    },
1542    {
1543       "pcsx_rearmed_nosmccheck",
1544       "(Speed Hack) Disable SMC Checks",
1545       "Disable SMC Checks",
1546       "Will cause crashes when loading, and lead to memory card failure.",
1547       NULL,
1548       "speed_hack",
1549       {
1550          { "disabled", NULL },
1551          { "enabled",  NULL },
1552          { NULL, NULL },
1553       },
1554       "disabled",
1555    },
1556    {
1557       "pcsx_rearmed_gteregsunneeded",
1558       "(Speed Hack) Assume GTE Registers Unneeded",
1559       "Assume GTE Registers Unneeded",
1560       "May cause rendering errors.",
1561       NULL,
1562       "speed_hack",
1563       {
1564          { "disabled", NULL },
1565          { "enabled",  NULL },
1566          { NULL, NULL },
1567       },
1568       "disabled",
1569    },
1570    {
1571       "pcsx_rearmed_nogteflags",
1572       "(Speed Hack) Disable GTE Flags",
1573       "Disable GTE Flags",
1574       "Will cause rendering errors.",
1575       NULL,
1576       "speed_hack",
1577       {
1578          { "disabled", NULL },
1579          { "enabled",  NULL },
1580          { NULL, NULL },
1581       },
1582       "disabled",
1583    },
1584 #endif /* !DRC_DISABLE && !LIGHTREC */
1585    {
1586       "pcsx_rearmed_nostalls",
1587       "Disable CPU/GTE Stalls",
1588       NULL,
1589       "Will cause some games to run too quickly."
1590 #if defined(LIGHTREC)
1591       " Interpreter only."
1592 #endif
1593       ,
1594       NULL,
1595       "compat_hack",
1596       {
1597          { "disabled", NULL },
1598          { "enabled",  NULL },
1599          { NULL, NULL },
1600       },
1601       "disabled",
1602    },
1603    { NULL, NULL, NULL, NULL, NULL, NULL, {{0}}, NULL },
1604 };
1605
1606 struct retro_core_options_v2 options_us = {
1607    option_cats_us,
1608    option_defs_us
1609 };
1610
1611 /*
1612  ********************************
1613  * Language Mapping
1614  ********************************
1615 */
1616
1617 #ifndef HAVE_NO_LANGEXTRA
1618 struct retro_core_options_v2 *options_intl[RETRO_LANGUAGE_LAST] = {
1619    &options_us, /* RETRO_LANGUAGE_ENGLISH */
1620    NULL,        /* RETRO_LANGUAGE_JAPANESE */
1621    NULL,        /* RETRO_LANGUAGE_FRENCH */
1622    NULL,        /* RETRO_LANGUAGE_SPANISH */
1623    NULL,        /* RETRO_LANGUAGE_GERMAN */
1624    NULL,        /* RETRO_LANGUAGE_ITALIAN */
1625    NULL,        /* RETRO_LANGUAGE_DUTCH */
1626    NULL,        /* RETRO_LANGUAGE_PORTUGUESE_BRAZIL */
1627    NULL,        /* RETRO_LANGUAGE_PORTUGUESE_PORTUGAL */
1628    NULL,        /* RETRO_LANGUAGE_RUSSIAN */
1629    NULL,        /* RETRO_LANGUAGE_KOREAN */
1630    NULL,        /* RETRO_LANGUAGE_CHINESE_TRADITIONAL */
1631    NULL,        /* RETRO_LANGUAGE_CHINESE_SIMPLIFIED */
1632    NULL,        /* RETRO_LANGUAGE_ESPERANTO */
1633    NULL,        /* RETRO_LANGUAGE_POLISH */
1634    NULL,        /* RETRO_LANGUAGE_VIETNAMESE */
1635    NULL,        /* RETRO_LANGUAGE_ARABIC */
1636    NULL,        /* RETRO_LANGUAGE_GREEK */
1637    &options_tr, /* RETRO_LANGUAGE_TURKISH */
1638 };
1639 #endif
1640
1641 /*
1642  ********************************
1643  * Functions
1644  ********************************
1645 */
1646
1647 /* Handles configuration/setting of core options.
1648  * Should be called as early as possible - ideally inside
1649  * retro_set_environment(), and no later than retro_load_game()
1650  * > We place the function body in the header to avoid the
1651  *   necessity of adding more .c files (i.e. want this to
1652  *   be as painless as possible for core devs)
1653  */
1654
1655 static INLINE void libretro_set_core_options(retro_environment_t environ_cb,
1656       bool *categories_supported)
1657 {
1658    unsigned version  = 0;
1659 #ifndef HAVE_NO_LANGEXTRA
1660    unsigned language = 0;
1661 #endif
1662
1663    if (!environ_cb || !categories_supported)
1664       return;
1665
1666    *categories_supported = false;
1667
1668    if (!environ_cb(RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION, &version))
1669       version = 0;
1670
1671    if (version >= 2)
1672    {
1673 #ifndef HAVE_NO_LANGEXTRA
1674       struct retro_core_options_v2_intl core_options_intl;
1675
1676       core_options_intl.us    = &options_us;
1677       core_options_intl.local = NULL;
1678
1679       if (environ_cb(RETRO_ENVIRONMENT_GET_LANGUAGE, &language) &&
1680           (language < RETRO_LANGUAGE_LAST) && (language != RETRO_LANGUAGE_ENGLISH))
1681          core_options_intl.local = options_intl[language];
1682
1683       *categories_supported = environ_cb(RETRO_ENVIRONMENT_SET_CORE_OPTIONS_V2_INTL,
1684             &core_options_intl);
1685 #else
1686       *categories_supported = environ_cb(RETRO_ENVIRONMENT_SET_CORE_OPTIONS_V2,
1687             &options_us);
1688 #endif
1689    }
1690    else
1691    {
1692       size_t i, j;
1693       size_t option_index              = 0;
1694       size_t num_options               = 0;
1695       struct retro_core_option_definition
1696             *option_v1_defs_us         = NULL;
1697 #ifndef HAVE_NO_LANGEXTRA
1698       size_t num_options_intl          = 0;
1699       struct retro_core_option_v2_definition
1700             *option_defs_intl          = NULL;
1701       struct retro_core_option_definition
1702             *option_v1_defs_intl       = NULL;
1703       struct retro_core_options_intl
1704             core_options_v1_intl;
1705 #endif
1706       struct retro_variable *variables = NULL;
1707       char **values_buf                = NULL;
1708
1709       /* Determine total number of options */
1710       while (true)
1711       {
1712          if (option_defs_us[num_options].key)
1713             num_options++;
1714          else
1715             break;
1716       }
1717
1718       if (version >= 1)
1719       {
1720          /* Allocate US array */
1721          option_v1_defs_us = (struct retro_core_option_definition *)
1722                calloc(num_options + 1, sizeof(struct retro_core_option_definition));
1723
1724          /* Copy parameters from option_defs_us array */
1725          for (i = 0; i < num_options; i++)
1726          {
1727             struct retro_core_option_v2_definition *option_def_us = &option_defs_us[i];
1728             struct retro_core_option_value *option_values         = option_def_us->values;
1729             struct retro_core_option_definition *option_v1_def_us = &option_v1_defs_us[i];
1730             struct retro_core_option_value *option_v1_values      = option_v1_def_us->values;
1731
1732             option_v1_def_us->key           = option_def_us->key;
1733             option_v1_def_us->desc          = option_def_us->desc;
1734             option_v1_def_us->info          = option_def_us->info;
1735             option_v1_def_us->default_value = option_def_us->default_value;
1736
1737             /* Values must be copied individually... */
1738             while (option_values->value)
1739             {
1740                option_v1_values->value = option_values->value;
1741                option_v1_values->label = option_values->label;
1742
1743                option_values++;
1744                option_v1_values++;
1745             }
1746          }
1747
1748 #ifndef HAVE_NO_LANGEXTRA
1749          if (environ_cb(RETRO_ENVIRONMENT_GET_LANGUAGE, &language) &&
1750              (language < RETRO_LANGUAGE_LAST) && (language != RETRO_LANGUAGE_ENGLISH) &&
1751              options_intl[language])
1752             option_defs_intl = options_intl[language]->definitions;
1753
1754          if (option_defs_intl)
1755          {
1756             /* Determine number of intl options */
1757             while (true)
1758             {
1759                if (option_defs_intl[num_options_intl].key)
1760                   num_options_intl++;
1761                else
1762                   break;
1763             }
1764
1765             /* Allocate intl array */
1766             option_v1_defs_intl = (struct retro_core_option_definition *)
1767                   calloc(num_options_intl + 1, sizeof(struct retro_core_option_definition));
1768
1769             /* Copy parameters from option_defs_intl array */
1770             for (i = 0; i < num_options_intl; i++)
1771             {
1772                struct retro_core_option_v2_definition *option_def_intl = &option_defs_intl[i];
1773                struct retro_core_option_value *option_values           = option_def_intl->values;
1774                struct retro_core_option_definition *option_v1_def_intl = &option_v1_defs_intl[i];
1775                struct retro_core_option_value *option_v1_values        = option_v1_def_intl->values;
1776
1777                option_v1_def_intl->key           = option_def_intl->key;
1778                option_v1_def_intl->desc          = option_def_intl->desc;
1779                option_v1_def_intl->info          = option_def_intl->info;
1780                option_v1_def_intl->default_value = option_def_intl->default_value;
1781
1782                /* Values must be copied individually... */
1783                while (option_values->value)
1784                {
1785                   option_v1_values->value = option_values->value;
1786                   option_v1_values->label = option_values->label;
1787
1788                   option_values++;
1789                   option_v1_values++;
1790                }
1791             }
1792          }
1793
1794          core_options_v1_intl.us    = option_v1_defs_us;
1795          core_options_v1_intl.local = option_v1_defs_intl;
1796
1797          environ_cb(RETRO_ENVIRONMENT_SET_CORE_OPTIONS_INTL, &core_options_v1_intl);
1798 #else
1799          environ_cb(RETRO_ENVIRONMENT_SET_CORE_OPTIONS, option_v1_defs_us);
1800 #endif
1801       }
1802       else
1803       {
1804          /* Allocate arrays */
1805          variables  = (struct retro_variable *)calloc(num_options + 1,
1806                sizeof(struct retro_variable));
1807          values_buf = (char **)calloc(num_options, sizeof(char *));
1808
1809          if (!variables || !values_buf)
1810             goto error;
1811
1812          /* Copy parameters from option_defs_us array */
1813          for (i = 0; i < num_options; i++)
1814          {
1815             const char *key                        = option_defs_us[i].key;
1816             const char *desc                       = option_defs_us[i].desc;
1817             const char *default_value              = option_defs_us[i].default_value;
1818             struct retro_core_option_value *values = option_defs_us[i].values;
1819             size_t buf_len                         = 3;
1820             size_t default_index                   = 0;
1821
1822             values_buf[i] = NULL;
1823
1824             /* Skip options that are irrelevant when using the
1825              * old style core options interface */
1826             if ((strcmp(key, "pcsx_rearmed_show_input_settings") == 0) ||
1827                 (strcmp(key, "pcsx_rearmed_show_gpu_peops_settings") == 0) ||
1828                 (strcmp(key, "pcsx_rearmed_show_gpu_unai_settings") == 0))
1829                continue;
1830
1831             if (desc)
1832             {
1833                size_t num_values = 0;
1834
1835                /* Determine number of values */
1836                while (true)
1837                {
1838                   if (values[num_values].value)
1839                   {
1840                      /* Check if this is the default value */
1841                      if (default_value)
1842                         if (strcmp(values[num_values].value, default_value) == 0)
1843                            default_index = num_values;
1844
1845                      buf_len += strlen(values[num_values].value);
1846                      num_values++;
1847                   }
1848                   else
1849                      break;
1850                }
1851
1852                /* Build values string */
1853                if (num_values > 0)
1854                {
1855                   buf_len += num_values - 1;
1856                   buf_len += strlen(desc);
1857
1858                   values_buf[i] = (char *)calloc(buf_len, sizeof(char));
1859                   if (!values_buf[i])
1860                      goto error;
1861
1862                   strcpy(values_buf[i], desc);
1863                   strcat(values_buf[i], "; ");
1864
1865                   /* Default value goes first */
1866                   strcat(values_buf[i], values[default_index].value);
1867
1868                   /* Add remaining values */
1869                   for (j = 0; j < num_values; j++)
1870                   {
1871                      if (j != default_index)
1872                      {
1873                         strcat(values_buf[i], "|");
1874                         strcat(values_buf[i], values[j].value);
1875                      }
1876                   }
1877                }
1878             }
1879
1880             variables[option_index].key   = key;
1881             variables[option_index].value = values_buf[i];
1882             option_index++;
1883          }
1884
1885          /* Set variables */
1886          environ_cb(RETRO_ENVIRONMENT_SET_VARIABLES, variables);
1887       }
1888
1889 error:
1890       /* Clean up */
1891
1892       if (option_v1_defs_us)
1893       {
1894          free(option_v1_defs_us);
1895          option_v1_defs_us = NULL;
1896       }
1897
1898 #ifndef HAVE_NO_LANGEXTRA
1899       if (option_v1_defs_intl)
1900       {
1901          free(option_v1_defs_intl);
1902          option_v1_defs_intl = NULL;
1903       }
1904 #endif
1905
1906       if (values_buf)
1907       {
1908          for (i = 0; i < num_options; i++)
1909          {
1910             if (values_buf[i])
1911             {
1912                free(values_buf[i]);
1913                values_buf[i] = NULL;
1914             }
1915          }
1916
1917          free(values_buf);
1918          values_buf = NULL;
1919       }
1920
1921       if (variables)
1922       {
1923          free(variables);
1924          variables = NULL;
1925       }
1926    }
1927 }
1928
1929 #ifdef __cplusplus
1930 }
1931 #endif
1932
1933 #endif