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
+83
View File
@@ -0,0 +1,83 @@
#!/usr/bin/env python3
"""Check the northern room and non-player probes against the ROM's 6502 leaf."""
import json,re
from extract_graphics import decode
from extract_start_room import RGB
from validate_life_captures import canvas,body
from PIL import Image,ImageChops
from extract_graphics import ROOT
import validate_collision_rom as leaf
from nes_object_graphics import descriptor,octorok
from validate_octorok_graphics import native_image
def verify_captures():
p=(ROOT/'.tmp/zelda-1.nes').read_bytes()[16:];patterns=bytearray(4096)
patterns[:1792]=p[32895:34687];patterns[1792:4096]=p[19892:22196];patterns[2272:4096]=p[53595:55419]
rgb=dict(RGB);rgb.update({2:(0,0,188),34:(104,136,252),41:(56,184,0),12:(0,64,88),28:(0,136,136),44:(88,248,216)})
rows=[list(p[103187+i*4:103191+i*4]) for i in range(4)]
def column(t,pal,flip=False):
im=Image.new('RGBA',(8,16));im.putdata([(0,0,0,0) if v==0 else (*rgb[rows[pal][v]],255) for n in (t,t+1) for v in decode(patterns[n*16:(n+1)*16])]);return im.transpose(Image.Transpose.FLIP_LEFT_RIGHT) if flip else im
frames=[]
for phase in range(2):
for direction in ('left','up','down','right'):
frames.append((f'{direction}_{phase}',native_image(octorok(direction,phase))))
for i,t in enumerate((112,114,116)):
im=Image.new('RGBA',(16,16));im.paste(column(t,1),(0,0));im.paste(column(t,1,True),(8,0));frames.append((f'cloud_{i}',im))
frames.append(('rock',native_image(descriptor(0x53))))
checks=[]
for name in ('fixed_cloud_visible','fixed_north_actors','fixed_encounter_4'):
actual=Image.open(ROOT/f'extracted/overworld/north/validation/{name}.png').convert('RGBA');a=actual.crop((112,79,368,255)).convert('RGB');ap=a.load();found={}
for label,im in frames:
support=[(x,y,c[:3]) for y in range(16) for x in range(16) if (c:=im.getpixel((x,y)))[3]]
assert support,label
x0,y0,c0=support[0]
for y in range(161):
for x in range(241):
if ap[x+x0,y+y0]==c0 and all(ap[x+dx,y+dy]==color for dx,dy,color in support):found[(x,y+64)]=(label,im)
actors=[k for k,v in found.items() if v[0]!='rock'];assert len(actors)==4,(name,len(actors))
expected=canvas(ROOT/'extracted/overworld/north/room.png',34,255,False,False)
expected.paste(Image.open(ROOT/'assets/ui/hud/hud-north-marker.png').convert('RGBA'),(144,47))
body(expected,'up',0,120,224,0)
for (x,y),(label,im) in found.items():expected.alpha_composite(im,(112+x,15+y))
diff=sum(v!=(0,0,0,0) for v in ImageChops.difference(actual,expected).getdata());assert diff==0,(name,diff)
checks.append({'capture':name,'native_sprites':[{ 'x':x,'y':y,'frame':v[0]} for (x,y),v in found.items()],'different_pixels':diff})
return checks
def main():
room=json.loads((ROOT/'extracted/overworld/north/room.json').read_text())
tiles=[t for row in room['tilemap'][8:] for t in row]
leaf.DATA=dict(leaf.DATA,tiles=tiles,room_id=103)
for col in range(32):
addr=leaf.BASE[0xe400+col*2]|leaf.BASE[0xe401+col*2]<<8
for row in range(22):leaf.BASE[addr+row]=tiles[row*32+col]
source=(ROOT/'src/stages/overworld_north/room.generated.pbs').read_text()
assert list(map(int,re.findall(r'\d+',source.split('= [',1)[1].split('];',1)[0])))==tiles
def model(x,y,d,monster):
offset={1:16,2:-16 if monster else -8,4:8,8:-16 if monster else -8}[d]
sx=x;sy=(y+11)%256
if d in (4,8):
if d==8 or sy<221:sy=(sy+offset)%256
elif (d==1 and x<240) or (d==2 and x>=16):sx=(sx+offset)%256
col=sx//8;row=((sy-64)%256)//8
def tile(c,r):return tiles[r*32+c] if 0<=c<32 and 0<=r<22 else 255
value=tile(col,row)
if d in (4,8):value=max(value,tile(col+1,row))
return 38 if value in leaf.DATA['walkable_exceptions'] else value
counts={}
for slot in (0,1):
checked=0
for x in range(16,225,8):
for y in range(77,206,8):
for d in (1,2,4,8):
a=leaf.rom_probe(x,y,d,slot,103);b=model(x,y,d,slot!=0)
assert a==b,(slot,x,y,d,a,b);checked+=1
counts['player' if slot==0 else 'enemy']=checked
enemies=json.loads((ROOT/'extracted/overworld/north/enemies.json').read_text())
assert room['room_attributes']==[0x72,0x86,0x47,0x62,0x64,0x40]
assert enemies['type']==7 and enemies['count']==4
fixture=Image.open(ROOT/'extracted/overworld/north/validation/fixture.png').convert('RGB')
for i in range(32):assert fixture.getpixel((i%16*16+5,i//16*16+5))==(0,255,0),i+1
visual=verify_captures()
report={'visual_comparisons':visual,'room_id':103,'collision_probes':counts,'mismatches':0,'guest_assertions':32,'scope':'Leaf collision routine, raw room data and saved guest fixture; not full-game lockstep equivalence.'}
(ROOT/'extracted/overworld/north/validation/results.json').write_text(json.dumps(report,indent=2)+'\n');print(json.dumps(report))
if __name__=='__main__':main()