Editing MAME

{{Infobox software
| name                   = MAME
| title                  =
| logo                   = MAMELogo.jpg<!-- Image name is enough -->
| logo caption           =
| logo size              = 270px
| logo alt               = MAME Logo
| screenshot             = Mame1.png
| caption                = MAME's main menu (as of version 0.142)
| screenshot size        =
| screenshot alt         =
| collapsible            =
| author                 = [[Nicola Salmoria]]
| developer              = [[Nicola Salmoria]] and the MAME Team
| released               = {{Start date and age|1997|02|05|df=yes}}
| discontinued           =
| programming language   = [[C++]] ([[C (programming language)|C]] and [[Python (programming language)|Python]] for some drivers)
| operating system       = Windows, macOS, Linux, BSD, Amiga, etc
| platform               =
| size                   =
| language               =
| language count         = <!-- Number only -->
| language footnote      =
| genre                  = [[Emulator]]
| license                = [[BSD license#3-clause|New BSD]], [[GNU General Public License|GNU GPL v2 or later]]
| alexa                  =
| website                = {{URL|https://www.mamedev.org/}}
| standard               =
| AsOf                   =
}}
'''MAME''' (originally an [[acronym]] of '''Multiple Arcade Machine Emulator''') is a [[free and open source software|free and open source]] [[emulator]] designed to recreate the hardware of [[arcade game]] systems in [[software]] on modern personal computers and other platforms.  The intention is to preserve gaming history by preventing vintage games from being lost or forgotten.  The aim of MAME is to be a reference to the inner workings of the emulated arcade machines; the ability to actually play the games is considered "a nice side effect". [[Joystiq]] has listed MAME as an application that every [[Windows]] and [[MacOS|Mac]] gamer should have.

The first public MAME release (0.1) was on February 5, 1997, by [[Nicola Salmoria]]. The emulator now supports over seven thousand unique games and ten thousand actual [[ROM image]] sets, though not all of the supported games are playable. [[MESS]], an emulator for many [[video game console]]s and computer systems, based on the MAME core, was integrated upstream into MAME in 2015.

== History and overview ==
The project was started by the Italian programmer Nicola Salmoria. MAME traces its roots to an earlier emulator project called Multi-Pac, but the name was changed as more and more games started to be emulated within the MAME framework. The first version was released in 1996. In April 1997, Salmoria stepped down for his [[military service#Italy|national service]] commitments, handing stewardship of the project to fellow Italian Mirko Buffoni for a period of half a year. In May 2003, David Haywood took over the job of the coordinator. From April 2005 to April 2011, the project was coordinated by Aaron Giles. Angelo Salese stepped in as the new coordinator. In 2012, Miodrag Milanovic took over. The project is supported by hundreds of developers around the world and thousands of outside contributors.

At first, MAME was developed exclusively for MS-DOS, but it was soon ported to [[Unix-like]] systems (X/MAME), Macintosh (MacMAME and later MAME OS X) and Windows (MAME32). Since 24 May 2001 with version 0.37b15, the main development occurs on the Windows platform, and most other platforms are supported through the [[Simple Directmedia Layer|SDLMAME]] project, which was integrated into the main development source tree in 2006. In addition, different versions of MAME have been ported to other computers, game consoles, mobile phones and PDAs, and at one point even to digital cameras. In 2012, [[Google]] ported MAME to [[Google Native Client|Native Client]], which allows MAME to run inside [[Google Chrome|Chrome]].

Major releases of MAME occur approximately once a month. Windows executables in both 32-bit and 64-bit fashion are released on the official web site of the development team, along with the complete source code. Smaller, incremental "u" (for update) releases were released weekly (until version 0.149u1) as source [[diff]]s against the most recent major version, to keep code in synchronization among developers. The MAME source code is developed on a public [[GitHub]] repository. This allows those with the required expertise & tools to build the most up-to-date version of the code and contribute enhancements in the form of [[Distributed version control#Pull requests|Pull Requests]].

The architecture of MAME has been extensively improved over the years. Support for both [[Raster graphics|raster]] and [[vector display]]s, as well as multiple CPUs and sound chips, were added to MAME in the first six months of the project. A flexible timer system to coordinate the synchronization between multiple emulated CPU cores was implemented, and ROM images started to be loaded according to their [[CRC32]] hash in the [[ZIP (file format)|ZIP files]] they were stored in. MAME has pioneered the reverse engineering of many undocumented system architectures, various CPUs (such as the [[M6809]]-derivative custom [[Konami]] CPU with new instructions) and sound chips (for example the [[List of Yamaha products#Sound chips|Yamaha FM sound chips]]), and MAME developers have been instrumental in the reverse engineering of many proprietary encryption algorithms utilized in arcade games. Examples of these include the [[Neo Geo]], [[CP System II]], [[CP System III]] and many others.

The popularity of MAME has well since broken through to the mainstream, with enthusiasts building their own [[Video game arcade cabinet|arcade game cabinets]] to relive the old games, and with companies producing illegal derivative works of MAME to be installed in [[Video arcade|arcades]]. Cabinets can be built either from scratch or by taking apart and modifying a genuine arcade game cabinet that was once used with the real hardware inside. Cabinets inspired by classic arcade games can also be purchased and assembled (with optional  and MAME preinstalled).

Although MAME contains a rudimentary user interface, the use of MAME in arcade game cabinets and [[home theater PC|home theater ]]s necessitates special launcher applications called ''front ends'' with more advanced user interfaces. Front ends provide varying degrees of customization – allowing one to see images of the cabinets, history of the games and tips on how to play, and even video of the game play or ''attract mode'' of the game.

The information contained within MAME is free for re-use, and companies have been known to utilize MAME when recreating their old classics on modern systems. Some have gone as far as to hire MAME developers to create emulators for their old properties. An example of this is the ''[[Taito Legends]]'' pack which contains ROMS readable on select versions of MAME.

Since 2012 MAME is maintained by then MESS project leader Miodrag Milanovic.

On May 27, 2015 (0.162), the games console and computer system emulator [[Multi Emulator Super System|MESS]] was integrated with MAME (so the MESS User Manual is still the most important usage instruction for the non-arcade parts of MAME). 

In May 2015, it was announced that MAME's developers were planning to [[Software relicensing|re-license]] the software under a more common [[free and open source]] [[software license|license]], away from the [[MAME#Original MAME-license|original MAME-license]]. MAME developer Miodrag Milanovic explained that the change is intended to draw more developer interest to the project, allow the manufacturers of games to distribute MAME to emulate their own games, and make the software a ''"learning tool for developers working on development boards"''. The transition of MAME's licensing to the BSD/GPL licenses was completed in March 2016. With the license change, most of MAME's [[source code]] (90%+) is available under a three-clause [[BSD license]] and the complete project is under the [[GNU General Public License]] version 2 or later.

On Feb 24, 2016 (0.171), MAME embedded MEWUI front-end (and developer joined the team), providing MAME with a flexible and more full-featured UI.

== Design ==
The MAME core coordinates the emulation of several elements at the same time. These elements replicate the behavior of the hardware present in the original [[arcade cabinet|arcade machines]]. MAME can emulate many different [[central processing unit]]s (CPUs) and associated hardware. These elements are virtualized so MAME acts as a software layer between the original program of the game, and the platform MAME runs on. MAME supports arbitrary screen resolutions, refresh rates and display configurations. Multiple emulated monitors, as required by for example [[Darius (video game)|Darius]], are supported as well.

Individual arcade systems are specified by ''drivers'' which take the form of [[C preprocessor]] [[Macro (computer science)|macros]]. These drivers specify the individual components to be emulated and how they communicate with each other. While MAME was originally written in [[C (programming language)|C]], the need for object oriented programming caused the development team to begin to compile all code as [[C++]] for MAME 0.136, taking advantage of additional features of that language in the process.

Although a great majority of the CPU emulation cores are [[Interpreter (computing)|interpretive]], MAME also supports [[dynamic recompilation]] through an intermediate language called the Universal Machine Language (UML) to increase the emulation speed. Back-end targets supported are x86 and x64. A C backend is also available to further aid verification of the correctness. CPUs emulated in this manner are SH-2, MIPS R3000 and PowerPC.

=== Game data ===
The original program code, graphics and sound data need to be present so that the game can be emulated. In most arcade machines, the data is stored in [[Read-only memory|read-only memory chips]] (ROMs), although other devices such as [[cassette tape]]s, [[floppy disk]]s, [[hard disk]]s, [[laserdisc]]s, and [[compact disc]]s are also used. The contents of most of these devices can be copied to computer files, in a process called "dumping". The resulting files are often generically called [[ROM image]]s or ROMs regardless of the kind of storage they came from. A game usually consists of multiple ROM and [[Programmable Array Logic|PAL]] images; these are collectively stored inside a single [[ZIP (file format)|ZIP file]], constituting a ROM set. In addition to the "parent" ROM set (usually chosen as the most recent "World" version of the game), games may have "clone" ROM sets with different program code, different language text intended for different markets etc. For example, ''[[Street Fighter II|Street Fighter II Turbo]]'' is considered a variant of ''Street Fighter II Champion Edition''. System boards like the [[Neo Geo (console)|Neo Geo]] that have ROMs shared between multiple games require the ROMs to be stored in "BIOS" ROM sets and named appropriately.

Hard disks, compact discs and laserdiscs are stored in a MAME-specific format called CHD (Compressed Hunks of Data). Some arcade machines use analog hardware, such as laserdiscs, to store and play back audio/video data such as soundtracks and cinematics. This data must be captured and encoded into digital files that can be read by MAME. MAME does not support the use of external analog devices, which (along with identical speaker and speaker enclosures) would be required for a 100% faithful reproduction of the arcade experience. A number of games use sound chips that have not yet been emulated successfully. These games require sound samples in WAV file format for sound emulation. MAME additionally supports artwork files in [[Portable Network Graphics|PNG format]] for bezel and overlay graphics.

== Philosophy and accuracy ==
The stated aim of the project is to document hardware, and so MAME takes a somewhat purist view of emulation, prohibiting programming [[hack (technology slang)|hacks]] that might make a game run improperly or run faster at the expense of emulation accuracy. Components such as CPUs are emulated at a low level (meaning individual instructions are emulated) whenever possible, and [[high-level emulation]] (HLE) is only used when a chip is completely undocumented and cannot be reverse-engineered in detail. Signal level emulation is used to emulate audio circuitry that consists of analog components.

{{Quotation|We want to document the hardware. Now a lot of people will say; "Where's your document? You just write a bunch of source code." And yes, that's true. One thing I've learned is that keeping documentation synced with source code is nearly impossible. The best proof that your documentation is right is "does this code work".|Aaron Giles|California Extreme 2008}}

MAME emulates well over a thousand different [[arcade system board]]s, a majority of which are completely undocumented and custom designed to run either a single game or a very small number of them. The approach MAME takes with regards to accuracy is an incremental one; systems are emulated as accurately as they reasonably can be. Bootleg copies of games are often the first to be emulated, with proper (and copy protected) versions emulated later. Besides encryption, arcade games were usually protected with custom [[microcontroller unit]]s (MCUs) that implemented a part of the game logic or some other important functions. Emulation of these chips is preferred even when they have little or no immediately visible effect on the game itself. For example, the monster behavior in [[Bubble Bobble]] was not perfected until the code and data contained with the custom MCU was dumped through the [[decapping]] of the chip. This results in the ROM set requirements changing as the games are emulated to a more and more accurate degree, causing older versions of the ROM set becoming unusable in newer versions of MAME.

Portability and genericity are also important to MAME. Combined with the uncompromising stance on accuracy, this often results in high system requirements. Although a 2&nbsp;GHz processor is enough to run almost all 2D games, more recent systems and particularly systems with 3D graphics can be unplayably slow, even on the fastest computers. MAME does not currently take advantage of hardware acceleration to speed up the rendering of 3D graphics, in part because of the lack of a stable cross-platform 3D API,{{Citation needed|reason=This claim needs a reliable source; OpenGL is a stable cross-platform 3D API since 1997|date=August 2012}} and in part because software rendering can in theory be an exact reproduction of the various custom 3D rendering approaches that were used in the arcade games.

== Legal status ==

Owning and distributing MAME itself is legal in most countries, as it is merely an emulator. Companies such as [[Sony Computer Entertainment|Sony]] have attempted in court to prevent other software such as [[Virtual Game Station]], a [[Sony Playstation]] emulator from being sold, but they have been ultimately unsuccessful. MAME itself has thus far not been the subject of any court cases.  Early coverage of MAME tended to be sensationalist, such as [[IGN]] highlighting the use of MAME among console pirates.

Most arcade games are still covered by copyright. Downloading or distributing copyrighted ROMs without permission from copyright holders is almost always a violation of copyright laws. However, some countries (including the US) allow the owner of a board to transfer data contained in its ROM chips to a personal computer or other device they own. Some copyright holders have explored making arcade game ROMs available to the public through licensing. For example, in 2003 [[Atari]] made MAME-compatible ROMs for 27 of its arcade games available on the internet site ''Star ROMs''. However, by 2006 the ROMs were no longer being sold there. At one point, various [[Capcom]] games were sold with the HotRod arcade joystick manufactured by [[Hanaho]], but this arrangement was discontinued as well. Other copyright holders have released games which are no longer commercially viable free of charge to the public under licenses that prohibit commercial use of the games. Many of these games may be downloaded legally from the official MAME web site. The Spanish arcade game developer [[Gaelco]] has also released ''World Rally'' for non-commercial use on their website.

The MAME community has distanced itself from other groups redistributing ROMs via the internet or physical media, claiming they are blatantly infringing copyright and harm the project by potentially bringing it into disrepute. Despite this, illegal distributions of ROMs are widespread on the internet, and many "Full Sets" also exist which contains a full collection of a specific version's roms. In addition, many bootleg game systems, such as arcade multi carts, often use versions of MAME to run their games.

== Original MAME-license ==
{{anchor|License}}
MAME was formerly distributed under a custom own-written [[copyleft]] [[software license|license]], called "MAME license" or "MAME-like license", which was adopted also by other projects, e.g. [[Visual Pinball]]. This old "MAME license" ensures the source code availability, while the redistribution in commercial activities is prohibited. Due to this clause, the license is incompatible with the [[Open Source Initiative|OSI]]'s [[Open source definition]] and the [[Free Software Foundation|FSF]]'s [[Free software definition]]. The non-commercial clause was designed to prevent arcade operators from installing MAME cabinets and profiting from the works of the original manufacturers of the games. The ambiguity of the definition "commercial" lead to legal problems with the license. 

Since March 2016 with version 0.172, MAME itself [[Software relicensing|switched]] to common [[free and open source]] [[software license]]s, the [[BSD license|BSD]] and [[GPL license]]s.