#!/usr/bin/env python3 """Check Studio assertion output and visible combat states against ROM patterns.""" import json from PIL import Image,ImageChops from extract_graphics import ROOT,decode from extract_start_room import RGB from nes_object_graphics import P,item,descriptor,octorok OUT=ROOT/'extracted/combat/validation' 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)}) PPU=bytearray(8192) for offset,length,address in [(32895,1792,0),(19892,2304,1792),(53595,1824,2272),(34687,1792,4096),(51515,2080,5888),(36479,224,7968)]:PPU[address:address+length]=P[offset:offset+length] ROWS=[list(P[103171+i*4:103175+i*4]) for i in range(8)] def blank(): im=Image.open(ROOT/'extracted/hud/runtime_initial.png').convert('RGBA');im.paste(Image.open(ROOT/'extracted/overworld/north/room.png').convert('RGBA'),(112,15));return im def sprite(info): im=Image.new('RGBA',(16,16));offset=4 if info['sides']==1 else 0 for side in range(info['sides']): t=info['tiles'][side];attr=info['attributes'][side];pal=ROWS[4+(attr&3)];start=(t&1)*4096+(t&254)*16 col=Image.new('RGBA',(8,16));col.putdata([(0,0,0,0) if v==0 else (*RGB[pal[v]],255) for n in (start,start+16) for v in decode(PPU[n:n+16])]) if attr&64:col=col.transpose(Image.Transpose.FLIP_LEFT_RIGHT) if attr&128:col=col.transpose(Image.Transpose.FLIP_TOP_BOTTOM) im.paste(col,(offset+side*info['x_separation'],0)) return im def place(im,slot,frame,palette,x,y,flip_x=False,flip_y=False): info=item(slot,frame,palette+(128 if flip_y else 0),flip_x);im.alpha_composite(sprite(info),(112+x,16+y)) def counter(im,value,x,y): # FormatDecimalCountByte: native HUD triplets, including leading X and space. codes=[value//100,value//10%10,value%10] if value>=100 else [33,value//10,value%10] if value>=10 else [33,value,36] for i,code in enumerate(codes): glyph=Image.new('RGBA',(8,8));glyph.putdata([(*RGB[ROWS[0][v]],255) for v in decode(PPU[4096+code*16:4096+(code+1)*16])]);im.paste(glyph,(112+x+i*8,15+y)) def compare(name,expected): actual=Image.open(OUT/(name+'.png')).convert('RGBA');diff=sum(v!=(0,0,0,0) for v in ImageChops.difference(actual,expected).getdata());assert diff==0,(name,diff);return {'capture':name,'different_pixels':diff} def beams(clock): im=blank() for direction,pal,x in [(8,0,24),(4,1,72),(2,2,120),(1,3,168)]:place(im,34,0 if direction in (4,8) else 1,pal,x,96+(3 if direction in (1,2) else 0),direction==2,direction==4) for x,y,radius,pal in [(80,160,6,0),(168,160,12,2)]: # Native spread corner attributes: 0, V, HV, H in drawing order. for right,bottom in [(False,False),(False,True),(True,True),(True,False)]: place(im,35,2,pal+(64 if right else 0),x+(radius if right else -radius),y+(radius if bottom else -radius),False,bottom) table=P.index(bytes.fromhex('01fffe02ffff'));width=[v if v<128 else v-256 for v in P[table:table+4]];height=[v if v<128 else v-256 for v in P[table+2:table+6]] for col in range(4): x=48+col*48+width[col]*clock;y=208+height[col]*clock im.alpha_composite(sprite(descriptor(0x53)),(112+x,16+y)) return im def find_sprite(actual,template): a=actual.crop((112,79,368,255)).convert('RGBA');pixels=a.load() support=[(x,y,c) for y in range(16) for x in range(16) if (c:=template.getpixel((x,y)))[3]] x0,y0,color=support[0] return [(x,y+64) for y in range(161) for x in range(241) if pixels[x+x0,y+y0]==color and all(pixels[x+dx,y+dy]==c for dx,dy,c in support)] def verify_live(): evidence=[] for name,count in [('three_enemies_return',3),('third_enemy_down',1),('collect_heart',1),('room_cleared_confirm',0),('cleared_room_stays_empty',0)]: actual=Image.open(OUT/(name+'.png')).convert('RGBA');actors=set() for phase in range(2): for direction in ('left','up','down','right'):actors.update(find_sprite(actual,sprite(octorok(direction,phase)))) assert len(actors)==count,(name,actors,count) hearts=set();fairies=set() for palette in (1,2):hearts.update(find_sprite(actual,sprite(item(25,0,palette)))) for phase in (0,1):fairies.update(find_sprite(actual,sprite(item(20,phase,2)))) if name=='third_enemy_down':assert len(hearts)==1 if name=='collect_heart':assert not hearts if name=='room_cleared_confirm':assert len(fairies)==1 if name=='cleared_room_stays_empty':assert not hearts and not fairies evidence.append({'capture':name,'octoroks':len(actors),'hearts':len(hearts),'fairies':len(fairies)}) return evidence def main(): meta=json.loads((OUT/'fixture-metadata.json').read_text());a=Image.open(OUT/'fixture_assertions.png').convert('RGB');encoded=a.getpixel((475,268));count=encoded[0]*256+encoded[1];assert count==meta['top_level_assertions'],(count,meta) failures=[i+1 for i in range(count) if a.getpixel((i%160*3,i//160*3))!=(0,255,0)];assert not failures,failures;assert a.getpixel((478,268))==(0,255,0) im=blank() for slot,phase,palette,x,y in [(1,0,1,24,96),(28,0,1,64,96),(22,0,1,104,96),(22,0,2,144,96),(25,0,1,184,96),(25,0,2,24,144),(20,0,2,64,144),(20,1,2,104,144)]:place(im,slot,phase,palette,x,y) for value,x in [(0,24),(9,64),(23,104),(123,144),(255,184)]:counter(im,value,x,24) checks=[compare('fixture_items',im),compare('fixture_beams',beams(1)),compare('fixture_bounces_8',beams(8))] before=Image.open(ROOT/'extracted/game_flow/validation/new_game_ready.png').convert('RGBA');checks.append(compare('initial',before)) live=verify_live() report={'live_session':live,'guest_assertions':count,'failures':0,'visual_comparisons':checks,'scope':'Saved Studio fixture and production initial frame, composed using original item descriptor code, CHR, palettes and bounce table; no complete NES timing-equivalence claim.'};(OUT/'results.json').write_text(json.dumps(report,indent=2)+'\n');print(json.dumps(report)) if __name__=='__main__':main()