summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/usingmame
Commit message (Collapse)AuthorAgeFilesLines
* Initial touch input support: Vas Crabb2024-04-121-3/+27
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * Feed mouse/pen/touch pointer events through UI input manager with Win32 and SDL. * Started migrating UI code to use new API and reworking mouse/touch interaction. * emu/render.cpp: Support pressing multiple clickable layout items simultaneously. * emu/render.cpp: Allow UI elements to be drawn in any window. * emu/rendlay.cpp, luaengine_render.cpp: Added layout view events for pointer input. * ui/ui.cpp: Allow the UI handler to control pointer display. * ui/analogipt.cpp: Added mouse/touch and more keys for navigating field state list. * ui/menu.cpp: Use vertical swipe to scroll and horizontal swipe to adjust. * ui/menu.cpp: Draw after processing input - greatly improves responsiveness. * ui/menu.cpp: Ignore keyboard/gamepad input during pointer actions. * ui/selmenu.cpp: Made left/right info pane arrows repeat when held. * ui/selmenu.cpp: Use middle click to move keyboard focus. * ui/selmenu.cpp: Let filter list scroll if it's too tall, and use a bit of horizontal padding. * ui/selmenu.cpp: Improved divider sizing. * ui/state.cpp: Don't allow clicks to pass through the confirm deletion prompt to the menu. * ui/simpleselgame.cpp: Fixed error message display and graphics/sound status not showing. * ui/simpleselgame.cpp: Allow tap/click to dismiss error message. * ui/utils.cpp: Show UI for choice filters when there are no choices - it's less confusing. * modules/input/input_sdl.cpp: Made scaling for mouse scroll better match RawInput and DirectInput. * modules/input/input_rawinput.cpp: Added support for horizontal scroll axis. * modules/input/input_win32.cpp: Added support for scroll axes and more buttons to mouse/lightgun. * modules/debugger/debugimgui.cpp: Don't fight over events with the UI manager - it breaks menus. * osd/windows/window.cpp: Translate mouse position to window cooridinates for scroll wheel events. * osd/sdl/window.cpp: Supply last mouse position for scroll wheel events if possible. * scripts/build/complay.py: Made zero input mask an error - it was only being used to block clicks.
* mamemenus.rst: mention the changed pause key hap2024-02-181-1/+1
|
* docs: combine description for fastforward key hap2024-02-171-6/+1
|
* osdsdl: move prescale keys from ctrl+f6/f7 to alt+f8/f9 hap2024-02-171-6/+6
|
* - osd sdl default keys: remove ctrl-blocks on f3 and f4, move opengl filter ↵ hap2024-02-161-11/+17
| | | | | | | from lctrl+f5 to lalt+f10, - osd windows default keys: move post processing key from lctrl+lalt+f5 to lalt+f10, - mame default keys: move rewind step from shit+tilde to shift+f4, move cheat from shift+f6 to shift+f8, move quick save/load from (none) to shift+f6/f7
* Default UI keys cleanup [hap, R. Belmont] arbee2024-02-131-10/+10
| | | | | | | - Pause moved from P to F5 - Step single frame moved from Shift-P to Shift-F5 - Create save state moved from Shift-F7 to F6 - Toggle cheats moved from F6 to Shift-F6
* Revert "ui: move decrease frameskip key from F8 to Shift F9" hap2024-02-111-2/+2
| | | | This reverts commit d88e12714307ff5a9dc02d0e849ed84d3c4b4f93.
* ui: move decrease frameskip key from F8 to Shift F9 hap2024-02-091-2/+2
|
* docs: Updated for changes to media loading behaviour. Vas Crabb2023-10-202-14/+28
| | | | | Bumped docs version since this now describes behaviour of the upcoming release.
* docs: Fixed many editing errors and spelling errors. (#11575) Tom Cariello2023-09-293-5/+5
| | | Also fixed outdated link to contributing guidelines.
* Input refactoring: Vas Crabb2023-02-182-44/+45
| | | | | | | | | | | | | | | | | | | | | | | | | | osd/modules/input, emu/inpttype.cpp: Made most default joystick assignments supplied by input modules. Input modules take available controls into consideration when generating default assignments. emu/inpttype.ipp: Added a separate "Back" UI input separate from Cancel. You may want an easier to hit combination for moving to the previous menu than for exiting or cancelling input. They both default to Escape. emu/inpttype.ipp: Added a UI Help control. Currently only used by analog inputs menu emu/inpttype.h: Moved I/O port field type enum to its own header and sorted UI controls so they appear in a more logical order. ui: Don't use UI Select to restore defaults - people should be getting used to the UI Clear input by now. UI Select cycles multi-value items instead. ui/inputmap.cpp: Don't use immediate cancel to cycle between clearing and restoring default assignment (use UI Clear instead). osd: Reduced the number of files needing to include the dreaded emu.h. Got some implementation out of headers.
* docs: Corrected parent menu for input devices menu. Vas Crabb2022-09-261-2/+2
|
* Patched up some gaps in functionality and fixed some bugs. Vas Crabb2022-09-021-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ui: Added some missing functionality: * Added an option to copy input device IDs to the relevant menus. * Added an item for setting the software lists files path (-hashpath) to the folder setup menu. * Allow pasting text from clipboard in most places that allow typing (searching, entering filenames, entering barcodes). * Changed the software selection menu heading to be a bit less misleading. * Made barcode menu less eager to rebuild itself unnecessarily, and removed some confusing and apparently pointless code. Exposed more Lua bindings: * Added low-level palette objects. * Added indexed bitmap types. * Added a bitmap method for extracting pixels from a rectangular area as a packed binary string. * Changed screen device pixels method to return width and height in addition to the pixels. osd: Added some functionality and cleaned up a little: * Added a function for copying text to the clipboard. * Moved function for converting Windows error codes to standard error conditions to winutil.cpp so it can be used from more places. * Removed duplicate declaration of osd_get_clipboard_text and made the function noexcept (including fixing implementations). * Made macOS implementation of osd_get_clipboard_text skip the encoding conversion if it finds UTF-8 text first. * Changed the default -uimodekey setting so it doesn't lose the "not shift" that stops the default from interfering with UI paste. Various bug fixes: * util/unicode.cpp: Fixed the version of utf8_from_uchar that returns std::string blowing up on invalid codepoints. * util/bitmap.h: Fixed wrapping constructors for indexed bitmaps taking the wrong parameter type (nothing was using them before). * util/bitmap.cpp: Fixed potential use-after-free issues with bitmap palettes. * emu/input.cpp, emu/inputdev.cpp: Log 1-based device numbers, matching what's shown in the internal UI and used in tokens in CFG files. * emu/emumem.cpp: Added the bank tag to a fatal error message where it was missing. docs: Reworked and expanded documentation on configuring stable controller IDs. For translators, the changes are quite minor: * There's a menu item for copying a device ID to the clipboard, and associated success/failure messages. * There's the menu item for setting the software list file search path. * One of the lines in the software selection menu heading has changes as it could be interpreted as implying it showed a software list name.
* -Got rid of some legacy MESS support glue. Vas Crabb2022-06-131-4/+4
| | | | | | | | | | | * Got rid of the special-casing for the "mess" subtarget name. * Got rid of the MESS-specific Windows resources, emuator info source and man page. * Added subtarget name to the internal name and original name in Windows resources. -ui: Put the system-specific items on the input settings menu together, and fixed the crosshair visibility settings.
* ui, docs: Added menus to fill a couple of gaps, improved consistency. (#9915) Vas Crabb2022-06-114-54/+341
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Added menus for controlling toggle inputs, and showing recognised input devices and control state. Moved input menu options off main menu to a submenu, as there are a lot of them now. Moved menu heading drawing into base class, added headings to more menus, and made headings more consistent with the menu items used to reach them. Also made terminology more consistent. Changed the default names for buttons and hat switches/D-pads to use 1-based numbering. DirectInput still returns 0-based button numbers for some devices. Removed local copy of MinGW xaudio2.h as it’s now included in the MSYS2 package. Also fixed building the DirectSound sound output module with the SDL OSD on Windows - the Windows headers are sensitive to include order. Started adding documentation for menus, to hopefully help people find menus they remember seeing but can't recall how to access. For translators, this makes terminology more consistent. In particular: * "Settings" is preferred over "configuration" in a number of places, as the latter can be construed as referring specifically to settings stored in .cfg files in the cfg_directory folder. Also, references to saving machine configuration could be interpreted as relating to the settings on the "Machine Configuration" menu. * The controls on host input devices (e.g. keys, buttons, joystick axes) are referred to as "controls", while emulated inputs are referred to as "inputs". * The menus for assigning host controls to emulated inputs are called "input assignments" menus to distinguish them from other input settings menus. * Combinations of controls that can be assigned to emulated inputs are referred to as "combinations" rather than "sequences". * The potentially confusing term "ROM set" has been removed altogether. Use "short name" to refer to a device or system's identifier. * "System" is used in almost places to refer to a complete, runnable system rather than "Machine". * "Driver" is now only used to refer to source files where systems or devices are defined - it is no longer used to refer to individual systems. * A few more menus have message context for the messages. This makes it a bit easier to guess where the messages are used. It also means you can use different translations in different places if necessary (e.g. if the same English text should be translated differently as an item in one menu and as a heading in another).
* ui/viewgfx.cpp: Added ability to restrict tiles to integer scale factors. ↵ Vas Crabb2022-05-201-4/+6
| | | | | (#9783) Also encapsulated things a bit more and made the UI manager hold onto the storage rather than keeping it in file statics.
* docs: Added page describing how MAME searches for media. Vas Crabb2022-03-103-5/+409
| | | | | | | 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.
* input: Clarify docuemntation and a comment. Vas Crabb2021-11-061-7/+7
|
* -Enabled complex combinations for analog axes: Vas Crabb2021-11-061-28/+59
| | | | | | | | | | | | | | | | | | | | | | | | * Made it possible to add digital controls to axis settings as enables. * Mix multiple analog controls assigned to an axis setting. * Added a "reverse" modifier for analog controls (useful with mixing). * Fixed an issue assigning mouse axes using multiple mouse-like devices with -nomultimouse. -frontend: More cleanup: * Got rid of some abuse of "special main menus". * Added a helper class for auto-pause menus that don't spawn submenus. * Got rid of the fake menu that schedules an exit on the first frame. * Turned the confirm quit prompt into a menu, eliminated one more special-cased event loop. * Fixed the confirm quit prompt resuming if you return to emulation if you weren't paused to begin with. -bus/centronics: Fixed conflicting DIP locations, reversed order and inverted polarity for Epson printers. * Also added the LX-810 (without L suffix) DIP switches for reference - we don't have a device for this printer yet.
* Two small fixes (bad menu flags in cheat plugin, copy/paste in docs). Vas Crabb2021-11-041-2/+3
|
* -emu/ioport.cpp: Fixed some default setting handling issues. Vas Crabb2021-11-041-2/+44
| | | | | | | | | | | | | | | | | | | | | | * Issues were unlikely to actually manifest unless you use controller configuration files to change specific system input defaults. -src/emu/output.h: Added size accessor to multi-element output finder. * std::size will work on the top rank of an outut finder now. Sorry for hitting emu.h again so soon. -lua: Exposed a couple more input related things. * Exposed constructor and a few methods on input_seq required for scripts to properly clear assignments or restore default settings. * Exposed ioport_manager::set_type_seq which is required to configure general input assignments properly. * Removed unnecessary use of sol::overload in favour of optional parameters. * Updated documentation and also fixed a few errors. -docs: Added description for axis setting assignments.
* -emu/ioport.cpp: Made default behaviour better. Vas Crabb2021-11-033-4/+172
| | | | | | | | | | | | | | | * 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.
* Fix various usability issues: Vas Crabb2021-11-021-4/+127
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | frontend: Made it so you can press UI On Screen Display to hide the Analog Controls menu and see the response to your inputs without the risk of changing settings, and see more axes at once and scroll them for systems with very large number of axes. Also ensure the axis being configured is visible when the menu is visible, and made the menu behave a bit more like the system input assignments menu (including previous/next group navigation). frontend: Allow Lua to draw to the UI container - this addresses the main complaint in #7475. Note that drawing to the UI container will draw over any UI elements, including menus. Plugins can check menu_active to avoid drawing over menus. Also removed some unnecessary use of sol::overload. frontend: Improved info/image box navigation on the system/softwre selection menus, and cleaned up some leftover code that came from the copy/pasted event handling functions. frontend: Fixed sliders menu not handling Alt+Shift as intended (thanks Coverity). Fixed a couple of harmless Coverity errors, too. emu/inpttype.ipp: Made the default assignment for Save State recognise right shift. plugins: Added next/previous group navigation to input macro edit menu. docs: Added basic description of the system and software selection menus, and corrected a couple of errors in the Lua reference.
* -frontend: Refactored menu event handling and fixed a number of issues. (#8777) Vas Crabb2021-10-314-28/+193
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Moved common code for drawing about box, info viewer, and other text box menus to a base class; removed the last of the info viewer logic and the multi-line item hack from the base menu class. * Added previous/next group navigation for general inputs and plugin input selection menus. * Moved message catalog logic to lib/util, allowing osd and emu to use localised messages. * Made the base menu class use the UI manager’s feature for holding session state rather than a static map and mutex. * Improved menu event handling model, and fixed many issues, particularly with menus behaving badly when hidden/shown. * Added better support for menus that don’t participate in the usual menu stack, like the menuless sliders and the save/load state menus. * Made a number of menus refresh state when being shown after being hidden (fixes MT08121 among other issues). * Fixed indication of mounted slot option in the slot option details menu. * Improved appearance of background menus when emulation isn't running - draw all menus in the stack, and darken the background menus to make the edges of the active menu clearer. * Fixed locale issues in -listxml. -debugger: Made GUI debuggers more uniform. * Added new memory view features to Win32 debugger. * Fixed spelling of hexadecimal in Cocoa debugger and added decimal address option. * Fixed duplicate keyboard shortcut in Cocoa debugger (Shift-Cmd-D was both new device window and 64-bit float format). * Made keyboard shortcuts slightly more consistent across debuggers. -plugins: Moved input selection menu and sequence polling code to a common library. Fixed the issue that prevented keyboard inputs being mapped with -steadykey on. -docs: Started adding some documentation for MAME's internal UI, and updated the list of example front-ends. -Regenerated message catalog sources. For translators, the new strings are mostly: * The names of the inputs provided by the OS-dependent layer for things like fullscreen and video features. These show up in the user interface inputs menu. * The names for automatically generated views. These show up in the video options menu - test with a system with a lot of screens to see more variants. * The input macro plugin UI. * A few format strings for analog input assignments. * A few strings for the about box header.
* -docs: Started documenting plugins. Vas Crabb2021-10-241-36/+4
| | | | | | | | | * 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.
* docs: Still more cleanup on the FAQ page. Vas Crabb2021-10-221-14/+45
|
* docs: More adjustments. Vas Crabb2021-10-221-18/+51
|
* commonissues.rst: Fixed bad English. Robbbert2021-10-221-2/+2
|
* plugins/timer: Fixed ticking when menu is left on the screen. Vas Crabb2021-10-221-34/+60
|
* -docs: Documented debugger's built-in functions for expressions. Vas Crabb2021-10-191-2/+2
| | | | -Fixed a couple of coverity warnings.
* frontend: Keep cleaning up. Vas Crabb2021-10-111-9/+25
| | | | | | | | | | | | | | | | | | | Got rid of one of the UI audit inputs. There only needs to be one, and the options can be presented in the confirmation menu. Two secret keystrokes is too confusing. Also got rid of the long-obsolete UI Toggle Debugger input. Added audit media button to the toolbar so it's a bit less opaque, and it can be accessed with a mouse/trackball (not just by knowing the key mapping). Made default I/O port names localisable. Made autofire plugin save port fields using the { port, mask, type } tuple, the same way MAME does. Unfortunately this will break existing autofire configuration, but it should be more stable going forward. Added some more UI keys to the default key mappings documentation.
* -ui: Made zoom controls a bit more intuitive. Vas Crabb2021-09-061-2/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * The UI controls are described as zoom in/out, but they had the opposite effect on the palette and tile viewers. That has been changed to make them consistent with the tilemap viewer. * Made the default zoom key not act as a toggle. People are familiar with the function of Ctrl+0/=/- in web browsers, so making them behave similarly in MAME should make it more approachable. Also added the default zoom key to the relevant documentation page. * Implemented the default zoom key for the palette and tile viewers. * In the tilemap viewer, if the view is in default expand to fit mode, zoom in/out starting from the actual zoom ratio. Once again, this behaves more like the zoom controls in a web browser displaying an image so it should be more intuitive. * Made more messages from the tilemap viewer localisable. -util/zippath.cpp: Fixed MT08074. * There were multiple issues at play here. After #8443 was applied, is_root was simply never returning true on Windows, as OSD_WINDOWS isn't actually defined outside libosd and libocore. This caused phantom parent items to appear in disk roots on Windows, but it meant that the check in zippath_resolve would always fail so the trailing backslash would be trimmed. Fixing the macro test in is_root meant the trailing backslash from C:\ would no longer be trimmed, which caused the stat in zippath_resolve to fail. -bigbord2.cpp: Hooked up floppy DRQ that had somehow got lost. -Reduced tag map lookups in several drivers and devices. -util/coretmpl.h: Removed an overload of bitswap that can be avoided using if constexpr. -Added doxygen comments to some classes, and fixed several doxygen warnings. -util, osd: Test for _WIN32 rather than WIN32. * In C++17 mode, WIN32 is no longer a predefined macro, although various things in 3rdparty define it to maintain legacy support. We're better off moving forward anyway for when WIN32 disappears entirely. (WIN32 is not a reserved name, while _WIN32 is, starting with an underscore follwed by an uppercase letter.)
* Remove leftover mame64 from docs Olivier Galibert2021-05-251-1/+1
|
* Docmumentation update/expansion. [Firehawke, Vas Crabb] Vas Crabb2021-05-072-27/+68
|
* Change "mame64" to "mame" in docs (#7709) Firehawke2021-01-291-2/+2
|
* version bump for 0.227, some documentation clean-upmame0227 Vas Crabb2020-12-311-7/+23
|
* docs: Fix mistake on which key was SDL-specific and which was non-SDL AJR2020-12-241-2/+2
|
* docs: Update list of default keys due to recent removals AJR2020-12-241-7/+2
|
* Optimise some SVG images Vas Crabb2020-10-091-287/+206
|
* -emu/rendlay.cpp: Small optimisation for opaque pixels in image component. Vas Crabb2020-09-192-116/+555
| | | | | | -machine/pc1512kb.cpp: Put \| and #~ on the right keys by default. -docs: Re-organised default keys, added P2-4 defaults, added mahjong panel diagram.
* Fix artwork labeld for tisub buttons Vas Crabb2020-09-161-3/+3
|
* Cleaned up inputs a little. Vas Crabb2020-09-161-81/+52
| | | | | | | | | | | | | Removed the IPT_POKER_BET, replacing it with IPT_GAMBLE_BET. Re-organised the order of input types in the source and the documentation to better reflect how they're logically grouped or organised on a mahjong or gambling control panel. Made the blackjack, poker and slots documentation headings subheadings under the gambling heading. Cleaned up inputs for a number of gambling games.
* Docs: Overhaul the default keys list (#7222) Firehawke2020-09-161-104/+613
| | | | | | | * Docs: Overhaul the default keys list * Second phase of documenting default inputs better, also change Score to Take Score in Mahjong inputs * Phase two of default keys docs adjustment.
* First completed pass of commandline parameters. (nw) (#6711) Firehawke2020-06-121-0/+17
| | | | | | | | | | | | | | | * 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)
* Update documentation (nw) Firehawke2019-11-251-1/+34
| | | | | | | | * 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.
* Clean up phrasing a bit on input from MG (nw) Firehawke2018-10-191-2/+2
|
* Update FAQ (nw) with HLSL/BGFX update info, old external OPL2 support ↵ Firehawke2018-10-191-3/+13
| | | | information
* Reword the entire merged set example to avoid long sentence soup (#3857) Firehawke2018-08-171-2/+2
| | | | | | * Reword the entire merged set example to avoid long sentence soup, also clarify parent/clone (nw) * Per request, adjust phrasing slightly more. (nw)
* Fix a typo (found by Wellington Uemura, @katananja) and... Wellington Uemura2018-08-091-1/+1
| | | | | ... also replace the '--' by a Harvard comma, as suggested by @cuavas. (see also: pull request #3805)
* allow repeating elements and groups - useful if you need e.g. a lot of ↵ Vas Crabb2018-07-222-14/+14
| | | | numbered labels, but it limits complay.py's ability to check for invalid references as it can't evaluate expressions (nw)