chore: version Zelda 1 port and engineering records
This commit is contained in:
@@ -0,0 +1,117 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Compare the complete first-sword playthrough to ROM-derived render states."""
|
||||
import json
|
||||
import re
|
||||
from PIL import Image, ImageChops
|
||||
from extract_graphics import ROOT, ROM_SHA256
|
||||
|
||||
# name, room variant (OW/full cave/person/fires), x, y, direction, phase,
|
||||
# owned sword, action, doorway step
|
||||
CHECKPOINTS=[
|
||||
('initial',0,120,133,'down',0,False,'walk',-1),
|
||||
('unarmed_a',0,120,133,'down',0,False,'walk',-1),
|
||||
('release_initial',0,120,133,'down',0,False,'walk',-1),
|
||||
('approach_left',0,65,133,'left',1,False,'walk',-1),
|
||||
('door_ready',0,64,77,'up',0,False,'walk',-1),
|
||||
('cave_ready',1,112,173,'up',1,False,'walk',-1),
|
||||
('cave_unarmed_a',1,112,173,'up',1,False,'walk',-1),
|
||||
('cave_release',1,112,173,'up',1,False,'walk',-1),
|
||||
('align_sword',1,120,173,'right',0,False,'walk',-1),
|
||||
('outside_pickup',1,120,158,'up',0,False,'walk',-1),
|
||||
('pickup_first',2,120,157,'up',0,True,'lift',-1),
|
||||
('lift_input_lock',2,120,157,'up',0,True,'lift',-1),
|
||||
('lift_tick127',3,120,157,'up',0,True,'lift',-1),
|
||||
('lift_tick128',3,120,157,'up',0,True,'walk',-1),
|
||||
('held_a_after_lift',3,120,157,'up',0,True,'walk',-1),
|
||||
('release_lift',3,120,157,'up',0,True,'walk',-1),
|
||||
('armed_attack',3,120,157,'up',0,True,'attack',-1),
|
||||
('attack_recovered',3,120,157,'up',1,True,'walk',-1),
|
||||
('exit_ready',0,64,93,'down',0,True,'walk',16),
|
||||
('exit_start',0,64,92,'down',0,True,'walk',15),
|
||||
('overworld_owned',0,64,77,'down',0,True,'walk',-1),
|
||||
('walk_away',0,64,85,'down',1,True,'walk',-1),
|
||||
('return_door',0,64,77,'up',0,True,'walk',0),
|
||||
('cave_revisited',3,112,173,'up',1,True,'walk',-1),
|
||||
('realign',3,120,173,'right',0,True,'walk',-1),
|
||||
('no_second_pickup',3,120,157,'up',0,True,'walk',-1),
|
||||
('new_game',0,120,133,'down',0,False,'walk',-1),
|
||||
('new_game_cave',1,112,173,'up',1,False,'walk',-1),
|
||||
]
|
||||
|
||||
|
||||
def validate_grade_leaf(prg):
|
||||
# Execute HandleClass2 for Y=0 (sword), including its real branch to RTS.
|
||||
entry=prg.index(bytes.fromhex('a50ad957069020995706c00bd019'))
|
||||
results=[]
|
||||
for current in range(4):
|
||||
for grade in (1,2,3):
|
||||
pc,a,value,carry,zero=entry,0,current,False,False
|
||||
for _ in range(16):
|
||||
op=prg[pc];pc+=1
|
||||
if op==0x60: break
|
||||
if op==0xA5:
|
||||
assert prg[pc]==10;pc+=1;a=grade
|
||||
elif op==0xD9:
|
||||
assert prg[pc:pc+2]==bytes.fromhex('5706');pc+=2
|
||||
carry,zero=a>=value,a==value
|
||||
elif op==0x99:
|
||||
assert prg[pc:pc+2]==bytes.fromhex('5706');pc+=2;value=a
|
||||
elif op==0xC0:
|
||||
rhs=prg[pc];pc+=1;carry,zero=0>=rhs,0==rhs
|
||||
elif op in (0x90,0xD0):
|
||||
offset=prg[pc];pc+=1
|
||||
if (op==0x90 and not carry) or (op==0xD0 and not zero):
|
||||
pc+=offset if offset<128 else offset-256
|
||||
else: raise AssertionError((hex(op),pc-1))
|
||||
else: raise AssertionError('HandleClass2 did not return')
|
||||
assert value==max(current,grade)
|
||||
results.append({'before':current,'taken_grade':grade,'after':value})
|
||||
return results
|
||||
|
||||
|
||||
def main():
|
||||
out=ROOT/'extracted/inventory';metadata=json.loads((out/'rom-data.json').read_text())
|
||||
assert metadata['rom_sha256']==ROM_SHA256
|
||||
prg=(ROOT/'.tmp/zelda-1.nes').read_bytes()[16:]
|
||||
grade_cases=validate_grade_leaf(prg)
|
||||
for key in ('item_slots','item_descriptors'):
|
||||
offset=metadata['prg_offsets'][key]
|
||||
assert list(prg[offset:offset+36])==metadata[key]
|
||||
assert metadata['item_slots'][1:4]==[0,0,0]
|
||||
assert metadata['item_descriptors'][1:4]==[0x21,0x22,0x23]
|
||||
assert metadata['new_game_items'][0]==0 and len(metadata['new_game_items'])==40
|
||||
generated=(ROOT/'src/inventory/items.generated.pbs').read_text()
|
||||
for name,values in [('item_slots',metadata['item_slots']),('item_descriptors',metadata['item_descriptors']),('new_game_items',metadata['new_game_items'])]:
|
||||
literal=re.search(name+r': array<int> = \[([^]]*)\]',generated).group(1)
|
||||
assert list(map(int,re.findall(r'\d+',literal)))==values
|
||||
backgrounds=[ROOT/'extracted/overworld/start/room.png',ROOT/'extracted/cave/start/room.png',
|
||||
ROOT/'extracted/cave/start/room_taken_person.png',ROOT/'extracted/cave/start/room_taken.png']
|
||||
backgrounds=[Image.open(p).convert('RGBA') for p in backgrounds]
|
||||
armed=Image.open(ROOT/'extracted/hud/hud.png').convert('RGBA')
|
||||
unarmed=Image.open(ROOT/'extracted/hud/hud_unarmed.png').convert('RGBA')
|
||||
template=Image.open(ROOT/'extracted/hud/runtime_initial.png').convert('RGBA')
|
||||
results=[]
|
||||
for name,room,x,y,direction,phase,owned,action,door in CHECKPOINTS:
|
||||
expected=template.copy();expected.paste(backgrounds[room],(112,15));expected.paste(armed if owned else unarmed,(112,15))
|
||||
def sprite(path,sx,sy):expected.alpha_composite(Image.open(ROOT/path).convert('RGBA'),(112+sx,15+sy))
|
||||
if action=='lift':
|
||||
sprite('assets/characters/link_pickup/lift_sword.png',x,y+1)
|
||||
sprite('assets/characters/link_pickup/wooden_sword.png',x,y-15)
|
||||
else:
|
||||
if action=='attack':sprite('assets/characters/link/sword_up.png',x-1,y-9)
|
||||
path=f'assets/characters/link/{action}_{direction}_{phase}.png'
|
||||
if door>=0:path=f'assets/characters/link_door/door_{door:02d}_{direction}_{phase}.png'
|
||||
sprite(path,x,y+3)
|
||||
actual=Image.open(out/f'validation/{name}.png').convert('RGBA')
|
||||
differences=sum(v!=(0,0,0,0) for v in ImageChops.difference(actual,expected).getdata())
|
||||
result={'checkpoint':name,'room_variant':room,'x':x,'y':y,'direction':direction,'phase':phase,
|
||||
'sword_level':1 if owned else 0,'action':action,'different_pixels':differences}
|
||||
assert differences==0,result
|
||||
results.append(result)
|
||||
report={'rom_sha256':ROM_SHA256,'rom_tables_verified':True,'items_slots':40,'room_item_mask':16,
|
||||
'captures_compared':len(results),'equipment_grade_rom_cases':grade_cases,'checkpoints':results,
|
||||
'scope':'Live guest path: unarmed inputs, exact pickup threshold, lift at ticks 1/127/128, input lock, held-A edge, armed attack, room-flag persistence on reentry. Inventory tables/defaults checked against ROM; other item effects and full NES execution excluded.'}
|
||||
(out/'validation/results.json').write_text(json.dumps(report,indent=2)+'\n')
|
||||
print(json.dumps({'captures_compared':len(results),'different_pixels':0,'rom_tables_verified':True,'equipment_grade_rom_cases':len(grade_cases)}))
|
||||
|
||||
if __name__=='__main__':main()
|
||||
Reference in New Issue
Block a user