summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/commandline/commandline-all.rst
Commit message (Collapse)AuthorAgeFilesLines
* New sound infrastructure. Olivier Galibert6 days1-1/+1
| | | | | | | | | | | | | | | | | Should be added soon: - mute - speaker/microphone resampling To be added a little later: - compression - reverb Needs to be added by someone else: - coreaudio - direct - portaudio - xaudio2 - js
* Cleaned up the mess from #12610: Vas Crabb2024-08-271-3/+19
| | | | | | | * Command line options need to be documented. * Don't assume C strings returned as option values remain valid indefinitely. * Fixed wording for option description.
* input/input_sdl.cpp: Added an SDL lightgun provider. Vas Crabb2024-04-261-40/+31
| | | | | | | | | | This does essentially the same thing as the Win32 lightgun provider, mapping the absolute pointer position over the window to gun axes. Also added a bunch of const in the windows input handling code. docs: Bumped version, as features that are not in a releaesd version of MAME are now documented.
* Fixes and cleanup: Vas Crabb2024-03-121-3/+3
| | | | | | | | | | | | | | | | roland/roland_d70.cpp: Use object finders, use memory shares rather than ram_device, fixed Endianness bugs, fixed bad indentation, fixed double-qualified member functions, use m_ prefix consistently for members, use lowercase hex digits, don't allow writes to ROM, fixed header #include order. docs: Corrected docmented default for ui_mouse option. tektronix/tek440x.cpp: #include local headers first, etc. bus/a2bus/snesmax.h: Fixed copy/pasted comment. yamaha/ympsr2000.cpp: Put code in an anonymous namespace.
* docs: Fixed typo in -wavwrite option example. (#11919) Angelo Salese2024-01-091-1/+1
|
* docs: Fixed many editing errors and spelling errors. (#11575) Tom Cariello2023-09-291-9/+9
| | | Also fixed outdated link to contributing guidelines.
* Adjustments to option priority interactions: Vas Crabb2023-05-091-11/+16
| | | | | | | | | | | | emu/sound.cpp: Made -volume in source file INI or higher priority context take precedence over volume read from CFG file. This matches behaviour of -bgfx_screen_chains. emu/input.cpp: Made explicit -no{mouse|joystick|lightgun} take precedence over -{mouse|trackball|adstick|paddle}_device etc. from lower priority levels. Alos got rid of a bunch of unnecessary simple_list.
* clifront.cpp: Changed -listbios to work more like -listslots, showing all ↵ Vas Crabb2023-04-101-45/+52
| | | | BIOS options in a system.
* Cleaned up some recent changes. Vas Crabb2023-02-041-4/+4
|
* docs: Clarified documentation of input options. Vas Crabb2023-02-031-12/+42
| | | | | | | | | Made explanation of interaction between device class enable options (-[no]mouse, -[no]joystick, -[no]lightgun) and automatic device class enable options (-*_device) more explicit. Also documented that -mouse_device mouse is set by default in both relevant places. Provided a better explanation of the purpose of -dual_lightgun.
* Various input and OSD refactoring: Vas Crabb2023-01-291-5/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | osd: Supply OSD object to modules on initialisation. Encapsulated some event handling in the OSD objects rather than leaving it in free functions. Put various stuff in namespaces. osd/modules/input: Enabled dinput, xinput and winhybrid modules for Windows SDL builds, and enabled background input for dinput and xinput (and by extension winhybrid) modules. Also fixed some COM and X11 resource leaks. osd/modules/input/input_sdl.cpp: Flipped SDL mouse button order to match Windows, and exposed vertical and horizontal scroll as Z and rZ axes. Moved SDL UI event handling out of input devices into OSD object. osd/modules/input_rawinput.cpp: Changed lightgun Z axis token so it's correctly identified as a relative axis (it maps to the scroll wheel equivalent). osd: Added an option to choose the network provider module. Mostly useful if you build with both TUN/TAP and pcap support included, or if you want to disable emulated networking completely. emu/input.cpp: Use a better strategy for assembling input code names that uses fewer temporary strings and doesn't require use of the non-Unicode-aware space trimming function (fixes MT08552). osd/modules/input_dinput.cpp: Improved polling logic. osd: Made various parts of the input code less dependent on concrete emu objects, and reduced inappropriately passing around the machine object. Made input modules less dependent on OSD implementation. Encapsulated some stuff and got rid of some vestigial newui and SDL1 support code. Cleaned up some interfaces. Moved OSD options classes to their own files. Prepare to remove main.h from emu.h - it's mostly used to get the application name, which the vast majority of emulated devices don't need to do.
* Miscellaneous fixes and refactoring: Vas Crabb2023-01-281-36/+78
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ui/analogipt.cpp: Fixed bar graph display for fields with ranges that wrap through zero. emu/inputdev.cpp: Separateed analog axis deadzone and switch threshold settings, reduced default deadzone, and fixed a potential division by zero if the deadzone and saturation settings are equal. emu/ioport.cpp: Fixed behaviour of absolute analog fields where range passes through zero - it previously only worked for specific combinations of mask, minimum and default. Removed a workaround from universal/getaway.cpp that is no longer necessary. emu/input.cpp: Fixed unintuitive behaviour when an absolute field is assigned an OR combination of a relative control folled by an absolute control (e.g. Mouse X or Joy 1 LSX). Also fixed reading axis input sequences where an axis code is followed by a switch code (these can only be produced by manually editing configuration files, not through MAME's UI), and fixed the returned type when multiple relative axes sum to zero. osd/modules/input_dinput.cpp: Fixed hat switches being stuck in up position when input is suspended in the background taito/taitoio_yoke.cpp: Give throttle control a distinct type, and don't auto-centre. osd: Added option to select MIDI provider module (currently only PortMidi and the dummy module are available). Also put various things in namespaces, and fixed builds including SDL sound module with native Windows OSD. emu/validity.cpp: Added check to catch I/O port fields using UI input types. emu/inpttype.ipp: Renamed inputs that were causing confusion. "Bill" and "Track" were causing confusion for translators and hence likely causing confusion for many users, especially those who are not native English speakers. "Track" as an abbreviation for "Trackball" was frequently being mistranslated, e.g. in the sense of a CD track selection button or even in the sense of a railway track. There's no reason to abbreviate it. "Bill" in the US English sense as a banknote is too ambiguous and was causing confusion for translators. It's better to use the less ambiguous "Banknote". Corrected Greek translations of "Trackball". Don't run GitHub Actions on issue template changes.
* Add -listbios command to list alternate BIOSes for drivers and devices AJR2023-01-241-2/+21
|
* osd: Added option to accept SDL game controller/joystick input when losing ↵ Vas Crabb2023-01-141-13/+42
| | | | UI focus.
* docs: Updated default joystick providers. Vas Crabb2023-01-141-6/+6
|
* osd: Added support for mapping files to sdlgame joystick provider and made ↵ Vas Crabb2023-01-141-25/+50
| | | | | | | | | | | | | | | | | it default with SDL. This changes behaviour, however I think it's a net positive: * Most games using Steam Input or SDL2 to read game controllers have this behaviour, so users have come to expect it. * This module is better at giving meaningful names to buttons on common controller, and assigning axes consistently. * Button/axis mapping files using a widely-used format are supported. * The old behaviour is still available with `-joystickprovider sdljoy` if anyone wants it. The new option for controller mapping files is in the general OSD options rather than SDL options as it can be extended to DirectInput in the future.
* -osd: Better XInput and SDL game controller input enhancements: Vas Crabb2023-01-121-4/+6
| | | | | | | | | | | | | | | * Added initial support for XInput controller subtypes, starting with driving, arcade and flight controllers. * Check XInput capabilities to ignore buttons and hats that aren't present. * Added preliminary SDL Game Controller joystick provider. Reconnection and mixed Game Controller/Joystick devices are unsupported. * Show the input token for the highlighted control on input device menus. -ui: Allow menus to set required space above and below menu when metrics change. Fixes the initial bad layout on the system selecton menu, or bad layout after resizing windows.
* docs: Added page describing how MAME searches for media. Vas Crabb2022-03-101-6/+66
| | | | | | | Also made error messages for missing CHDs and missing files for software parts using the image file loader show search paths, and changed the (poorly named) bitbanger device to use the image file loader rather than the ROM loader for software items.
* Clean up various loose ends: Vas Crabb2022-02-031-30/+16
| | | | | | | | | | | | | | | | | | | | | frontend: Exposed debug symbol tables and parsed expressions to Lua (these can be used when the debugger is not active). Also made it simpler to walk input types. imagedev/bitbngr.cpp: Added software list loader support (used by sitcom). sitcom.cpp: Replaced bankdev with a memory view. Also added a bar graph for the timer DAC output, and made the DL1414 displays squarer in the layout like they are in real life. They still don't look right because the internal segment drawing code doen't draw the segments the right width. docs: Fixed broken links and added missing links in command line options index. Also removed documentation for an option that no longer exists and fixed some inconsistent terminology. Separated includes by module in various drivers.
* -emu/ioport.cpp: Made default behaviour better. Vas Crabb2021-11-031-5/+4
| | | | | | | | | | | | | | | * If an input is configured to some combination of controls that are not present at all, ignore the setting altogether for the session. * Fixed relative axes with PORT_RESET not responding to absolute controls (MT07685). * Fixed relative axes not responding to an absolute control if the value doesn’t change every frame (eg. holding a stick against the stop). * Changed the scaling for absolute controls assigned to relative axes to make defaults more sane (e.g. arkanoid or spdheat with a joystick). -frontend: Fixed some localisation issues in Analog Controls menu. -docs: Added documentation on assigning inputs.
* plugins: Moved the timecode recording functionality to a plugin. Vas Crabb2021-11-021-16/+0
|
* -docs: Started documenting plugins. Vas Crabb2021-10-241-13/+65
| | | | | | | | | * Also added a couple of missing command-line options, and added a local table of contents to the (rather long) command line options page. -Added a separate CI target for localisation updates that produces an artefact, and removed the message catalogs from the trigger paths for the Linux CI build.
* Various improvements to the user experience: Vas Crabb2021-10-131-5/+6
| | | | | | | | | | | | | | | | | | Extended the memory access prefixes in debugger expressions to support address space names. Made the debugger history command aware of how much history it has collected, and added a help topic for it to the built-in debugger help. Started updating the documentation for the web site, and corrected some of the more misleading built-in debugger help. Made some corrections to Chinese localisation after discussion with YuiFAN. Darkened the UI red colour a little. cpu/m6502/st2205u.h: Marked sound imperfect.
* emu/video.cpp: Set file names via -snapname when exiting in -seconds_… (#8633) 0kmg2021-09-301-2/+2
|
* docs: explain compressor a bit again hap2021-09-241-1/+2
|
* docs: explain compressor a bit hap2021-09-241-1/+1
|
* sound: make the compressor optional (clamp overdrive to -1.0-1.0 when off) hap2021-09-241-0/+13
|
* API cleanups and miscellaneous fixes. Vas Crabb2021-07-151-7/+9
| | | | | | | | | | | | | | | | emu/ioport.cpp: Allow controller files to override input sequences for inputs that don't use defaults, and to override the toggle setting for digital inputs. emu/config.cpp: Expose configuration level (mostly matters for controller files), improved verbose diagnostic messages, and moved a few things out of the global and preprocessor namespaces. docs: Added documentation for some controller configuration file features. The device mapping feature documentation will be merged in at some point. util/unicode.cpp, emu/input.cpp: API cleanups.
* Change "mame64" to "mame" in docs (#7709) Firehawke2021-01-291-205/+205
|
* -docs update: Vas Crabb2021-01-231-0/+6
| | | | | | | | | | | | | | | * Added note explaining that view options saved in machine CFG take precedence over INI/command line. * Added prerequisites for building HTML documentation under MSYS2 and Fedora Linux. * Explicitly mentioned that Ubuntu modifies GCC to enable "fortify source" by default in the relevant section. * Removed obsolete reference to glibstdc++6. * Re-formated compiling guide source (hard wrap at 80 columns, typographical quotes, code blocks for sample command lines). -genie.lua: Show GCC ignored attribute warnings, but don't fail for them.
* Fix some oversights and emergent behaviour with view selection. Vas Crabb2020-12-201-21/+30
| | | | | | | | | | | | | | | | | | | | | | | | | Exposed the "native snapview" option on the video manager. Trying to use presence of a single view is a poor proxy that breaks with multi-screen systems. Allow rotation to be changed for native snapshot views, and disable the zoom to screen area control when it has no effect on the selected view. Treat an empty string identically to "auto" for view selectction. Previously this was being used for prefix matching so it would force the first view. (This caused the bad snapshot view selection. It had been relying on "internal" not being a common view name prefix so it fell through to automatic selection, but when changed to an empty string it forced the first view.) Documented "auto" as well as "native" for the -snapview option and changed the default to auto rather than an empty string for consistency with the -viewN options. Added [w]string_view handlers to the stuff that's instantiated in strformat.cpp since we'll be increasingly using them. Cleaned up and updated some documentation.
* Remove VRR statement until it can be retested. Firehawke2020-09-171-2/+0
|
* Fixed compilation of docs for HTML and manfiles. Firehawke2020-08-101-38/+40
|
* Documentation update for vector options. Aaron Giles2020-08-051-56/+84
|
* Documentation updates (#6825) Firehawke2020-07-181-20/+90
| | | | | | Documentation updates [Firehawke] * Preliminary work on -joystick_map redesign * Adjustments to phrasing for analog mapping * Health warning text
* First completed pass of commandline parameters. (nw) (#6711) Firehawke2020-06-121-150/+1575
| | | | | | | | | | | | | | | * First completed pass of commandline parameters. (nw) * Further refinements on commandline (nw) * Get the audio latency numbers right and add PortAudio info. * FreeSync/GSync information cleanup. * Minor additions to G-Sync/FreeSync. * Add tip for keyboardprovider, remove biospath, correct anchor positioning (nw) * A few corrections per Vas (nw)
* dialong -> dialog (nw) Angelo Salese2020-01-301-1/+1
|
* Update documentation (nw) Firehawke2019-11-251-0/+10
| | | | | | | | * Update MAME docs revision to 0.216 * Add FAQ question about autofire with walkthrough of setup process. * Add VSCode .gitignore for RST compilation temporary folder (/docs/source/_build) * Add a caveat about autofire+normal fire mapping * Add -lowlatency to the docs.
* Make layout format more flexible: Vas Crabb2019-07-061-40/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * There is no longer a concept of "layers" - there are only screens and elements. * Elements are now instantiated with <element ref="..."> * Screens and elements can have explicit blending mode specified with blend="..." * Default blending mode for screens is "add" and default for other elements is "alpha" * Other supported modes are "none" and "multiply" * This removes the options to enable/disable layers individually - use views instead * Legacy layouts can still be loaded, and support won't be removed for at least a year The current artwork model is over-stretched. It's based on a Space Invaders cabinet model, and isn't applicable to a lot of the systems MAME emulates now. The fact that MAME has to switch to an "alternate" mode to deal with games like Golly! Ghost! without requiring pre-matted bitmaps shows that the Space Invaders model wasn't even adequate for general arcade use. It shows in that for a lot of the systems that heavily depend on artwork, people just seem to randomly choose layers for elements until they get something that works. Also, the fact that MAME will switch to an alternate (Golly! Ghost!) mode depending on the combination of elements is a trap for people learning to make artwork. There are cases that the current approach of implying the blending mode from the layer doesn't work with. Examples include LEDs behind diffusers (requires additive blending for layout elements), and mutliple stacked LCD panels (requires RGB multiplication for screens). For configurability, it's now a lot easier to make multiple views using groups. For example, if you want to make it possible to hide the control panel section of your layout, you can put the control panel elements in a group and create views with and without it. I will gradually migrate the internal artwork to use the new approach. I have an XSLT stylesheet that helps with this, but I'm not comfortable adding it because it isn't a complete solution and it still requires manul steps. I wanted to get the re-worked pointer handling done sooner so I could push them both at the same time, but unfortunately various things have prevented me from progressing as quickly as I wanted to. Sorry guys, that stuff's going to have to wait.
* (nw) Clean up the mess on master Vas Crabb2019-03-261-423/+1355
| | | | | | | | | | | | | This effectively reverts b380514764cf857469bae61c11143a19f79a74c5 and c24473ddff715ecec2e258a6eb38960cf8c8e98e, restoring the state at 598cd5227223c3b04ca31f0dbc1981256d9ea3ff. Before pushing, please check that what you're about to push is sane. Check your local commit log and ensure there isn't anything out-of-place before pushing to mainline. When things like this happen, it wastes everyone's time. I really don't need this in a week when real work™ is busting my balls and I'm behind where I want to be with preparing for MAME release.
* Revert "conflict resolution (nw)" andreasnaive2019-03-251-1355/+423
| | | | | This reverts commit c24473ddff715ecec2e258a6eb38960cf8c8e98e, reversing changes made to 009cba4fb8102102168ef32870892438327f3705.
* Make -nonvram_save also inhibit saving of "battery" NVRAM for image devices AJR2019-02-191-1/+2
|
* update docs (nw) Vas Crabb2019-01-281-4/+5
|
* Correct compilation packages (for #4507) and finish cleanup on previous docs ↵ Firehawke2019-01-131-7/+9
| | | | | | | | updates. (nw) (#4509) * Correct the compilation packages [partial for #4507] (nw) * Minor corrections, joymap adjustments (nw)
* more command line doc cleanup (nw) Vas Crabb2019-01-111-30/+46
|
* Major formatting update for command line options, copyright/version update ↵ Firehawke2019-01-111-410/+1115
| | | | | | | | | | | | | | | | | | | | | (#4470) * Update copyrights and docs revision (nw) Updates copyright on existing 2018 entries to 2019 (and one 2016) Updates the docs compilation script to MAME 0.205 and 2019 copyright. * Further formatting overhauling (nw) Clamp to 80 column where possible; it makes it easier to track errant line breaks, etc. Also begin standardizing tab formatting and two spaces after period. * Further corrections to command line materials (nw) * More adjustments for Cuavas (nw) Getting closer to acceptable.
* Make informational verbs a bit more consistent, reduce copy/pasted code, a ↵ Vas Crabb2019-01-041-103/+310
| | | | slight performance improvement for reading localisation files, and more documentation clean-up/correction/clarification
* Case sensitivity training for INI (nw) (#4455) Firehawke2019-01-031-204/+205
| | | | | | | | | | | | | | | | | | | | * Case sensitivity training for INI (nw) The world is not 100% Windows, so case sensitvity is needed. * Further standardization of the formatting (nw) More to go... * Pass 2 of new formatting wave (nw) More to go, though. * wave 3 of formatting cleanup (nw) Further adjustments and cleanups, including unwanted tabs. * Correct filtering instructions (nw)
* (nw) update some documentation and get the MAME and legacy MESS pages more ↵ Vas Crabb2018-12-251-3/+6
| | | | in sync. sorry if I've busted formatting, I can't currently build sphinx or man on this Windows notebook.
* Misc. document fixes (nw) Scott Stone2018-09-261-3/+3
|