Next Previous Contents

## 3. Usage

To run it, you'll find a GXMame icon in your menu Games/Arcade (that could change following your distribution and environment) or you can open a terminal and type `gxmame`, in that case you will have more information displayed in the terminal, that could be useful if you experience some problems and/or want to make a bug report...

## 3.1 First time use

When you run GXMame for the first time, you wont see any game, you need to change your directories preferences to point to a valid Mame executable if its not already the case then, rebuild the game list. After that can Audit all games to see what games are playable or not.

## 3.2 Presentation & General use.

GXMame will appear with, at the top of the window, a menu bar from where most action are available and a toolbox bar where the most common action are available. at the bottom of the window a status bar giving you some games informations.

The main window is divided in three part, the left part is the folder (or filter) panel, that allows you to view games following a specific criteria. the middle part is the game list panel and the right part is the screenshots panel that display different snapshots and informations.

You have several way to select a game:

- use the mouse and click on the game.
- Use the keyboard arrows up and down.
- Use the keyboard letters to jump to the first game beginning with this letter, if you type several letters fast enough you will jump to the game you typed. For example if you type o-m you will jump to the game Omega.

After choose your game options, you can double click on it, press enter or use the Play item from File or contextual menus to launch it.

## 3.3 Menus

It is from these menus, you can do everything you want about the games or the GUI itself.

### File menu

- Play (Return) : Launch the highlighted game.
- Play and Record Input... : Create of an *.inp file which will allow X-Mame to record keystrokes in the game being played for playback later. Similar to a VCR.
- Playback Input... : Load and play a previously recorded *.inp file.
- Select Random Game : Randomly highlight a game in the game list.
- Add to 'favorites' : Add the highlighted game to the favorite game list.
- Remove from 'favorites' : Remove the highlighted game from the favorite game list.
- Properties : Display the highlighted game's individual settings, these settings over-ride those made to all games in the Options -> Default Options menu item.
- Audit All Games : Check all the available games, verifying them to X-Mame's expected results.
- Quit : Exit the program.

### View Menu

- Toolbar (Alt+T) : Toggle the toolbar on or off.
- Status Bar (Alt+S) : Toggle the status bar on or off.
- Folder List (Alt+D) : Toggle the folder list panel on or off.
- Screenshot Panel (Alt+N) : Toggle the screenshot panel on or off.
- Screenshot Panel Tab (Alt+O) : Toggle the screenshot panel tab on or off.
- List : Display small icons in the gamelist area.
- List Tree: Display small icons in the gamelist area with clones displayed as children of original game.
- Details : Display small icons along with full game name and other information like Samples, Directory Type...
- Details Tree : Display small icons along with full game name and other information like Samples, Directory Type...with clones displayed as children of original game.
- Expand All : Expand all Original game to show they clones.
- Collapse All : Collapse all Original game to hide they clones.
- Collums Layout... : Open the Column layout window.
- The Prefix : Toggle the "the" before or after game name, i.e. "The King of Fighters 2000" will become "King of Fighters 2000, The"
- Refresh (F5) : Update game availability with the existence of zip files that match game directory names. This is not as exhaustive as the File -> Audit function menu function.

### Options Menu

- Clone Color : Allows you to change the color of clone games.
- Game list Font : Allows you to change the font used by the folder and gamelist.
- Rebuild Game List : Rebuild the game list from the selected X-Mame executable.
- Directories... : Allows you to choose different directories for xmame executable, Path, art & support files i.e. : roms, samples, catver, flyers, cabinets, marquees, titles, snapshots, artwork, high scores, input files, Cheat file, high scores file, History and mameinfo file.
- Default Options... : Display an option window for the global customization of all games in the game list. These settings are overridden by altering the individual game settings using the File -> Properties menu item or Properties item from the contextual menu.
- Startup Options... : Display an option window that allows: toggling on or off the search for new games on start, toggling on or off the list version mismatch feature, toggling on or off the ability to use a gamepad to navigate the GUI.
- Executable : Allow you to select the X-Mame executable you want to use to play game, generate or audit a game list.

### Help Menu

- About... : Display informations about the version of GXMame.

### Contextual menu

This menu appear when you right click on the gamelist on press the menu button of the keyboard, providing you almost the same action that from the File menu but from a more intuitive way.

- Play (Return) : Launch the highlighted game.
- Play and Record Input... : Create of an *.inp file which will allow X-Mame to record keystrokes in the game being played for playback later. Similar to a VCR.
- Playback Input... : Load and play a previously recorded *.inp file.
- Add to 'favorites' : Add the highlighted game to the favorite game list.
- Remove from 'favorites' : Remove the highlighted game from the favorite game list.
- Select Random Game : Randomly highlight a game in the game list.
- Properties : Display the highlighted game's individual settings, these settings override those made to all games in the Options -> Default Options menu item.

## 3.4 Bars

### Toolbar

This bar provide a quick way to change option of the GUI and can be toggled on by using the View -> Toolbar menu item, or the Alt-T keyboard shortcut.

- Folder List (Alt+D) button : Toggle the folder list panel on or off.
- Screenshot (Alt+N) button : Toggle the screenshot panel on or off.
- List button : Display small icons in the gamelist area.
- List Treebutton : Display small icons in the gamelist area with clones displayed as children of original game.
- Details button : Display small icons along with full game name and other information like Samples, Directory Type...
- Details Tree button: Display small icons along with full game name and other information like Samples, Directory Type...with clones displayed as children of original game.
- The Prefix button : Toggle the "the" before or after game name, i.e. "The King of Fighters 2000" will become "King of Fighters 2000, The"
- About... button : Display information about the version of GXMame.
- Executable Dropbox : Allow you to select the X-Mame executable you want to use to play game, generate or audit a game list.

### Status Bar

This status bar provide you some information about the games and can be toggled on by using the View -> Status Bar menu item, or the Alt-S keyboard shortcut.

- Name : Complete name of the game.
- Status : Show you if the game is :
  - Working : The game is available and playable.
  - Not working : The game is available but not playable due to emulation problems. For some games, you can give a try if you get a new set of roms (I'm thinking of the CPS2 games and sets of XOR roms)
  - ROMs missing : The game is not available because some or all roms are missing.
  - UNKNOWN : The games haven't been audited yet (quick or complete audit). you need to audit the game to find out it true status.
- number of games : Display the number of games available in the current folder.

## 3.5 Panels

### Folder panel

First section on the far left, the folder (or filter) panel allows you to view games following a specific criteria when highlighting a folder in this panel and can be toggled on by using the View -> Folder List menu item, or the Alt-D keyboard shortcut.

- All games : Display all games without restriction.
- Available : Display games that got all their roms, either if they are working(playable) or not.
- Unvailable : Display games that have missing roms or set.
- Neo-Geo : Display all Neo-Geo games.
- CPS1 : Display all Capcom Play System 1 games.
- CPS2 : Display all Capcom Play System 2 games.
- Manufacturer : Contain subfolders that will display games from a specific manufacturer. this subfolders list is created from the main game list.
- Year : Contain subfolders that will display games from a specific year. this subfolders list is created from the main game list.
- Working : Display games that are emulated and playable, either if their roms are present or not.
- Non-Working : Display games that are partially emulated and not playable, either if their roms are present or not.
- Custom : Contain two subfolders that will display games from a specific manufacturer.
  - Favorites : Display games that are part of your favorite list. Yoy can add/remove games to/from your favorite list from the File menu or the contextual one.
  - Played : Display games that have already been played at least once.
- Originals : Display original games, those was the first release of the game or the the "World" or "USA Version" of the game if it was multilingual.
- Clones : Display clone games. Clones are often "alternate versions" such as versions of a game with a different title, in another language, "bootleg" versions that lack copy protection, relicensing and the like. The "Parent ROMs" are often the original game, and if it is multilingual, often the parent is the "World" or "USA Version" of the game.
- Raster : Display games using Raster graphics, i.e. classic bitmaps graphics.
- Vector : Display games using Vector graphics.
- Trackball : Display games that was playable with a trackball.
- Stereo : Display games that have stereo sound.
- Driver : Contain subfolders that will display games from a specific driver. this subfolders list is created from the main game list.
- Category : Contain subfolders that will display games from a specific category. these subfolders list is created the catver file.
- Version : Contain subfolders that will display games from specific version. these subfolders list is created from the catver file.

### Game List panel

Second section on the middle, the game list panel contain the list of the games filtered by the folder panel, following the type of view you selected (for the moment only list and details views are available) it will display :

- List View : Only display the name of the game.
- List Tree View : Only display the name of the game and clone games are displayed as children or original games.
- Details View : Display, in addition of the game name :
  - Sample : Nothing (" ") if no samples are needed, Yes if sample are correct or No if samples are missing.
  - Directory : The name of the folder or zip file where the rom must be stored, for clone games, the roms can be stored in the parent directory or zip.
  - Type : The graphic type of the game, Raster of Vector.
  - Trackball : Yes or No if the games that was or wasn't playable with a trackball.
  - Played : The number of time the games has been played.
  - Manufacturer : The name of the manufacturer of the game.
  - Year : Year of release of the game.
  - Clone of : This is the parent directory game or "-" if the game is an original.
  - Driver : The driver used for the game, that can be an unique driver or a driver for a set of rom (neogeo or cps1/2).
  - Version : The version of Mame to which the game was added. You need to have the catver file to have this field filled.
  - Category : The game category. You need to have the catver file to have this field filled.
- Details Tree View : Same as the Details View with clone games displayed as children or original games:

Additionnally, you can add following fields to detailled layouts using the Column Layout window:

- ROMS : Display if you have all roms of the game or not
- Status : Show the status of the game (Available...).
- Rom of : Show if the game use roms from another game or bios.
- Driver Status : If the driver is working or not.
- Players : The number of player.
- Buttons : The number of button used in this game.
- CPU (1-4) : the CPU(s) model used in this game.
- Sound (1-4) : the sound CPU(s) model used in this game.
- Favorite : If the game is one of your favorite one.
- Channels : Mono or Stereo.

### Screenshot panel

Third section, on the far right, this panel display different snapshots and informations and can be toggled on by using the View -> Screen shot menu item, or the Alt-N keyboard shortcut.

- Screenshot : Display the screenshot of the currently highlighted game, if you click with the mouse on the screenshot, you'll cycle trough screenshots, flyers, cabinets, marquees, and titles shots. If you have the Screenshoot panel tab activated, you can click on the tab you want.
- Info : The area under the screenshots will also display the mameinfo.dat information followed by the history.dat information if these files are present.

## 3.6 Columns Layout

In this window, you can choose the way informations are displayed in detailled views. You select the info you want to add in the "Available colums" part of the window and clic on Add, identically, to remove one, select it in the "Shown columns" par and click on Remove. Finally you may want to change the order by selecting a item and click on Up or Down.

## 3.7 Directory Selection

In this window, you'll choose path to different directories for your Xmame executable, roms, samples, art and support files. Once your change are done, you can press on Apply to apply your changes, on OK to apply your change and close your window or on Cancel to close the window without taking your changes in account.

GXMame Directories

You will find here path to emulator executables and art file used by GXMame.

- Xmame executables : Click on browse to select an Xmame executable the press add to add it to the Xmame executable list or select an executable in the list and click remove to... remove it.
- catver Path : Choose where your catver file is stored.
- Flyers Path : Choose where your flyers pictures or flyers.zip file are stored.
- Cabinets Path : Choose where your cabinets pictures or cabinets.zip file are stored.
- Marquees Path : Choose where your marquees pictures or marquees.zip file are stored.
- Titles Path : Choose where your titles pictures or titles.zip file are stored.
- Icons Path : Choose where your icons or icons.zip file are stored.

XMame basic paths

You will find here paths needed by XMame to be able to play.

- Roms Paths : Click on browse to select an romspath the press add to add it to the romspath list or select an executable in the list and click remove to... remove it.
- Samples Paths : Click on browse to select an samplespath the press add to add it to the samplespath list or select an executable in the list and click remove to... remove it.
- Artworks Path : Choose where your artworks files are stored.

XMame additionnal paths

Here goes art and support files used by GXMame and XMame.

- Snapshots Path : Choose where your snapshots pictures or snapshots.zip file are stored.
- History file : Choose where your history.dat file is stored.
- Mameinfo file : Choose where your mameinfo.dat file is stored.
- Cheat file : Choose where your cheat.dat file is stored.
- high scores file : Choose where your highscore.dat file is stored.
- Controler Directory : Choose where your controller definitions are stored.

User resources

Finally, here are set the paths to user's personnal datas (user need to have write right on these folders).

- High Scores Path : Choose where your high scores are saved.
- Recorded games Path : Choose where your input files are saved.
- Game configuration Path : Choose where your game configuration files are saved.
- NVRam Path : Choose where your nvram are saved.
- Memory Cards Path : Choose where your memory cards data are saved.
- Game Status Path : Choose where your game status are saved.
- Ini files Path : Choose where your ini files are saved.
- Diff path : Choose where your hard drive image difference files are saved (used by new chd games).

## 3.8 Preferences window

In this window, you'll define options that will be used to run Xmame. Following the way you open that window, you'll change global games setting (from Options... -> Default Option menu) or specific game setting (from Properties menu). For a specific game, you'll also have access to two tab that will give you additional informations and allow you to audit the game.

Once your change are done, you can press on Apply to apply your changes, on OK to apply your change and close your window or on Cancel to close the window without taking your changes in account.

At the top of all tabs, is displayed the complete name of the game and the internal name (used for the game folder or zip) for specific game options.

### General Tab (not for general options)

In this tab, are displayed informations about the selected game:

- Manufacturer : the date of the game release and the manufacturer of this release.
- Status : Display if the game is :
  - Working : The game is available and playable.
  - Not working : The game is available but not playable due to emulation problems. For some games, you can give a try if you get a new set of roms (I'm thinking of the CPS2 games and sets of XOR roms)
  - ROMs missing : The game is not available because some or all roms are missing.
  - UNKNOWN : The games haven't been audited yet (quick or complete audit). you need to audit the game to find out it true status.
- CPU : The main processor(s) and frequency.
- Sound : The main sound processor(s) and frequency.
- Screen : The screen resolution (for raster games), the orientation of the game (horz) or (vert) and the screen frequency refresh.
- Colors : The number or colors of the game.
- Clone of : The complete name of the game and the internal name (used for the game folder or zip) of the parent game if any.

### Audit Tab (not for general options)

When you click on this tab, you automatically activate the audit of the game. after a while, the result is displayed and tell you if Rom and samples audit are/

- Passed : Every files needed are present and correct, the game should work.
- Not passed : Some files are missing, the game wont work.
- Not found : the game folder or zip haven't been found, the game wont work.
- None required (only for Samples): the game doesn't need samples.

in addition, a description of missing/bad size/ bad dump will be displayed in the Details field.

### Display Tab

In this tab, you'll change the Video related options for XMame.

- Draw only changes : Enable/disable use of dirty rectangles (no more available since XMame 0.61).
- Throttle : This option prevents XMame from running games as fast as the host CPU can go. Unless this is toggled on, a modern x86 processor will run Donkey Kong at a thousand times its original speed. Accessible during game with F10.
- Sleep when idle : Enable/disable sleep during idle. Accessible during game with Shift + F10.

Effect

- Effect : This option allows XMame to attempt to simulate more closely the look of the original hardware's monitors, which were much lower resolution devices than modern computer monitors, it use a Video effect from the following (you can see an example of these effects here):
  - none (default)
  - scale2x (smooth scaling effect)
  - scan2 (light scanlines)
  - rgbstripe (3x2 rgb vertical stripes)
  - rgbscan (2x3 rgb horizontal scanlines)
  - scan3 (3x3 deluxe scanlines)
- Use Scanlines : Enable/disable displaying simulated scanlines. Scanlines are small, evenly-spaced, horizontal blank lines that are typical of real arcade monitors. If you don't prefer this "authentic" look, turn scanlines off.

Corrections

- Gamma correction : This option controls the global gamma correction in a game and can result in much brighter video output if moved to the higher setting. Accessible during game with ` or ~ then navigate with Up/Down and change the value with Left/Right
- Brightness correction : This option controls the global brightness in a game at the palette level in XMame and works with 99% of the games, (does not for those that go directly to RGB). Accessible during game with ` or ~ then navigate with Up/Down and change the value with Left/Right

Rotation

- Rotation : This drop down box allows XMame to rotate the video output by 90 degrees in either direction. This setting is useful if used in conjunction with a pivoting monitor, or playing games with a monitor on its side. Doing so allows vertical oriented games to be played full screen.
- Do not apply rotation : Rotate display even if the game ask for it.
- Flip screen upside-down : Flip X axis.
- Flip screen left-right : Flip Y axis.

Frame skipping

- Automatic : Automatically determines the frameskip level while you're playing the game, adjusting it constantly in a frantic attempt to keep the game running at full speed. the number of frame dropped is limited by Max frameskip.
- Frames to skip : This is the number of frames out of every 12 to drop when not using autoframeskip. For example, if you say -frameskip 2, then MAME will display 10 out of every 12 frames. By skipping those frames, you may be able to get full speed in a game that requires more horsepower than your computer has.. (F8 to Reduce frame skip and F9 to Increase frameskip During game)
- Method : Select which autoframeskip and throttle routines to use. Available choices are:
  - Dos frameskip code (left-ctrl + insert During game)
  - Enhanced frameskip code by William A. Barath (left-ctrl + home During game)
- Max frameskip : Set highest allowed frameskip for autoframeskip.

Resolution :

- Heightscale : Set Y-Scale aspect ratio (0-8). (left-shift + home to Increase heightscale and left-shift + end to Decrease heightscale During game)
- Widthscale : Set X-Scale aspect ratio (0-8). (left-shift + insert to Increase widthscale and left-shift + delete to Decrease widthscale During game)
  - (left-shift + pageup to Increase height & width scale left-shift + pagedown to Decrease height & width scale During game)
- Bit per pixels : Specify the colordepth the core should render, one of: Auto, 8, 16, 32.
- scale video to exactly this height : Scale video to exactly this height (0-4096).
- Autodouble : Enable/disable automatic scale doubling for 1:2 pixel aspect ratio games.

### Rendering Tab

x11 options

- DGA fullscreen : Select the DGA fullscreen mode if compiled in, you need to be root or have your Xmame executable with suid. You can use left-alt + insert to switch to Normal window and left-alt + home Fullscreen DGA during game.
- Show cursor : Show the cursor on the XMame window when playing.
- use MIT shared memory : Use MIT Shared Memory (if available and compiled in).
- xv extension : Use Xv extension for hardware scaling (if available, compiled in and MIT shared memory used). (available since xmame-0.61-pr7). If you notice weird colors when using Xv, you can try to force use of YUV or YV12 mode.
- Vidix : Use vidix drivers for hardware scaling. Note that due to licenses compatibility between vidix drivers and Mame, you only can use vidix downloading a patch available at VIDIX Target for XMAME homepage.
  - Fullscreen : Start in fullscreen stretched mode (incompatible with DGA fullscreen use).
  - Geometry : Specify the size of the window. (useful if you don't use any window manager).
  - Force YUV mode : YUV mode (for video cards with broken RGB overlays).
  - Force YV12 mode : Force YV12 mode (for video cards with broken RGB overlays). height & width scales can be both set to 2 to obtain a result less blurry.
- X Synch : Use/don't use XSync instead of XFlush as screen refresh method.
- Private colormap : Use private color map.
- XIL scaling : Enable/disable use of XIL for scaling (if available and compiled in).
  - multi threading : Enable/disable multi threading of XIL.

Open GL options

- Full Screen : Start at fullscreen.
- Double buffering : Enable/disable double buffering.
- texture size : Force the max width and height of one texture segment (0=autosize).
- Bilinear filtering : Enable/disable bilinear filtering.
- GL extension #78 : Force the usage of the gl extension #78, if available (paletted texture).
- True color blitter : Force blitter for true color modes 15/32bpp.
- Draw bitmap : Enable/Disable the drawing of the bitmap - e.g. disable it within vector games for a speedup.
- Color modulation : Enable/Disable color modulation (intensity,gamma).
- Antialiasing : Enable/disable antialiasing.
- Alphablending : Enable/disable alphablending if available.
- Cabinet model : Specify which cabinet model to use (default: glmamejau).
- Resolution : Always scale games to XresxYres, keeping their aspect ratio. This overrides the scale options.
- OpenGL Library : Choose the dynamically loaded OpenGL Library (default libGL.so).
- GLU Library : Choose the dynamically loaded GLU Library (default libGLU.so).

SDL options

- Full Screen : Start fullscreen, Can be switched during the game by pressing Alt + Return.
- Auto Resolution : Determine the best resolution available for running the game.
- SDL Modes: use the specified resolution mode if Auto Resolution is not activated. for XMame <0.61, you will just see number corresponding to the joystick mode, for XMame >=0.61 you will see resolution in the form XRESxYRES.

FX (Glide) options

- keep aspect ratio : Try / don't try to keep the aspect ratio of a game.
- Resolution : Specify the resolution/ windowsize to use in the form of XRESxYRES.

Photon options

- Full Screen : Select the fullscreen Video Overlay mode. You can use left-alt + insert to switch to Normal window and left-alt + home Fullscreen Video Overlay during game.
- Show cursor : Show / don't show the cursor.

Video Mode

- Keep aspect ratio : Try / don't try to keep the aspect ratio of a game when selecting the best videomode. If used, display aspect ratio of your monitor must be set. The default = 1.33 (4/3). Use 0.75 (3/4) for a portrait monitor.
- Disable mode : Don't use mode XRESxYRESxDEPTH this can be used to disable specific video modes which don't work on your system. The xDEPTH part of the string is optional.

GGI options

- linear framebuffer (fast) : Enable/disable use of linear framebuffer (fast).
- Force resolutions : Force X and Y resolutions.

SVGA options

- planar (modeX) modes : Enable/disable use of planar (modeX) modes (slow).
- linear framebuffer (fast) : Enable/disable use of linear framebuffer (fast).
- Use tweaked VGA modes : Enable/disable svgalib tweaked video modes.
- Center X : Adjust the horizontal center of tweaked vga modes.
- Center Y : Adjust the vertical center of tweaked vga modes.

### Sound Tab

- Enable sound : This setting toggles sound on or off in games.
  - Use samples : This setting allows XMame to utilize samples for games which do not have their sound hardware emulated, or were using analogue circuitry.
- Fake sound : Generate sound even when sound is disabled, this is needed for some games which won't run without sound.
- Samplerate : Sets the audio sample rate. Smaller values (e.g. 11025) cause lower audio quality but faster emulation speed. Higher values (e.g. 44100) cause higher audio quality but slower emulation speed. The default is 44100.
- Volume attenuation : Sets the startup volume. The volume is an attenuation in dB: e.g., "-volume -12" will start with -12dB attenuation. The default is 0. Accessible during game with ` or ~ then navigate with Up/Down and change the value with Left/Right.
- Buffer size : Number of frames of sound to buffer
- Audio device : Use an alternative audiodevice.
- Mixer device : Use an alternative mixerdevice.
- DSP Plugin : Select which plugin to use for digital sound. Following the Xmame compilation options, you may have choice between:
  - Open Sound System : OSS, one of the standard sound system.
  - Alsa Sound System : ALSA, another standard sound system.
  - aRts : aRts sound server.
  - Esound : Enlightment sound daemon.
  - Simple Direct Library : SDL Layer.
  - Wave File Output: Save sound to a file using Microsoft's PCM WAVE format.
- Mixer Plugin : Select which plugin to use for the sound mixer (if compiled in).
- Sound file name : select the file to save sound when using the Wave file output DSP Plugin.
- timer based audio : Use / don't use timer based audio (normally it will be used automagically when necessary).

aRts Options

- aRts buffer delay time : aRts buffer delay time.

QNX Options

- use preferred device : Use the preferred device or use the primary device.

Alsa Sound System Options

- PCM : Specify the PCM by name.
- buffer size µs : Set the buffer size [micro sec] (default: 250000).
- Card ID : select card # or card id (0-32).
- Device # : select device number.

### Controllers Tab

Joystick

- Joystick type : Select type of joystick support to use. Following the Xmame compilation options, you may have choice between:
  - No joystick
  - i386 style joystick driver (if compiled in)
  - Fm Town Pad support (if compiled in)
  - X11 input extension joystick (if compiled in)
  - new i386 linux 1.x.x joystick driver(if compiled in)
  - NetBSD USB joystick driver (if compiled in)
  - PS2-Linux native pad (if compiled in)
  - SDL (if XMame target is SDL)
- Joystick device prefix : Joystick device prefix (defaults to /dev/js) for linux. You don't need to specifie the number (js0, js1, js2...) since XMame will iterate through all /dev/js* device to find the joystick.
- Name of pad device (FM townpad) : Name of pad device (defaults to /dev/pad00).
- X-based device : Name of X-based joystick device (if compiled in).
- Analog joystick : Use Joystick as analog for analog controls.
- Rapid-fire : Enable rapid-fire support for joysticks.
- UGCI(tm) coin play support : Enable UGCI(tm) coin/play support ( UGCI at Happ Controls)
- HotRod support : Sets a default keyboard configuration suitable for the HotRod joystick by HanaHo Games.
- HotRod SE support : Sets a default keyboard configuration suitable for the HotRod SE joystick by HanaHo Games.
- Xinput joystick : Device name for joystick of player 1/2/3/4 (currently broken in XMame).

Mouse / Trackball

- use mouse : Enable/disable mouse (if supported).
- Grab mouse : Enable/disable mousegrabbing (for X11 and photon targets). When this is enabled, you will not be able to use your mouse for other things while playing a game. Can be toggled by alt + pagedown during game.
- Xinput trackball : Device name for trackball of player 1/2/3/4.

Keyboard

- Grab keyboard : Enable/disable keyboardgrabbing (for X11 target). When this is enabled, you will not be able to use your keyboard for other things while playing a game. Can be toggled by alt + pageup during game.
- Enable Windows keys : Enable/disable mapping of windowskeys under X (for X11 and photon targets).
- Keyboard Layout type : allow you to select a keyboard with a different mapping (for the moment only French and German ones are available).

### Misc Tab

- Use additional game artwork : Enable or disable usage of additional artwork. For XMame <0.61 it only use one type of artwork, for XMame >=0.61 it use three type of artwork (backdrops, overlays, bezel) that can be enable individually.

Use additional game artwork

- Backdrops : Enable usage of backdrops.
- Bezels : Enable usage of bezels.
- Overlays : Enable usage of overlays.

- Artwork Resolution : Set the artwork resolution to Auto high or low.

Artwork Misc

- Crop artwork : Shrink the scene down to the games original dimensions, cropping any available art pieces.

Other Options

- Use keyboard LEDs as game indicators : Not yet implementer in XMame.
- Enable game cheats : Use some cheats that are present in games like Defender and Battlezone to make control easier. It also allows for the use of an external cheat.dat file which can be used to cheat illegally in games in a variety of ways, including infinite lives, level jumping, etc...
- Skip Disclaimer Info : Allows you to skip the disclaimer screen.
- Skip gameinfo : Allows you to skip the gameinfo screen
- Use additional options : with this option you can define new options to pass to XMame like the infamous "-rid `xwininfo -root | grep xwininfo: | awk '{print $4}'`" which is needed for xmame.x11 to show up on some version of KDE or any option you developed or not yet available in GXMame.
- debug windows (for developers) : Activates the integrated debugger. During emulation, press the Tilde key (~) to activate the debugger. (Available if compiled in)
- Window size : Specify the resolution/windowsize to use for the debugger(window) in the form of XRESxYRES (minimum size = 640x480)
- Log debug info : Creates a log of illegal memory accesses into a file set by the following parameter.
- File : Set the logfile name for the debugging info.
- Neo-Geo Bios : Set the Bios version used by Xmame.

- Use network : Use the network with the following options.

Network Options

Network Mode

- Client Mode : Enable client mode and try to connect to the hot defined below.
- Host : The host to which connect when running as client.
- Server Mode : Enable server mode and se the number of player defined below
- Number of player : Number of player to use when running as server.
- Use NetMapKey : When enabled all players use the player 1 keys. For use with *real* multiplayer games.
- State debug : Check complete machine state against slaves at each frame -- extremely slow, for debugging.
- Bind port : Specify a UDP port on which to accept messages.
- Perform network input sync in advance : Perform network input sync in advance: Causes ~ 16 ms input delay but more suitable for relatively slow machines.

### Vector Tab

- Draw antialiased vectors : Antialiasing for vector games.
- Draw tranlucencent vectors : Enables or disables vector translucency. Colors of crossing vector beams will be merged.
- Beam size : Sets the width in pixels of the vectors. This option expects a float in the range of 1.00 through 16.00.
- Flicker : Makes the vectors flicker. This option requires a float argument in the range of 0.00 through 100.00.
- Intensity : Change the brightness/intensity of the vector lines. This option requires a float argument in the range of 0.50 through 3.00.
- Use fixed resolution : Always scale vectorgames to XresxYres, keeping their aspect ratio. This overrides the scale options.

Open GL options

- Draw bitmap : Enable/Disable the drawing of the bitmap - e.g. disable it within vector games for a speedup.
- Antialiasing : Enable/disable antialiasing.

## 3.9 Startup Options Window

In this window, you can set several option for the GUI:

- Search for new games : Check if zip file of non working games or not checked games are present at startup.
- Enable version mismatch warning : Display a warning if the gamelist was created by a different version of XMame.
- Allow selection by a Joystick : Allow to use Joystick to select and launch a game.
- joystick device : Set the joystick used to control the game selection.

## 3.10 About Window

This window display credit information about GXMame, X-Mame and Mame.

Next Previous Contents