#!/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 = \[([^]]*)\]',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()