From 2cf26ac28dcf965795f0dc9da33f6721b9ba0c9d Mon Sep 17 00:00:00 2001
From: Vince Weaver <vince@deater.net>
Date: Sat, 9 Mar 2024 13:36:33 -0500
Subject: [PATCH] keen: initial checkin

---
 games/duke/Makefile                     |   4 +-
 games/duke/empty.dsk                    | Bin 143360 -> 0 bytes
 games/keen/gr_copy.s                    | 161 ++++++
 games/keen/gr_fast_clear.s              | 201 +++++++
 games/keen/graphics/Makefile            |  32 ++
 games/keen/graphics/keen1_title.png     | Bin 0 -> 7006 bytes
 games/keen/init_vars.s                  |  32 ++
 games/keen/keen_title.s                 | 277 +++++++++
 games/keen/loader.s                     | 709 ++++++++++++++++++++++++
 games/keen/print_help.s                 |  40 ++
 games/keen/text_print.s                 | 191 +++++++
 games/keen/zp.inc                       | 209 +++++++
 games/keen/zx02_optim.s                 | 163 ++++++
 games/sb/rat_graphics/Makefile          |   2 +-
 graphics/gr/bubble_universe/Makefile    |  32 ++
 graphics/gr/bubble_universe/bubble_gr.s | 304 ++++++++++
 graphics/gr/bubble_universe/hello.bas   |  13 +
 17 files changed, 2367 insertions(+), 3 deletions(-)
 delete mode 100644 games/duke/empty.dsk
 create mode 100644 games/keen/gr_copy.s
 create mode 100644 games/keen/gr_fast_clear.s
 create mode 100644 games/keen/graphics/Makefile
 create mode 100644 games/keen/graphics/keen1_title.png
 create mode 100644 games/keen/init_vars.s
 create mode 100644 games/keen/keen_title.s
 create mode 100644 games/keen/loader.s
 create mode 100644 games/keen/print_help.s
 create mode 100644 games/keen/text_print.s
 create mode 100644 games/keen/zp.inc
 create mode 100644 games/keen/zx02_optim.s
 create mode 100644 graphics/gr/bubble_universe/Makefile
 create mode 100644 graphics/gr/bubble_universe/bubble_gr.s
 create mode 100644 graphics/gr/bubble_universe/hello.bas

diff --git a/games/duke/Makefile b/games/duke/Makefile
index 99d28cad..8104cc2c 100644
--- a/games/duke/Makefile
+++ b/games/duke/Makefile
@@ -6,12 +6,12 @@ B2D = ../../utils/bmp2dhr/b2d
 PNG2GR = ../../utils/gr-utils/png2gr
 LZSA = ~/research/lzsa/lzsa/lzsa
 TOKENIZE = ../../utils/asoft_basic-utils/tokenize_asoft
-
+EMPTY_DISK = ../../empty_disk/empty.dsk
 
 all:	duke.dsk
 
 duke.dsk:	HELLO LOADER DUKE_TITLE DUKE_LEVEL1 DUKE_LEVEL2
-	cp empty.dsk duke.dsk
+	cp $(EMPTY_DISK) duke.dsk
 	$(DOS33) -y duke.dsk SAVE A HELLO
 	$(DOS33) -y duke.dsk BSAVE -a 0x1000 LOADER
 	$(DOS33) -y duke.dsk BSAVE -a 0x4000 DUKE_TITLE
diff --git a/games/duke/empty.dsk b/games/duke/empty.dsk
deleted file mode 100644
index b34eb5199d4f28583c3ea48dbade142d2d16eefb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 143360
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
K7MwK*@qYoHv}K_H

diff --git a/games/keen/gr_copy.s b/games/keen/gr_copy.s
new file mode 100644
index 00000000..a657400b
--- /dev/null
+++ b/games/keen/gr_copy.s
@@ -0,0 +1,161 @@
+	;=========================================================
+	; gr_copy_to_current, 40x48 version
+	;=========================================================
+	; copy 0xc00 to DRAW_PAGE
+	;
+	; 45 + 2 + 120*(8*9 + 5) -1 + 6 = 9292
+;.align	$100
+gr_copy_to_current:
+
+	lda	DRAW_PAGE					; 3
+	clc							; 2
+	adc	#$4						; 2
+	sta	gr_copy_line+5					; 4
+	sta	gr_copy_line+11					; 4
+	adc	#$1						; 2
+	sta	gr_copy_line+17					; 4
+	sta	gr_copy_line+23					; 4
+	adc	#$1						; 2
+	sta	gr_copy_line+29					; 4
+	sta	gr_copy_line+35					; 4
+	adc	#$1						; 2
+	sta	gr_copy_line+41					; 4
+	sta	gr_copy_line+47					; 4
+							;===========
+							;	45
+
+	ldy	#119		; for early ones, copy 120 bytes	; 2
+
+gr_copy_line:
+	lda	$C00,Y		; load a byte (self modified)		; 4
+	sta	$400,Y		; store a byte (self modified)		; 5
+
+	lda	$C80,Y		; load a byte (self modified)		; 4
+	sta	$480,Y		; store a byte (self modified)		; 5
+
+	lda	$D00,Y		; load a byte (self modified)		; 4
+	sta	$500,Y		; store a byte (self modified)		; 5
+
+	lda	$D80,Y		; load a byte (self modified)		; 4
+	sta	$580,Y		; store a byte (self modified)		; 5
+
+	lda	$E00,Y		; load a byte (self modified)		; 4
+	sta	$600,Y		; store a byte (self modified)		; 5
+
+	lda	$E80,Y		; load a byte (self modified)		; 4
+	sta	$680,Y		; store a byte (self modified)		; 5
+
+	lda	$F00,Y		; load a byte (self modified)		; 4
+	sta	$700,Y		; store a byte (self modified)		; 5
+
+	lda	$F80,Y		; load a byte (self modified)		; 4
+	sta	$780,Y		; store a byte (self modified)		; 5
+
+	dey			; decrement pointer			; 2
+	bpl	gr_copy_line	;					; 2nt/3
+
+	rts								; 6
+
+
+
+	;=========================================================
+	; gr_copy_to_current, 40x48 version
+	;=========================================================
+	; copy 0x1000 to DRAW_PAGE
+
+gr_copy_to_current_1000:
+
+	lda	DRAW_PAGE					; 3
+	clc							; 2
+	adc	#$4						; 2
+	sta	gr_copy_line_40+5				; 4
+	sta	gr_copy_line_40+11				; 4
+	adc	#$1						; 2
+	sta	gr_copy_line_40+17				; 4
+	sta	gr_copy_line_40+23				; 4
+	adc	#$1						; 2
+	sta	gr_copy_line_40+29				; 4
+	sta	gr_copy_line_40+35				; 4
+	adc	#$1						; 2
+	sta	gr_copy_line_40+41				; 4
+	sta	gr_copy_line_40+47				; 4
+							;===========
+							;	45
+
+	ldy	#119		; for early ones, copy 120 bytes	; 2
+
+gr_copy_line_40:
+	lda	$1000,Y		; load a byte (self modified)		; 4
+	sta	$400,Y		; store a byte (self modified)		; 5
+
+	lda	$1080,Y		; load a byte (self modified)		; 4
+	sta	$480,Y		; store a byte (self modified)		; 5
+
+	lda	$1100,Y		; load a byte (self modified)		; 4
+	sta	$500,Y		; store a byte (self modified)		; 5
+
+	lda	$1180,Y		; load a byte (self modified)		; 4
+	sta	$580,Y		; store a byte (self modified)		; 5
+
+	lda	$1200,Y		; load a byte (self modified)		; 4
+	sta	$600,Y		; store a byte (self modified)		; 5
+
+	lda	$1280,Y		; load a byte (self modified)		; 4
+	sta	$680,Y		; store a byte (self modified)		; 5
+
+	lda	$1300,Y		; load a byte (self modified)		; 4
+	sta	$700,Y		; store a byte (self modified)		; 5
+
+	lda	$1380,Y		; load a byte (self modified)		; 4
+	sta	$780,Y		; store a byte (self modified)		; 5
+
+	dey			; decrement pointer			; 2
+	bpl	gr_copy_line_40	;					; 2nt/3
+
+	rts								; 6
+
+
+
+	;=========================================================
+	; gr_copy_to_current_40x40
+	;=========================================================
+	; Take image in 0xc00
+	; 	Copy to DRAW_PAGE
+	;	Actually copy lines 0..39
+	; Don't over-write bottom 4 lines of text
+gr_copy_to_current_40x40:
+
+	ldx	#0
+gc_40x40_loop:
+	lda	gr_offsets,x
+	sta	OUTL
+	sta	INL
+	lda	gr_offsets+1,x
+	clc
+	adc	DRAW_PAGE
+	sta	OUTH
+
+	lda	gr_offsets+1,x
+	clc
+	adc	#$8
+	sta	INH
+
+	ldy	#39
+gc_40x40_inner:
+	lda	(INL),Y
+	sta	(OUTL),Y
+
+	dey
+	bpl	gc_40x40_inner
+
+	inx
+	inx
+
+	cpx	#40
+	bne	gc_40x40_loop
+
+	rts								; 6
+
+
+
+
diff --git a/games/keen/gr_fast_clear.s b/games/keen/gr_fast_clear.s
new file mode 100644
index 00000000..76035a21
--- /dev/null
+++ b/games/keen/gr_fast_clear.s
@@ -0,0 +1,201 @@
+;clear_screens:
+;	;===================================
+;	; Clear top/bottom of page 0
+;	;===================================
+;
+;	lda	#$0
+;	sta	DRAW_PAGE
+;	jsr	clear_top
+;	jsr	clear_bottom
+
+;	;===================================
+;	; Clear top/bottom of page 1
+;	;===================================
+;
+;	lda	#$4
+;	sta	DRAW_PAGE
+;	jsr	clear_top
+;	jsr	clear_bottom
+;
+;	rts
+
+
+
+
+	;=========================================================
+	; clear_top
+	;=========================================================
+	; clear DRAW_PAGE
+	; original = 14,558 cycles(?) 15ms, 70Hz
+	; OPTIMIZED MAX (page0,48rows): 45*120+4+6 = 5410 = 5.4ms 185Hz
+	;		(pageX,40rows): 50*120+4+6 = 6010 = 6.0ms 166Hz
+	;				50*120+4+6+37 = 6055 = 6.0ms 166Hz
+clear_top:
+	lda	#0							; 2
+clear_top_a:
+	sta	COLOR							; 3
+	clc								; 2
+	lda	DRAW_PAGE						; 3
+
+	adc	#4							; 2
+	sta	__ctf+2							; 3
+	sta	__ctf+5							; 3
+	adc	#1							; 2
+	sta	__ctf+8							; 3
+	sta	__ctf+11						; 3
+	adc	#1							; 2
+	sta	__ctf2+2						; 3
+	sta	__ctf2+5						; 3
+	adc	#1							; 2
+	sta	__ctf2+8						; 3
+	sta	__ctf2+11						; 3
+
+
+	ldy	#120							; 2
+	lda	COLOR							; 3
+clear_top_fast_loop:
+__ctf:
+	sta	$400,Y							; 5
+	sta	$480,Y							; 5
+	sta	$500,Y							; 5
+	sta	$580,Y							; 5
+
+	cpy	#80							; 2
+	bpl	no_draw_bottom						; 2nt/3
+__ctf2:
+	sta	$600,Y							; 5
+	sta	$680,Y							; 5
+	sta	$700,Y							; 5
+	sta	$780,Y							; 5
+no_draw_bottom:
+
+	dey								; 2
+	bpl	clear_top_fast_loop					; 2nt/3
+
+	rts								; 6
+
+
+
+
+	;=========================================================
+	; clear_bottom
+	;=========================================================
+	; clear bottom of draw page
+
+clear_bottom:
+	clc								; 2
+	lda	DRAW_PAGE						; 3
+
+	adc	#6							; 2
+	sta	__cbf2+2						; 3
+	sta	__cbf2+5						; 3
+	adc	#1							; 2
+	sta	__cbf2+8						; 3
+	sta	__cbf2+11						; 3
+
+
+	ldy	#120							; 2
+	lda	#$a0	; Normal Space					; 2
+clear_bottom_fast_loop:
+__cbf2:
+	sta	$600,Y							; 5
+	sta	$680,Y							; 5
+	sta	$700,Y							; 5
+	sta	$780,Y							; 5
+
+	dey								; 2
+	cpy	#80							; 2
+	bpl	clear_bottom_fast_loop					; 2nt/3
+
+	rts								; 6
+
+
+;clear_screens_notext:
+        ;===================================
+        ; Clear top/bottom of page 0
+        ;===================================
+
+;	lda	#$0
+;	sta	DRAW_PAGE
+;	jsr	clear_all
+
+	;===================================
+        ; Clear top/bottom of page 1
+        ;===================================
+
+;	lda	#$4
+;	sta	DRAW_PAGE
+;	jsr	clear_all
+
+;	rts
+
+
+clear_bottoms:
+
+	lda	DRAW_PAGE
+	pha
+
+	;===================================
+	; Clear bottom of page 0
+	;===================================
+
+	lda	#$0
+	sta	DRAW_PAGE
+	jsr	clear_bottom
+
+	;===================================
+	; Clear bottom of page 1
+	;===================================
+
+	lda	#$4
+	sta	DRAW_PAGE
+	jsr	clear_bottom
+
+	pla
+	sta	DRAW_PAGE
+
+        rts
+
+
+	;=========================================================
+	; clear_all
+	;=========================================================
+	; clear 48 rows
+
+clear_all:
+	clc								; 2
+	lda	DRAW_PAGE						; 3
+
+	adc	#4							; 2
+	sta	__caf+2							; 3
+	sta	__caf+5							; 3
+	adc	#1							; 2
+	sta	__caf+8							; 3
+	sta	__caf+11						; 3
+	adc	#1							; 2
+	sta	__caf2+2						; 3
+	sta	__caf2+5						; 3
+	adc	#1							; 2
+	sta	__caf2+8						; 3
+	sta	__caf2+11						; 3
+
+
+	ldy	#120							; 2
+clear_all_color:
+	lda	#' '|$80						; 2
+clear_all_fast_loop:
+__caf:
+	sta	$400,Y							; 5
+	sta	$480,Y							; 5
+	sta	$500,Y							; 5
+	sta	$580,Y							; 5
+__caf2:
+	sta	$600,Y							; 5
+	sta	$680,Y							; 5
+	sta	$700,Y							; 5
+	sta	$780,Y							; 5
+
+	dey								; 2
+	bpl	clear_all_fast_loop					; 2nt/3
+
+	rts								; 6
diff --git a/games/keen/graphics/Makefile b/games/keen/graphics/Makefile
new file mode 100644
index 00000000..8edb44e5
--- /dev/null
+++ b/games/keen/graphics/Makefile
@@ -0,0 +1,32 @@
+include ../../../Makefile.inc
+
+ZX02 = ~/research/6502_compression/zx02.git/build/zx02 -f
+PNG_TO_HGR = ../../../utils/hgr-utils/png2hgr
+LINKER_SCRIPTS = ../../../linker_scripts
+DOS33 = ../../../utils/dos33fs-utils/dos33
+EMPTY_DISK = ../../../empty_disk/empty.dsk
+TOKENIZE = ../../../utils/asoft_basic-utils/tokenize_asoft
+PNG2GR = ../../../utils/gr-utils/png2gr
+PNG2SPRITES = ../../../utils/gr-utils/png2sprites
+HGR_SPRITE = ../../../utils/hgr-utils/hgr_make_sprite
+
+all:	keen1_title.hgr.zx02
+
+####
+
+#disk_sprites.inc:	a2_fortnight_sprites.png
+#	$(HGR_SPRITE) -s -l disk_sprite0 a2_fortnight_sprites.png  14   7 41  34 > disk_sprites.inc
+
+####
+
+keen1_title.hgr.zx02:	keen1_title.hgr
+	$(ZX02) keen1_title.hgr keen1_title.hgr.zx02
+
+keen1_title.hgr:	keen1_title.png
+	$(PNG_TO_HGR) keen1_title.png > keen1_title.hgr
+
+####
+
+clean:
+	rm -f *~ *.o *.lst  *.zx02 *.hgr
+
diff --git a/games/keen/graphics/keen1_title.png b/games/keen/graphics/keen1_title.png
new file mode 100644
index 0000000000000000000000000000000000000000..b90b079e95f4d5dd23dcde8b523d244ecbd00f83
GIT binary patch
literal 7006
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
Mojsk39Vkiv18Gw}=l}o!

literal 0
HcmV?d00001

diff --git a/games/keen/init_vars.s b/games/keen/init_vars.s
new file mode 100644
index 00000000..538b9b1d
--- /dev/null
+++ b/games/keen/init_vars.s
@@ -0,0 +1,32 @@
+
+	;=====================
+	; init vars
+	;=====================
+init_vars:
+	lda	#0
+	sta	ANIMATE_FRAME
+	sta	FRAMEL
+	sta	FRAMEH
+	sta	DISP_PAGE
+	sta	JOYSTICK_ENABLED
+	sta	DUKE_WALKING
+	sta	DUKE_JUMPING
+	sta	LEVEL_OVER
+	sta	LASER_OUT
+	sta	DUKE_XL
+	sta	SCORE0
+	sta	SCORE1
+	sta	SCORE2
+	sta	DUKE_FALLING
+	sta	DUKE_SHOOTING
+	sta	KICK_UP_DUST
+	sta	DOOR_ACTIVATED
+	sta	INVENTORY
+
+	lda	#1
+	sta	FIREPOWER
+
+	lda	#7
+	sta	HEALTH
+
+	rts
diff --git a/games/keen/keen_title.s b/games/keen/keen_title.s
new file mode 100644
index 00000000..262e51e6
--- /dev/null
+++ b/games/keen/keen_title.s
@@ -0,0 +1,277 @@
+; Keen1 Title
+
+; loads a HGR version of the title
+
+; by deater (Vince Weaver) <vince@deater.net>
+
+; Zero Page
+	.include "zp.inc"
+	.include "hardware.inc"
+	.include "common_defines.inc"
+
+keen_title_start:
+	;===================
+	; init screen
+	;===================
+
+	jsr	TEXT
+	jsr	HOME
+	bit	KEYRESET
+
+	bit	SET_GR
+	bit	PAGE0
+	bit	HIRES
+	bit	FULLGR
+
+	;===================
+	; machine workarounds
+	;===================
+	; mostly IIgs
+	;===================
+	; thanks to 4am who provided this code from Total Replay
+
+	lda	ROM_MACHINEID
+	cmp	#$06
+	bne	not_a_iigs
+	sec
+	jsr	$FE1F			; check for IIgs
+	bcs	not_a_iigs
+
+	; gr/text page2 handling broken on early IIgs models
+	; this enables the workaround
+
+	jsr	ROM_TEXT2COPY		; set alternate display mode on IIgs
+	cli				; enable VBL interrupts
+
+	; also set background color to black instead of blue
+	lda	NEWVIDEO
+	and	#%00011111	; bit 7 = 0 -> IIgs Apple II-compat video modes
+				; bit 6 = 0 -> IIgs 128K memory map same as IIe
+				; bit 5 = 0 -> IIgs DHGR is color, not mono
+				; bits 0-4 unchanged
+	sta   NEWVIDEO
+	lda   #$F0
+	sta   TBCOLOR			; white text on black background
+	lda   #$00
+	sta   CLOCKCTL			; black border
+	sta   CLOCKCTL			; set twice for VidHD
+
+not_a_iigs:
+
+	;===================
+	; Load hires graphics
+	;===================
+reload_everything:
+
+	lda	#<new_title
+	sta	ZX0_src
+	lda	#>new_title
+	sta	ZX0_src+1
+
+	lda	#$20	; decompress to hgr page1
+
+	jsr	full_decomp
+
+	;===================================
+	; detect if we have a language card
+	; and load sound into it if possible
+	;===================================
+
+;	lda	#0
+;	sta	SOUND_STATUS		; clear out, sound enabled
+
+;	jsr	detect_language_card
+;	bcs	no_language_card
+
+	; update sound status
+;	lda	SOUND_STATUS
+;	ora	#SOUND_IN_LC
+;	sta	SOUND_STATUS
+
+	; load sounds into LC
+
+	; read ram, write ram, use $d000 bank1
+;	bit	$C08B
+;	bit	$C08B
+
+;	lda	#<linking_noise_compressed
+;	sta	getsrc_smc+1
+;	lda	#>linking_noise_compressed
+;	sta	getsrc_smc+2
+
+;	lda	#$D0	; decompress to $D000
+
+;	jsr	decompress_lzsa2_fast
+
+;blah:
+
+	; read rom, nowrite, use $d000 bank1
+;	bit	$C08A
+
+no_language_card:
+
+	;===================================
+	; Setup Mockingboard
+	;===================================
+;	lda	#0
+;	sta	DONE_PLAYING
+;	sta	LOOP
+
+	; detect mockingboard
+;	jsr	mockingboard_detect
+
+;	bcc	mockingboard_notfound
+
+mockingboard_found:
+;;       jsr     mockingboard_patch      ; patch to work in slots other than 4?
+
+;	lda	SOUND_STATUS
+;	ora	#SOUND_MOCKINGBOARD
+;	sta	SOUND_STATUS
+
+	;=======================
+	; Set up 50Hz interrupt
+	;========================
+
+;	jsr	mockingboard_init
+;	jsr	mockingboard_setup_interrupt
+
+	;============================
+	; Init the Mockingboard
+	;============================
+
+;	jsr	reset_ay_both
+;	jsr	clear_ay_both
+
+	;==================
+	; init song
+	;==================
+
+;	jsr     pt3_init_song
+
+;	jmp     done_setup_sound
+
+
+mockingboard_notfound:
+
+
+done_setup_sound:
+
+
+
+	;===================================
+	; Do Intro Sequence
+	;===================================
+
+	; wait a bit at LOAD screen
+
+	lda	#100
+	jsr	wait_a_bit
+
+
+done_intro:
+
+	; restore to full screen (no text)
+
+	bit	FULLGR
+	bit	LORES
+
+	;============================
+	; init vars
+
+	jsr	init_vars
+
+
+
+	;============================
+	; set up initial location
+
+	lda	#LOAD_DUKE1
+	sta	WHICH_LOAD		; start at first level
+
+	rts
+
+
+	;==========================
+	; includes
+	;==========================
+
+	.include	"gr_pageflip.s"
+	.include	"gr_copy.s"
+;	.include	"wait_a_bit.s"
+	.include	"gr_offsets.s"
+	.include	"zx02_optim.s"
+
+	.include	"print_help.s"
+	.include	"gr_fast_clear.s"
+	.include	"text_print.s"
+
+	.include	"init_vars.s"
+;	.include	"graphics_title/title_graphics.inc"
+;	.include	"lc_detect.s"
+
+
+	; pt3 player
+;	.include "pt3_lib_core.s"
+;	.include "pt3_lib_init.s"
+;	.include "interrupt_handler.s"
+;	.include "pt3_lib_mockingboard_detect.s"
+;	.include "pt3_lib_mockingboard_setup.s"
+
+new_title:
+.incbin "graphics/keen1_title.hgr.zx02"
+
+
+
+	;====================================
+	; wait for keypress or a few seconds
+	;====================================
+
+wait_a_bit:
+
+	bit	KEYRESET
+	tax
+
+keyloop:
+	lda	#200			; delay a bit
+	jsr	WAIT
+
+	lda	KEYPRESS
+	bmi	done_keyloop
+
+;	bmi	keypress_exit
+
+	dex
+	bne	keyloop
+
+done_keyloop:
+	bit	KEYRESET
+
+	cmp	#'H'|$80
+	bne	really_done_keyloop
+
+	bit	SET_TEXT
+	jsr	print_help
+	bit	SET_GR
+	bit	PAGE0
+
+	ldx	#100
+
+	jmp	keyloop
+
+really_done_keyloop:
+
+
+	rts
+
+
+
+
+
+
+;PT3_LOC = theme_music
+
+;.align $100
+;theme_music:
+;.incbin "audio/theme.pt3"
+
diff --git a/games/keen/loader.s b/games/keen/loader.s
new file mode 100644
index 00000000..add1bc68
--- /dev/null
+++ b/games/keen/loader.s
@@ -0,0 +1,709 @@
+; Loader for DUKE
+
+.include "zp.inc"
+.include "hardware.inc"
+.include "common_defines.inc"
+
+nibtbl =  $300	; nothing uses the bottom 128 bytes of $300, do they?
+bit2tbl = $380 	; bit2tbl:	.res 86			;	= nibtbl+128
+filbuf  = $3D6  ; filbuf:	.res 4			;	= bit2tbl+86
+
+; read any file slot 6 version
+; based on FASTLD6 and RTS copyright (c) Peter Ferrie 2011-2013,2018
+
+; modified to assembled with ca65 -- vmw
+; added code to patch it to run from current disk slot -- vmw
+
+;	WHICH_LOAD =	$7E	; thing to load
+;	adrlo	=	$26	; constant from boot prom
+;	adrhi	=	$27	; constant from boot prom
+;	tmpsec	=	$3c	; constant from boot prom
+;	reqsec	=	$3d	; constant from boot prom
+;	sizelo	=	$44
+;	sizehi	=	$45
+;	secsize	=	$46
+;	namlo	=	$f8
+;	namhi	=	$f9
+;	TEMPY	=	$fa
+;	step	=	$fd	; state for stepper motor
+;	tmptrk	=	$fe	; temporary copy of current track
+;	phase	=	$ff	; current phase for /seek
+;	OUTL	=	$fe	; for picking filename
+;	OUTH	=	$ff
+
+	dirbuf	=	$c00
+				; note, don't put this immediately below
+				;   the value being read as destaddr-4
+				;   is temporarily overwritten during read
+				;   process
+
+
+	FILENAME = $280
+
+	;===================================================
+	;===================================================
+	; START / INIT
+	;===================================================
+	;===================================================
+
+loader_start:
+
+	lda	#LOAD_TITLE
+	sta	WHICH_LOAD
+
+	jsr	init	; unhook DOS, init nibble table
+
+
+	;===================================================
+	;===================================================
+	; SETUP THE FILENAME
+	;===================================================
+	;===================================================
+
+which_load_loop:
+
+
+
+	; update the which-file error message
+;	lda	WHICH_LOAD
+;	tay
+;	lda	which_disk,Y
+;	sta	error_string+19
+
+	lda	WHICH_LOAD
+	asl
+
+	tay
+	lda	filenames,Y
+	sta	OUTL
+	lda	filenames+1,Y
+	sta	OUTH
+
+	lda	WHICH_LOAD
+	bne	load_other
+
+load_intro:
+	lda	#<$4000
+	sta	entry_smc+1
+	lda	#>$4000
+	sta	entry_smc+2
+	jmp	actual_load
+
+load_other:
+	lda	#<$2000
+	sta	entry_smc+1
+	lda	#>$2000
+	sta	entry_smc+2
+
+actual_load:
+
+	;===================================================
+	;===================================================
+	; SET UP DOS3.3 FILENAME
+	;===================================================
+	;===================================================
+
+load_file_and_execute:
+
+	jsr	opendir_filename
+
+entry_smc:
+	jsr	$1000		; jump to common entry point
+
+	; hope they updated the WHICH_LOAD value
+
+	jmp	which_load_loop
+
+
+	;==============================
+	; setup filename then open/load
+
+opendir_filename:
+
+	; clear out the filename with $A0 (space)
+
+	lda	#<FILENAME
+	sta	namlo
+	lda	#>FILENAME
+	sta	namhi
+
+	ldy	#29
+wipe_filename_loop:
+	lda	#$A0
+	sta	(namlo),Y
+	dey
+	bpl	wipe_filename_loop
+
+	ldy	#0
+copy_filename_loop:
+	lda	(OUTL),Y
+	beq	copy_filename_done
+	ora	#$80
+	sta	(namlo),Y
+	iny
+	bne	copy_filename_loop
+
+copy_filename_done:
+	jsr	opendir		; open and read entire file into memory
+
+	rts
+
+filenames:
+	.word title_filename
+	.word keen1_filename
+	.word keen2_filename
+
+title_filename:
+	.byte "KEEN_TITLE",0
+keen1_filename:
+	.byte "KEEN_LEVEL1",0
+keen2_filename:
+	.byte "KEEN_LEVEL2",0
+
+
+	;===================================================
+	;===================================================
+	; INIT (build nibble table)
+	;===================================================
+	;===================================================
+
+                ;unhook DOS and build nibble table
+
+init:
+	; patch to use current drive
+
+	; locate input paramater list
+	jsr	$3E3
+	; result is in A:Y
+	sta	$FF
+	sty	$FE
+	ldy	#1
+	lda	($FE),y
+
+	; list+1 should have slot<<8
+
+
+	ora	#$80		; add in $80
+
+	; c0e0
+	sta	mlsmc06+1
+
+	; c0e8
+	clc
+	adc	#8
+	sta	mlsmc02+1
+	sta	mlsmc07+1
+
+	; c0e9
+	clc
+	adc	#1
+	sta	mlsmc01+1
+
+	; c0ec
+	clc
+	adc	#3
+	sta	mlsmc03+1
+	sta	mlsmc04+1
+	sta	mlsmc05+1
+
+	jsr	$fe93					; clear COUT
+	jsr	$fe89					; clear KEYIN
+
+	;========================
+	; Create nibble table
+	; Note: the table starts 16 bytes in, and is sparse
+	;	so it doesn't entirely look like the DOS33 table at
+
+	ldy	#0
+	ldx	#3
+L1:	stx	$3c		; store tempx    (3?)
+	txa			; a=x	     (a=3)
+	asl			; a*=2       (a=6)
+	bit	$3c		; a&tempx, set N/V (a=6)
+	beq	L3		; if 0, skip to L3
+	ora	$3c		; a|=tempx	(a=7)
+	eor	#$ff		; a=~a		(a=f8)
+	and	#$7e		; a&=0x7e 0111 1110 (a=78)
+L2:	bcs	L3		; this set way back at asl??
+	lsr			; a>>1		a=3c c=0
+				;		a=1e c=0
+				;		a=0f c=0
+				;		a=07 c=1
+	bne	L2		; if a!=0 goto l2
+	tya			; if a==0, a=y
+	sta	nibtbl, x	; write out to table
+	iny			; increment y
+L3:	inx			; increment x	x=4, a=0f
+	bpl	L1		; loop while high bit not set
+
+	rts
+
+
+	;===================================================
+	;===================================================
+	; file not found
+	;===================================================
+	;===================================================
+
+file_not_found:
+
+mlsmc07:lda	$c0e8		; turn off drive motor?
+
+	jsr	TEXT
+	jsr	HOME
+
+	ldy	#0
+
+	lda	#<error_string
+	sta	OUTL
+	lda	#>error_string
+	sta	OUTH
+
+quick_print:
+	lda	(OUTL),Y
+	beq	quick_print_done
+	jsr	COUT1
+	iny
+	jmp	quick_print
+
+quick_print_done:
+;	rts
+
+;	jsr	quick_print
+
+fnf_keypress:
+	lda	KEYPRESS
+	bpl	fnf_keypress
+	bit	KEYRESET
+
+	jmp	which_load_loop
+
+; offset for disk number is 19
+error_string:
+.byte "PLEASE INSERT DISK 1, PRESS RETURN",0
+
+
+
+
+
+	;===================================================
+	;===================================================
+	; OPENDIR: actually load the file
+	;===================================================
+	;===================================================
+
+	; turn on drive and read volume table of contents
+opendir:
+mlsmc01:lda	$c0e9		; turn slot#6 drive on
+	ldx	#0
+	stx	adrlo		; zero out adrlo
+	stx	secsize		; zero out secsize
+	lda	#$11		; a=$11 (VTOC)
+	jsr	readdirsec
+firstent:
+
+	lda	dirbuf+1
+
+	; lock if entry not found
+entry_not_found:
+	beq	file_not_found
+
+	; read directory sector
+
+	ldx	dirbuf+2
+	jsr	seekread1
+	ldy	#7              ;number of directory entries in a sector
+	ldx	#$2b            ;offset of filename in directory entry
+nextent:
+	tya
+	pha			; was **phy**
+	txa
+	pha			; was **phx**
+	ldy	#$1d
+
+	; match name backwards (slower but smaller)
+
+L4:
+	lda	(namlo), y
+	cmp	dirbuf, x
+	beq	foundname
+	pla
+
+	; move to next directory in this block, if possible
+
+	clc
+	adc	#$23
+	tax
+	pla
+	tay			; was **ply**
+	dey
+	bne	nextent
+	beq	firstent	; was **bra**
+
+foundname:
+	dex
+	dey
+	bpl	L4
+	pla
+	tay			; was **ply**
+	pla
+
+	; read track/sector list
+
+	lda	dirbuf-32, y
+	ldx	dirbuf-31, y
+	jsr	seekread1
+
+	; read load offset and length info only, initially
+
+	lda	#<filbuf
+	sta	adrlo
+	lda	#4
+	sta	secsize
+	lda	dirbuf+12
+	ldx	dirbuf+13
+	ldy	#>filbuf
+	jsr	seekread
+
+	; reduce load offset by 4, to account for offset and length
+
+	sec
+	lda	filbuf
+	sbc	#4
+	sta	adrlo
+
+	lda	filbuf+1
+	sbc	#0
+	sta	adrhi
+
+	; save on stack bytes that will be overwritten by extra read
+
+	ldy	#3
+L5:
+	lda	(adrlo), y
+	pha
+	dey
+	bpl	L5
+
+	lda	adrhi
+	pha
+	lda	adrlo
+	pha
+
+	; increase load size by 4, to account for offst and length
+
+	lda	filbuf+2
+	adc	#3
+	sta	sizelo
+	sta	secsize
+
+	lda	filbuf+3
+	adc	#0
+	sta	sizehi
+	beq	readfirst
+	lda	#0		; was **stz secsize**
+	sta	secsize
+
+readfirst:
+	ldy	#$0c
+
+	; read a file sector
+
+readnext:
+	tya
+	pha
+	lda	dirbuf, y		; A = track
+	ldx	dirbuf+1, y		; x = sector
+	jsr	seekread1
+	pla
+	tay
+
+	; if low count is non-zero then we are done
+	; (can happen only for partial last block)
+
+	lda	secsize
+	bne	readdone
+
+	; continue if more than $100 bytes left
+
+	dec	sizehi
+        bne	L6
+
+	; set read size to min(length, $100)
+
+	lda	sizelo
+	beq	readdone
+	sta	secsize
+L6:
+	inc	adrhi
+	iny
+	iny
+	bne 	readnext
+
+	; save current address for after t/s read
+
+	lda	adrhi
+	pha
+	lda	adrlo
+	pha
+	lda	#0
+	sta	adrlo			; was **stz adrlo**
+
+	; read next track/sector sector
+
+	lda	dirbuf+1
+	ldx	dirbuf+2
+	jsr	readdirsec
+	clc
+
+	; restore current address
+readdone:
+	pla
+	sta	adrlo			; code originally had this backwards
+	pla
+	sta	adrhi
+	bcc	readfirst
+
+mlsmc02:lda	$c0e8
+
+	; restore from stack bytes that were overwritten by extra read
+
+	ldx	#3
+	ldy	#0
+L7:
+	pla
+	sta	(adrlo), y
+	iny
+	dex
+	bpl	L7
+	rts
+
+
+	;======================
+	; readdirsec
+	;======================
+	; a = track?
+	; x = sector?
+readdirsec:
+	ldy	#>dirbuf
+seekread:
+	sty	adrhi
+seekread1:
+	sta	phase
+	lda	sectbl, x
+	sta	reqsec
+	jsr	readadr
+
+	; if track does not match, then seek
+
+	cpx	phase
+	beq	checksec
+	jsr	seek
+
+
+	;=========================================
+	; re merge in with qkumba's recent changes
+	; to fix seek problem?
+	;=========================================
+
+	; [re-]read sector
+
+re_read_addr:
+	jsr	readadr
+checksec:
+	cmp	reqsec
+	bne	re_read_addr
+
+	;=========================
+	; read sector data
+	;=========================
+
+readdata:
+	jsr	readd5aa
+	eor	#$ad		; zero A if match
+	bne	re_read_addr
+
+L12:
+mlsmc03:ldx	$c0ec		; read until valid data (high bit set)
+	bpl	L12
+	eor	nibtbl-$80, x
+	sta	bit2tbl-$aa, y
+	iny
+	bne	L12
+L13:
+mlsmc04:ldx	$c0ec		; read until valid data (high bit set)
+	bpl	L13
+	eor	nibtbl-$80, x
+	sta	(adrlo), y	; the real address
+	iny
+	cpy	secsize
+	bne	L13
+	ldy	#0
+L14:
+	ldx	#$a9
+L15:
+	inx
+	beq	L14
+	lda	(adrlo), y
+	lsr	bit2tbl-$aa, x
+	rol
+	lsr	bit2tbl-$aa, x
+	rol
+	sta	(adrlo), y
+	iny
+	cpy	secsize
+	bne	L15
+	rts
+
+	; no tricks here, just the regular stuff
+
+	;=======================
+	; readaddr -- read the address field
+	;=======================
+	; Find address field, put track in cutrk, sector in tmpsec
+
+readadr:
+	jsr	readd5aa
+	cmp	#$96
+	bne	readadr
+	ldy	#3		; three?
+				; first read volume/volume
+				; then track/track
+				; then sector/sector?
+adr_read_two_bytes:
+	tax
+	jsr	readnib
+	rol
+	sta	tmpsec
+	jsr	readnib
+	and	tmpsec
+	dey
+	bne	adr_read_two_bytes
+	rts
+
+	;========================
+	; make sure we see the $D5 $AA pattern
+
+readd5aa:
+L16:
+	jsr	readnib
+L17:
+	cmp	#$d5
+	bne	L16
+	jsr	readnib
+	cmp	#$aa
+	bne	L17
+	tay		; we need Y=#$AA later
+
+readnib:
+mlsmc05:lda	$c0ec		; read until valid (high bit set)
+	bpl	readnib
+
+seekret:
+	rts
+
+	;=====================
+	; SEEK
+	;=====================
+	; current track in X?
+	; desired track in phase
+
+seek:
+	ldy	#0
+	sty	step
+	asl	phase		; multiply by two
+	txa			; current track?
+	asl			; mul by two
+copy_cur:
+	tax
+	sta	tmptrk
+	sec
+	sbc	phase
+	beq	L22
+	bcs	L18
+	eor	#$ff
+	inx
+	bcc	L19
+L18:
+	sbc	#1
+	dex
+L19:
+	cmp	step
+	bcc	L20
+	lda	step
+L20:
+	cmp	#8
+	bcs	L21
+	tay
+	sec
+L21:
+	txa
+	pha
+	ldx	step1, y
+L22:
+	php
+	bne	L24
+L23:
+	clc
+	lda	tmptrk
+	ldx	step2, y
+L24:
+	stx	tmpsec
+	and	#3
+	rol
+	tax
+	lsr
+mlsmc06:lda	$c0e0, x
+L25:
+	ldx	#$12
+L26:
+	dex
+	bpl	L26
+	dec	tmpsec
+	bne	L25
+	bcs	L23
+	plp
+	beq	seekret
+	pla
+	inc	step
+	bne	copy_cur
+
+
+
+step1:	.byte $01, $30, $28, $24, $20, $1e, $1d, $1c
+step2:	.byte $70, $2c, $26, $22, $1f, $1e, $1d, $1c
+
+sectbl:	.byte $00,$0d,$0b,$09,$07,$05,$03,$01,$0e,$0c,$0a,$08,$06,$04,$02,$0f
+
+
+; From $BA96 of DOS33
+;nibtbl:	.res 128			;		= *
+;	.byte	$00,$01,$98,$99,$02,$03,$9C,$04	; $BA96	; 00
+;	.byte	$05,$06,$A0,$A1,$A2,$A4,$A4,$A5 ; $BA9E	; 08
+;	.byte	$07,$08,$A8,$A9,$AA,$09,$0A,$0B ; $BAA6	; 10
+;	.byte	$0C,$0D,$B0,$B1,$0E,$0F,$10,$11 ; $BAAE	; 18
+;	.byte	$12,$13,$B8,$14,$15,$16,$17,$18 ; $BAB6	; 20
+;	.byte	$19,$1A,$C0,$C1,$C2,$C3,$C4,$C5	; $BABE	; 28
+;	.byte	$C6,$C7,$C8,$C9,$CA,$1B,$CC,$1C ; $BAC6	; 30
+;	.byte	$1D,$1E,$D0,$D1,$D2,$1E,$D4,$D5 ; $BACE	; 38
+;	.byte	$20,$21,$D8,$22,$23,$24,$25,$26	; $BAD6	; 40
+;	.byte	$27,$28,$E0,$E1,$E2,$E3,$E4,$29	; $BADE ; 48
+;	.byte	$2A,$2B,$E8,$2C,$2D,$2E,$2F,$30	; $BAE6 ; 50
+;	.byte	$31,$32,$F0,$F1,$33,$34,$35,$36 ; $BAEE ; 58
+;	.byte	$37,$38,$F8,$39,$3A,$3B,$3C,$3D	; $BAF6	; 60
+;	.byte	$3E,$3F,$13,$00,$01,$02,$01,$00 ; $BAFE ; 68
+;	.byte	$00,$00,$00,$00,$00,$00,$00,$00
+;	.byte	$00,$00,$00,$00,$00,$00,$00,$00
+
+
+;bit2tbl:	.res 86			;	= nibtbl+128
+;filbuf:		.res 4			;	= bit2tbl+86
+
+
+					;dataend         = filbuf+4
+
+	.include	"init_vars.s"
+
+loader_end:
+
+.assert (<loader_end - <loader_start)>16, error, "loader too big"
diff --git a/games/keen/print_help.s b/games/keen/print_help.s
new file mode 100644
index 00000000..35113863
--- /dev/null
+++ b/games/keen/print_help.s
@@ -0,0 +1,40 @@
+; For Help press ^H
+
+print_help:
+	bit	KEYRESET		; clear keyboard
+	bit	SET_TEXT
+
+	jsr	normal_text
+
+	lda     #' '|$80
+        sta     clear_all_color+1
+	jsr	clear_all
+
+	lda	#<help_text
+	sta	OUTL
+	lda	#>help_text
+	sta	OUTH
+	jsr	move_and_print_list
+
+	jsr	page_flip
+
+wait_for_keypress:
+	lda     KEYPRESS
+	bpl	wait_for_keypress
+	bit	KEYRESET
+
+
+	bit	SET_GR
+	rts
+
+help_text:
+.byte 0, 5,"CONTROLS:",0
+.byte 3, 6,   "A OR <-      : MOVE LEFT",0
+.byte 3, 7,   "D OR ->      : MOVE RIGHT",0
+.byte 3, 8,   "W OR UP      : ACTION, ENTER DOOR",0
+.byte 3, 9,   "SPACEBAR     : JUMP",0
+.byte 3,10,   "RETURN       : SHOOT LASER",0
+.byte 3,12,   "ESC          : QUITS",0
+.byte 3,13,   "CONTROL-T    : TOGGLE SOUND",0
+.byte 3,14,   "J            : ENABLE JOYSTICK",0
+.byte 255
diff --git a/games/keen/text_print.s b/games/keen/text_print.s
new file mode 100644
index 00000000..dada5ca0
--- /dev/null
+++ b/games/keen/text_print.s
@@ -0,0 +1,191 @@
+	;=============================
+	; normal_text
+	;=============================
+	; modify so print normal text
+normal_text:
+
+	; want ora #$80
+	lda	#$09
+	sta	ps_smc1
+
+	lda	#$80
+	sta	ps_smc1+1
+
+	rts
+
+	;=============================
+	; inverse_text
+	;=============================
+	; modify so print inverse text
+inverse_text:
+
+	; want and #$3f
+	lda	#$29
+	sta	ps_smc1
+
+	lda	#$3f
+	sta	ps_smc1+1
+
+	rts
+
+
+	;=============================
+	; raw text
+	;=============================
+	; modify so print raw string
+raw_text:
+
+	; want nop nop
+	lda	#$EA
+	sta	ps_smc1
+
+	lda	#$EA
+	sta	ps_smc1+1
+
+	rts
+
+
+
+	;================================
+	; move_and_print
+	;================================
+	; get X,Y from OUTL/OUTH
+	; then print following string to that address
+	; stop at NUL
+	; convert to APPLE ASCII (or with 0x80)
+	; leave OUTL/OUTH pointing to next string
+
+move_and_print:
+	ldy	#0
+	lda	(OUTL),Y
+	sta	CH
+	iny
+	lda	(OUTL),Y
+	asl
+	tay
+	lda	gr_offsets,Y    ; lookup low-res memory address
+	clc
+	adc	CH		; add in xpos
+	sta	BASL		; store out low byte of addy
+
+	lda	gr_offsets+1,Y	; look up high byte
+	adc	DRAW_PAGE	;
+	sta	BASH		; and store it out
+				; BASH:BASL now points at right place
+
+	clc
+	lda	OUTL
+	adc	#2
+	sta	OUTL
+	lda	OUTH
+	adc	#0
+	sta	OUTH
+
+	;================================
+	; print_string
+	;================================
+
+print_string:
+	ldy	#0
+print_string_loop:
+	lda	(OUTL),Y
+	beq	done_print_string
+ps_smc1:
+	and	#$3f			; make sure we are inverse
+	sta	(BASL),Y
+	iny
+	bne	print_string_loop
+done_print_string:
+	iny
+	clc
+	tya
+	adc	OUTL
+	sta	OUTL
+	lda	OUTH
+	adc	#0
+	sta	OUTH
+
+	rts
+
+
+	;================================
+	; move and print a list of lines
+	;================================
+move_and_print_list:
+	jsr	move_and_print
+	ldy	#0
+	lda	(OUTL),Y
+	bpl	move_and_print_list
+
+	rts
+
+
+.if 0
+	;================================
+	; move and print a list of lines
+	;================================
+move_and_print_list_both_pages:
+	lda	DRAW_PAGE
+	pha
+
+	lda	OUTL
+	pha
+	lda	OUTH
+	pha
+
+	lda	#0
+	sta	DRAW_PAGE
+
+	jsr	move_and_print_list
+
+	pla
+	sta	OUTH
+	pla
+	sta	OUTL
+
+	lda	#4
+	sta	DRAW_PAGE
+
+	jsr	move_and_print_list
+
+	pla
+	sta	DRAW_PAGE
+
+
+	rts
+
+
+
+	;=======================
+	; print to both pages
+	;=======================
+print_both_pages:
+	lda	DRAW_PAGE
+	pha
+
+	lda	OUTL
+	pha
+	lda	OUTH
+	pha
+
+	lda	#0
+	sta	DRAW_PAGE
+
+	jsr	move_and_print
+
+	pla
+	sta	OUTH
+	pla
+	sta	OUTL
+
+	lda	#4
+	sta	DRAW_PAGE
+
+	jsr	move_and_print
+
+	pla
+	sta	DRAW_PAGE
+
+
+	rts
+.endif
diff --git a/games/keen/zp.inc b/games/keen/zp.inc
new file mode 100644
index 00000000..25419a34
--- /dev/null
+++ b/games/keen/zp.inc
@@ -0,0 +1,209 @@
+;; Zero Page
+
+;; ZX02 addresses
+
+ZP=$00
+
+offset          = ZP+0
+ZX0_src         = ZP+2
+ZX0_dst         = ZP+4
+bitr            = ZP+6
+pntr            = ZP+7
+
+
+
+;; Zero page monitor routines addresses
+
+WNDLFT	= $20
+WNDWDTH	= $21
+WNDTOP	= $22
+WNDBTM	= $23
+CH	= $24
+CV	= $25
+GBASL	= $26
+GBASH	= $27
+BASL	= $28
+BASH	= $29
+H2	= $2C
+X_LEFT	= $2C
+V2	= $2D
+MASK	= $2E
+COLOR_MASK = $2F
+COLOR	= $30
+
+SEEDL	= $4e
+SEEDH	= $4f
+XMAX	= $50
+
+
+
+; MIST zero page addresses
+
+FRAMEL			= $60
+FRAMEH			= $61
+;CURSOR_X		= $62
+;CURSOR_Y		= $63
+XPOS			= $64
+YPOS			= $65
+LOCATION_STRUCT_L	= $66
+LOCATION_STRUCT_H	= $67
+IN_SPECIAL		= $68
+CURSOR_VISIBLE		= $69
+IN_LEFT			= $6A
+IN_RIGHT		= $6B
+BTC_L			= $6C
+BTC_H			= $6D
+
+; pt3 player registers
+REGISTER_DUMP   = $70
+AY_REGISTERS    = $70
+A_FINE_TONE     = $70
+A_COARSE_TONE   = $71
+B_FINE_TONE     = $72
+B_COARSE_TONE   = $73
+C_FINE_TONE     = $74
+C_COARSE_TONE   = $75
+NOISE           = $76
+ENABLE          = $77
+PT3_MIXER_VAL   = $77
+A_VOLUME        = $78
+B_VOLUME        = $79
+C_VOLUME        = $7A
+ENVELOPE_FINE   = $7B
+ENVELOPE_COARSE = $7C
+ENVELOPE_SHAPE  = $7D
+COPY_OFFSET     = $7E
+DECODER_STATE   = $7F
+
+PATTERN_L       = $7E
+PATTERN_H       = $7F
+
+
+; note 70-7f also used by disk code
+
+; note: rest are up at $f0
+
+; We have to save/restore the following values
+; when loading/storing from disk
+
+WHICH_LOAD		= $80		; which file to load
+
+DUKE_XL			= $81
+DUKE_X			= $82		; location of protagonist
+DUKE_Y			= $83
+DUKE_DIRECTION		= $84
+DUKE_WALKING		= $85
+DUKE_JUMPING		= $86
+
+LASER_OUT		= $87
+LASER_X			= $88
+LASER_Y			= $89
+LASER_DIRECTION		= $8A
+TILEMAP_X		= $8B
+TILEMAP_Y		= $8C
+
+DUKE_FOOT_OFFSET	= $8D
+
+FIREPOWER		= $8E
+INVENTORY		= $8F
+	INV_RED_KEY		= $80
+	INV_BLUE_KEY		= $20
+	INV_SHOE		= $08
+	INV_GRIP		= $02
+HEALTH			= $90
+SCORE0			= $91
+SCORE1			= $92
+SCORE2			= $93
+UPDATE_STATUS		= $94
+
+DUKE_FALLING		= $95
+DUKE_SHOOTING		= $96
+KICK_UP_DUST		= $97
+SUPPRESS_WALK		= $98
+ENEMY_DATAL		= $99
+ENEMY_DATAH		= $9A
+DOOR_ACTIVATED		= $9B
+LASER_TILE		= $9C
+TILE_TEMP		= $9D
+
+; done game puzzle state
+
+
+WHICH_SLOT	=	$DA
+JS_BUTTON_STATE	=	$DB
+CURRENT_DISK	=	$DC
+JOYSTICK_ENABLED=	$DD
+SOUND_STATUS	=	$DE
+	SOUND_DISABLED	= $80
+	SOUND_IN_LC	= $01 ; $01 sound effects in language card
+	SOUND_MOCKINGBOARD = $02 ; mockingboard detected
+
+GRID_PAGE	=	$DF
+ANIMATE_FRAME	=	$E0
+LEVEL_OVER	=	$E1
+	GAME_OVER	=	$FF
+	NEXT_LEVEL	=	$01
+LOCATIONS_L	=	$E2
+LOCATIONS_H	=	$E3
+
+; temp var per-world define
+LONG_FRAME	=	$E4	; nibel
+CURRENT_DISPLAY	=	$E4	; selena
+LAST_PLAYED	=	$E4	; selena
+
+DISP_PAGE	=	$ED	; ALL
+DRAW_PAGE	=	$EE	; ALL
+
+; rest of pt3_player
+MB_DETECTED	= $EF
+WHICH_CHUNK	= $F0
+MB_CHUNK_OFFSET	= $F1
+LOOP		= $F4
+MB_VALUE	= $F5
+MB_ADDR_L	= $F6
+MB_ADDR_H	= $F7
+DONE_PLAYING	= $F8
+DONE_SONG	= $F9
+
+; rest of pt3_player
+PT3_TEMP        = $EF
+ORNAMENT_L      = $F0
+ORNAMENT_H      = $F1
+SAMPLE_L        = $F2
+SAMPLE_H        = $F3
+
+
+
+
+
+
+TEMP		=	$FA
+TEMPY		=	$FB
+INL		=	$FC
+INH		=	$FD
+OUTL		=	$FE
+OUTH		=	$FF
+
+; read any file slot 6 version
+; based on FASTLD6 and RTS copyright (c) Peter Ferrie 2011-2013,2018
+
+; modified to assemble with ca65 -- vmw
+; added code to patch it to run from current disk slot -- vmw
+
+
+        adrlo   =       $26     ; constant from boot prom
+        adrhi   =       $27     ; constant from boot prom
+        tmpsec  =       $3c     ; constant from boot prom
+        reqsec  =       $3d     ; constant from boot prom
+        sizelo  =       $44
+        sizehi  =       $45
+        secsize =       $46
+
+        ldsizel =       $70
+        ldsizeh =       $71
+        namlo   =       $7b
+        namhi   =       $7c
+        step    =       $7d     ; state for stepper motor
+        tmptrk  =       $7e     ; temporary copy of current track
+        phase   =       $7f     ; current phase for /seek
+
diff --git a/games/keen/zx02_optim.s b/games/keen/zx02_optim.s
new file mode 100644
index 00000000..8b88caf8
--- /dev/null
+++ b/games/keen/zx02_optim.s
@@ -0,0 +1,163 @@
+; De-compressor for ZX02 files
+; ----------------------------
+;
+; Decompress ZX02 data (6502 optimized format), optimized for speed and size
+;  138 bytes code, 58.0 cycles/byte in test file.
+;
+; Compress with:
+;    zx02 input.bin output.zx0
+;
+; (c) 2022 DMSC
+; Code under MIT license, see LICENSE file.
+
+
+;ZP=$80
+
+;offset          = ZP+0
+;ZX0_src         = ZP+2
+;ZX0_dst         = ZP+4
+;bitr            = ZP+6
+;pntr            = ZP+7
+
+            ; Initial values for offset, source, destination and bitr
+;zx0_ini_block:
+;            .byte $00, $00	; offset
+;comp_data:
+;		.byte $0, $0	; zx0_src
+;out_addr:
+;		.byte $0, $0	; zx0_dst
+;		.byte $80	; bitr
+
+;--------------------------------------------------
+; Decompress ZX0 data (6502 optimized format)
+
+	; destination page in A
+full_decomp:
+		sta	ZX0_dst+1
+
+		ldy	#$80
+		sty	bitr
+
+		ldy	#0		; always on page boundary
+		sty	ZX0_dst
+
+		sty	offset
+		sty	offset+1
+
+		; Y needs to be 0 here
+
+              ; Get initialization block
+;              ldy #7
+
+;copy_init:     lda zx0_ini_block-1, y
+ ;             sta offset-1, y
+  ;            dey
+   ;           bne copy_init
+
+; Decode literal: Ccopy next N bytes from compressed file
+;    Elias(length)  byte[1]  byte[2]  ...  byte[N]
+decode_literal:
+              jsr   get_elias
+
+cop0:         lda   (ZX0_src), y
+              inc   ZX0_src
+              bne   plus1
+              inc   ZX0_src+1
+plus1:             sta   (ZX0_dst),y
+              inc   ZX0_dst
+              bne   plus2
+              inc   ZX0_dst+1
+plus2:             dex
+              bne   cop0
+
+              asl   bitr
+              bcs   dzx0s_new_offset
+
+; Copy from last offset (repeat N bytes from last offset)
+;    Elias(length)
+              jsr   get_elias
+dzx0s_copy:
+              lda   ZX0_dst
+              sbc   offset  ; C=0 from get_elias
+              sta   pntr
+              lda   ZX0_dst+1
+              sbc   offset+1
+              sta   pntr+1
+
+cop1:
+              lda   (pntr), y
+              inc   pntr
+              bne   plus3
+              inc   pntr+1
+plus3:             sta   (ZX0_dst),y
+              inc   ZX0_dst
+              bne   plus4
+              inc   ZX0_dst+1
+plus4:             dex
+              bne   cop1
+
+              asl   bitr
+              bcc   decode_literal
+
+; Copy from new offset (repeat N bytes from new offset)
+;    Elias(MSB(offset))  LSB(offset)  Elias(length-1)
+dzx0s_new_offset:
+              ; Read elias code for high part of offset
+              jsr   get_elias
+              beq   exit  ; Read a 0, signals the end
+              ; Decrease and divide by 2
+              dex
+              txa
+              lsr   ; @
+              sta   offset+1
+
+              ; Get low part of offset, a literal 7 bits
+              lda   (ZX0_src), y
+              inc   ZX0_src
+              bne   plus5
+              inc   ZX0_src+1
+plus5:
+              ; Divide by 2
+              ror   ; @
+              sta   offset
+
+              ; And get the copy length.
+              ; Start elias reading with the bit already in carry:
+              ldx   #1
+              jsr   elias_skip1
+
+              inx
+              bcc   dzx0s_copy
+
+; Read an elias-gamma interlaced code.
+; ------------------------------------
+get_elias:
+              ; Initialize return value to #1
+              ldx   #1
+              bne   elias_start
+
+elias_get:    ; Read next data bit to result
+              asl   bitr
+              rol   ; @
+              tax
+
+elias_start:
+              ; Get one bit
+              asl   bitr
+              bne   elias_skip1
+
+              ; Read new bit from stream
+              lda   (ZX0_src), y
+              inc   ZX0_src
+              bne   plus6
+              inc   ZX0_src+1
+plus6:             ;sec   ; not needed, C=1 guaranteed from last bit
+              rol   ;@
+              sta   bitr
+
+elias_skip1:
+              txa
+              bcs   elias_get
+              ; Got ending bit, stop reading
+exit:
+              rts
diff --git a/games/sb/rat_graphics/Makefile b/games/sb/rat_graphics/Makefile
index 6b71962b..ab2e0774 100644
--- a/games/sb/rat_graphics/Makefile
+++ b/games/sb/rat_graphics/Makefile
@@ -96,5 +96,5 @@ a2_fortnight_rat2.hgr:	a2_fortnight_rat2.png
 ####
 
 clean:
-	rm -f *~ *.o *.lst disk_sprintes.inc *.zx02 *.hgr
+	rm -f *~ *.o *.lst disk_sprites.inc *.zx02 *.hgr
 
diff --git a/graphics/gr/bubble_universe/Makefile b/graphics/gr/bubble_universe/Makefile
new file mode 100644
index 00000000..6b0ef91d
--- /dev/null
+++ b/graphics/gr/bubble_universe/Makefile
@@ -0,0 +1,32 @@
+include ../../../Makefile.inc
+
+DOS33 = ../../../utils/dos33fs-utils/dos33
+TOKENIZE = ../../../utils/asoft_basic-utils/tokenize_asoft
+LINKER_SCRIPTS = ../../../linker_scripts
+EMPTY_DISK = ../../../empty_disk
+
+all:	bubble_gr.dsk
+
+bubble_gr.dsk:	HELLO BUBBLE_GR
+	cp $(EMPTY_DISK)/empty.dsk bubble_gr.dsk
+	$(DOS33) -y bubble_gr.dsk SAVE A HELLO
+	$(DOS33) -y bubble_gr.dsk BSAVE -a 0x2000 BUBBLE_GR
+
+###
+
+HELLO:	hello.bas
+	$(TOKENIZE) < hello.bas > HELLO
+
+###
+
+BUBBLE_GR:	bubble_gr.o
+	ld65 -o BUBBLE_GR bubble_gr.o -C $(LINKER_SCRIPTS)/apple2_2000.inc
+
+bubble_gr.o:	bubble_gr.s
+	ca65 -o bubble_gr.o bubble_gr.s -l bubble_gr.lst
+
+###
+
+clean:	
+	rm -f *~ *.o *.lst HELLO BUBBLE_GR
+
diff --git a/graphics/gr/bubble_universe/bubble_gr.s b/graphics/gr/bubble_universe/bubble_gr.s
new file mode 100644
index 00000000..046a05c8
--- /dev/null
+++ b/graphics/gr/bubble_universe/bubble_gr.s
@@ -0,0 +1,304 @@
+; bubble universe -- Apple II Hires
+
+; size optimized version, using ROM (slower)
+
+; by Vince `deater` Weaver
+
+; this version based on fast c64 code by serato_fig
+;	as posted to the sizecoding discord
+;	based on his TIC-80 variant
+
+; originally was working off the BASIC code posted on the pouet forum
+; original effect by yuruyrau on twitter
+
+;  534 bytes -- tiny version
+;  250 bytes -- strip out fast clear and hplot code and use ROM
+
+; 76d03 cycles = 486659 cycles = 2fps
+
+; soft-switches
+
+KEYPRESS	= $C000
+KEYRESET	= $C010
+PAGE1		= $C054
+PAGE2		= $C055
+
+; ROM routines
+
+BKGND0		= $F3F4         ; clear current page to A
+HGR2		= $F3D8		; set hires page2 and clear $4000-$5fff
+HGR		= $F3E2		; set hires page1 and clear $2000-$3fff
+HPLOT0		= $F457		; plot at (Y,X), (A)
+HCOLOR1	= $F6F0		; set HGR_COLOR to value in X
+;COLORTBL	= $F6F6
+;WAIT		= $FCA8		; delay 1/2(26+27A+5A^2) us
+
+; zero page
+
+GBASL		= $26
+GBASH		= $27
+
+
+HPLOTYL		= $92
+
+I		= $D0
+J		= $D1
+T		= $D7
+U		= $D8
+V		= $D9
+
+HGR_PAGE	= $E6
+
+INL		= $FC
+INH		= $FD
+OUTL		= $FE
+OUTH		= $FF
+
+; const
+
+;NUM		= 32
+;NUM		= 24
+
+bubble:
+
+	;========================
+	; setup lookup tables
+
+;	jsr	hgr_make_tables
+
+;	jsr	hgr_clear_codegen
+
+	jsr	setup_sine_table
+
+	;=======================
+	; init graphics
+
+	jsr	HGR
+	jsr	HGR2
+
+	;=======================
+	; init variables
+
+	; HGR leaves A at 0
+
+;	lda	#0
+	sta	U
+	sta	V
+	sta	T
+
+	ldx	#7
+	jsr	HCOLOR1
+
+	;=========================
+	;=========================
+	; main loop
+	;=========================
+	;=========================
+
+next_frame:
+
+	; reset I*T
+
+	lda	T
+	sta	it1_smc+1
+	sta	it2_smc+1
+
+	; reset I*S
+
+	lda	#0
+	sta	is1_smc+1
+	sta	is2_smc+1
+
+num1_smc:
+	lda	#24	; 40
+	sta	I
+
+i_loop:
+num2_smc:
+	lda	#24	; 200
+
+	sta	J
+j_loop:
+	ldx	U
+	ldy	V
+
+
+	; where S=41 (approximately 1/6.28)
+
+	clc			; 2
+
+
+
+	; calc:	b=i+t+u;
+	; 	u=cosines[a]+cosines[b];
+is2_smc:
+	lda	cosines,Y	; 4+
+it2_smc:
+	adc	cosines,X	; 4+
+	sta	V
+
+	; calc:	a=i*s+v;
+	; 	u=sines[a]+sines[b];
+is1_smc:
+	lda	sines,Y		; 4+
+it1_smc:
+	adc	sines,X		; 4+
+	sta	U		; 3
+
+	;===========================================================
+	; HPLOT U+44,V+96
+	;	U is centered at 96, to get to center of 280 screen add 44
+
+	; U already in A
+
+	adc	#44							; 2
+	tax								; 2
+
+	; calculate Ypos
+	lda	V
+
+;HPLOT0		= $F457		; plot at (Y,X), (A)
+
+	ldy	#0
+
+	jsr	HPLOT0
+
+
+	dec	J
+	bne	j_loop
+
+done_j:
+
+	lda	is1_smc+1
+	clc
+	adc	#41		; 1/6.28 = 0.16 =  0 0    1   0       1 0 0 0 = 0x28
+	sta	is1_smc+1
+	sta	is2_smc+1
+	dec	I
+	bne	i_loop
+done_i:
+
+;	sty	V
+	inc	T
+
+end:
+
+.if 0
+	lda	KEYPRESS
+	bpl	flip_pages
+	bit	KEYRESET
+				; 0110 -> 0100
+	and	#$5f		; to handle lowercase too...
+
+	cmp	#'A'
+	bne	check_z
+	inc	num1_smc+1
+	jmp	done_keys
+check_z:
+	cmp	#'Z'
+	bne	check_j
+	dec	num1_smc+1
+	jmp	done_keys
+check_j:
+	cmp	#'J'
+	bne	check_m
+	inc	num2_smc+1
+	jmp	done_keys
+check_m:
+	cmp	#'M'
+	bne	done_keys
+	dec	num2_smc+1
+.endif
+done_keys:
+
+flip_pages:
+	; flip pages
+
+	; if $20 (draw PAGE1) draw PAGE2, SHOW page1
+	; if $40 (draw PAGE2) draw PAGE1, SHOW page2
+
+	lda	HGR_PAGE
+	eor	#$60
+	sta	HGR_PAGE
+
+	cmp	#$40
+	bne	flip2
+flip1:
+	bit	PAGE1
+	lda	#0
+	jsr	BKGND0
+;	jsr	hgr_page2_clearscreen
+	jmp	next_frame
+flip2:
+	bit	PAGE2
+	lda	#0
+	jsr	BKGND0
+;	jsr	hgr_page1_clearscreen
+	jmp	next_frame
+
+
+; floor(s*sin((x-96)*PI*2/256.0)+48.5);
+
+; note: min=7, around 32
+;       max=89 ($59), around 160
+;	subtract 7, so 0...82?  halfway = 41 = $29 + 7 = $30
+;       halfway= 6*16 = 96
+
+sines	= $6c00
+sines2	= $6d00
+cosines = $6e00
+cosines2= $6f00
+
+	;===================================
+	;
+	;
+	; final_sine[i]=quarter_sine[i];          // 0..64
+	; final_sine[128-i]=quarter_sine[i];      // 64..128
+	; final_sine[128+i]=0x60-quarter_sine[i]; // 128..192
+	; final_sine[256-i]=0x60-quarter_sine[i]; // 192..256
+
+setup_sine_table:
+
+	ldy	#64
+	ldx	#64
+setup_sine_loop:
+
+	lda	sines_base,Y
+	sta	sines,Y
+	sta	sines2,Y
+	sta	sines,X
+	sta	sines2,X
+
+	lda	#$60
+	sec
+	sbc	sines_base,Y
+
+	sta	sines+128,Y
+	sta	sines2+128,Y
+	sta	sines+128,X
+	sta	sines2+128,X
+
+	inx
+	dey
+	bpl	setup_sine_loop
+
+
+	ldy	#0
+cosine_loop:
+	lda	sines+192,Y
+	sta	cosines,Y
+	sta	cosines2,Y
+	iny
+	bne	cosine_loop
+
+	rts
+
+sines_base:
+	.byte $30,$31,$32,$33,$34,$35,$36,$37,$38,$39,$3A,$3B,$3C,$3D,$3E,$3F
+	.byte $40,$41,$42,$42,$43,$44,$45,$46,$47,$48,$48,$49,$4A,$4B,$4C,$4C
+	.byte $4D,$4E,$4E,$4F,$50,$50,$51,$52,$52,$53,$53,$54,$54,$55,$55,$55
+	.byte $56,$56,$57,$57,$57,$58,$58,$58,$58,$58,$59,$59,$59,$59,$59,$59
+	.byte $59
+
+; floor(s*cos((x-96)*PI*2/256.0)+48.5);
+
diff --git a/graphics/gr/bubble_universe/hello.bas b/graphics/gr/bubble_universe/hello.bas
new file mode 100644
index 00000000..af786417
--- /dev/null
+++ b/graphics/gr/bubble_universe/hello.bas
@@ -0,0 +1,13 @@
+5 HOME
+10 PRINT "      BUBBLE GR"
+15 PRINT "  BY DEATER / FAST CODE BY SERATO_FIG"
+20 PRINT
+25 PRINT "THIS VERSION YOU CAN CHANGE"
+27 PRINT "PARAMETERS ON THE FLY"
+28 PRINT "+ TRY PRESSING A/Z TO INC/DEC I"
+29 PRINT "+ TRY PRESSING J/M TO INC/DEC J"
+30 PRINT:PRINT "PRESS ANY KEY TO START"
+40 GET A$
+50 IF A$="Q" THEN END
+60 PRINT:PRINT CHR$(4)"BRUN BUBBLE_GR"
+