# List of candidates for self-running 'captive' demos
#
# Not all games are good candidates. Some have no demo mode at all.
# Others technically have one but it's visually uninteresting or too short.
# Others are ruled out by technical constraints. Due to the architecture of
# the launcher, all captive demos must run entirely in main memory (48K).
# NO languard card, NO auxmem!
#
# We have enough disk space that we don't worry too much about it. (Wow.)
# Generally we start with an uncompressed ProDOS port of the entire game
# and whittle it down to just the files it needs for its demo mode, then
# apply patches so that it
#
# - returns control after the natural end of the demo cycle
# - returns control on any keypress
# - returns control on any button press (note: some games don't support
#   joystick buttons at all, and we don't add button support, but if you
#   can start the game by pressing a button, we need to ensure that that
#   returns control instead)
# - disables all sound output
#
# 'Returning control' involves activating RAM bank 1 read access and
# jumping to $D000 (labeled as |Reenter| in the source code). The launcher
# puts this code at $0100 before executing a captive demo, so generally
# you can just put 'JMP $0100' anywhere. If a particular game overwrites
# this area of the stack page, you will need to find 6 bytes for the
# 'LDA $C088 / JMP $D000' instructions yourself.
#
# Notes on completed and in-progress captive demos are in res/notes/
#

# TODO
Apple Cider Spider
Conan
Gumball
Karateka
Pac-Man
Repton
Ribbit
Sammy Lightfoot [priority]
Stellar 7
Succession
Track N Field
Tubeway ][
Vindicator

# uncompressed but unpatched
Agent USA
Alien Downpour
Bouncing Kamungas
Buzzard Bait
Canyon Climber
Ceiling Zero
Choplifter
Drelbs
Dung Beetles
Firebird
Flip Out
Formula 1 Racer
Galaxian
Gamma Goblins
Hard Hat Mack
High Rise
Lady Tut
Lost Tomb
Mr. Cool
Nibbler
O'Riley's Mine
Pie-Man
Robotron 2084
Serpentine
Snake Byte
Snoggle
Spider Raid
Starblaster
Stargate
Thunder Bombs

# done
Alien Ambush
Alien Rain
Aquatron
Bolo
BurgerTime
Championship Lode Runner
Dino Eggs
Jungle Hunt
Lode Runner
Pest Patrol
Pitfall II
Plasmania
Pooyan
Sneakers
Spare Change
Spy Hunter
Spy's Demise
Wavy Navy

# obvious candidates that we're skipping
Arkanoid (requires 64K)
Drol (attract mode is minimal)
Mr. Do (attract mode requires 64K)
Prince of Persia (requires 128K)
Tag Team Wrestling (requires 64K)