Files
zelda-1-prometeu-port/tools/validate_game_flow.py
T

69 lines
5.0 KiB
Python

#!/usr/bin/env python3
"""Compare Studio captures with ROM patterns/OAM and existing gameplay assets."""
import json
from PIL import Image,ImageChops,ImageDraw
from extract_graphics import ROOT,decode
from extract_start_room import RGB
from validate_life_captures import canvas,body
OUT=ROOT/'extracted/game_flow'
META=json.loads((OUT/'rom-data.json').read_text())
P=(ROOT/'.tmp/zelda-1.nes').read_bytes()[16:]
RGB=dict(RGB);RGB.update({16:(188,188,188),8:(80,48,0),40:(248,216,120),59:(160,252,224),34:(104,136,252),7:(136,20,0),12:(0,64,88),28:(0,136,136),44:(88,248,216),41:(56,184,0),38:(248,120,88),21:(164,0,164)})
patterns=bytearray(8192)
for offset,length,address in [(32895,1792,0),(34687,1792,4096),(36479,224,7968),(19892,2304,1792),(22196,2080,5888)]:patterns[address:address+length]=P[offset:offset+length]
def tile(n,row,base=4096,transparent=False):
im=Image.new('RGBA',(8,8));im.putdata([(0,0,0,0) if transparent and v==0 else (*RGB[row[v]],255) for v in decode(patterns[base+n*16:base+(n+1)*16])]);return im
def frame(im):
out=Image.open(ROOT/'extracted/hud/runtime_initial.png').convert('RGBA');out.paste(im,(112,15));return out
def title(clock):
memory=bytearray(16384);memory[8192:10240]=bytes([36])*2048;o=META['title']['prg_offset']
while P[o]<128:
a=P[o]*256+P[o+1];c=P[o+2];n=c&63 or 64;o+=3
for i in range(n):memory[a+i*(32 if c&128 else 1)]=P[o if c&64 else o+i]
o+=1 if c&64 else n
glow=timer=nxt=0;waves=[182,200,216]
for _ in range(clock):
if timer==0:
glow=nxt;nxt+=1;timer=6
if nxt==8:nxt=0;timer=16
timer-=1;waves=[178 if y+2>=227 else y+2 for y in waves]
rows=[list(r) for r in META['native_palettes']];rows[1][2]=META['glow_colors'][glow]
im=Image.new('RGBA',(256,240))
for y in range(30):
for x in range(32):
attr=memory[9152+(y//4)*8+x//4];pal=(attr>>(((y%4)//2)*4+((x%4)//2)*2))&3
im.paste(tile(memory[8192+y*32+x],rows[pal]),(x*8,y*8))
sprites=list(META['initial_oam'])
for y in waves:
offset=0 if y<185 else 8 if y<194 else 16
sprites.extend([y,t+offset,0,x] for t,x in zip((178,180,182,184),(80,88,96,104)))
sprites.extend([168,t+(clock//8%2)*8,0,x] for t,x in zip((162,164,166,168),(80,88,96,104)))
for y,t,a,x in reversed(sprites):
s=Image.new('RGBA',(8,16));s.paste(tile(t,rows[4+(a&3)],0,True),(0,0));s.paste(tile(t+1,rows[4+(a&3)],0,True),(0,8))
if a&64:s=s.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
if a&128:s=s.transpose(Image.Transpose.FLIP_TOP_BOTTOM)
im.alpha_composite(s,(x,y+1))
return frame(im)
def menu(selection=0,flash=False):
o=P.index(bytes.fromhex('3f00200f3000120f1627360f0c1c2c0f121c2c0f2927070f2227070f2627070f152730ff'))+3
rows=[list(P[o+i*4:o+i*4+4]) for i in range(8)];im=Image.new('RGBA',(256,240),(0,0,0,255))
for k,(word,address) in enumerate(zip(('CONTINUE','RETRY'),META['continue_label_addresses'])):
for i,c in enumerate(word):im.paste(tile(ord(c)-ord('A')+10,rows[1 if flash and selection==k else 0]),(((address-8192)%32+i)*8,(address-8192)//32*8))
im.alpha_composite(tile(242,rows[6],transparent=True),(80,40 if selection==0 else 72));return frame(im)
def game(owned=False,width=256,cave=False):
bg=ROOT/('extracted/cave/start/room_taken.png' if cave and owned else 'extracted/cave/start/room.png' if cave else 'extracted/overworld/start/room.png')
im=canvas(bg,34,255,owned,False);body(im,'up',1 if cave else 0,112 if cave else 120,176 if cave else 144,0)
if width<256:
n=(256-width)//2;d=ImageDraw.Draw(im);d.rectangle((112,79,112+n-1,254),fill=(0,0,0,255));d.rectangle((368-n,79,367,254),fill=(0,0,0,255))
return im
checks=[]
def check(name,expected):
actual=Image.open(OUT/f'validation/{name}.png').convert('RGBA');diff=sum(v!=(0,0,0,0) for v in ImageChops.difference(actual,expected).getdata());assert diff==0,(name,diff);checks.append({'capture':name,'different_pixels':diff})
for n in (6,7,8,13,25,31,43,58,59,64,512):check(f'title_{n}',title(n))
for name,n in [('title_first',1),('title_ignored_controls',542),('play_title',1),('return_title',0),('title_after_retry',1)]:check(name,title(n))
for name,s,f in [('continue_menu',0,False),('confirm_continue',0,False),('continue_flash',0,True),('continue_wait_last',0,False),('retry_menu',0,False),('select_retry',1,False),('hold_select',1,False),('confirm_retry',1,False),('retry_flash',1,True)]:check(name,menu(s,f))
for name,owned,width in [('unfurl_first',False,16),('unfurl_mid',False,128),('unfurl_ready',False,256),('new_game_curtain',False,16),('new_game_ready',False,256),('continue_curtain',True,16),('continue_ready',True,256),('retry_new_curtain',False,16),('retry_new_ready',False,256)]:check(name,game(owned,width))
for name,owned in [('cave_ready',False),('cave_owned_again',True),('new_game_cave',False)]:check(name,game(owned,cave=True))
(OUT/'validation/results.json').write_text(json.dumps({'pixel_comparisons':checks,'scope':'Saved Studio captures; independent ROM title/menu composition, gameplay composition from previously verified assets. No complete NES emulator equivalence claim.'},indent=2)+'\n')
print(f'{len(checks)} captures match pixel-for-pixel')