diff options
Diffstat (limited to 'docs/release/src/emu/emuopts.h')
-rw-r--r-- | docs/release/src/emu/emuopts.h | 404 |
1 files changed, 404 insertions, 0 deletions
diff --git a/docs/release/src/emu/emuopts.h b/docs/release/src/emu/emuopts.h new file mode 100644 index 00000000000..9f1b4b644ec --- /dev/null +++ b/docs/release/src/emu/emuopts.h @@ -0,0 +1,404 @@ +// license:BSD-3-Clause +// copyright-holders:Aaron Giles +/*************************************************************************** + + emuopts.h + + Options file and command line management. + +***************************************************************************/ + +#ifndef MAME_EMU_EMUOPTS_H +#define MAME_EMU_EMUOPTS_H + +#pragma once + +#include "options.h" + +#define OPTION_PRIORITY_CMDLINE OPTION_PRIORITY_HIGH + 1 +// core options +#define OPTION_SYSTEMNAME core_options::unadorned(0) +#define OPTION_SOFTWARENAME core_options::unadorned(1) + +// core configuration options +#define OPTION_READCONFIG "readconfig" +#define OPTION_WRITECONFIG "writeconfig" + +// core search path options +#define OPTION_HOMEPATH "homepath" +#define OPTION_MEDIAPATH "rompath" +#define OPTION_HASHPATH "hashpath" +#define OPTION_SAMPLEPATH "samplepath" +#define OPTION_ARTPATH "artpath" +#define OPTION_CTRLRPATH "ctrlrpath" +#define OPTION_INIPATH "inipath" +#define OPTION_FONTPATH "fontpath" +#define OPTION_CHEATPATH "cheatpath" +#define OPTION_CROSSHAIRPATH "crosshairpath" +#define OPTION_PLUGINSPATH "pluginspath" +#define OPTION_LANGUAGEPATH "languagepath" +#define OPTION_SWPATH "swpath" + +// core directory options +#define OPTION_CFG_DIRECTORY "cfg_directory" +#define OPTION_NVRAM_DIRECTORY "nvram_directory" +#define OPTION_INPUT_DIRECTORY "input_directory" +#define OPTION_STATE_DIRECTORY "state_directory" +#define OPTION_SNAPSHOT_DIRECTORY "snapshot_directory" +#define OPTION_DIFF_DIRECTORY "diff_directory" +#define OPTION_COMMENT_DIRECTORY "comment_directory" + +// core state/playback options +#define OPTION_STATE "state" +#define OPTION_AUTOSAVE "autosave" +#define OPTION_PLAYBACK "playback" +#define OPTION_RECORD "record" +#define OPTION_RECORD_TIMECODE "record_timecode" +#define OPTION_EXIT_AFTER_PLAYBACK "exit_after_playback" +#define OPTION_MNGWRITE "mngwrite" +#define OPTION_AVIWRITE "aviwrite" +#define OPTION_WAVWRITE "wavwrite" +#define OPTION_SNAPNAME "snapname" +#define OPTION_SNAPSIZE "snapsize" +#define OPTION_SNAPVIEW "snapview" +#define OPTION_SNAPBILINEAR "snapbilinear" +#define OPTION_STATENAME "statename" +#define OPTION_BURNIN "burnin" + +// core performance options +#define OPTION_AUTOFRAMESKIP "autoframeskip" +#define OPTION_FRAMESKIP "frameskip" +#define OPTION_SECONDS_TO_RUN "seconds_to_run" +#define OPTION_THROTTLE "throttle" +#define OPTION_SLEEP "sleep" +#define OPTION_SPEED "speed" +#define OPTION_REFRESHSPEED "refreshspeed" + +// core render options +#define OPTION_KEEPASPECT "keepaspect" +#define OPTION_UNEVENSTRETCH "unevenstretch" +#define OPTION_UNEVENSTRETCHX "unevenstretchx" +#define OPTION_UNEVENSTRETCHY "unevenstretchy" +#define OPTION_AUTOSTRETCHXY "autostretchxy" +#define OPTION_INTOVERSCAN "intoverscan" +#define OPTION_INTSCALEX "intscalex" +#define OPTION_INTSCALEY "intscaley" + +// core rotation options +#define OPTION_ROTATE "rotate" +#define OPTION_ROR "ror" +#define OPTION_ROL "rol" +#define OPTION_AUTOROR "autoror" +#define OPTION_AUTOROL "autorol" +#define OPTION_FLIPX "flipx" +#define OPTION_FLIPY "flipy" + +// core artwork options +#define OPTION_ARTWORK_CROP "artwork_crop" +#define OPTION_USE_BACKDROPS "use_backdrops" +#define OPTION_USE_OVERLAYS "use_overlays" +#define OPTION_USE_BEZELS "use_bezels" +#define OPTION_USE_CPANELS "use_cpanels" +#define OPTION_USE_MARQUEES "use_marquees" + +// core screen options +#define OPTION_BRIGHTNESS "brightness" +#define OPTION_CONTRAST "contrast" +#define OPTION_GAMMA "gamma" +#define OPTION_PAUSE_BRIGHTNESS "pause_brightness" +#define OPTION_EFFECT "effect" + +// core vector options +#define OPTION_BEAM_WIDTH_MIN "beam_width_min" +#define OPTION_BEAM_WIDTH_MAX "beam_width_max" +#define OPTION_BEAM_INTENSITY_WEIGHT "beam_intensity_weight" +#define OPTION_FLICKER "flicker" + +// core sound options +#define OPTION_SAMPLERATE "samplerate" +#define OPTION_SAMPLES "samples" +#define OPTION_VOLUME "volume" + +// core input options +#define OPTION_COIN_LOCKOUT "coin_lockout" +#define OPTION_CTRLR "ctrlr" +#define OPTION_MOUSE "mouse" +#define OPTION_JOYSTICK "joystick" +#define OPTION_LIGHTGUN "lightgun" +#define OPTION_MULTIKEYBOARD "multikeyboard" +#define OPTION_MULTIMOUSE "multimouse" +#define OPTION_STEADYKEY "steadykey" +#define OPTION_UI_ACTIVE "ui_active" +#define OPTION_OFFSCREEN_RELOAD "offscreen_reload" +#define OPTION_JOYSTICK_MAP "joystick_map" +#define OPTION_JOYSTICK_DEADZONE "joystick_deadzone" +#define OPTION_JOYSTICK_SATURATION "joystick_saturation" +#define OPTION_NATURAL_KEYBOARD "natural" +#define OPTION_JOYSTICK_CONTRADICTORY "joystick_contradictory" +#define OPTION_COIN_IMPULSE "coin_impulse" + +// input autoenable options +#define OPTION_PADDLE_DEVICE "paddle_device" +#define OPTION_ADSTICK_DEVICE "adstick_device" +#define OPTION_PEDAL_DEVICE "pedal_device" +#define OPTION_DIAL_DEVICE "dial_device" +#define OPTION_TRACKBALL_DEVICE "trackball_device" +#define OPTION_LIGHTGUN_DEVICE "lightgun_device" +#define OPTION_POSITIONAL_DEVICE "positional_device" +#define OPTION_MOUSE_DEVICE "mouse_device" + +// core debugging options +#define OPTION_LOG "log" +#define OPTION_DEBUG "debug" +#define OPTION_VERBOSE "verbose" +#define OPTION_OSLOG "oslog" +#define OPTION_UPDATEINPAUSE "update_in_pause" +#define OPTION_DEBUGSCRIPT "debugscript" + +// core misc options +#define OPTION_DRC "drc" +#define OPTION_DRC_USE_C "drc_use_c" +#define OPTION_DRC_LOG_UML "drc_log_uml" +#define OPTION_DRC_LOG_NATIVE "drc_log_native" +#define OPTION_BIOS "bios" +#define OPTION_CHEAT "cheat" +#define OPTION_SKIP_GAMEINFO "skip_gameinfo" +#define OPTION_UI_FONT "uifont" +#define OPTION_UI "ui" +#define OPTION_RAMSIZE "ramsize" + +// core comm options +#define OPTION_COMM_LOCAL_HOST "comm_localhost" +#define OPTION_COMM_LOCAL_PORT "comm_localport" +#define OPTION_COMM_REMOTE_HOST "comm_remotehost" +#define OPTION_COMM_REMOTE_PORT "comm_remoteport" + +#define OPTION_CONFIRM_QUIT "confirm_quit" +#define OPTION_UI_MOUSE "ui_mouse" + +#define OPTION_AUTOBOOT_COMMAND "autoboot_command" +#define OPTION_AUTOBOOT_DELAY "autoboot_delay" +#define OPTION_AUTOBOOT_SCRIPT "autoboot_script" + +#define OPTION_CONSOLE "console" +#define OPTION_PLUGINS "plugins" +#define OPTION_PLUGIN "plugin" +#define OPTION_NO_PLUGIN "noplugin" + +#define OPTION_LANGUAGE "language" + +#define OPTION_HTTP "http" +#define OPTION_HTTP_PORT "http_port" +#define OPTION_HTTP_ROOT "http_root" + +//************************************************************************** +// TYPE DEFINITIONS +//************************************************************************** + +class emu_options : public core_options +{ +public: + enum ui_option + { + UI_CABINET, + UI_SIMPLE + }; + + // construction/destruction + emu_options(); + + // core options + const char *system_name() const { return value(OPTION_SYSTEMNAME); } + const char *software_name() const { return value(OPTION_SOFTWARENAME); } + + // core configuration options + bool read_config() const { return bool_value(OPTION_READCONFIG); } + bool write_config() const { return bool_value(OPTION_WRITECONFIG); } + + // core search path options + const char *home_path() const { return value(OPTION_HOMEPATH); } + const char *media_path() const { return value(OPTION_MEDIAPATH); } + const char *hash_path() const { return value(OPTION_HASHPATH); } + const char *sample_path() const { return value(OPTION_SAMPLEPATH); } + const char *art_path() const { return value(OPTION_ARTPATH); } + const char *ctrlr_path() const { return value(OPTION_CTRLRPATH); } + const char *ini_path() const { return value(OPTION_INIPATH); } + const char *font_path() const { return value(OPTION_FONTPATH); } + const char *cheat_path() const { return value(OPTION_CHEATPATH); } + const char *crosshair_path() const { return value(OPTION_CROSSHAIRPATH); } + const char *plugins_path() const { return value(OPTION_PLUGINSPATH); } + const char *language_path() const { return value(OPTION_LANGUAGEPATH); } + const char *sw_path() const { return value(OPTION_SWPATH); } + + // core directory options + const char *cfg_directory() const { return value(OPTION_CFG_DIRECTORY); } + const char *nvram_directory() const { return value(OPTION_NVRAM_DIRECTORY); } + const char *input_directory() const { return value(OPTION_INPUT_DIRECTORY); } + const char *state_directory() const { return value(OPTION_STATE_DIRECTORY); } + const char *snapshot_directory() const { return value(OPTION_SNAPSHOT_DIRECTORY); } + const char *diff_directory() const { return value(OPTION_DIFF_DIRECTORY); } + const char *comment_directory() const { return value(OPTION_COMMENT_DIRECTORY); } + + // core state/playback options + const char *state() const { return value(OPTION_STATE); } + bool autosave() const { return bool_value(OPTION_AUTOSAVE); } + const char *playback() const { return value(OPTION_PLAYBACK); } + const char *record() const { return value(OPTION_RECORD); } + bool record_timecode() const { return bool_value(OPTION_RECORD_TIMECODE); } + bool exit_after_playback() const { return bool_value(OPTION_EXIT_AFTER_PLAYBACK); } + const char *mng_write() const { return value(OPTION_MNGWRITE); } + const char *avi_write() const { return value(OPTION_AVIWRITE); } + const char *wav_write() const { return value(OPTION_WAVWRITE); } + const char *snap_name() const { return value(OPTION_SNAPNAME); } + const char *snap_size() const { return value(OPTION_SNAPSIZE); } + const char *snap_view() const { return value(OPTION_SNAPVIEW); } + bool snap_bilinear() const { return bool_value(OPTION_SNAPBILINEAR); } + const char *state_name() const { return value(OPTION_STATENAME); } + bool burnin() const { return bool_value(OPTION_BURNIN); } + + // core performance options + bool auto_frameskip() const { return bool_value(OPTION_AUTOFRAMESKIP); } + int frameskip() const { return int_value(OPTION_FRAMESKIP); } + int seconds_to_run() const { return int_value(OPTION_SECONDS_TO_RUN); } + bool throttle() const { return bool_value(OPTION_THROTTLE); } + bool sleep() const { return m_sleep; } + float speed() const { return float_value(OPTION_SPEED); } + bool refresh_speed() const { return m_refresh_speed; } + + // core render options + bool keep_aspect() const { return bool_value(OPTION_KEEPASPECT); } + bool uneven_stretch() const { return bool_value(OPTION_UNEVENSTRETCH); } + bool uneven_stretch_x() const { return bool_value(OPTION_UNEVENSTRETCHX); } + bool uneven_stretch_y() const { return bool_value(OPTION_UNEVENSTRETCHY); } + bool auto_stretch_xy() const { return bool_value(OPTION_AUTOSTRETCHXY); } + bool int_overscan() const { return bool_value(OPTION_INTOVERSCAN); } + int int_scale_x() const { return int_value(OPTION_INTSCALEX); } + int int_scale_y() const { return int_value(OPTION_INTSCALEY); } + + // core rotation options + bool rotate() const { return bool_value(OPTION_ROTATE); } + bool ror() const { return bool_value(OPTION_ROR); } + bool rol() const { return bool_value(OPTION_ROL); } + bool auto_ror() const { return bool_value(OPTION_AUTOROR); } + bool auto_rol() const { return bool_value(OPTION_AUTOROL); } + bool flipx() const { return bool_value(OPTION_FLIPX); } + bool flipy() const { return bool_value(OPTION_FLIPY); } + + // core artwork options + bool artwork_crop() const { return bool_value(OPTION_ARTWORK_CROP); } + bool use_backdrops() const { return bool_value(OPTION_USE_BACKDROPS); } + bool use_overlays() const { return bool_value(OPTION_USE_OVERLAYS); } + bool use_bezels() const { return bool_value(OPTION_USE_BEZELS); } + bool use_cpanels() const { return bool_value(OPTION_USE_CPANELS); } + bool use_marquees() const { return bool_value(OPTION_USE_MARQUEES); } + + // core screen options + float brightness() const { return float_value(OPTION_BRIGHTNESS); } + float contrast() const { return float_value(OPTION_CONTRAST); } + float gamma() const { return float_value(OPTION_GAMMA); } + float pause_brightness() const { return float_value(OPTION_PAUSE_BRIGHTNESS); } + const char *effect() const { return value(OPTION_EFFECT); } + + // core vector options + float beam_width_min() const { return float_value(OPTION_BEAM_WIDTH_MIN); } + float beam_width_max() const { return float_value(OPTION_BEAM_WIDTH_MAX); } + float beam_intensity_weight() const { return float_value(OPTION_BEAM_INTENSITY_WEIGHT); } + float flicker() const { return float_value(OPTION_FLICKER); } + + // core sound options + int sample_rate() const { return int_value(OPTION_SAMPLERATE); } + bool samples() const { return bool_value(OPTION_SAMPLES); } + int volume() const { return int_value(OPTION_VOLUME); } + + // core input options + bool coin_lockout() const { return bool_value(OPTION_COIN_LOCKOUT); } + const char *ctrlr() const { return value(OPTION_CTRLR); } + bool mouse() const { return bool_value(OPTION_MOUSE); } + bool joystick() const { return bool_value(OPTION_JOYSTICK); } + bool lightgun() const { return bool_value(OPTION_LIGHTGUN); } + bool multi_keyboard() const { return bool_value(OPTION_MULTIKEYBOARD); } + bool multi_mouse() const { return bool_value(OPTION_MULTIMOUSE); } + const char *paddle_device() const { return value(OPTION_PADDLE_DEVICE); } + const char *adstick_device() const { return value(OPTION_ADSTICK_DEVICE); } + const char *pedal_device() const { return value(OPTION_PEDAL_DEVICE); } + const char *dial_device() const { return value(OPTION_DIAL_DEVICE); } + const char *trackball_device() const { return value(OPTION_TRACKBALL_DEVICE); } + const char *lightgun_device() const { return value(OPTION_LIGHTGUN_DEVICE); } + const char *positional_device() const { return value(OPTION_POSITIONAL_DEVICE); } + const char *mouse_device() const { return value(OPTION_MOUSE_DEVICE); } + const char *joystick_map() const { return value(OPTION_JOYSTICK_MAP); } + float joystick_deadzone() const { return float_value(OPTION_JOYSTICK_DEADZONE); } + float joystick_saturation() const { return float_value(OPTION_JOYSTICK_SATURATION); } + bool steadykey() const { return bool_value(OPTION_STEADYKEY); } + bool ui_active() const { return bool_value(OPTION_UI_ACTIVE); } + bool offscreen_reload() const { return bool_value(OPTION_OFFSCREEN_RELOAD); } + bool natural_keyboard() const { return bool_value(OPTION_NATURAL_KEYBOARD); } + bool joystick_contradictory() const { return m_joystick_contradictory; } + int coin_impulse() const { return m_coin_impulse; } + + // core debugging options + bool log() const { return bool_value(OPTION_LOG); } + bool debug() const { return bool_value(OPTION_DEBUG); } + bool verbose() const { return bool_value(OPTION_VERBOSE); } + bool oslog() const { return bool_value(OPTION_OSLOG); } + const char *debug_script() const { return value(OPTION_DEBUGSCRIPT); } + bool update_in_pause() const { return bool_value(OPTION_UPDATEINPAUSE); } + + // core misc options + bool drc() const { return bool_value(OPTION_DRC); } + bool drc_use_c() const { return bool_value(OPTION_DRC_USE_C); } + bool drc_log_uml() const { return bool_value(OPTION_DRC_LOG_UML); } + bool drc_log_native() const { return bool_value(OPTION_DRC_LOG_NATIVE); } + const char *bios() const { return value(OPTION_BIOS); } + bool cheat() const { return bool_value(OPTION_CHEAT); } + bool skip_gameinfo() const { return bool_value(OPTION_SKIP_GAMEINFO); } + const char *ui_font() const { return value(OPTION_UI_FONT); } + ui_option ui() const { return m_ui; } + const char *ram_size() const { return value(OPTION_RAMSIZE); } + + // core comm options + const char *comm_localhost() const { return value(OPTION_COMM_LOCAL_HOST); } + const char *comm_localport() const { return value(OPTION_COMM_LOCAL_PORT); } + const char *comm_remotehost() const { return value(OPTION_COMM_REMOTE_HOST); } + const char *comm_remoteport() const { return value(OPTION_COMM_REMOTE_PORT); } + + + bool confirm_quit() const { return bool_value(OPTION_CONFIRM_QUIT); } + bool ui_mouse() const { return bool_value(OPTION_UI_MOUSE); } + + const char *autoboot_command() const { return value(OPTION_AUTOBOOT_COMMAND); } + int autoboot_delay() const { return int_value(OPTION_AUTOBOOT_DELAY); } + const char *autoboot_script() const { return value(OPTION_AUTOBOOT_SCRIPT); } + + bool console() const { return bool_value(OPTION_CONSOLE); } + + bool plugins() const { return bool_value(OPTION_PLUGINS); } + + const char *plugin() const { return value(OPTION_PLUGIN); } + const char *no_plugin() const { return value(OPTION_NO_PLUGIN); } + + const char *language() const { return value(OPTION_LANGUAGE); } + + // Web server specific optopns + bool http() const { return bool_value(OPTION_HTTP); } + short http_port() const { return int_value(OPTION_HTTP_PORT); } + const char *http_root() const { return value(OPTION_HTTP_ROOT); } + + std::string main_value(const char *option) const; + std::string sub_value(const char *name, const char *subname) const; + +protected: + virtual void value_changed(const std::string &name, const std::string &value) override; + +private: + static const options_entry s_option_entries[]; + + // cached options + int m_coin_impulse; + bool m_joystick_contradictory; + bool m_sleep; + bool m_refresh_speed; + ui_option m_ui; +}; + +#endif // MAME_EMU_EMUOPTS_H |