Files
zelda-1-prometeu-port/tools/validate_combat_captures.py

82 lines
5.7 KiB
Python

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