Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
mess:howto [2013/08/10 13:31]
stiletto [Compiling MESS]
mess:howto [2021/10/20 02:19] (current)
stiletto [Frontends]
Line 29: Line 29:
 ===== Purpose of MESS ===== ===== Purpose of MESS =====
  
-The primary purpose of MESS is to preserve decades of computer and console history. As technology continues to rush forward, MESS prevents these important "​vintage"​ systems from being lost and forgotten. MESS is based on MAME and shares many of its components. Additional information about MESS and MAME can be found at the [[http://www.mess.org|MESS home page]] or at [[http://​mamedev.org|MAMEDev]]. You could also find the [[http://​mamedev.org/​devwiki/​index.php?​title=Frequently_Asked_Questions|MAME FAQ]] and [[:faq|MESS FAQ]] a very interesting read.+The primary purpose of MESS is to preserve decades of computer and console history. As technology continues to rush forward, MESS prevents these important "​vintage"​ systems from being lost and forgotten. MESS is based on MAME and shares many of its components. Additional information about MESS and MAME can be found at the [[http://​mess.redump.net|MESS wiki]] or at [[http://​mamedev.org|MAMEDev]]. You could also find the [[http://​mamedev.org/​devwiki/​index.php?​title=Frequently_Asked_Questions|MAME FAQ]] and [[:faq|MESS FAQ]] a very interesting read.
  
 ===== Systems Emulated by MESS ===== ===== Systems Emulated by MESS =====
Line 39: Line 39:
 Alternatively,​ you can simply see the status by yourself, launching the system emulation and taking a look to the red or yellow warning screen which appears before the emulation starts, if any. Alternatively,​ you can simply see the status by yourself, launching the system emulation and taking a look to the red or yellow warning screen which appears before the emulation starts, if any.
  
-Notice that if you have information which can help to improve the emulation of a supported system, or if you can directly contribute fixes and/or addition to the current source, you can follow the instructions at the [[http://www.mess.org/​contacts.php|contact page]] or post to the [[http://​forums.bannister.org/​ubbthreads.php?​ubb=postlist&​Board=1|MESS Message Board]].+Notice that if you have information which can help to improve the emulation of a supported system, or if you can directly contribute fixes and/or addition to the current source, you can follow the instructions at the [[http://​mess.redump.net/​contacts.php|contact page]] or post to the [[http://​forums.bannister.org/​ubbthreads.php?​ubb=postlist&​Board=1|MESS Message Board]].
  
  
Line 237: Line 237:
 If you don't like using MESS from command line, you may want to use MESS in conjunction with a frontend. Various frontends currently support MESS. In alphabetical order: If you don't like using MESS from command line, you may want to use MESS in conjunction with a frontend. Various frontends currently support MESS. In alphabetical order:
  
-  * [[http://​emuloader.mameworld.info/​emucon/​|EmuCon]] - Windows only+  * [[https://​web.archive.org/​web/​20210607003404/​https://​emuloader.mameworld.info/​emucon/​|EmuCon]] - Windows only
   * [[http://​gelide.sourceforge.net/​|Gelide]] - Linux   * [[http://​gelide.sourceforge.net/​|Gelide]] - Linux
   * [[http://​bobz38.free.fr/​gnomess/​index.php|GNOMESS]] - Linux   * [[http://​bobz38.free.fr/​gnomess/​index.php|GNOMESS]] - Linux
-  * [[http://​www.hyperspin-fe.com/​|HyperSpin]] - Windows - [[http://​hyperspin-fe.com/​oldsite/​index.php?​option=com_content&​view=article&​id=104&​Itemid=116|Atari 5200 tutorial]] +  * [[https://​www.hyperspin-fe.com/​|HyperSpin]] - Windows - [[http://​hyperspin-fe.com/​oldsite/​index.php?​option=com_content&​view=article&​id=104&​Itemid=116|Atari 5200 tutorial]] 
-  * [[http://​sourceforge.net/​projects/​kxmame/​|kxmame]] - Linux +  * [[https://​sourceforge.net/​projects/​kxmame/​|kxmame]] - Linux 
-  * [[http://​sourceforge.net/​projects/​mameplus/​|MAME Plus! GUI]] - Windows, Linux and Mac OS X supported+  * [[https://​sourceforge.net/​projects/​mameplus/​|MAME Plus! GUI]] - Windows, Linux and Mac OS X supported
   * [[https://​sites.google.com/​site/​meagrefrontend/​home|MEAGRE]] - Windows only   * [[https://​sites.google.com/​site/​meagrefrontend/​home|MEAGRE]] - Windows only
-  * [[http://​eadmaster.altervista.org/​pub/​index.php?​page=cliapps#​mess|MESS auto-launcher]] - Windows and *nix (command-line only) +  * [[https://​eadmaster.altervista.org/​pub/​index.php?​page=cliapps#​mess|MESS auto-launcher]] - Windows and *nix (command-line only) 
-  * [[http://​macmess.org/​|MessMenu]] - Mac OS X only +  * [[https://​macmess.org/​|MessMenu]] - Mac OS X only 
-  * [[http://messui.the-chronicles.org/|MESSUI]] - Windows only (formerly part of the official project) +  * [[https://messui.1emulation.com/|MESSUI]] - Windows only (formerly part of the official project) 
-  * [[http://​mameload.mameworld.info/​|ML TNG]] - Windows only +  * [[https://​mameload.mameworld.info/​|ML TNG]] - Windows only 
-  * [[http://​robert.hurst-ri.us/​myarcade/​|My Arcade]] - Windows, Linux +  * [[https://​web.archive.org/​web/​20180817030035/​https://​robert.hurst-ri.us/​myarcade/​|My Arcade]] - Windows, Linux 
-  * [[http://qmc2.arcadehits.net/wordpress/|QMC2]] - Windows, Linux and Mac OS X supported+  * [[https://qmc2.batcom-it.net/​|QMC2]] - Windows, Linux and Mac OS X supported
   * [[http://​www.anti-particle.com/​wahcade.shtml|Wah!Cade]] - Linux   * [[http://​www.anti-particle.com/​wahcade.shtml|Wah!Cade]] - Linux
-  * [[http://​sourceforge.net/​projects/​xlbmessui/​|xlbmessui]] - Linux +  * [[https://​sourceforge.net/​projects/​xlbmessui/​|xlbmessui]] - Linux 
-  * [[http://​code.google.com/​p/​xmessgui/​|xMess GUI]] - cross-platform+  * [[https://​code.google.com/archive/​p/​xmessgui/​|xMess GUI]] - cross-platform
  
 Please refer to their home pages and support forums for more information about the available options of the frontends. Please refer to their home pages and support forums for more information about the available options of the frontends.
Line 353: Line 353:
   * Alternatively,​ don't hesitate to ask for suggestions on the [[http://​forums.bannister.org/​ubbthreads.php?​ubb=postlist&​Board=1|MESS message board]]   * Alternatively,​ don't hesitate to ask for suggestions on the [[http://​forums.bannister.org/​ubbthreads.php?​ubb=postlist&​Board=1|MESS message board]]
  
-If you can provide fixes or addition of missing components, please follow the submission rules at the [[http://www.mess.org/​contacts.php|contact page]].+If you can provide fixes or addition of missing components, please follow the submission rules at the [[http://​mess.redump.net/​contacts.php|contact page]].
  
  
Line 415: Line 415:
 Afterwards, you can always edit this file and the configuration values by opening and editing it with a text editor. The same command can be also handy if you want to reset every option to its default value at once, because the new mess.ini will overwrite the one already present. Afterwards, you can always edit this file and the configuration values by opening and editing it with a text editor. The same command can be also handy if you want to reset every option to its default value at once, because the new mess.ini will overwrite the one already present.
  
-It is recommended that you modify the writeconfig setting to 1.+It is generally ​recommended that you modify the writeconfig setting to 1. Keep in mind that this will also save the information what cartridges and floppy disks are inserted, so they are automatically re-mounted on the next start unless you specify something different. If you prefer to start with a clean system each time you should set this value to 0.
   writeconfig ​  1   writeconfig ​  1
 Save your changes. Then, copy your new mess.ini to the ini folder. Save your changes. Then, copy your new mess.ini to the ini folder.
Line 587: Line 587:
   -comment_directory [for debugger comments]   -comment_directory [for debugger comments]
  
-Check also [[http://​mess.toseciso.org/​mess:​mess.ini#​core_search_path_options|this page]] and [[http://​mess.toseciso.org/​mess:​mess.ini#​core_output_directory_options|this page]], respectively,​ to read about the corresponding configuration options available in mess.ini.+Check also [[mess:​mess.ini#​core_search_path_options|this page]] and [[mess:​mess.ini#​core_output_directory_options|this page]], respectively,​ to read about the corresponding configuration options available in mess.ini.
  
  
Line 635: Line 635:
 Keep in mind that dropping too many frames will cause the game to become more jerky and stuttery. Keep in mind that dropping too many frames will cause the game to become more jerky and stuttery.
  
-Check also [[http://​mess.redump.net/​mess:​mess.ini#​core_performance_options|this page]], to read about the corresponding configuration options available in mess.ini.+Check also [[mess:​mess.ini#​core_performance_options|this page]], to read about the corresponding configuration options available in mess.ini.
  
  
Line 1102: Line 1102:
 MESS solution to this problem is to offer two different emulation modes for the keyboard of each system, Full and Partial, whenever you start the emulation of a computer (this does not apply to console). As said above, you can switch between the two using <​key>​ScrLock</​key>​ (in (SDL)MESS, the default key is <​key>​Delete</​key>​ and you can change it in [[:​mess:​mess.ini|mess.ini]] changing the ''​uimodekey''​ line). MESS solution to this problem is to offer two different emulation modes for the keyboard of each system, Full and Partial, whenever you start the emulation of a computer (this does not apply to console). As said above, you can switch between the two using <​key>​ScrLock</​key>​ (in (SDL)MESS, the default key is <​key>​Delete</​key>​ and you can change it in [[:​mess:​mess.ini|mess.ini]] changing the ''​uimodekey''​ line).
  
-(For more information on how to change this <​key>​ScrLock</​key>​ to be something else, see: http://​mess.redump.net/​faq#​for_some_reason_esc_does_not_quit_mess_nor_does_tab_bring_up_the_menu)+(For more information on how to change this <​key>​ScrLock</​key>​ to be something else, see: [[:​faq#​for_some_reason_esc_does_not_quit_mess_nor_does_tab_bring_up_the_menu)]]
  
 Below is a short description of the differences between the two modes. Below is a short description of the differences between the two modes.
Line 1559: Line 1559:
   -video gdi   -video gdi
  
-D3D is the fastest setting, but it requires a Direct 3D 8+ compatible graphics card. If your card is not compatible with latest Direct 3D, you may want to try ddraw or gdi+D3D is the fastest setting, but it requires a Direct 3D 9+ compatible graphics card. If your card is not compatible with latest Direct 3D, you may want to try ddraw or gdi.
- +
-You can also select which version of Direct 3D libraries to use, by setting the ''​-d3dversion''​ options. You can only choose between 8 and 9 (corresponding to Direct 3D 8 and Direct 3D 9), 9 being the default+
  
 If you are using (SDL)MESS, you can select If you are using (SDL)MESS, you can select