XFME Desktop for Windows - release 1.2 (version 0.1.2): what is new since release 1.1
=====================================================================================

Release 1.2 is the first public release after 1.1. Everything changed since 1.1 is listed here. "Checked" below means
checked in our own testing (scripted runs and pictures on the test PC); nothing here has been played on a real
cabinet beside XFME, and many of the sound changes have not yet been listened to by ear. Please report what you find.


NEW BOARDS AND GAMES
--------------------

Maygay M2 (1996-99 video quiz machines) - new in XFME
* The Maygay M2 board with its video, I/O and sound boards.
* Guinness Book Of Records, Risk and Big Break (two program versions each), London Underground, and their "Protocol"
  versions: they start, take coins (10p / 20p / 50p / GBP1) and start a game. Guinness, Risk and Big Break have been
  played through to the end of a game in our tests; in XFME Desktop a coin and a started game were checked on Guinness
  and Risk.
* The A / B / C buttons light with the game. Guinness also has its GUINNESS letters and trail lamps on its layout.
* Sound: the sound board's phrases and its volume chip. The game's own volume is set in its refill mode (see the
  known issues).
* The Protocol versions need "Protocol 1" in their .gam (a data unit then answers the game); without it they stop on
  ERROR 7.1 - COMMS ERROR, as a real machine with no data unit would.
* Aladdin does not play: it stops on "ERROR: BANK 6 FAILED!!!" because one of its ROMs is in no known dump.

Reflex Gaming B3 video on the Heber Pluto 6 - new in XFME
* Thunderbirds B3 v1.60 (Data and Protocol), Golden Nile V1.3 B3 Protocol, Cash Ahoy V1.6 B3 Protocol: they reach
  attract on both screens, take coins and play (checked in XFME Desktop; Cash Ahoy also with a win). Golden Nile's
  panel lamps follow the game.
* Double Yer Luck B3: reaches attract on both screens and takes coins (no game played in our tests yet).
* Play by touch on the main screen or with the panel buttons; the panel buttons and lamps were taken from each game's
  own Switch Test and Lamp Test.


IMPROVED BOARDS
---------------

Speed (the same results, less work for your PC)
* Much less of the PC is needed for the newer boards. Measured on one core of the test PC, in play, against the build
  before these changes: Scorpion 5 about 3-4 times faster, Adder 5 about 3 times, Pluto 6 about twice (with a video
  card about 1.5-2 times), Pluto 5 about 2.5 times (Bugs Money), System A1 about 1.5 times, MPU6 about 1.3-1.7
  times.
* MPU6: Dublin Up's busiest moments now keep real time on the test PC (1.1 fell behind there and the sound broke up).
* The Pluto 5 / Pluto 6 video cards draw their picture faster (the same picture).
* Every one of these was checked to give exactly the same game as before, trace for trace.

Sound
* The crackle and distortion on synth-sound machines (Smash 'n' Grab, Line Up, 777 Heaven and others) is gone. Two
  causes: XFME ran every machine about 3 % slow, so the sound card kept running dry (now exact real time, paced by your
  sound card); and a sample was dropped every few hundredths of a second on many boards (now none).
* Seventeen boards now turn their chip sound into samples properly - ProConn, Scorpion 1 and 2,
  spACE, System 1 / 5 / 83 / 85, MMM, Coinmaster, IGT S+ and S2000, Phoenix, MPS2, Electrocoin, Inder, M1 Video -
  which removes the cause of a thump at the start and end of each note.
* Some boards now play at their proper level, which is quieter than 1.1: MPS2, Inder, Scorpion 2, System 5, M1 Video and
  Phoenix (about half the level) and IGT S2000.
* Barcrest MPU3: its tones were 36 % flat; they now play at the right pitch (higher than in 1.1).
* JPM Give us a Break / Ten Up: the music played four octaves too high; now at its pitch.
* Maygay M1A/B: the clipping (distortion) measured on games such as Casino Royale and Search Light is gone.
* Cup Final and The Big Match (BWB, MPU4): their samples now play at 10.75 kHz instead of 16 kHz, which was too fast
  (not yet checked by ear against a machine).
* Pluto 6 games: the sound no longer runs about a second behind the game (for example the spin sound after the reels
  had stopped).
* Games on Epoch, Scorpion 4 or Scorpion 5 with no sound ROM no longer freeze waiting for a sound to end (Extreme
  Ca$hino's volume screen).

Barcrest MPU3 - the board rebuilt
* Lamps (including lamps 64-95), LED digits, the alpha display with its brightness, the reels (set up from the layout
  and started where the game was left), the AUX2 lines, the coin mech and the cabinet sound effects.
* Exchanges games show words with a double letter properly; Banker's digits now read correctly.
* Magic Replay (Dutch) Dx01 / Dx02 now run (they stopped in 1.1).
* In our scripted play more MPU3 games paid out than in 1.1 (Line Up, Hot Shot, Wacky Racer, More Money, Supaswop).

JPM Impact - the board rebuilt
* Lamps with their brightness and fade, LED digits, the display with its brightness, the coin inhibits, the pay
  slides, and the cabinet sound effects (reel bounce, meter clicks, hopper and coin sounds).
* The German and Dutch sets that stopped shortly after switch-on now run: Cash Breaker, Excellence, Pharaoh, Samurai,
  Indiana Jones (German), Jokers Gold (German), Schloss Drachenstein, Star Wars (German). The German sets first show
  their own set-up menu on a fresh RAM (see the known issues).
* Coin buttons that the game locks out are now let through when the game opens its coin inhibits (they refused every
  coin before, for example on Pot Of Gold Dx03).

Maygay M1A/B - the board rebuilt
* Lamps flash as they should, the alpha and 2-digit displays, the hopper, the reels with their bounce, and the cabinet
  sound effects.
* The OKI sample chip is emulated at the chip level and plays its samples at their proper rates.
* Layout coin buttons now credit the right coin: in our collection 58 coin buttons gave nothing or the wrong coin in
  1.1.

Pluto 6
* Bullion Bars with 2 to 4 players: the stops on NPTR / BIDX / NO NOTE STACKR / CCT COIN FAIL are fixed (none in 60
  seats over 29 full-length test runs).
* Notes: XFME Desktop has a NOTE IN button (a GBP20) under COIN IN, lit while the game takes notes; the touch front end's
  linked seats have a GBP20 too.
* Genie Community: the comms error with three machines (in 1.1's known issues) was not seen again in our tests.

Other
* Secrets Of The Golden Nile (Project): its display is a graphic LCD that an MFME layout cannot show; new XFME layouts
  for both sets are in Secrets_Of_The_Golden_Nile_XFME.zip.
* What A Carry On (PCP, spACE): its reels move when PCP's reel controller file is in the game's folder (any file name);
  XFME finds it by its contents, or lists it as missing.
* Holiday Club (spACE): the Cashpot / Reserve display no longer fills with stray letters after a spin.
* Epoch games: a quick-start snapshot saved during a game's very first start now resumes properly.


FIXES
-----

* Opening some games from the Games Library (double-click) could close XFME Desktop. Fixed.
* A game's name in the library is no longer lost after it has been played (games on XFME's own layouts showed their
  file name instead).
* The version you type in Configuration now shows in the library; the .gam's Game / Version lines are written when the
  game closes, as MFME does.
* A layout button's switch is now read as MFME reads it: Fortune Pot C02 and Bugs Money (Mute) start from their own
  buttons (44 layouts in our collection change).
* A game with no name of its own (for example Line Up Dx01) is named by its file name in the header, as in the Game
  Manager.
* The magnifier now works in the borderless and full-screen modes too.
* Draggable Reels (Preferences) now works: drag a reel and it springs back when you let go.
* Updated game zips: Bugs Money (the number reel shows the right numbers), Rainbow Riches Dublin Up (the coin mech on
  the glass can be clicked; no longer marked work in progress).


NEW IN THE PROGRAM
------------------

* Check for updates (Library menu, the three dots above the games list): shows the latest version and what is new in
  it; "Update now" downloads it, checks its signature, swaps the program's files (keeping your old version in a folder
  beside it) and restarts. Nothing is ever installed unless you press Update now. A tick (off unless you tick it) also
  checks when XFME starts.
* Report a problem (Library menu, and Help > About): makes one small zip - XFME's version, your Windows version and
  screen, the game's file names with their sizes and checksums (never the ROMs, layouts or RAM), the error log and
  what you write. "Send to XFME" sends it to xfme.co.uk and gives you a reference to quote; "Save the zip..." keeps it
  for you to attach yourself.
* XFME uses the internet only when you press Send to XFME or use Check for updates.
* First start: the empty games library tells you what to do - ADD YOUR GAMES FOLDER..., IMPORT MFME 20.1 SETTINGS...,
  IMPORT MFME'S GAME LIST... - and if a scan finds nothing it says why.
* Hidden games are counted under the list ("3 games hidden: 2 work in progress - show, 1 not running - show"); a click
  on "show" lists them.
* Cabinet sound effects helper: Library menu > "Cabinet sound effects: find my MFME folder..." copies MFME's own
  DefaultSounds from your MFME 20.1 installation (they are not part of XFME). A line under the list offers it while
  the sounds are missing.
* Full screen: black around the machine by default. Untick Extras > "Black around the machine in full screen" for
  MFME's behaviour (the layout's own border colour).
* The games library keeps its place when you start a game, and remembers its tab and its List / Pictures view.
* The library list remembers its column widths; right-click the column headings to hide Rating / Version / Tech; the
  work-in-progress and non-runner ticks are remembered. MFME's own Game Manager window keeps its column widths too.
* Layout editor: the Gamball ball unit, the ticket dispenser (with the Game of Tickets ticket as its stock picture,
  which you can change) and the graphic LCD panel can be added, moved, sized and deleted in XFME's own layouts.
* Clearer tooltips on the SETTINGS and SCREEN controls.

After updating, each game's quick-start snapshot from 1.1 is not used once (see KNOWN_ISSUES.txt, "Saving"): the game
starts normally from its RAM and saves a new one.
