#!/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()