BETTY HEARTBEAT 64 V2.6 + GAME V4.2
=================================

A fan-made Commodore 64 demoscene-style Betty tribute.

WHAT IS NEW IN V2
-----------------
- Completely redrawn Betty portrait using ALL 8 C64 hardware sprites as a 4x2 multicolor mosaic
- 96x84 physical-pixel portrait area (48x42 logical multicolor artwork)
- Large eyes, 1930s curls, red lips, earrings, red sweetheart dress
- Separate blink animation frame for the upper four sprites
- 28-second demo presentation followed by automatic start of Heartbreak Hotel V4.2
- Intro -> Betty reveal -> Henrik greeting -> finale -> GAME
- Smooth bottom scroller with a 16-bit message pointer
- Raster color bars (background only, border stays black)
- Twinkling star field
- Even stronger Betty floating/bobbing with larger vertical movement and wider side sway
- Original three-voice SID-style demo music with pulse modulation
- SPACE skips the demo via direct C64 keyboard-matrix reading
- Old-school flickering moving rainbow transition before the game
- Heartbreak Hotel V4.2 is embedded/compressed in RAM: no second disk load
- Revised game SID music: slower tempo, lower lead, softer envelopes and more rests

HOW TO RUN
----------
Fastest test in VICE: drag BETTY_HEARTBEAT64_V2_6_GAME_V4_2.PRG into VICE and autostart it.

Combined disk image:
  LOAD"BETTYDEMO",8,1
  RUN

After the demo, the embedded V4.2 image is unpacked directly from RAM and starts at $0810.
Press SPACE at any point during the demo to jump to the rainbow transition immediately.
The PRG is now self-contained; the second BETTYV42 file on D64 is kept as a direct-start backup.

The BASIC stub runs SYS 4096. Machine code starts at $1000.
Sprite data starts at $3000 (VIC sprite pointers $C0-$CB).

IMPORTANT IRQ FIX
-----------------
This version uses the normal KERNAL IRQ vector at $0314/$0315 and exits via JMP $EA81.
The KERNAL has already saved A/X/Y before dispatching through $0314, so the custom handler does not push them again.
This avoids the stack corruption that caused the first version to flash briefly and return to READY.

FILES
-----
BETTY_HEARTBEAT64_V2_6_GAME_V4_2.PRG            ready-to-run program
BETTY_HEARTBEAT64_V2_6_GAME_V4_2.d64            combined disk image: demo + Heartbreak Hotel V4.2
BETTY_HEARTBEAT64_V2_6_GAME_V4_2.asm            generated ACME-style 6510 listing
BETTY_HEARTBEAT64_V2_6_GAME_V4_2_BETTY_PREVIEW.png enlarged preview of the actual multicolor sprite artwork
make_betty_v2.py      reproducible build script

CREDITS
-------
Idea: Henrik Mak
Code/design: ChatGPT 5.6 Sol

The game component is Heartbreak Hotel V4.2 from the user's earlier Betty Boop game project.
Fan-made, noncommercial demo/game package.
