chore: version Zelda 1 port and engineering records

This commit is contained in:
Nilton Constantino
2026-11-16 15:22:13 +00:00
commit 6f2fa420c2
4282 changed files with 822198 additions and 0 deletions
+90
View File
@@ -0,0 +1,90 @@
#!/usr/bin/env python3
"""Check the cave's terrain probes against original 6502 and saved Studio frames."""
import json
import re
from PIL import Image, ImageChops
import validate_collision_rom as collision
from extract_graphics import ROOT
OUT = ROOT / 'extracted/cave/start'
# One continuous Studio session, starting with no input and a fresh build.
# Explicit checkpoints come from the ROM doorway/spawn coordinates and movement.
CHECKPOINTS = [
('initial',1,{},0,120,133,'down',0,-1),
('approach_left',40,{'left':True},0,65,133,'left',1,-1),
('door_ready',43,{'up':True},0,64,77,'up',0,-1),
('door_start',1,{},0,64,77,'up',0,0),
('door_middle',32,{},0,64,85,'up',1,8),
('cave_spawn',31,{},1,112,221,'up',0,-1),
('cave_walk_done',32,{},1,112,173,'up',1,-1),
('cave_idle',12,{},1,112,173,'up',1,-1),
('cave_left_wall',200,{'left':True},1,32,173,'left',1,-1),
('cave_right_wall',200,{'right':True},1,208,173,'right',0,-1),
('cave_center',72,{'left':True},1,111,173,'left',0,-1),
('cave_exit_ready',36,{'down':True},1,112,221,'down',0,-1),
('exit_start',1,{'down':True},0,64,93,'down',0,16),
('exit_middle',32,{},0,64,85,'down',1,8),
('exit_done',32,{},0,64,77,'down',1,-1),
('exit_idle',24,{},0,64,77,'down',1,-1),
('walk_away',6,{'down':True},0,64,85,'down',0,-1),
('return_to_door',6,{'up':True},0,64,77,'up',0,0),
('reenter_start',1,{},0,64,77,'up',0,0),
('cave_again',96,{},1,112,173,'up',1,-1),
]
def validate_probes():
room=json.loads((OUT/'room.json').read_text())
tiles=[t for row in room['tilemap'][8:] for t in row]
generated=(ROOT/'src/stages/cave_start/room.generated.pbs').read_text()
literal=generated.split('= [',1)[1].split('];',1)[0]
assert [int(v) for v in re.findall(r'\d+',literal)]==tiles
# Reuse the bounded original CPU routine, supplying this cave's column RAM.
collision.DATA['tiles']=tiles
for col in range(32):
ptr=collision.BASE[0xE400+col*2] | collision.BASE[0xE401+col*2]<<8
for row in range(22):collision.BASE[ptr+row]=tiles[row*32+col]
checked=0
for x in range(0,241,8):
for y in range(61,222,8):
for direction in (1,2,4,8):
if y==61 and direction==8:continue
expected=collision.rom_probe(x,y,direction)
actual=collision.port_probe(x,y,direction)
assert actual==expected,(x,y,direction,actual,expected)
checked+=1
return checked
def validate_frames():
hud=Image.open(ROOT/'extracted/hud/hud.png').convert('RGBA')
backgrounds=[Image.open(ROOT/'extracted/overworld/start/room.png').convert('RGBA'),
Image.open(OUT/'room.png').convert('RGBA')]
template=Image.open(ROOT/'extracted/hud/runtime_initial.png').convert('RGBA')
results=[]
for name,frames,buttons,stage,x,y,direction,phase,door in CHECKPOINTS:
expected=template.copy();expected.paste(backgrounds[stage],(112,15));expected.paste(hud,(112,15))
path=ROOT/f'assets/characters/link/walk_{direction}_{phase}.png'
if door>=0:path=ROOT/f'assets/characters/link_door/door_{door:02d}_{direction}_{phase}.png'
expected.alpha_composite(Image.open(path).convert('RGBA'),(112+x,15+y+3))
actual=Image.open(OUT/f'validation/{name}.png').convert('RGBA')
different=sum(p!=(0,0,0,0) for p in ImageChops.difference(actual,expected).getdata())
result={'checkpoint':name,'frames':frames,'input':buttons,'stage':stage,'x':x,'y':y,
'direction':direction,'animation_phase':phase,'door_step':door,'different_pixels':different}
results.append(result)
if different:
expected.save(OUT/f'validation/{name}.expected.png')
raise AssertionError(result)
return results
def main():
checked=validate_probes()
frames=validate_frames()
report={'rom_sha256':collision.ROM_SHA256,'cave_probes_compared':checked,'probe_mismatches':0,
'runtime_frames_compared':len(frames),'checkpoints':frames,
'scope':'Original collision leaf routine with cave column RAM; full-frame checkpoints of entry, cave walls, exit, idle without reentry and a second visit. Excludes full-game NES execution, video-copy waits and cave object interactions.'}
(OUT/'validation/results.json').write_text(json.dumps(report,indent=2)+'\n')
print(json.dumps({'cave_probes_compared':checked,'runtime_frames_compared':len(frames),'different_pixels':0}))
if __name__=='__main__':main()