libretro/beetle-psx-libretro
1
0
Fork 0
mirror of https://github.com/libretro/beetle-psx-libretro.git synced 2024-11-27 19:00:35 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
56e5cbcef9
beetle-psx-libretro/libretro_core_options.h
ggdrt dec5afe8e2 Rewrite core option sublabels
2019-12-06 09:04:18 -08:00

1098 lines
39 KiB
C
Raw Blame History

#ifndef LIBRETRO_CORE_OPTIONS_H__
#define LIBRETRO_CORE_OPTIONS_H__
#include <stdlib.h>
#include <string.h>
#include <libretro.h>
#include <retro_inline.h>
#ifndef HAVE_NO_LANGEXTRA
#include "libretro_core_options_intl.h"
#endif
#include "libretro_options.h"
/*
********************************
* VERSION: 1.3
********************************
*
* - 1.3: Move translations to libretro_core_options_intl.h
* - libretro_core_options_intl.h includes BOM and utf-8
* fix for MSVC 2010-2013
* - Added HAVE_NO_LANGEXTRA flag to disable translations
* on platforms/compilers without BOM support
* - 1.2: Use core options v1 interface when
* RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION is >= 1
* (previously required RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION == 1)
* - 1.1: Support generation of core options v0 retro_core_option_value
* arrays containing options with a single value
* - 1.0: First commit
*/
#ifdef __cplusplus
extern "C" {
#endif
/*
********************************
* Core Option Definitions
********************************
*/
/* RETRO_LANGUAGE_ENGLISH */
/* Default language:
* - All other languages must include the same keys and values
* - Will be used as a fallback in the event that frontend language
* is not available
* - Will be used as a fallback for any missing entries in
* frontend language definition */
struct retro_core_option_definition option_defs_us[] = {
#if defined(HAVE_OPENGL) || defined(HAVE_OPENGLES) || defined(HAVE_VULKAN)
{
BEETLE_OPT(renderer),
"Renderer (Restart)",
"Choose video renderer. The software renderer is the most accurate but has steep performance requirements when running at increased internal GPU resolutions. The hardware renderers, while less accurate, improve performance over the software renderer at increased internal resolutions and enable various graphical enhancements. 'Hardware' automatically selects the Vulkan or OpenGL renderer depending upon the current libretro frontend video driver. If the provided video driver is not Vulkan or OpenGL 3.3-compatible then the core will fall back to the software renderer.",
{
{ "hardware", "Hardware" },
{ "software", "Software" },
{ NULL, NULL },
},
"hardware"
},
{
BEETLE_OPT(renderer_software_fb),
"Software Framebuffer",
"Enable accurate emulation of framebuffer effects (e.g. motion blur, FF7 battle swirl) when using hardware renderers by running a copy of the software renderer at native resolution in the background. If disabled, these operations are omitted (OpenGL) or rendered on the GPU (Vulkan). Disabling can improve performance but may cause severe graphical errors. Leave enabled if unsure.",
{
{ "enabled", NULL },
{ "disabled", NULL },
{ NULL, NULL },
},
"enabled"
},
#endif
{
BEETLE_OPT(internal_resolution),
"Internal GPU Resolution",
"Set internal resolution multiplier. Resolutions higher than '1x (Native)' improve fidelity of 3D models at the expense of increased performance requirements. 2D elements are generally unaffected by this setting.",
{
{ "1x(native)", "1x (Native)" },
{ "2x", NULL },
{ "4x", NULL },
{ "8x", NULL },
{ "16x", NULL },
{ NULL, NULL },
},
"1x(native)"
},
#if defined(HAVE_OPENGL) || defined(HAVE_OPENGLES)
{
BEETLE_OPT(depth),
"Internal Color Depth",
"Set internal color depth. Higher color depth can reduce color banding effects without the use of dithering. 16 bpp emulates original hardware but may have visible banding if dithering is not enabled. 'Dithering Pattern' is recommended to be disabled when this option is set to 32 bpp.",
{
{ "16bpp(native)", "16 bpp (Native)" },
{ "32bpp", "32 bpp" },
{ NULL, NULL },
},
"16bpp(native)"
},
// Sort of, it's more like 15-bit high color and 24-bit true color for visible output. The alpha channel is used for mask bit. Vulkan renderer uses ABGR1555_555 for 31 bits internal? FMVs are always 24-bit on all renderers like original hardware (BGR888, no alpha)
#endif
{
BEETLE_OPT(dither_mode),
"Dithering Pattern",
"Set dithering pattern configuration. '1x (Native)' emulates native low resolution dithering used by original hardware to smooth out color banding artefacts visible at native color depth. 'Internal Resolution' scales dithering granularity to the configured internal resolution for cleaner results. Recommended to be disabled when running at 32 bpp color depth. Note: On Vulkan, enabling this will force downsampling to native color depth while disabling will automatically enable output at higher color depth.",
{
{ "1x(native)", "1x (Native)" },
{ "internal resolution", "Internal Resolution" },
{ "disabled", NULL },
{ NULL, NULL },
},
"1x(native)"
},
#if defined(HAVE_OPENGL) || defined(HAVE_OPENGLES) || defined(HAVE_VULKAN)
{
BEETLE_OPT(filter),
"Texture Filtering",
"Select texture filtering method. 'Nearest' emulates original hardware. 'Bilinear' and '3-Point' are smoothing filters, which reduce pixelation via blurring. 'SABR', 'xBR', and 'JINC2' are upscaling filters that may improve texture fidelity/sharpness at the expense of increased performance requirements. Only supported by the hardware renderers.",
{
{ "nearest", "Nearest" },
{ "SABR", NULL },
{ "xBR", NULL },
{ "bilinear", "Bilinear" },
{ "3-point", "3-Point" },
{ "JINC2", NULL },
{ NULL, NULL },
},
"nearest"
},
#endif
#ifdef HAVE_VULKAN
{
BEETLE_OPT(adaptive_smoothing),
"Adaptive Smoothing",
"When enabled, smooths 2D artwork and UI elements without blurring 3D rendered objects. Only supported by the Vulkan renderer.",
{
{ "enabled", NULL },
{ "disabled", NULL },
{ NULL, NULL },
},
"enabled"
},
{
BEETLE_OPT(super_sampling),
"Supersampling (Downsample to Native Resolution)",
"When enabled, downsamples rendered content from upscaled internal resolution down to native resolution. Combining this with higher internal resolution multipliers allows for games to be displayed with anti-aliased 3D objects at native low resolution. Produces best results when applied to titles that mix 2D and 3D elements (e.g. 3D characters on pre-rendered backgrounds), and works well in conjunction with CRT shaders. Only supported by the Vulkan renderer. Note: 'Dithering Pattern' is recommended to be disabled when enabling this option.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(msaa),
"Multi-Sampled Anti Aliasing",
"Set MSAA level for rendered content. Improves the appearance of 3D objects. Only supported by the Vulkan renderer.",
{
{ "1x", "1x (Default)" },
{ "2x", NULL },
{ "4x", NULL },
{ "8x", NULL },
{ "16x", NULL },
{ NULL, NULL },
},
"1x"
},
{
BEETLE_OPT(mdec_yuv),
"MDEC YUV Chroma Filter",
"Improves the quality of FMV playback by reducing 'macroblocking' artefacts (squares/jagged edges). Only supported by the Vulkan renderer.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
#endif
#if defined(HAVE_OPENGL) || defined(HAVE_OPENGLES)
{
BEETLE_OPT(wireframe),
"Wireframe Mode (Debug)",
"When enabled, renders 3D models in outline form without textures or shading. Only supported by the OpenGL hardware renderer. Note: This is for debugging purposes, and should normally be disabled.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(display_vram),
"Display Full VRAM (Debug)",
"When enabled, visualises the entire emulated console's VRAM. Only supported by the OpenGL hardware renderer. Note: This is for debugging purposes, and should normally be disabled.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
#endif
{
BEETLE_OPT(pgxp_mode),
"PGXP Operation Mode",
"Allows 3D objects to be rendered with subpixel precision, minimizing distortion and jitter of 3D objects seen on original hardware due to the usage of fixed point vertex coordinates. 'Memory Only' mode has minimal compatibility issues and is recommended for general use. 'Memory + CPU (Buggy)' mode can reduce jitter even further but has high performance requirements and may cause various geometry errors.",
{
{ "disabled", NULL },
{ "memory only", "Memory Only" },
{ "memory + CPU", "Memory + CPU (Buggy)" },
{ NULL, NULL },
},
"disabled"
},
#if defined(HAVE_OPENGL) || defined(HAVE_OPENGLES) || defined(HAVE_VULKAN)
{
BEETLE_OPT(pgxp_vertex),
"PGXP Vertex Cache",
"Allows PGXP-enhanced vertex positions to be cached for re-use across polygon draws. Can potentially improve object alignment and reduce visible seams when rendering textures, but false positives when querying the cache may produce graphical glitches. It is currently recommended to leave this option disabled. This option is applied only when PGXP Operation Mode is enabled. Only supported by the hardware renderers.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(pgxp_texture),
"PGXP Perspective Correct Texturing",
"When enabled, replaces native PSX affine texture mapping with perspective correct texture mapping. Eliminates position-dependent distortion and warping of textures, resulting in properly aligned textures. This option is applied only when PGXP Operation Mode is enabled. Only supported by the hardware renderers.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
#endif
{
BEETLE_OPT(display_internal_fps),
"Display Internal FPS",
"Display the internal frame rate at which the emulated PlayStation system is rendering content. Note: Requires onscreen notifications to be enabled in the libretro frontend.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(lineRender),
"Line-to-Quad Hack",
"Choose line-to-quad hack method. Some games (e.g. Doom, Hexen, Soul Blade, etc) draw horizontal lines by stretching single-pixel-high triangles across the screen, which are rasterized as a row of pixels on original hardware. This hack detects these small triangles and converts them to quads as required, allowing them to be displayed properly on the hardware renderers and at upscaled internal resolutions. 'Aggressive' is required for some titles (e.g. Dark Forces, Duke Nukem) but may otherwise introduce graphical glitches. Leave at 'Default' if unsure.",
{
{ "default", "Default" },
{ "aggressive", "Aggressive" },
{ "disabled", NULL },
{ NULL, NULL },
},
"default"
},
{
BEETLE_OPT(frame_duping),
"Frame Duping (Speedup)",
"When enabled and supported by the libretro frontend, provides a small performance increase by directing the frontend to repeat the previous frame if the core has nothing new to display.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(cpu_freq_scale),
"CPU Frequency Scaling (Overclock)",
"Enable overclocking (or underclocking) of the emulated PSX CPU. Overclocking can eliminate slowdown and improve frame rates in certain games at the expense of increased performance requirements. Note that some games have an internal frame rate limiter and may not benefit from overclocking. May cause certain effects to animate faster than intended in some titles when overclocked.",
{
{ "50%", NULL },
{ "60%", NULL },
{ "70%", NULL },
{ "80%", NULL },
{ "90%", NULL },
{ "100%(native)", "100% (Native)" },
{ "110%", NULL },
{ "120%", NULL },
{ "130%", NULL },
{ "140%", NULL },
{ "150%", NULL },
{ "160%", NULL },
{ "170%", NULL },
{ "180%", NULL },
{ "190%", NULL },
{ "200%", NULL },
{ "210%", NULL },
{ "220%", NULL },
{ "230%", NULL },
{ "240%", NULL },
{ "250%", NULL },
{ "260%", NULL },
{ "270%", NULL },
{ "280%", NULL },
{ "290%", NULL },
{ "300%", NULL },
{ "310%", NULL },
{ "320%", NULL },
{ "330%", NULL },
{ "340%", NULL },
{ "350%", NULL },
{ "360%", NULL },
{ "370%", NULL },
{ "380%", NULL },
{ "390%", NULL },
{ "400%", NULL },
{ "410%", NULL },
{ "420%", NULL },
{ "430%", NULL },
{ "440%", NULL },
{ "450%", NULL },
{ "460%", NULL },
{ "470%", NULL },
{ "480%", NULL },
{ "490%", NULL },
{ "500%", NULL },
{ NULL, NULL },
},
"100%(native)"
},
{
BEETLE_OPT(gte_overclock),
"GTE Overclock",
"When enabled, lowers all emulated GTE (CPU coprocessor for 3D graphics) operations to a constant one-cycle latency. For games that make heavy use of the GTE, this can greatly improve frame rate and frame time stability.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(gpu_overclock),
"GPU Rasterizer Overclock",
"Enable overclocking of the 2D rasterizer contained within the emulated PSX's GPU. Does not improve 3D rendering, and in general has little effect.",
{
{ "1x(native)", "1x (Native)" },
{ "2x", NULL },
{ "4x", NULL },
{ "8x", NULL },
{ "16x", NULL },
{ "32x", NULL },
{ NULL, NULL },
},
"1x(native)"
},
{
BEETLE_OPT(skip_bios),
"Skip BIOS",
"Skips the PlayStation BIOS boot animation normally displayed when loading content. Note: Enabling this causes compatibility issues with a number of games (PAL copy protected games, Saga Frontier, etc).",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(widescreen_hack),
"Widescreen Mode Hack",
"When enabled, renders 3D content anamorphically and outputs the emulated framebuffer at a widescreen aspect ratio. Produces best results with fully 3D games. 2D elements will be horizontally stretched and may be misaligned.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(crop_overscan),
"Crop Horizontal Overscan",
"By default, the renderers add horizontal padding (pillarboxes on either side of the image) to emulate the same black bars generated in analog video output by real PSX hardware. Enabling this option removes horizontal padding.",
{
{ "enabled", NULL },
{ "disabled", NULL },
{ NULL, NULL },
},
"enabled"
},
{
BEETLE_OPT(image_crop),
"Additional Cropping",
"When 'Crop Horizontal Overscan' is enabled, this option further reduces the width of the cropped image by the specified number of pixels. Only supported by the software renderer.",
{
{ "disabled", NULL },
{ "1px", NULL },
{ "2px", NULL },
{ "3px", NULL },
{ "4px", NULL },
{ "5px", NULL },
{ "6px", NULL },
{ "7px", NULL },
{ "8px", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(image_offset),
"Offset Cropped Image",
"When 'Crop Horizontal Overscan' is enabled, allows the resultant cropped image to be offset horizontally to the right (positive) or left (negative) by the specified number of pixels. May be used to correct alignment issues. Only supported by the software renderer.",
{
{ "disabled", NULL },
{ "-4px", NULL },
{ "-3px", NULL },
{ "-2px", NULL },
{ "-1px", NULL },
{ "+1px", NULL },
{ "+2px", NULL },
{ "+3px", NULL },
{ "+4px", NULL },
{ NULL, NULL },
},
"disabled"
},
#if defined(HAVE_OPENGL) || defined(HAVE_OPENGLES) || defined(HAVE_VULKAN)
{
BEETLE_OPT(image_offset_cycles),
"Horizontal Image Offset (GPU Cycles)",
"Specify number of GPU cycles to offset image by. Positive values move image to the right, negative values move image to the left. Only supported by the hardware renderers.",
{
{ "-24", NULL },
{ "-23", NULL },
{ "-22", NULL },
{ "-21", NULL },
{ "-20", NULL },
{ "-19", NULL },
{ "-18", NULL },
{ "-17", NULL },
{ "-16", NULL },
{ "-15", NULL },
{ "-14", NULL },
{ "-13", NULL },
{ "-12", NULL },
{ "-11", NULL },
{ "-10", NULL },
{ "-9", NULL },
{ "-8", NULL },
{ "-7", NULL },
{ "-6", NULL },
{ "-5", NULL },
{ "-4", NULL },
{ "-3", NULL },
{ "-2", NULL },
{ "-1", NULL },
{ "0", NULL },
{ "+1", NULL },
{ "+2", NULL },
{ "+3", NULL },
{ "+4", NULL },
{ "+5", NULL },
{ "+6", NULL },
{ "+7", NULL },
{ "+8", NULL },
{ "+9", NULL },
{ "+10", NULL },
{ "+11", NULL },
{ "+12", NULL },
{ "+13", NULL },
{ "+14", NULL },
{ "+15", NULL },
{ "+16", NULL },
{ "+17", NULL },
{ "+18", NULL },
{ "+19", NULL },
{ "+20", NULL },
{ "+21", NULL },
{ "+22", NULL },
{ "+23", NULL },
{ "+24", NULL },
{ NULL, NULL},
},
"0"
},
#endif
{
BEETLE_OPT(initial_scanline),
"Initial Scanline - NTSC",
"Select the first displayed scanline when running NTSC content. Setting a value greater than zero will reduce the height of output images by cropping pixels from the topmost edge. May be used to counteract letterboxing. Requires restart for software renderer.",
{
{ "0", NULL },
{ "1", NULL },
{ "2", NULL },
{ "3", NULL },
{ "4", NULL },
{ "5", NULL },
{ "6", NULL },
{ "7", NULL },
{ "8", NULL },
{ "9", NULL },
{ "10", NULL },
{ "11", NULL },
{ "12", NULL },
{ "13", NULL },
{ "14", NULL },
{ "15", NULL },
{ "16", NULL },
{ "17", NULL },
{ "18", NULL },
{ "19", NULL },
{ "20", NULL },
{ "21", NULL },
{ "22", NULL },
{ "23", NULL },
{ "24", NULL },
{ "25", NULL },
{ "26", NULL },
{ "27", NULL },
{ "28", NULL },
{ "29", NULL },
{ "30", NULL },
{ "31", NULL },
{ "32", NULL },
{ "33", NULL },
{ "34", NULL },
{ "35", NULL },
{ "36", NULL },
{ "37", NULL },
{ "38", NULL },
{ "39", NULL },
{ "40", NULL },
{ NULL, NULL },
},
"0"
},
{
BEETLE_OPT(last_scanline),
"Last Scanline - NTSC",
"Select the last displayed scanline when running NTSC content. Setting a value less than 239 will reduce the height of output images by cropping pixels from the bottommost edge. May be used to counteract letterboxing. Requires restart for software renderer.",
{
{ "210", NULL },
{ "211", NULL },
{ "212", NULL },
{ "213", NULL },
{ "214", NULL },
{ "215", NULL },
{ "216", NULL },
{ "217", NULL },
{ "218", NULL },
{ "219", NULL },
{ "220", NULL },
{ "221", NULL },
{ "222", NULL },
{ "223", NULL },
{ "224", NULL },
{ "225", NULL },
{ "226", NULL },
{ "227", NULL },
{ "228", NULL },
{ "229", NULL },
{ "230", NULL },
{ "231", NULL },
{ "232", NULL },
{ "233", NULL },
{ "234", NULL },
{ "235", NULL },
{ "236", NULL },
{ "237", NULL },
{ "238", NULL },
{ "239", NULL },
{ NULL, NULL },
},
"239"
},
{
BEETLE_OPT(initial_scanline_pal),
"Initial Scanline - PAL",
"Select the first displayed scanline when running PAL content. Setting a value greater than zero will reduce the height of output images by cropping pixels from the topmost edge. May be used to counteract letterboxing. Requires restart for software renderer.",
{
{ "0", NULL },
{ "1", NULL },
{ "2", NULL },
{ "3", NULL },
{ "4", NULL },
{ "5", NULL },
{ "6", NULL },
{ "7", NULL },
{ "8", NULL },
{ "9", NULL },
{ "10", NULL },
{ "11", NULL },
{ "12", NULL },
{ "13", NULL },
{ "14", NULL },
{ "15", NULL },
{ "16", NULL },
{ "17", NULL },
{ "18", NULL },
{ "19", NULL },
{ "20", NULL },
{ "21", NULL },
{ "22", NULL },
{ "23", NULL },
{ "24", NULL },
{ "25", NULL },
{ "26", NULL },
{ "27", NULL },
{ "28", NULL },
{ "29", NULL },
{ "30", NULL },
{ "31", NULL },
{ "32", NULL },
{ "33", NULL },
{ "34", NULL },
{ "35", NULL },
{ "36", NULL },
{ "37", NULL },
{ "38", NULL },
{ "39", NULL },
{ "40", NULL },
{ NULL, NULL },
},
"0"
},
{
BEETLE_OPT(last_scanline_pal),
"Last Scanline - PAL",
"Select the last displayed scanline when running PAL content. Setting a value less than 287 will reduce the height of output images by cropping pixels from the bottommost edge. May be used to counteract letterboxing. Requires restart for software renderer.",
{
{ "230", NULL },
{ "231", NULL },
{ "232", NULL },
{ "233", NULL },
{ "234", NULL },
{ "235", NULL },
{ "236", NULL },
{ "237", NULL },
{ "238", NULL },
{ "239", NULL },
{ "240", NULL },
{ "241", NULL },
{ "242", NULL },
{ "243", NULL },
{ "244", NULL },
{ "245", NULL },
{ "246", NULL },
{ "247", NULL },
{ "248", NULL },
{ "249", NULL },
{ "250", NULL },
{ "251", NULL },
{ "252", NULL },
{ "253", NULL },
{ "254", NULL },
{ "255", NULL },
{ "256", NULL },
{ "257", NULL },
{ "258", NULL },
{ "259", NULL },
{ "260", NULL },
{ "261", NULL },
{ "262", NULL },
{ "263", NULL },
{ "264", NULL },
{ "265", NULL },
{ "266", NULL },
{ "267", NULL },
{ "268", NULL },
{ "269", NULL },
{ "270", NULL },
{ "271", NULL },
{ "272", NULL },
{ "273", NULL },
{ "274", NULL },
{ "275", NULL },
{ "276", NULL },
{ "277", NULL },
{ "278", NULL },
{ "279", NULL },
{ "280", NULL },
{ "281", NULL },
{ "282", NULL },
{ "283", NULL },
{ "284", NULL },
{ "285", NULL },
{ "286", NULL },
{ "287", NULL },
{ NULL, NULL },
},
"287"
},
#ifndef EMSCRIPTEN
{
BEETLE_OPT(cd_access_method),
"CD Access Method (Restart)",
"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' loads the entire disk image into memory when launching content which may improve in-game loading times at the cost of an initial delay at startup. 'Pre-Cache' may cause issues on systems with low RAM.",
{
{ "sync", "Synchronous" },
{ "async", "Asynchronous" },
{ "precache", "Pre-Cache" },
{ NULL, NULL },
},
"sync"
},
#endif
{
BEETLE_OPT(cd_fastload),
"CD Loading Speed",
"Select disk access speed multiplier. Setting this higher than '2x (Native)' can greatly reduce in-game loading times, but may introduce timing errors. Some games may not function properly if this option is increased above a certain value.",
{
{ "2x(native)", "2x (Native)" },
{ "4x", NULL },
{ "6x", NULL },
{ "8x", NULL },
{ "10x", NULL },
{ "12x", NULL },
{ "14x", NULL },
{ NULL, NULL },
},
"2x(native)"
},
{
BEETLE_OPT(use_mednafen_memcard0_method),
"Memory Card 0 Method (Restart)",
"Choose the save data format used for memory card 0. 'Libretro' is recommended. 'Mednafen' may be used for compatibility with the stand-alone version of Mednafen.",
{
{ "libretro", "Libretro" },
{ "mednafen", "Mednafen" },
{ NULL, NULL },
},
"libretro"
},
{
BEETLE_OPT(enable_memcard1),
"Enable Memory Card 1",
"Select whether to emulate a second memory card in slot 1. When disabled, games can only access the memory card in slot 0. Note: Some games require this option to be disabled for correct operation (e.g. Codename Tenka).",
{
{ "enabled", NULL },
{ "disabled", NULL },
{ NULL, NULL },
},
"enabled"
},
{
BEETLE_OPT(shared_memory_cards),
"Shared Memcards (Restart)",
"When enabled, all games will save to and load from the same memory card files. When disabled, separate memory card files will be generated for each item of loaded content. Note: The 'Memory Card 0 Method' option must be set to 'Mednafen' for correct operation of shared memory cards.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(analog_calibration),
"Analog Self-Calibration",
"When the input device is set to DualShock, Analog Controller, Analog Joystick, or neGcon, this option allows dynamic calibration of analog inputs. Maximum registered input values are monitored in real time and used to scale analog coordinates passed to the emulator. This should be used for games such as Mega Man Legends 2 that expect larger values than what modern controllers provide. For best results, analog sticks should be rotated at full extent to tune the calibration algorithm each time content is loaded.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(analog_toggle),
"Enable DualShock Analog Mode Toggle",
"When the input device type is DualShock, sets whether or not the emulated DualShock can be toggled between DIGITAL and ANALOG mode like original hardware. When this option is disabled, the DualShock is locked to ANALOG mode and when enabled, the DualShock can be toggled between DIGITAL and ANALOG mode by pressing and holding START+SELECT+L1+L2+R1+R2.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(enable_multitap_port1),
"Port 1: Multitap Enable",
"Enables/Disables multitap functionality on port 1.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(enable_multitap_port2),
"Port 2: Multitap Enable",
"Enables/Disables multitap functionality on port 2.",
{
{ "disabled", NULL },
{ "enabled", NULL },
{ NULL, NULL },
},
"disabled"
},
{
BEETLE_OPT(gun_input_mode),
"Gun Input Mode",
"Specify whether to use a mouse-controlled 'Light Gun' or a 'Touchscreen' input when device type is set to 'Guncon / G-Con 45' or 'Justifier'.",
{
{ "lightgun", "Light Gun" },
{ "touchscreen", "Touchscreen" },
{ NULL, NULL },
},
"lightgun"
},
// Shouldn't the gun_input_mode just be Mouse vs. Touchscreen?
{
BEETLE_OPT(gun_cursor),
"Gun Cursor",
"Select the gun cursor to be displayed on screen while using the the 'Guncon / G-Con 45' and 'Justifier' input device types. When disabled, cross hairs are always hidden.",
{
{ "cross", "Cross" },
{ "dot", "Dot" },
{ "off", "disabled" },
{ NULL, NULL },
},
"cross"
},
{
BEETLE_OPT(mouse_sensitivity),
"Mouse Sensitivity",
"Configure the response of the 'Mouse' input device type.",
{
{ "5%", NULL },
{ "10%", NULL },
{ "15%", NULL },
{ "20%", NULL },
{ "25%", NULL },
{ "30%", NULL },
{ "35%", NULL },
{ "40%", NULL },
{ "45%", NULL },
{ "50%", NULL },
{ "55%", NULL },
{ "60%", NULL },
{ "65%", NULL },
{ "70%", NULL },
{ "75%", NULL },
{ "80%", NULL },
{ "85%", NULL },
{ "90%", NULL },
{ "95%", NULL },
{ "100%", NULL },
{ "105%", NULL },
{ "110%", NULL },
{ "115%", NULL },
{ "120%", NULL },
{ "125%", NULL },
{ "130%", NULL },
{ "135%", NULL },
{ "140%", NULL },
{ "145%", NULL },
{ "150%", NULL },
{ "155%", NULL },
{ "160%", NULL },
{ "165%", NULL },
{ "170%", NULL },
{ "175%", NULL },
{ "180%", NULL },
{ "185%", NULL },
{ "190%", NULL },
{ "195%", NULL },
{ "200%", NULL },
{ NULL, NULL },
},
"100%"
},
{
BEETLE_OPT(negcon_response),
"NegCon Twist Response",
"Specifies the response of the RetroPad left analog stick when simulating the 'twist' action of emulated 'neGcon' input devices. Analog stick displacement may be mapped to negCon rotation angle either linearly, quadratically or cubically. 'Quadratic' allows for greater precision than 'Linear' when making small movements. 'Cubic' further increases small movement precision, but 'exaggerates' larger movements. Note: 'Linear' is only recommended when using racing wheel peripherals. Conventional gamepads implement analog input in a manner fundamentally different from the neGcon 'twist' mechanism, such that linear mapping over-amplifies small movements, impairing fine control. In most cases, 'Quadratic' provides the closest approximation of real hardware.",
{
{ "linear", "Linear" },
{ "quadratic", "Quadratic" },
{ "cubic", "Cubic" },
{ NULL, NULL },
},
"linear"
},
{
BEETLE_OPT(negcon_deadzone),
"NegCon Twist Deadzone",
"Sets the deadzone of the RetroPad left analog stick when simulating the 'twist' action of emulated 'neGcon' input devices. Used to eliminate controller drift. Note: Most negCon-compatible titles provide in-game options for setting a 'twist' deadzone value. To avoid loss of precision, the in-game deadzone should *always* be set to zero. Any required adjustments should *only* be applied via this core option. This is particularly important when 'NegCon Twist Response' is set to 'Quadratic' or 'Cubic'.",
{
{ "0%", NULL },
{ "5%", NULL },
{ "10%", NULL },
{ "15%", NULL },
{ "20%", NULL },
{ "25%", NULL },
{ "30%", NULL },
{ NULL, NULL },
},
"0%"
},
{ NULL, NULL, NULL, {{0}}, NULL },
};
/*
********************************
* Language Mapping
********************************
*/
#ifndef HAVE_NO_LANGEXTRA
struct retro_core_option_definition *option_defs_intl[RETRO_LANGUAGE_LAST] = {
option_defs_us, /* RETRO_LANGUAGE_ENGLISH */
NULL, /* RETRO_LANGUAGE_JAPANESE */
NULL, /* RETRO_LANGUAGE_FRENCH */
NULL, /* RETRO_LANGUAGE_SPANISH */
NULL, /* RETRO_LANGUAGE_GERMAN */
NULL, /* RETRO_LANGUAGE_ITALIAN */
NULL, /* RETRO_LANGUAGE_DUTCH */
NULL, /* RETRO_LANGUAGE_PORTUGUESE_BRAZIL */
NULL, /* RETRO_LANGUAGE_PORTUGUESE_PORTUGAL */
NULL, /* RETRO_LANGUAGE_RUSSIAN */
NULL, /* RETRO_LANGUAGE_KOREAN */
NULL, /* RETRO_LANGUAGE_CHINESE_TRADITIONAL */
NULL, /* RETRO_LANGUAGE_CHINESE_SIMPLIFIED */
NULL, /* RETRO_LANGUAGE_ESPERANTO */
NULL, /* RETRO_LANGUAGE_POLISH */
NULL, /* RETRO_LANGUAGE_VIETNAMESE */
NULL, /* RETRO_LANGUAGE_ARABIC */
NULL, /* RETRO_LANGUAGE_GREEK */
NULL, /* RETRO_LANGUAGE_TURKISH */
};
#endif
/*
********************************
* Functions
********************************
*/
/* Handles configuration/setting of core options.
* Should be called as early as possible - ideally inside
* retro_set_environment(), and no later than retro_load_game()
* > We place the function body in the header to avoid the
* necessity of adding more .c files (i.e. want this to
* be as painless as possible for core devs)
*/
static INLINE void libretro_set_core_options(retro_environment_t environ_cb)
{
unsigned version = 0;
if (!environ_cb)
return;
if (environ_cb(RETRO_ENVIRONMENT_GET_CORE_OPTIONS_VERSION, &version) && (version >= 1))
{
#ifndef HAVE_NO_LANGEXTRA
struct retro_core_options_intl core_options_intl;
unsigned language = 0;
core_options_intl.us = option_defs_us;
core_options_intl.local = NULL;
if (environ_cb(RETRO_ENVIRONMENT_GET_LANGUAGE, &language) &&
(language < RETRO_LANGUAGE_LAST) && (language != RETRO_LANGUAGE_ENGLISH))
core_options_intl.local = option_defs_intl[language];
environ_cb(RETRO_ENVIRONMENT_SET_CORE_OPTIONS_INTL, &core_options_intl);
#else
environ_cb(RETRO_ENVIRONMENT_SET_CORE_OPTIONS, &option_defs_us);
#endif
}
else
{
size_t i;
size_t num_options = 0;
struct retro_variable *variables = NULL;
char **values_buf = NULL;
/* Determine number of options */
while (true)
{
if (option_defs_us[num_options].key)
num_options++;
else
break;
}
/* Allocate arrays */
variables = (struct retro_variable *)calloc(num_options + 1, sizeof(struct retro_variable));
values_buf = (char **)calloc(num_options, sizeof(char *));
if (!variables || !values_buf)
goto error;
/* Copy parameters from option_defs_us array */
for (i = 0; i < num_options; i++)
{
const char *key = option_defs_us[i].key;
const char *desc = option_defs_us[i].desc;
const char *default_value = option_defs_us[i].default_value;
struct retro_core_option_value *values = option_defs_us[i].values;
size_t buf_len = 3;
size_t default_index = 0;
values_buf[i] = NULL;
if (desc)
{
size_t num_values = 0;
/* Determine number of values */
while (true)
{
if (values[num_values].value)
{
/* Check if this is the default value */
if (default_value)
if (strcmp(values[num_values].value, default_value) == 0)
default_index = num_values;
buf_len += strlen(values[num_values].value);
num_values++;
}
else
break;
}
/* Build values string */
if (num_values > 0)
{
size_t j;
buf_len += num_values - 1;
buf_len += strlen(desc);
values_buf[i] = (char *)calloc(buf_len, sizeof(char));
if (!values_buf[i])
goto error;
strcpy(values_buf[i], desc);
strcat(values_buf[i], "; ");
/* Default value goes first */
strcat(values_buf[i], values[default_index].value);
/* Add remaining values */
for (j = 0; j < num_values; j++)
{
if (j != default_index)
{
strcat(values_buf[i], "|");
strcat(values_buf[i], values[j].value);
}
}
}
}
variables[i].key = key;
variables[i].value = values_buf[i];
}
/* Set variables */
environ_cb(RETRO_ENVIRONMENT_SET_VARIABLES, variables);
error:
/* Clean up */
if (values_buf)
{
for (i = 0; i < num_options; i++)
{
if (values_buf[i])
{
free(values_buf[i]);
values_buf[i] = NULL;
}
}
free(values_buf);
values_buf = NULL;
}
if (variables)
{
free(variables);
variables = NULL;
}
}
}
#ifdef __cplusplus
}
#endif
#endif
Reference in New Issue View Git Blame Copy Permalink