Files
Oshima-Game/tools/build_xinyin_up_source_sheets_validation.py
T
2026-09-19 17:24:02 +08:00

169 lines
8.3 KiB
Python

from __future__ import annotations
import json
from pathlib import Path
from PIL import Image, ImageDraw, ImageFont
ROOT = Path(r"C:\milimoe\osm-game")
ASSET_ROOT = ROOT / "assets/images/2d-game-characters/02-xinyin"
SOURCE_DIR = ASSET_ROOT / "source/up"
MASTER = SOURCE_DIR / "xinyin-up-neutral-master-v1.png"
CORE = SOURCE_DIR / "xinyin-up-core-parts-sheet-v2.png"
SOFT = SOURCE_DIR / "xinyin-up-soft-parts-sheet-v2.png"
CORE_DIAGNOSTIC = ASSET_ROOT / "diagnostics/xinyin-up-core-parts-v2-components.png"
CORE_COMPONENTS = ASSET_ROOT / "diagnostics/xinyin-up-core-parts-v2-components.json"
SOFT_DIAGNOSTIC = ASSET_ROOT / "diagnostics/xinyin-up-soft-parts-v2-components.png"
SOFT_COMPONENTS = ASSET_ROOT / "diagnostics/xinyin-up-soft-parts-v2-components.json"
MANIFEST = SOURCE_DIR / "source-sheet-manifest-v1.json"
OUTPUT = ASSET_ROOT / "previews/xinyin-up-parts-sheets-validation-v1.png"
FONT = Path(r"C:\Windows\Fonts\msyh.ttc")
def font(size: int) -> ImageFont.FreeTypeFont:
return ImageFont.truetype(str(FONT), size)
def contain(image: Image.Image, size: tuple[int, int], margin: int = 0) -> Image.Image:
result = image.copy()
result.thumbnail((size[0] - margin * 2, size[1] - margin * 2), Image.Resampling.LANCZOS)
return result
def paste_center(canvas: Image.Image, image: Image.Image, rect: tuple[int, int, int, int]) -> None:
x0, y0, x1, y1 = rect
canvas.alpha_composite(image, (x0 + (x1 - x0 - image.width) // 2, y0 + (y1 - y0 - image.height) // 2))
def corners_transparent(image: Image.Image) -> bool:
alpha = image.getchannel("A")
width, height = image.size
return all(alpha.getpixel(point) == 0 for point in ((0, 0), (width - 1, 0), (0, height - 1), (width - 1, height - 1)))
def main() -> None:
master = Image.open(MASTER).convert("RGBA")
core = Image.open(CORE).convert("RGBA")
soft = Image.open(SOFT).convert("RGBA")
core_diagnostic = Image.open(CORE_DIAGNOSTIC).convert("RGBA")
soft_diagnostic = Image.open(SOFT_DIAGNOSTIC).convert("RGBA")
core_scan = json.loads(CORE_COMPONENTS.read_text(encoding="utf-8-sig"))
soft_scan = json.loads(SOFT_COMPONENTS.read_text(encoding="utf-8-sig"))
if core_scan["componentCount"] != 17:
raise ValueError(f"Expected 17 core components, got {core_scan['componentCount']}")
if soft_scan["componentCount"] != 24:
raise ValueError(f"Expected 24 soft components, got {soft_scan['componentCount']}")
manifest = {
"character": "02-xinyin",
"direction": "up",
"version": 1,
"status": "source-sheets-alpha-validated",
"generationMode": "built-in-imagegen",
"directionReference": "xinyin-up-neutral-master-v1.png",
"sideConvention": {
"A": "screen-right / character-right / fan-hand side",
"B": "screen-left / character-left / relaxed-hand and pouch side",
},
"sheets": [
{
"id": "core",
"file": CORE.name,
"canvas": list(core.size),
"componentCount": core_scan["componentCount"],
"contents": [
"rear-upper-torso", "rear-pelvis-hip-core", "rear-head-base", "shoulder-armor-a",
"shoulder-armor-b", "rear-neck-connector", "fan-grip-hand-a", "upper-arm-a",
"upper-arm-b", "forearm-a", "forearm-b", "relaxed-hand-b", "throw-open-hand-a",
"rear-thigh-a", "rear-thigh-b", "rear-lower-leg-boot-a", "rear-lower-leg-boot-b",
],
},
{
"id": "soft-accessories",
"file": SOFT.name,
"canvas": list(soft.size),
"componentCount": soft_scan["componentCount"],
"contents": [
"rear-nape-hair-overlay", "rear-head-hair-cap", "ponytail-root", "ponytail-middle",
"ponytail-tip", "silver-floral-hair-ornament", "outer-sleeve-cape-a", "outer-sleeve-cape-b",
"rear-coat-panel-01", "rear-coat-panel-02", "rear-coat-panel-03", "rear-coat-panel-04",
"rear-coat-panel-05", "rear-coat-panel-06", "rear-coat-panel-07", "rear-coat-panel-08",
"rear-coat-panel-alt-09", "central-rear-drape", "waist-pouch", "red-tassel-a",
"red-tassel-b", "weapon-fan-open", "weapon-blade-single", "weapon-double-feather",
],
},
],
"rejectedOrSupersededSheets": [
{
"file": "xinyin-up-core-parts-sheet-v1.png",
"reason": "Upper-arm A/B were composite sleeve-capes rather than compact shoulder-to-elbow rig segments.",
},
{
"file": "xinyin-up-soft-parts-sheet-v1.png",
"reason": "Sleeve-capes baked in shoulder armor and several coat panels baked in tassels/chains, preventing clean layer ownership.",
},
],
"generationPromptSet": [
"Generate a strict-rear 17-object core sheet in an invisible 6x3 grid from the approved UP master, with A on screen-right fan side and B on screen-left relaxed side.",
"Correct only the two core upper arms into compact black shoulder-to-elbow segments while preserving the other 15 objects.",
"Generate a strict-rear 24-object soft/accessory sheet in an invisible 6x4 grid: rear hair chain, two sleeve-capes, nine coat panels, rear drape, pouch, tassels, and weapons.",
"Remove baked shoulder armor from sleeve-capes and remove baked tassels/chains from all nine coat panels while preserving the other parts.",
],
"validation": {
"alphaThreshold": 16,
"minimumComponentArea": 80,
"edgeCornersTransparent": corners_transparent(core) and corners_transparent(soft),
"touchingComponents": False,
"coreComponentCount": core_scan["componentCount"],
"softComponentCount": soft_scan["componentCount"],
"notes": [
"Adopted core v2 has exactly 17 disconnected alpha components and compact independent upper arms.",
"Adopted soft v2 has exactly 24 disconnected alpha components in an invisible 6x4 production grid.",
"Sleeve-capes do not own shoulder armor; the nine coat panels do not own red tassels or hanging chains.",
"Part names, exact component mapping, pivots, and parent links remain provisional until independent extraction.",
],
},
}
MANIFEST.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
canvas = Image.new("RGBA", (2000, 1240), (24, 30, 42, 255))
draw = ImageDraw.Draw(canvas)
white = (242, 246, 252, 255)
muted = (166, 181, 205, 255)
blue = (98, 205, 255, 255)
green = (123, 225, 170, 255)
draw.text((48, 30), "心音|UP 背面分解源板验证 v1", font=font(40), fill=white)
draw.text((50, 82), "采用核心板 v2 17 件 + 软性/附件板 v2 24 件 · Alpha 阈值 16 · 8 邻域连通检测", font=font(21), fill=muted)
panels = [
((42, 126, 470, 1178), "A UP 背面母版"),
((500, 126, 1958, 625), "B 核心身体/四肢板 v2 · 17 件"),
((500, 650, 1958, 1178), "C 头发/衣摆/附件板 v2 · 24 件"),
]
for rect, title in panels:
draw.rounded_rectangle(rect, radius=16, fill=(34, 42, 57, 255), outline=(68, 84, 108, 255), width=2)
draw.text((rect[0] + 22, rect[1] + 18), title, font=font(23), fill=white)
master_visible = master.crop(master.getchannel("A").getbbox())
paste_center(canvas, contain(master_visible, (380, 940), 12), (66, 190, 446, 1130))
paste_center(canvas, contain(core_diagnostic, (1400, 400), 8), (526, 190, 1932, 606))
paste_center(canvas, contain(soft_diagnostic, (1400, 420), 8), (526, 716, 1932, 1150))
draw.text((72, 1128), "严格背面", font=font(20), fill=blue)
draw.text((205, 1128), "A 右持扇/B 左放松", font=font(20), fill=green)
draw.text((1530, 590), "17 / 17 独立", font=font(19), fill=green)
draw.text((1510, 1142), "24 / 24 独立", font=font(19), fill=green)
OUTPUT.parent.mkdir(parents=True, exist_ok=True)
canvas.convert("RGB").save(OUTPUT, quality=95)
print(MANIFEST)
print(OUTPUT)
print(json.dumps(manifest["validation"], ensure_ascii=False, indent=2))
if __name__ == "__main__":
main()