add Pitfall II captive demo

res/attract.conf

@@ -1 +1 @@
-#
# Mega-Attract-Mode configuration file
#
# Mega-Attract-Mode is split into modules. Each module can be a
# short slideshow or a self-running demo (like a game's built-in
# 'attract mode'). Modules are run in the order listed here, one
# after the next, until interrupted by user input. The last-run
# module is tracked in the master prefs file.
#
# Format:
# key=value
#
# value must be one of
#   1 for HGR slideshow (key is a file containing a list of HGR graphics)
#   2 for DHGR slideshow (key is a file containing a list of DHGR graphics)
#   3 for self-running demo (key is an executable binary file)
#
# Blank lines and lines beginning with '#' are ignored (like this one!)
# A line beginning with '[' terminates the parsing
#

SHORT.CONF=1
SPARE.CHANGE=3
DHGR.CONF=2
FAVORITES.CONF=1
#SNEAKERS=3
EFG.CONF=1
#WAVY.NAVY=3
ACTIVISION.CONF=1
CD.CONF=1
BRODERBUND.CONF=1
T.CONF=1
ATARI.CONF=1
SIERRA.CONF=1
PQR.CONF=1
DATAMOST.CONF=1
MNO.CONF=1
DATASOFT.CONF=1
S.CONF=1
MICROFUN.CONF=1
AB.CONF=1
PICCADILLY.CONF=1
HIJKL.CONF=1
SIRIUS.CONF=1

[eof]
+#
# Mega-Attract-Mode configuration file
#
# Mega-Attract-Mode is split into modules. Each module can be a
# short slideshow or a self-running demo (like a game's built-in
# 'attract mode'). Modules are run in the order listed here, one
# after the next, until interrupted by user input. The last-run
# module is tracked in the master prefs file.
#
# Format:
# key=value
#
# value must be one of
#   1 for HGR slideshow (key is a file containing a list of HGR graphics)
#   2 for DHGR slideshow (key is a file containing a list of DHGR graphics)
#   3 for self-running demo (key is an executable binary file)
#
# Blank lines and lines beginning with '#' are ignored (like this one!)
# A line beginning with '[' terminates the parsing
#

PITFALL.II=3
SHORT.CONF=1
SPARE.CHANGE=3
DHGR.CONF=2
FAVORITES.CONF=1
#SNEAKERS=3
EFG.CONF=1
#WAVY.NAVY=3
ACTIVISION.CONF=1
CD.CONF=1
BRODERBUND.CONF=1
T.CONF=1
ATARI.CONF=1
SIERRA.CONF=1
PQR.CONF=1
DATAMOST.CONF=1
MNO.CONF=1
DATASOFT.CONF=1
S.CONF=1
MICROFUN.CONF=1
AB.CONF=1
PICCADILLY.CONF=1
HIJKL.CONF=1
SIRIUS.CONF=1

[eof]

res/demo/_FileInformation.txt

@@ -9,23 +9,5 @@ PITFALL.II=Type(06),AuxType(08E5),Access(C3)
 SPY.HUNTER=Type(06),AuxType(0B87),Access(C3)
 SPARE.CHANGE=Type(06),AuxType(2700),Access(C3)
 SPARE.CHANGE.A=Type(06),AuxType(8E00),Access(C3)
-SPARE.CHANGE.B=Type(06),AuxType(8E00),Access(C3)
-SPARE.CHANGE.C=Type(06),AuxType(8E00),Access(C3)
-SPARE.CHANGE.D=Type(06),AuxType(8E00),Access(C3)
-SPARE.CHANGE.E=Type(06),AuxType(8E00),Access(C3)
-SPARE.CHANGE.F=Type(06),AuxType(8E00),Access(C3)
-SPARE.CHANGE.G=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.H=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.I=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.J=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.K=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.L=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.M=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.N=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.O=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.P=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.Q=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.R=Type(06),AuxType(9600),Access(C3)
 SPARE.CHANGE.S=Type(06),AuxType(9600),Access(C3)
-SPARE.CHANGE.T=Type(06),AuxType(9600),Access(C3)
 SPARE.CHANGE.Z=Type(06),AuxType(B400),Access(C3)

res/notes/pitfall-ii.txt

@@ -0,0 +1,6 @@
+$6055 checks for <ESC> (ends demo, starts game)
+$60FD checks for Ctrl-S (changes sound once game starts, but sound is always off during demo) (harmless, ignore)
+$AB43 is after demo cycle (demo player has died and returned to spawn point) [7 bytes available]
+
+$6055: C91BD011A20D -> AD88C04C00D0
+$AB43: A90085614C49 -> AD88C04C00D0

src/ui.attract.mode.a

@@ -83,6 +83,7 @@ AttractMode
          !word gSlideshowStore
          !word ldrlo2                ; (ldrlo2) points to load address
          !byte 0
+
          pla                         ; restore module type
          cmp   #$01
          beq   @HGRSlideshow
@@ -92,20 +93,22 @@ AttractMode
          jsr   BlankDHGR             ; switch to DHGR mode with initial blank screen
          jsr   okvs_iter             ; cycle through all listed DHGR files
          !word gSlideshowStore
-         !word DHGRLoad
+         !word DHGRLoad              ; address of callback (called on each file)
          jmp   BlankHGR              ; switch back to HGR mode with initial blank screen
 
 @HGRSlideshow
          jsr   LoadTransition        ; load transition effect code at $6000
          jsr   okvs_iter             ; cycle through all listed HGR files
          !word gSlideshowStore
-         !word HGRLoad
+         !word HGRLoad               ; address of callback (called on each file)
          rts
 
 ;------------------------------------------------------------------------------
 ; internal functions
 
 HGRLoad
+; in:    A/Y contains address of filename
+
          ldx   $C000
          bpl   +
          rts
@@ -115,11 +118,13 @@ HGRLoad
          ; load HGR screenshot at $4000
          +LOAD_FILE kHGRScreenshotDirectory, PTR
 
-;         jsr   LoadTransition
-         jsr   $6000                 ; transition effect code was loaded here earlier
+;         jsr   LoadTransition        ; uncomment this line to load a new transition on every picture
+         jsr   $6000                 ; call transition effect code to display picture
          jmp   WaitOnScreenshot
 
 DHGRLoad
+; in:    A/Y contains address of filename
+
          ldx   $C000
          bpl   +
          rts
@@ -136,7 +141,7 @@ DHGRLoad
          jsr   LoadDHRFile
          !word gPathname
 
-         jsr   $6000                 ; transition effect code was loaded here earlier
+         jsr   $6000                 ; call transition effect code to display picture
          ; note: execution falls through here
 
 WaitOnScreenshot