Files

138 lines
7.1 KiB
Python

#!/usr/bin/env python3
"""Compose Link's basic-shield body frames directly from verified NES patterns."""
import hashlib
import json
from pathlib import Path
from PIL import Image, ImageDraw
from extract_graphics import ROOT, ROM_SHA256, decode
BANK_UUID = "9bc59c58-4f6b-4b48-bffb-9dfc16ee44d8"
BANK_ROOT = "characters/link"
# RGB approximation for NES codes $29, $27, $17; NES codes are recorded too.
COLORS = [(0, 0, 0, 0), (56, 184, 0, 255), (252, 160, 68, 255), (172, 124, 0, 255)]
def write_json(path, value):
path.write_text(json.dumps(value, indent=2) + "\n")
def assemble():
rom = (ROOT / ".tmp/zelda-1.nes").read_bytes()
if hashlib.sha256(rom).hexdigest() != ROM_SHA256:
raise ValueError("Unverified ROM revision")
prg = rom[16:]
# These are the first eight frame descriptors of Link animation zero.
frames = bytes.fromhex("00 04 08 0c 10 10 14 18")
if prg.count(frames + bytes.fromhex("5c 9e 44 ce")) != 1:
raise ValueError("Link animation descriptor signature not found uniquely")
frame_offset = prg.index(frames + bytes.fromhex("5c 9e 44 ce"))
if prg[103168:103171] != bytes.fromhex("3f0020"):
raise ValueError("Level palette transfer record not found")
nes_palette = list(prg[103168 + 3 + 16:103168 + 3 + 20])
if nes_palette != [0x0F, 0x29, 0x27, 0x17]:
raise ValueError("Unexpected Link palette")
patterns = prg[32895:32895 + 1792]
bank = ROOT / "assets" / BANK_ROOT
bank.mkdir(parents=True, exist_ok=True)
asset_path = bank / "asset.json"
if asset_path.exists() and json.loads(asset_path.read_text())["asset_uuid"] != BANK_UUID:
raise ValueError("Refusing to replace an unrelated bank")
def column(tile, flip):
pixels = []
for index in (tile, tile + 1):
pixels.extend(decode(patterns[index * 16:(index + 1) * 16]))
image = Image.new("RGBA", (8, 16))
image.putdata([COLORS[n] for n in pixels])
return image.transpose(Image.Transpose.FLIP_LEFT_RIGHT) if flip else image
artifacts, provenance = [], []
clips = []
images = {}
for action in ("walk", "attack"):
for direction in ("down", "up", "left", "right"):
clip_frames = []
for phase in range(2):
frame = (phase if direction in ("left", "right") else 2 if direction == "down" else 3)
if action == "attack":
frame += 4
base = frames[frame]
flip = direction == "left" or (phase == 1 and direction in ("up", "down"))
tiles = [base + 2, base] if flip else [base, base + 2]
flips = [flip, flip]
# Reproduce Link_EndMoveAndAnimate's basic-shield patch AFTER H flip.
if direction == "down" and tiles[0] < 0x0B:
original = tiles[0]
tiles[0] += 0x50
if original == 0x0A:
flips[0] = False
image = Image.new("RGBA", (16, 16))
for side in range(2):
image.paste(column(tiles[side], flips[side]), (side * 8, 0))
name = f"{action}_{direction}_{phase}"
path = bank / f"{name}.png"
image.save(path)
fingerprint = hashlib.sha256(path.read_bytes()).hexdigest()
artifact_id = f"link-{name}"
artifacts.append({"file": path.name, "index": len(artifacts),
"artifact_id": artifact_id, "fingerprint": fingerprint})
provenance.append({"name": name, "frame_descriptor_prg_offset": frame_offset + frame,
"descriptor": base, "tiles_8x16": tiles,
"horizontal_flips": flips,
"tile_prg_offsets": [32895 + n * 16 for n in tiles]})
images[name] = image
clip_frames.append({"artifact_id": artifact_id, "duration_ticks": 6})
clips.append({"name": f"{action}_{direction}",
"mode": "loop" if action == "walk" else "once", "frames": clip_frames})
if action == "walk":
clips.append({"name": f"idle_{direction}", "mode": "loop", "frames": [clip_frames[0]]})
rgba = [int.from_bytes(bytes(c), "big", signed=True) for c in COLORS]
write_json(asset_path, {"schema_version": 1, "asset_uuid": BANK_UUID,
"name": "Link NES", "type": "glyph_bank",
"output": {"format": "GLYPH/indexed_v1", "codec": "NONE",
"pipeline": {"palettes": [{"index": 0, "palette": {"rgba8888": rgba}}]},
"codec_configuration": {}, "metadata": {"tile_size": "16x16"}},
"preload": {"enabled": True}, "artifacts": artifacts})
write_json(bank / "studio.asset.json", {"schema_version": 1, "glyph_bank_specialization": "sprites"})
registry_path = ROOT / "assets/.prometeu/index.json"
registry = json.loads(registry_path.read_text())
existing = [a for a in registry["assets"] if a["asset_uuid"] == BANK_UUID or a["root"] == BANK_ROOT]
if not existing:
asset_id = registry["next_asset_id"]
registry["assets"].append({"asset_id": asset_id, "asset_uuid": BANK_UUID,
"root": BANK_ROOT, "included_in_build": True})
registry["next_asset_id"] = asset_id + 1
write_json(registry_path, registry)
elif len(existing) != 1 or existing[0]["asset_uuid"] != BANK_UUID or existing[0]["root"] != BANK_ROOT:
raise ValueError("Asset registry identity collision")
output = ROOT / "extracted/link"
output.mkdir(parents=True, exist_ok=True)
write_json(output / "provenance.json", {"rom_sha256": ROM_SHA256,
"palette_nes": nes_palette, "palette_rgba": COLORS,
"rgb_note": "RGB approximation; NES color codes are authoritative",
"shield": "basic", "frames": provenance})
# Reviewed and persisted through studio_animation_update, not written as a sidecar here.
definition = {"schema_version": 1, "bank_asset_uuid": BANK_UUID,
"bindings": [{"artifact_id": a["artifact_id"], "glyph_id": a["index"],
"fingerprint": a["fingerprint"]} for a in artifacts],
"animators": [{"id": "link", "initial_clip": "idle_down", "clips": clips}]}
write_json(output / "animation-proposal.json", definition)
preview = Image.new("RGB", (480, 8 * 104), "#202932")
draw = ImageDraw.Draw(preview)
for row, (action, direction) in enumerate((a, d) for a in ("walk", "attack")
for d in ("down", "up", "left", "right")):
draw.text((12, row * 104 + 38), f"{action}_{direction}", fill="white")
for phase in range(2):
image = images[f"{action}_{direction}_{phase}"].resize((80, 80), Image.Resampling.NEAREST)
preview.paste(image, (180 + phase * 120, row * 104 + 8), image)
preview.save(output / "preview.png")
print(f"Created {len(artifacts)} frames and proposal with {len(clips)} clips; bank {BANK_UUID}")
if __name__ == "__main__":
assemble()