Pac2600Comp   version 1.0.0
=====================================================

Pac2600Comp is an unofficial, fan-made program. It is not made, endorsed or sponsored by any rights holder.
PAC-MAN is a trademark of Bandai Namco Entertainment Inc. The Atari 2600 game "Pac-Man" (1981), its program, pictures and sounds
belong to their respective rights holders (Atari and Bandai Namco). Atari and the Atari 2600 are trademarks of their owners.
All other names are the property of their owners. The game itself is NOT included in this program: you need your own legal copy.

This program plays the Atari 2600 game Pac-Man (1981) on your PC. It runs the game with its own rebuilt
game code (proved identical to the original game, picture and sound, frame for frame, against the Stella emulator), at the speed of a real 1981 NTSC console (59.92 pictures a second),
and it shows the picture in the right shape (12:7 pixels) with a black border, scaled to your screen.

THE GAME IS NOT INCLUDED. You need your own copy of the game file (a 4096-byte "Pac-Man (1981) (Atari).a26").
The program only accepts the original file; its fingerprint (SHA-1) must be
    0940fea7f04cdb6d4b90c5ad1a7e344e68f6dbb1

HOW TO START
  1. Unzip this folder somewhere you can write to (for example your Documents or Desktop; not "Program Files").
  2. Start Pac2600Comp.exe. The first time, it asks for your game file; or put the file into the "roms" folder
     here beforehand. The program remembers where it was, and where you left the window.
  3. Press F3 (or the Options button on a PS4 pad) to start a game.

IF WINDOWS WARNS YOU
  Windows may show a blue "Windows protected your PC" window ("unknown publisher") when you start Pac2600Comp.exe or one of the .cmd files. The program is
  free and is not signed with a paid publisher certificate, so this is expected. Click "More info", then "Run anyway".
  To avoid it for every file: right-click the downloaded zip, choose Properties, tick "Unblock" if it is there, click OK, and only then unzip.
  To check that a download is the genuine file, run this in a Command Prompt:
      certutil -hashfile Pac2600Comp-1.0.0-windows.zip SHA256
  and compare the long number with the one in Pac2600Comp-1.0.0-windows.zip.sha256 (next to the zip where you downloaded it) or on the release page.
  Some antivirus programs distrust any new unsigned program. If you would rather not trust it, build it yourself from the source zip in the source folder.

KEYS                                              PLAYSTATION PAD (XBOX PAD: A or X fire, Menu = Reset, View = Select, LB / RB, Y)
  Arrow keys or W A S D   move                      D-pad or left stick   move
  Space or Z              fire button               Cross or Square       fire button
  F3 (hold)               Game Reset: new game      Options               Game Reset
  F2 (hold)               Game Select: variation    Share                 Game Select
  F4                      TV type: Colour / B&W     Triangle              TV type
  F5 / F6                 left / right difficulty   L1 / R1               left / right difficulty
  F7                      soft glow on / off (off = as on a real TV)
  1 2 3 4 5               picture: Sharp, Fill, TV frame, Game area, Framed (5 is the standard)
  Alt + Enter             fullscreen on / off
  F1                      shows this list on the screen
  Esc                     opens and closes the menu (the game pauses)   PS button or touchpad: the same
The three switches (F4, F5, F6) stay where you leave them, also for the next start.

THE MENU (Esc)
  Resume, New game, Game options (game 1 to 8, players, difficulty, frame rate), Graphics options (background, TV type,
  CRT filter, HDR), Sound options, Control options, Achievements, Statistics, and Quit. Each row explains itself.

RECORDING (to keep a game and watch it again, or for testers)
  Double-click  "Record a game.cmd"   to play as usual while every frame's input is recorded. Close the game with Esc, Quit
                (or the X button): the recording is then saved in the "recordings" folder next to the program.
  Double-click  "Replay a game.cmd"   to play the newest recording back from power-on; the game comes out exactly the
                same. To replay another recording, drag its file onto "Replay a game.cmd". When a recording ends, the
                keyboard takes over again.
  By hand (Command Prompt, in this folder):   Pac2600Comp.exe --record "C:\some folder\my.inputs"
                                              Pac2600Comp.exe --replay "C:\some folder\my.inputs"
  A name without a folder is saved in the folder the Command Prompt was in, not beside the program.

FILES THE PROGRAM WRITES
  settings.ini next to Pac2600Comp.exe: the path of your game file, the window place and size, your choices from the menu,
  your achievements and your statistics. Delete it to start fresh. Nothing is sent anywhere: the program has no network code.

LICENCES AND SOURCE
  This program is distributed under the GNU General Public License, version 2 or later. It contains no emulator, but its picture colours
  are the colour table of Stella 7.0 and its CRT filters are ports of shaders (CRT-Geom, GDV NTSC, CRT-Lottes: see the notices); it also uses SDL 3.4.18 (zlib
  licence). The licence of this program is in LICENSE.txt, the notices and credits of everything from others are in THIRD_PARTY_NOTICES.txt,
  and the Stella licence text is in licences\Stella-License.txt. The complete source code of this program, with Stella and SDL, is in
      source\Pac2600Comp-1.0.0-source.zip     (how to build it: source\BUILDING.txt)
  The three Microsoft runtime files (msvcp140.dll, vcruntime140.dll, vcruntime140_1.dll) are Microsoft's
  Visual C++ runtime, shipped next to the program as Microsoft allows.
  The rights notice is in NOTICE.txt (and at the top of this file). What changed in each version is in CHANGELOG.txt.