1Bugs and Known Problems
2-----------------------
3
4* Cosmic Balance (game) hangs before the intro screen. This is probably
5  due to inaccurate emulation of POKEY interrupts (see below). The program
6  uses a hardware SIO loader as part of a presumed protection scheme.
7  There is a bug in the code which activates the POKEY timers at an
8  absurdly high frequency. This causes repeated interrupts which hangs the
9  program.
10  Probably there is some interaction with SIO which prevents this on
11  a real Atari.
12  A workaround is to invoke the monitor and type "c 10 40" and "cont".
13
14* new Pokey engine doesn't switch to mono output in STEREO_SOUND config
15
16* new Pokey engine doesn't support VOL_ONLY_SOUND on the second Pokey
17
18* a few keyboard-related bugs: e.g. pressing SHIFT+1 and then
19  releasing SHIFT should still give '!' characters
20
21* The cycle-exact ANTIC/GTIA/CPU timing is not 100%.
22  This causes display bugs in following programs:
23  - Surf's up (game) (the horizon)
24  - Satan's Hollow (game) (horizon) (confirmed sta WSYNC at WSYNC_C bug)
25  - Dimension X (game) (alignment problem)
26  - Te.mod (demo) (small glitched pixel in the final credits on the bottom left)
27  - Our 5oft Unity Part (demo) (cycle-alignment, probably WSYNC)
28  - Isolation (demo) (vector animations)
29  - 80 Random Moving Rectangles (demo) (top left of rectangles, screen data
30    is modified while drawing a scanline)
31  - Sirius games: Scores and Text in Worm War I, Final Orbit, Spider City,
32    Turmoil, Fantastic Voyage.  These games store screen data in page 0
33    and modify it each scan line.  They reuse the same data for each
34    scan line with an LMS on every line.  This makes the code look
35    like 2600 code. Emulating this requires trapping writes to
36    page 0 and doing partial ANTIC loads.
37  - Spider City has another bug in the map which is caused by player graphics
38    and HPOS being changed before the player is finished being drawn.  This
39    is only possible for wide players.
40  - Extract (demo) (face)
41
42* Non-bugs:
43  - Ergo Bibamus (demo) (one pixel of the flower above the perspective scroll)
44  - Mail Order Monsters (game)
45    (some colour changes do not align with text, occurs on a real Atari)
46  - The Break (demo) (bugs on the left side of photo)
47  - Star Raiders (disk image) (game) (doesn't work on XL/XE, select OS/B)
48  - Many other disk images of cartridges that work on XL/XE require OS B
49    because a once-popular cart dumping program for the Atari 800 generates
50    an OS B-specific loader. IIRC it loads the image and jumps into the OS B
51    RESET vector location, which is changed on the XL.
52  - Strip Poker (game) (Atari Basic must be enabled)
53  - Joust (Atari 5200 game) (the game sets all colors to black on PAL systems,
54    you need to switch the emulator to NTSC mode)
55
56* The following programs are improved by using the new cycle-exact code:
57  - 8 Players Demo (demo)
58  - Bewesoft's Demo (demo)
59  - Bitter Reality (demo)
60  - Demonic Laughter (music collection)
61  - Extract (graphics collection)
62  - GED (graphics editor)
63  - Joyride (demo)
64  - Mail Order Monsters (game)
65  - Master of the Lamps (game)
66  - Orneta '95 invitro (demo)
67  - Our 5oft Unity Part (demo)
68  - Studio Dream (demo)
69  - Sweet Illusion (demo)
70  - Te.mod (demo)
71  - The Break (demo)
72  - Miner 2049'er (game) (rotating 5's)
73  - Dimension X (game) (title screen upper and lower bars)
74  - Graphics impossible (demo) (Antic magazine)
75  - Power Graph (graphics editor)
76  - Darkness Warrior (picture)
77
78* POKEY interrupts are scanline-, not cycle-exact.
79  This causes display or sound bugs in following programs:
80  - Joyride (demo) (white lines on title picture)
81  - Mirax Force (game) (speech)
82  - Saturday Demo (demo) (music)
83  - The Last Guardian (game) (speech)
84  - Digital Trash (demo) (music)
85
86* VOL_ONLY_SOUND causes sound bugs in following programs:
87  - Ghostbusters (game)
88  - Overmind (demo)
89
90* intensive 130xe-banks switching slows down emulation much.
91  This causes performance problems in following programs:
92  - Impossible but Real (demo)
93  - Sheol (demo)
94  - Total Daze (demo)
95  - Ultra (demo)
96
97* The following VAPI images are known to not work:
98  (This list may not be complete, as full VAPI documentation
99   has never been released by the author)
100  - Alternate Reality: The City
101  - Ankh
102  - Attack at EP CYG 4
103  - Ballblazer Activision (UK)
104  - Jenny of the Prairie
105  - Mercenary - Escape from Targ _ Novagen Software
106  - Mr. Do!
107  - Music Studio (The)
108  - Promoteur
109  - Rescue on Fractalus! _ Activision (UK)
110  - Spy vs Spy
111  - Targets - A Number Game
112
113* SDL port uses call back system for filling sound buffer.
114  This causes wrong sound effects (noise) in some games.
115