Man Linux: Main Page and Category List

NAME

       MAME - The Multiple Arcade Machine Emulator

SYNOPSIS

       mame [options] gamename

DESCRIPTION

       Started  in  1997 by Nicola Salmoria, MAME was originally intended as a
       series of emulators for individual games,  which  were  later  combined
       into  a  single  multi-game emulator. In the following years, MAME grew
       over and over up to the actual size, with more than 100 contributors to
       the project.

OPTIONS

   Core commands
       -help, -?
              Displays current MAME version and copyright notice.

       -validate, -valid
              Performs  internal validation on every driver in the system. Run
              this before  submitting  changes  to  ensure  that  you  haven't
              violated any of the core system rules.

   Configuration commands
       -createconfig, -cc
              Creates  the default mame.ini file in the current directory. All
              the configuration options (not commands) described below can  be
              permanently changed by editing this configuration file.

       -showconfig, -sc
              Displays the current configuration settings.

       -showusage, -su
              Displays  a summary of all the command line options. For options
              that are not mentioned here, the short  summary  given  by  mame
              -showusage is usually sufficient.

   Frontend commands
       NOTE:  By  default,  all  the  '-list' commands below write info to the
       screen.  If you wish to write the  info  to  a  textfile  instead,  use
       redirection,  e.g.  mame -listxml > ~/mamelist.xml writes the full list
       of supported game to file mamelist.xml in your home directory.

       -listxml, -lx [gamename|wildcard]
              List comprehensive details for all of the supported  games.  The
              output  is  quite long, so it is usually better to redirect this
              into a file.  The output is in XML format. By default all  games
              are  listed;  however,  you  can limit this list by specifying a
              driver name or wildcard after the -listxml command.

       -listfull, -ll [gamename|wildcard]
              Displays a list  of  game  driver  names  and  descriptions.  By
              default  all  games are listed; however, you can limit this list
              by specifying a driver name  or  wildcard  after  the  -listfull
              command.

       -listsource, -ls [gamename|wildcard]
              Displays  a  list  of  drivers and the names of the source files
              their game drivers live in. Useful for finding  which  driver  a
              game  runs  on  in  order  to fix bugs. By default all games are
              listed; however, you can limit this list by specifying a  driver
              name or wildcard after the -listsource command.

       -listclones, -lc [gamename|wildcard]
              Displays  a  list  of  clones. By default all clones are listed;
              however, you can limit this list by specifying a driver name  or
              wildcard after the -listclones command.

       -listbrothers, -lb [gamename|wildcard]
              Displays  a  list  of  "brothers"  or  other  drivers  from same
              sourcefile.  By default all games are listed; however,  you  can
              limit  this  list  by specifying a driver name or wildcard after
              the -listbrothers command.

       -listcrc
              Displays a full list of CRCs of all ROM images referenced by all
              drivers within MAME code.

       -listroms gamename
              Displays  a list of ROM images referenced by the specified game.

       -listsamples gamename
              Displays a list of samples referenced by the specified game.

       -verifyroms [gamename|wildcard]
              Checks for invalid or missing ROM images. By default all drivers
              that  have  valid  ZIP  files  or directories in the rompath are
              verified; however, you can  limit  this  list  by  specifying  a
              driver name or wildcard after the -verifyroms command.

       -verifysamples [gamename|wildcard]
              Checks  for  invalid  or missing samples. By default all drivers
              that have valid ZIP files or directories in the  samplepath  are
              verified;  however,  you  can  limit  this  list by specifying a
              driver name or wildcard after the -verifyroms command.

       -romident
              Attempts to identify ROM files, if they are known  to  MAME,  in
              the  specified  .zip file or directory. This command can be used
              to try and identify ROM sets taken from unknown boards. On exit,
              the errorlevel is returned as one of the following:
              0  all files were identified
              7  all files were identified except for some "non-ROM" files
              8  some files were identified
              9  no files were identified

       -listdevices, -ld
              Output  the list of devices referenced by a given game or set of
              games.

       -listmedia, -lm
              Output the list of available media for the system.

       -listsoftware
              Output the list of known software for the system.

   Configuration options
       -[no]readconfig, -[no]rc
              Enables or disables  the  reading  of  the  config  files.  When
              enabled  (which is the default), MAME reads the following config
              files in order:
              1. mame.ini
              the main configuration file
              2. [name].ini
              where name is your executable name, i.e. mame unless you changed
              it  (e.g.  if you renamed mame to mame0137, the parsed file will
              be mame0137.ini)
              3. debug.ini, if the debugger is enabled
              4. vector.ini, for vector games only
              5. [driver].ini
              based on the source filename of the game driver
              6. [parent].ini
              for clones only, may be called recursively
              7. [gamename].ini
              note this sometimes resolves to the same of the source driver
              The settings in the later ini's override those  in  the  earlier
              ini's.   So,  for  example,  if  you  wanted  to disable overlay
              effects in the vector games, you can create  a  vector.ini  with
              the  "effect  none"  line  in  it, and it will override whatever
              effect value you have  in  your  mame.ini.  The  default  is  ON
              (-readconfig).

   Search path options
       IMPORTANT:  Please use the path, directory and file options in mame.ini
       ONLY. Otherwise, the outcome may be unpredictable  and  not  consistent
       across releases.

       -rompath, -rp, -biospath, -bp, pathname
              Specifies  a list of paths within which to find ROM or hard disk
              images.  Multiple paths can be specified by separating them with
              semicolons.   The default is 'roms' (that is, a directory "roms"
              in the same directory as the MAME executable).

       -samplepath, -sp pathname
              Specifies a list of paths within which  to  find  sample  files.
              Multiple   paths  can  be  specified  by  separating  them  with
              semicolons. The default  is  'samples'  (that  is,  a  directory
              "samples" in the same directory as the MAME executable).

       -artpath, -artwork_directory pathname
              Specifies  a  list  of paths within which to find artwork files.
              Multiple  paths  can  be  specified  by  separating  them   with
              semicolons.  The  default  is  'artwork'  (that  is, a directory
              "artwork" in the same directory as the MAME executable).

       -ctrlrpath, -ctrlr_directory pathname
              Specifies   a   list   of   paths   within   which    to    find
              controller-specific  configuration  files. Multiple paths can be
              specified by separating them with  semicolons.  The  default  is
              'ctrlr'  (that  is, a directory "ctrlr" in the same directory as
              the MAME executable).

       -inipath pathname
              Specifies a list of paths  within  which  to  find  .INI  files.
              Multiple   paths  can  be  specified  by  separating  them  with
              semicolons. The default is '/etc/mame/'.

       -fontpath pathname
              Specifies a list of paths within which to find .BDF font  files.
              Multiple   paths  can  be  specified  by  separating  them  with
              semicolons. The default is '.' (that  is,  search  in  the  same
              directory as the MAME executable).

       -cheatpath pathname
              Specifies  a  list  of  paths  within which to find cheat files.
              Multiple  paths  can  be  specified  by  separating  them   with
              semicolons. The default is 'cheat' (that is, a directory "cheat"
              in the same directory as the MAME executable).

       -crosshairpath pathname
              Specifies a list of paths within which to find crosshair  files.
              Multiple   paths  can  be  specified  by  separating  them  with
              semicolons. The default is 'crosshair'  (that  is,  a  directory
              "crosshair"  in  the same directory as the MAME executable).  If
              the Crosshair is set to default in the menu, MAME will look  for
              gamenamespecified  crosshairpath,  where # is the player number.
              Failing that, MAME will use built-in default crosshairs.

   Output Directory Options
       -cfg_directory pathname
              Specifies a  single  directory  where  configuration  files  are
              stored.   Configuration  files  store user configurable settings
              that are read at  startup  and  written  when  MAME  exits.  The
              default  is  'cfg'  (that  is,  a  directory  "cfg"  in the same
              directory as the MAME executable). If this  directory  does  not
              exist, it will be automatically created.

       -nvram_directory pathname
              Specifies a single directory where NVRAM files are stored. NVRAM
              files store the contents of EEPROM and non-volatile RAM  (NVRAM)
              for games which used this type of hardware. This data is read at
              startup and written when MAME  exits.  The  default  is  'nvram'
              (that  is, a directory "nvram" in the same directory as the MAME
              executable). If this  directory  does  not  exist,  it  will  be
              automatically created.

       -memcard_directory pathname
              Specifies a single directory where memory card files are stored.
              Memory card files store the contents of removable  memory  cards
              for  games  which  used this type of hardware. This data is read
              and written under control of the user via the "Memory Card" menu
              in  the  user  interface.  The  default is 'memcard' (that is, a
              directory  "memcard"  in  the  same  directory   as   the   MAME
              executable).  If  this  directory  does  not  exist,  it will be
              automatically created.

       -input_directory pathname
              Specifies a single directory where  input  recording  files  are
              stored.  Input recordings are created via the -record option and
              played back via the -playback option. The default is 'inp' (that
              is,  a  directory  "inp"  in  the  same  directory  as  the MAME
              executable). If this  directory  does  not  exist,  it  will  be
              automatically created.

       -state_directory pathname
              Specifies  a single directory where save state files are stored.
              Save state files are read and written either upon user  request,
              or  when  using the -autosave option. The default is 'sta' (that
              is, a  directory  "sta"  in  the  same  directory  as  the  MAME
              executable).  If  this  directory  does  not  exist,  it will be
              automatically created.

       -snapshot_directory pathname
              Specifies a single directory where screen snapshots are  stored,
              when  requested  by  the user. The default is 'snap' (that is, a
              directory "snap" in the same directory as the MAME  executable).
              If  this  directory  does  not  exist,  it will be automatically
              created.

       -diff_directory pathname
              Specifies a single directory where hard drive differencing files
              are stored. Hard drive differencing files store any data that is
              written back to a hard disk image,  in  order  to  preserve  the
              original  image.  The  differencing files are created at startup
              when a game with a hard disk image. The default is 'diff'  (that
              is,  a  directory  "diff"  in  the  same  directory  as the MAME
              executable). If this  directory  does  not  exist,  it  will  be
              automatically created.

       -comment_directory pathname
              Specifies  a  single  directory where debugger comment files are
              stored.  Debugger comment files are written by the debugger when
              comments are added to the disassembly for a game. The default is
              'comments'  (that  is,  a  directory  "comments"  in  the   same
              directory  as  the MAME executable).  If this directory does not
              exist, it will be automatically created.

   State/playback options
       -state slot
              Immediately after starting the specified game,  will  cause  the
              save state in the specified slot to be loaded.

       -[no]autosave
              When  enabled,  automatically  creates  a  save  state file when
              exiting MAME and automatically attempts to reload it when  later
              starting MAME with the same game. This only works for games that
              have explicitly enabled save state support in their driver.  The
              default is OFF (-noautosave).

       -playback, -pb filename
              Specifies  a  file  from  which  to  play  back a series of game
              inputs. This feature does not work reliably for all  games,  but
              can  be  used  to  watch a previously recorded game session from
              start to finish. In order to make things consistent, you  should
              only  record  and  playback with all configuration (.cfg), NVRAM
              (.nv), and memory card files deleted. The default  is  NULL  (no
              playback).

       -record, -rec filename
              Specifies  a  file to record all input from a game session. This
              can be used to record a game session for  later  playback.  This
              feature does not work reliably for all games, but can be used to
              watch a previously recorded game session from start  to  finish.
              In  order  to make things consistent, you should only record and
              playback with all configuration (.cfg), NVRAM (.nv), and  memory
              card files deleted. The default is NULL (no recording).

       -snapname name
              Describes  how  MAME  should name files for snapshots. name is a
              string that provides a template  that  is  used  to  generate  a
              filename.   Three  simple  substitutions  are  provided:  the  /
              character represents the path separator on any  target  platform
              (even  Windows); the string %g represents the driver name of the
              current game; and  the  string  %i  represents  an  incrementing
              index. If %i is omitted, then each snapshot taken will overwrite
              the previous one; otherwise, MAME will find the next empty value
              for  %i and use that for a filename. The default is %g/%i, which
              creates a separate folder for each game, and names the snapshots
              under it starting with 0000 and increasing from there.

       -snapsize widthxheight
              Hard-codes  the  size  for  snapshots  and  movie  recording. By
              default, MAME  will  create  snapshots  at  the  game's  current
              resolution  in  raw pixels, and will create movies at the game's
              starting resolution in raw pixels. If you specify  this  option,
              then  MAME  will  create  both  snapshots and movies at the size
              specified, and will bilinear filter the result. Note  that  this
              size  does  not  automatically  rotate if the game is vertically
              oriented. The default is 'auto'.

       -snapview viewname
              Specifies the view to use when rendering snapshots  and  movies.
              By  default, both use a special 'internal' view, which renders a
              separate snapshot per screen or renders movies only of the first
              screen. By specifying this option, you can override this default
              behavior and select  a  single  view  that  will  apply  to  all
              snapshots  and movies.  Note that viewname does not need to be a
              perfect match; rather, it will select the first view whose  name
              matches  all  the characters specified by viewname. For example,
              -snapview native will  match  the  "Native  (15:14)"  view  even
              though  it is not a perfect match.  viewname can also be 'auto',
              which selects the first  view  with  all  screens  present.  The
              default value is 'internal'.

       -mngwrite filename
              Writes  each  video  frame  to the given filename in MNG format,
              producing an animation of the game session. Note that  -mngwrite
              only  writes  video frames; it does not save any audio data. Use
              -wavwrite for that, and reassemble the audio/video using offline
              tools. The default is NULL (no recording).

       -aviwrite filename
              Stream video and sound data to the given filename in AVI format,
              producing an animation of the game session complete with  sound.
              The default is NULL (no recording).

       -wavwrite filename
              Writes  the  final  mixer  output  to  the given filename in WAV
              format, producing an audio recording  of  the     game  session.
              The default is NULL (no recording).

       -[no]burnin
              Tracks  brightness  of  the screen during play and at the end of
              emulation generates a PNG that can be used to  simulate  burn-in
              effects  on  other games. The resulting PNG is created such that
              the least used-areas  of  the  screen  are  fully  white  (since
              burned-in  areas  are darker, all other areas of the screen must
              be lightened a touch).  The intention is that this  PNG  can  be
              loaded  via an artwork file with a low alpha (e.g, 0.1-0.2 seems
              to work well) and blended over the entire screen. The PNG  files
              are     saved     in    the    snap    directory    under    the
              gamename\burnin-<screen.name>.png.   The    default    is    OFF
              (-noburnin).

   Performance options
       -[no]autoframeskip, -[no]afs
              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.  Turning  this on
              overrides the value you  have  set  for  -frameskip  below.  The
              default is OFF (-noautoframeskip).

       -frameskip, -fs value
              Specifies  the frameskip value (autoframeskip must be disabled).
              This is the number of frames  out  of  every  12  to  drop  when
              running.  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. The default value is 0, which
              skips no frames.

       -seconds_to_run, -str value
              This  option can be used for benchmarking and automated testing.
              It tells MAME to stop execution after a fixed number of seconds.
              By  combining  this  with  a  fixed  set  of  other command line
              options,  you  can  set  up   a   consistent   environment   for
              benchmarking  MAME performance. In addition, upon exit, the -str
              option will write a screenshot called final.png  to  the  game's
              snapshot directory.

       -[no]throttle
              Configures the default thottling setting. When throttling is on,
              MAME attempts to keep the game running at  the  game's  intended
              speed.  When throttling is off, MAME runs the game as fast as it
              can. Note that the fastest speed is more often than not  limited
              by  your  graphics card, especially for older games. The default
              is ON (-throttle).

       -[no]sleep
              Allows MAME to give time back to the system  when  running  with
              -throttle.   This  allows  other programs to have some CPU time,
              assuming that the game isn't taxing 100% of your CPU  resources.
              This  option  can  potentially  cause  hiccups in performance if
              other  demanding  programs  are  running.   The  default  is  ON
              (-sleep).

       -speed Controls  the  speed  of gameplay, relative to realtime; smaller
              numbers are slower. Default is 1.00.

       -refreshspeed, -rs
              Automatically adjusts the -speed parameter to keep the effective
              refresh rate below that of the lowest screen refresh rate.

       -multithreading, -mt
              Enable  multithreading; this enables rendering and blitting on a
              separate thread. The default is OFF.

       -numprocessors, -np
              Set number of processors; this overrides the number  the  system
              reports.

       -sdlvideofps
              Show SDL video performance.

   Rotation options
       -[no]rotate
              Rotate the game to match its normal state (horizontal/vertical).
              This ensures that  both  vertically  and  horizontally  oriented
              games show up correctly without the need to rotate your monitor.
              If you want to keep the game displaying 'raw' on the screen  the
              way  it  would  have  in  the  arcade, turn this option OFF. The
              default is ON (-rotate).

       -[no]ror | -[no]rol
              Rotate  the  game  screen  to  the  right  (clockwise)  or  left
              (counter-  clockwise)  relative  to  either its normal state (if
              -rotate is specified) or  its  native  state  (if  -norotate  is
              specified). The default for both of these options is OFF (-noror
              -norol).

       -[no]autoror | -[no]autorol
              These options are designed for use with  pivoting  screens  that
              only  pivot  in  a  single direction. If your screen only pivots
              clockwise, use -autorol to ensure that the game  will  fill  the
              screen   either   horizontally  or  vertically  in  one  of  the
              directions  you  can  handle.   If  your  screen   only   pivots
              counter-clockwise, use -autoror.

       -[no]flipx

       -[no]flipy
              Flip  (mirror)  the  game screen either horizontally (-flipx) or
              vertically (-flipy). The flips are applied after the -rotate and
              -ror/-rol  options  are  applied.  The default for both of these
              options is OFF (-noflipx -noflipy).

   Artwork options
       -[no]artwork_crop, -[no]artcrop
              Enable cropping of artwork to the game screen  area  only.  This
              option  can also be controlled via the Video Options menu in the
              user interface. The default is OFF (-noartwork_crop).

       -[no]use_backdrops, -[no]backdrop
              Enables/disables the display of backdrops.  The  default  is  ON
              (-use_backdrops).

       -[no]use_overlays, -[no]overlay
              Enables/disables  the  display  of  overlays.  The default is ON
              (-use_overlays).

       -[no]use_bezels, -[no]bezel
              Enables/disables the  display  of  bezels.  The  default  is  ON
              (-use_bezels).

   Screen options
       -brightness value
              Controls  the  default  brightness,  or black level, of the game
              screens.  This option does not affect the artwork or other parts
              of the display.  Using the MAME UI, you can individually set the
              brightness for  each  game  screen;  this  option  controls  the
              initial  value  for all visible game screens. The standard value
              is 1.0. Selecting lower values (down  to  0.1)  will  produce  a
              darkened display, while selecting higher values (up to 2.0) will
              give a brighter display. The default is 1.0.

       -contrast value
              Controls the contrast, or white level, of the game screens. This
              option  does  not  affect  the  artwork  or  other  parts of the
              display. Using  the  MAME  UI,  you  can  individually  set  the
              contrast  for each game screen; this option controls the initial
              value for all visible game screens. The standard value  is  1.0.
              Selecting  lower  values  (down  to  0.1)  will produce a dimmer
              display, while selecting higher values (up to 2.0) will  give  a
              more saturated display. The default is 1.0.

       -gamma value
              Controls the gamma, which produces a potentially nonlinear black
              to white ramp, for the game screens. This option does not affect
              the  artwork  or  other parts of the display. Using the MAME UI,
              you can individually set the gamma for each  game  screen;  this
              option  controls the initial value for all visible game screens.
              The standard value is 1.0, which gives a linear ramp from  black
              to white. Selecting lower values (down to 0.1) will increase the
              nonlinearity toward black, while selecting higher values (up  to
              3.0)  will  push  the  nonlinearity toward white. The default is
              1.0.

       -pause_brightness value
              This controls the brightness level  when  MAME  is  paused.  The
              default value is 0.65.

   Vector rendering options
       -[no]antialias, -[no]aa
              Enables antialiased line rendering for vector games. The default
              is ON (-antialias).

       -beam width
              Sets the width of the vectors. This is a scaling factor  against
              the  standard vector width. A value of 1.0 will keep the default
              vector line width. Smaller values will  reduce  the  width,  and
              larger values will increase the width. The default is 1.0.

       -flicker value
              Simulates a vector "flicker" effect, similar to a vector monitor
              that needs adjustment. This option requires a float argument  in
              the  range  of 0.00-100.00 (0=none, 100=maximum). The default is
              0.

   Video options
       -video [soft|opengl|opengl16|none]
              Specifies which video subsystem to use for drawing:
              soft   uses  software  rendering,  which  is  slower  but   more
              compatible.
              opengl   uses  OpenGL  and your graphics accelerator to speed up
              many aspects of  drawing  MAME  including  compositing  artwork,
              overlays,  and  bezels,  as  well as stretching the image to fit
              your screen.
              opengl16  uses  alternate  OpenGL  code,  which  should  provide
              faster output on some cards.
              none  does no drawing and is intended for CPU benchmarking.
              Default is SOFT.

       -numscreens
              Reserved for future use.

       -[no]window, -[no]w
              Run  MAME  in  either  full  screen  or  a  window.  This  is  a
              fully-featured window mode where the window resizes as necessary
              to  track  what  the game does.  And you can resize it  yourself
              with your OS's standard window controls.   The  default  is  OFF
              (-nowindow).

       -[no]maximize, -[no]max
              Controls  initial window size in windowed mode. If it is set on,
              the window will initially be set to the maximum  supported  size
              when  you start MAME. If it is turned off, the window will start
              out at the smallest supported size.  This  option  only  has  an
              effect  when  the  -window  option  is  used.  The default is ON
              (-maximize).

       -keepaspect, -ka
              Forces the correct aspect ratio. This means when you're resizing
              the window in windowed mode the actual game image will resize in
              discrete  steps  to  maintain  the  proper  shape  of  the  game
              graphics.  If  you  turn  this  off you can resize the window to
              anything you like and get funny squishing and  stretching.   The
              same applies for full-screen. Default is ON (-keepaspect).

       -unevenstretch, -ues
              Allow  non-integer  stretch  factors.  Video purists should stay
              far, far away from this option,  while  everyone  else  will  be
              happy  to  know  that  it  lets  you fill the screen properly in
              full-screen mode. Default is ON (-unevenstretch).

       -effect
              Name of a PNG file to use for visual effects, or 'none'. Default
              is 'none'.

       -centerh
              Center   horizontally  within  the  view  area.  Default  is  ON
              (-centerh).

       -centerv
              Center  vertically  within  the  view  area.   Default   is   ON
              (-centerv).

       -waitvsync
              Enable  waiting for the start of VBLANK before flipping screens;
              reduces tearing effects.

   Software video rendering subsystem options
       NOTE: All the options in this group are  available  only  with  softare
       video rendering subsystem, i.e -video soft.

       -prescale
              Scale screen rendering by this amount in software. Default is 1.

       -scalemode, -sm [none|async|yv12|yuy2|yv12x2|yuy2x2]
              Hardware scaling mode.
              none    use software rendering.
              async   async overlay.
              yv12    yv12 overlay.
              yuy2    yuy2 overlay.
              yv12x2  yv12 overlay using x2 prescaling.
              yuy2x2  yuy2 overlay using x2 prescaling.
              Default is NONE.

   OpenGL video rendering subsystem options
       NOTE: All the options in this group  are  available  only  with  OpenGL
       video rendering subsystem, i.e -video opengl or -video opengl16.

       -filter, -glfilter, -flt
              Enable  bilinear  filtering  on  screen  output.  Default  is ON
              (-filter).

       -prescale
              Scale screen rendering by this amount in software. Default is 1.

       -gl_forcepow2texture
              Force power of two textures. Default is NO.

       -gl_notexturerect
              Don't  use  OpenGL GL_ARB_texture_rectangle. Default is ON: turn
              off (set this to 0) if corruption occurs in OpenGL mode, at cost
              of some performance loss.

       -gl_vbo
              Enable  OpenGL  VBO,  if  available, for a performance increase.
              Default is ON: turn off (set this to 0) if corruption occurs.

       -gl_pbo
              Enable OpenGL PBO, if available,  for  a  performance  increase.
              Default is ON: turn off (set this to 0) if corruption occurs.

       -gl_glsl
              Enable OpenGL GLSL, if available, for a performance increase.

       -gl_glsl_filter
              Enable  OpenGL  GLSL  filtering instead of FF filtering 0=plain,
              1=bilinear.  Default is 1: bilinear.

       -glsl_shader_mame[0-9]
              Preferred custom OpenGL GLSL shader set mame bitmap (from  0  to
              9).

       -glsl_shader_screen[0-9]
              Preferred custom OpenGL GLSL shader screen bitmap (from 0 to 9).

       -gl_glsl_vid_attr
              Enable OpenGL GLSL handling of brightness and  contrast.  Better
              RGB game performance for free. Default is ON.

       -resolution, -r
              Select  the  resolution  to use in full-screen mode.  -switchres
              must be enabled for this to work.

       -screen

       -aspect, -screen_aspect

       -view

       -screen[0-3]

       -aspect[0-3]

       -resolution[0-3], -r[0-3]

       -view[0-3]
              All these options are reserved for future use.

   Full screen options
       -[no]switchres
              Affects full screen mode only. Chooses if MAME can try to change
              the  screen resolution (color depth is normally left alone) when
              in full-screen mode. If it's off, you always  get  your  desktop
              resolution in full-screen mode (which can be useful for LCDs).

       -useallheads
              Split full screen image across monitors.

   Sound options
       -[no]sound
              Enable  or disable sound altogether. The default is ON (-sound).

       -samplerate, -sr value
              Sets the audio sample rate. Smaller values  (e.g.  11025)  cause
              lower  audio  quality  but faster emulation speed. Higher values
              (e.g. 48000) cause higher audio  quality  but  slower  emulation
              speed. The default is 48000.

       -[no]samples
              Use samples if available. The default is ON (-samples).

       -volume, -vol value
              Sets  the  startup volume. It can later be changed with the user
              interface (see Keys section). The volume is  an  attenuation  in
              dB:  e.g.,  "-volume -12" will start with -12dB attenuation. The
              default is 0.

       -audio_latency value
              This controls  the  amount  of  latency  built  into  the  audio
              streaming.   The latency parameter controls the lower threshold.
              The default is 1 (meaning lower=1/5 and upper=2/5). Set it to  2
              (-audio_latency  2) to keep the sound buffer between 2/5 and 3/5
              full. If you crank it up to 4, you  can  definitely  notice  the
              lag.

   Input options
       -[no]coin_lockout, -[no]coinlock
              Enables  simulation  of  the  "coin  lockout"  feature  that  is
              implmeneted on a number of game PCBs. It was up to the  operator
              whether  or not the coin lockout outputs were actually connected
              to the  coin  mechanisms.  If  this  feature  is  enabled,  then
              attempts  to  enter a coin while the lockout is active will fail
              and will display a popup message in the user interface. If  this
              feature  is  disabled,  the coin lockout signal will be ignored.
              The default is ON (-coin_lockout).

       -ctrlr controller
              Enables support for special controllers. Configuration files are
              loaded  from  the  ctrlrpath. They are in the same format as the
              .cfg files that are saved, but only control  configuration  data
              is read from the file. The default is NULL (no controller file).

       -[no]mouse
              Controls whether or not MAME looks for  a  mouse  controller  to
              use.  Note  that in many cases, lightguns are treated as mice by
              the operating system, so you may need to enable this  to  enable
              lightgun  support. When this is enabled, you will not be able to
              use your mouse while playing a game. If you want to get  control
              of your computer back, you will need to either pause the game or
              quit. The default is OFF (-nomouse).

       -[no]joystick, -[no]joy
              Controls  whether  or  not  MAME  looks   for   joystick/gamepad
              controllers.  The default is ON (-joystick).

       -[no]lightgun, -[no]gun
              Controls  whether or not MAME makes use of lightgun controllers.
              Note that most lightguns map to the mouse,  so  using  -lightgun
              and  -mouse together may produce strange results. The default is
              OFF (-nolightgun).

       -[no]multikeyboard, -[no]multikey
              Determines  whether   MAME   differentiates   between   multiple
              keyboards.   Some  systems may report more than one keyboard; by
              default, the data from all of these  keyboards  is  combined  so
              that  it  looks  like  a single keyboard. Turning this option on
              will enable MAME to report  keypresses  on  different  keyboards
              independently. The default is OFF (-nomultikeyboard).

       -[no]multimouse
              Determines  whether  MAME  differentiates between multiple mice.
              Some systems may report more than one mouse device; by  default,
              the  data  from  all  of these mice is combined so that it looks
              like a single mouse. Turning this option on will enable MAME  to
              report  mouse  movement  and  button  presses  on different mice
              independently. The default is OFF (-nomultimouse).

       -[no]steadykey, -[no]steady
              Some games require two or more buttons to be pressed at  exactly
              the  same  time to make special moves. Due to limitations in the
              PC keyboard hardware, it can be difficult or even impossible  to
              accomplish  that  using  the  standard  keyboard  handling. This
              option selects a different handling  that  makes  it  easier  to
              register  simultaneous  button presses, but has the disadvantage
              of  making  controls  less  responsive.  The  default   is   OFF
              (-nosteadykey).

       -[no]offscreen_reload, -[no]reload
              Controls whether or not MAME treats a second button input from a
              lightgun as a reload signal. In this case, MAME will report  the
              gun's  position  as  (0,MAX)  with  the  trigger  held, which is
              equivalent to an offscreen reload. This is only needed for games
              that required you to shoot offscreen to reload, and then only if
              your gun does not support off screen reloads. The default is OFF
              (-nooffscreen_reload).

       -joystick_map, -joymap map
              Controls  how  joystick values map to digital joystick controls.
              See  /usr/share/doc/mame/config.txt  for  full  details  on  map
              format.

       -joystick_deadzone, -joy_deadzone, -jdz value
              If  you  play  with  an  analog joystick, the center can drift a
              little.  joystick_deadzone tells how far along an axis you  must
              move  before  the  axis  starts to change. This option expects a
              float in the range of 0.0 to 1.0. Where 0 is the center  of  the
              joystick and 1 is the outer limit. The default is 0.3.

       -joystick_saturation, -joy_saturation, -jsat value
              If  you  play  with  an  analog  joystick,  the ends can drift a
              little,   and   may   not   match   in   the   +/-   directions.
              joystick_saturation  tells how far along an axis movement change
              will be accepted before  it  reaches  the  maximum  range.  This
              option  expects  a  float in the range of 0.0 to 1.0, where 0 is
              the center of the joystick  and  1  is  the  outer  limit.   The
              default is 0.85.

       -natural, -nat
              Specifies whether to use a natural keyboard or not.

       -uimodekey, -umk
              Specifies  the  key  used  to toggle between full and partial UI
              mode.

       -keymap
              Enable keymap for non-QWERTY keyboards. Used in conjuction  with
              -keymap_file.

       -keymap_file keymap_file
              Specifies  the  full path to the keymap file to be used. Shipped
              keymap files lie in /usr/share/games/mame/keymaps.

       -joy_idx1 joystick

       -joy_idx2 joystick

       -joy_idx3 joystick

       -joy_idx4 joystick

       -joy_idx5 joystick

       -joy_idx6 joystick

       -joy_idx7 joystick

       -joy_idx8 joystick
              With these options you can assign a joystick to a specific index
              in  MAME.  Even  if  the  kernel  will  list  the joysticks in a
              different order on the  next  boot,  MAME  will  still  see  the
              joystick  as  e.g.  "Joystick  2".  Use  mame  -v  to  see which
              joysticks are recognized.  Default is AUTO.

       -sixaxis
              Use special handling for PS3 Sixaxis controllers.

       -videodriver, -vd x11|directfb|auto
              SDL video driver to use; auto selects SDL default.

       -audiodriver, -ad alsa|arts|auto
              SDL audio driver to use; auto selects SDL default.

       -gl_lib alsa|arts|auto
              Alternative libGL.so to use; auto selects SDL default.

   Input automatic enable options
       -paddle_device, -paddle [none|keyboard|mouse|lightgun|joystick]

       -adstick_device, -adstick [none|keyboard|mouse|lightgun|joystick]

       -pedal_device, -pedal [none|keyboard|mouse|lightgun|joystick]

       -dial_device, -dial [none|keyboard|mouse|lightgun|joystick]

       -trackball_device, -trackball [none|keyboard|mouse|lightgun|joystick]

       -lightgun_device [none|keyboard|mouse|lightgun|joystick]

       -positional_device [none|keyboard|mouse|lightgun|joystick]

       -mouse_device [none|keyboard|mouse|lightgun|joystick]
              Each of  these  options  controls  autoenabling  the  mouse,  or
              joystick  depending  on  the  presence  of a particular class of
              analog control for  a  particular  game.  For  example,  if  you
              specify  the  option  -paddle  mouse,  then  any game that has a
              paddle control will automatically enable mouse controls just  as
              if  you  had  explicitly  specified  -mouse.   Note  that  these
              controls override the values of -[no]mouse, -[no]joystick,  etc.

   Debugging options
       -[no]log
              Creates  a  file  called  error.log  which  contains  all of the
              internal log messages  generated  by  the  MAME  core  and  game
              drivers. The default is OFF (-nolog).

       -[no]verbose, -[no]v
              Displays  internal  diagnostic  information. This information is
              very useful for  debugging  problems  with  your  configuration.
              IMPORTANT:  when  reporting  bugs, please run with mame -verbose
              and include  the  resulting  information.  The  default  is  off
              (-noverbose).

       -update_in_pause
              Enables  updating  the  screen  bitmap while the game is paused.
              This is useful for debuggin in some scenarios (and gets  in  the
              way in others).

       -[no]debug, -[no]d
              Activates  the  integrated debugger. By default, the debugger is
              entered by pressing the tilde (~) key during  emulation.  It  is
              also   entered  immediately  at  startup.  The  default  is  OFF
              (-nodebug).

       -debugscript filename
              Specifies a file that contains a list of  debugger  commands  to
              execute  immediately  upon  startup.  The  default  is  NULL (no
              commands).

       -debug_internal, -di
              Use the internal debugger for debugging.

       -[no]oslog
              Outputs the error.log data to the system debugger. This  can  be
              used  at  the  same  time as -log to output the log data to both
              targets as well.  Default is OFF (-nooslog).

   Misc options
       -bios biosname
              Specifies the specific BIOS to use with the  current  game,  for
              game  systems  that make use of a BIOS. The -listxml output will
              list all of the possible BIOS names for a game. The  default  is
              'default'.

       -[no]cheat, -[no]c
              Enables  the  reading of the cheat database, if present, and the
              Cheat  menu  in  the  user  interface.  The    default  is   OFF
              (-nocheat).

       -[no]skip_gameinfo
              Forces MAME to skip displaying the game info screen. The default
              is OFF (-noskip_gameinfo).

LEGAL NOTICE

       Please visit the MAME website for some important legal information:

       http://mamedev.org/legal.html