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

225 lines
12 KiB
Python

from __future__ import annotations
import json
from pathlib import Path
from PIL import Image, ImageDraw, ImageFont
from build_xinyin_down_assembly import checker, fit, item, paste_part, render_single
ROOT = Path(r"C:\milimoe\osm-game")
CHARACTER = ROOT / "assets/images/2d-game-characters/02-xinyin"
PARTS_DIR = CHARACTER / "parts/up/v1"
MANIFEST_PATH = PARTS_DIR / "parts-manifest.json"
MASTER_PATH = CHARACTER / "source/up/xinyin-up-neutral-master-v1.png"
ASSEMBLED_DIR = CHARACTER / "assembled/up"
ASSEMBLY_PATH = ASSEMBLED_DIR / "xinyin-up-neutral-assembly-v1.png"
LAYOUT_PATH = ASSEMBLED_DIR / "assembly-layout-v1.json"
PREVIEW_PATH = CHARACTER / "previews/xinyin-up-assembly-validation-v1.png"
FONT_PATH = Path(r"C:\Windows\Fonts\msyh.ttc")
CANVAS_SIZE = (600, 760)
# Draw order is list order. X/Y are root-pivot positions on a 600x760 canvas.
# UP side ownership is frozen: A = screen-right fan side, B = screen-left relaxed/pouch side.
LAYOUT = [
item("ponytail-root", 275, 95, -5, .55, "hair-back", "三段马尾根;位于后脑之后并向画面左侧展开"),
item("ponytail-middle", 245, 190, -20, .55, "hair-back", "根枢轴贴合上一段远端关节并向画面左侧延伸"),
item("ponytail-tip", 202, 287, -12, .55, "hair-back", "末端与中段内压重叠并继续向左下收束"),
item("hair-cap", 300, 205, 0, .55, "hair-back", "后脑发帽;遮盖马尾根接缝"),
item("coat-panel-01", 215, 358, -5, .85, "cloth-back", "画面左外后层"),
item("coat-panel-02", 238, 356, -4, .85, "cloth-back", "画面左后层"),
item("coat-panel-03", 262, 357, -2, .85, "cloth-back", "中左后层"),
item("coat-panel-04", 283, 358, -1, .85, "cloth-back", "中左层"),
item("coat-panel-05", 317, 358, 1, .85, "cloth-back", "中右层"),
item("coat-panel-06", 338, 357, 2, .85, "cloth-back", "中右后层"),
item("coat-panel-07", 362, 356, 4, .85, "cloth-back", "画面右后层"),
item("coat-panel-08", 385, 358, 5, .85, "cloth-back", "画面右外后层"),
item("thigh-b", 266, 382, -2, .62, "legs", "B 腿髋点;画面左"),
item("shin-boot-b", 260, 564, -3, .50, "legs", "B 腿膝点;脚底基线候选"),
item("thigh-a", 334, 382, 2, .62, "legs", "A 腿髋点;画面右"),
item("shin-boot-a", 340, 564, 3, .50, "legs", "A 腿膝点;脚底基线候选"),
item("outer-sleeve-cape-b", 226, 241, -8, .65, "arms-back", "画面左放松手侧独立外袖披"),
item("outer-sleeve-cape-a", 374, 241, 8, .65, "arms-back", "画面右持扇手侧独立外袖披"),
item("upper-arm-b", 226, 241, -10, .33, "arms-back", "B 上臂;肩到肘"),
item("forearm-b", 219, 289, -6, .38, "arms-back", "B 前臂;肘点与上臂末端内压重叠"),
item("hand-relaxed-b", 210, 372, -5, .28, "arms-back", "B 放松手;腕点与前臂末端内压重叠"),
item("upper-arm-a", 374, 241, 10, .33, "arms-back", "A 上臂;肩到肘"),
item("forearm-a", 381, 289, 154, .38, "arms-back", "A 前臂向上回折;肘点内压重叠"),
item("hand-fan-grip-a", 418, 214, 7, .28, "weapon", "A 持扇手;腕点与前臂末端内压重叠"),
item("torso-upper", 300, 360, 0, .60, "body", "背面躯干根位于腰线"),
item("pelvis-hip-core", 300, 359, 0, .60, "body-overlay", "腰封、骨盆与中性后腰饰"),
item("shoulder-armor-b", 228, 237, -10, .30, "body-overlay", "画面左放松手侧肩甲"),
item("shoulder-armor-a", 372, 237, 10, .30, "body-overlay", "画面右持扇侧肩甲"),
item("neck", 300, 220, 0, .50, "body-overlay", "背面颈部连接"),
item("head-back", 300, 215, 0, .52, "head", "严格背面头部基底"),
item("hair-nape-overlay", 300, 112, 0, .57, "head-overlay", "后脑与后颈发丝覆盖层"),
item("hair-ornament-long", 252, 112, -3, .46, "head-overlay", "母版画面左侧长银花发饰"),
]
EXCLUDED = {
"coat-panel-alt-09": "九选八中的动作替换候选",
"rear-drape": "pelvis-hip-core 已含中性腰后布与系绳",
"waist-pouch": "pelvis-hip-core 已含画面左侧腰包",
"red-tassel-a": "中性站姿不重复叠加动作替换流苏",
"red-tassel-b": "中性站姿不重复叠加动作替换流苏",
"hand-throw-open-a": "投掷动作替换手",
"weapon-fan-open": "hand-fan-grip-a 已包含中性持握羽扇",
"weapon-blade-single": "投掷物,不用于中性持握",
"weapon-double-feather": "攻击替换物,不用于中性持握",
}
def main():
manifest = json.loads(MANIFEST_PATH.read_text(encoding="utf-8"))
by_name = {record["name"]: record for record in manifest["parts"]}
images = {name: Image.open(PARTS_DIR / record["file"]).convert("RGBA") for name, record in by_name.items()}
layout_names = {entry["name"] for entry in LAYOUT}
all_names = set(by_name)
if layout_names | set(EXCLUDED) != all_names:
missing = sorted(all_names - layout_names - set(EXCLUDED))
unknown = sorted(layout_names | set(EXCLUDED) - all_names)
raise ValueError(f"Part accounting mismatch. missing={missing}, unknown={unknown}")
assembly = Image.new("RGBA", CANVAS_SIZE, (0, 0, 0, 0))
records = []
entry_by_name = {entry["name"]: entry for entry in LAYOUT}
for entry in LAYOUT:
record = by_name[entry["name"]]
pivot_record = record["rootPivot"]["outputPixels"]
pivot = (pivot_record["x"], pivot_record["y"])
paste_part(assembly, images[entry["name"]], pivot, (entry["x"], entry["y"]), entry["scale"], entry["rotation"])
records.append({
"part": entry["name"],
"file": f"assets/images/2d-game-characters/02-xinyin/parts/up/v1/{record['file']}",
"targetPivot": {"x": entry["x"], "y": entry["y"]},
"rotationDegrees": entry["rotation"],
"scale": entry["scale"],
"group": entry["group"],
"note": entry["note"],
})
ASSEMBLED_DIR.mkdir(parents=True, exist_ok=True)
assembly.save(ASSEMBLY_PATH)
alpha = assembly.getchannel("A")
visible_bbox = alpha.getbbox()
edge_clear = not any((
alpha.crop((0, 0, CANVAS_SIZE[0], 1)).getbbox(),
alpha.crop((0, CANVAS_SIZE[1] - 1, CANVAS_SIZE[0], CANVAS_SIZE[1])).getbbox(),
alpha.crop((0, 0, 1, CANVAS_SIZE[1])).getbbox(),
alpha.crop((CANVAS_SIZE[0] - 1, 0, CANVAS_SIZE[0], CANVAS_SIZE[1])).getbbox(),
))
baselines = {}
for name in ("shin-boot-b", "shin-boot-a"):
entry = entry_by_name[name]
record = by_name[name]
pivot_record = record["rootPivot"]["outputPixels"]
single = render_single(images[name], (pivot_record["x"], pivot_record["y"]), entry)
bbox = single.getchannel("A").getbbox()
baselines[name] = bbox[3] - 1 if bbox else None
layout_manifest = {
"characterId": "02-xinyin",
"direction": "up",
"version": 1,
"status": "art-assembly-validated",
"canvas": {
"width": CANVAS_SIZE[0],
"height": CANVAS_SIZE[1],
"origin": "top-left",
"units": "pixels",
"footOrigin": {"x": CANVAS_SIZE[0] // 2, "y": max(baselines.values())},
},
"sideConvention": manifest["sideConvention"],
"sourceManifests": ["assets/images/2d-game-characters/02-xinyin/parts/up/v1/parts-manifest.json"],
"items": records,
"excludedParts": EXCLUDED,
"validation": {
"usedPartCount": len(records),
"excludedPartCount": len(EXCLUDED),
"allPartsAccountedFor": len(records) + len(EXCLUDED) == manifest["partCount"],
"visibleAlphaBounds": {"x": visible_bbox[0], "y": visible_bbox[1], "width": visible_bbox[2] - visible_bbox[0], "height": visible_bbox[3] - visible_bbox[1]},
"edgeTransparent": edge_clear,
"leftBootBaselineY": baselines["shin-boot-b"],
"rightBootBaselineY": baselines["shin-boot-a"],
"baselineDeltaPixels": abs(baselines["shin-boot-b"] - baselines["shin-boot-a"]),
},
"warnings": [
"This is an art-side assembly candidate, not an engine rig.",
"A/B ownership is frozen for UP and must not reuse the DOWN screen-side mapping.",
"The pelvis core already contains neutral rear cloth, cords, tassels, and the side pouch; standalone waist pieces remain action replacements.",
"The three-part ponytail chain is validated for the neutral pose; rotation extremes still require motion validation.",
],
}
LAYOUT_PATH.write_text(json.dumps(layout_manifest, ensure_ascii=False, indent=2), encoding="utf-8")
board = Image.new("RGB", (1920, 980), (17, 21, 30))
draw = ImageDraw.Draw(board)
title = ImageFont.truetype(str(FONT_PATH), 38)
panel_font = ImageFont.truetype(str(FONT_PATH), 25)
text_font = ImageFont.truetype(str(FONT_PATH), 18)
muted = (151, 169, 198)
draw.text((42, 24), "心音|UP 背面中性站姿装配验证 v1", font=title, fill=(240, 244, 252))
draw.text((44, 78), "冻结母版 / 41 件中的 32 件中性选择 / 背面枢轴、层级与双脚基线", font=text_font, fill=muted)
panel_rects = [(42, 122, 622, 930), (654, 122, 1234, 930), (1266, 122, 1878, 930)]
for rect in panel_rects:
draw.rounded_rectangle(rect, radius=16, fill=(24, 30, 42), outline=(65, 82, 112), width=2)
draw.text((62, 142), "A 冻结的 UP 母版", font=panel_font, fill=(240, 244, 252))
draw.text((674, 142), "B 32 件部件重建", font=panel_font, fill=(240, 244, 252))
draw.text((1286, 142), "C 枢轴、侧别与基线", font=panel_font, fill=(240, 244, 252))
master = fit(Image.open(MASTER_PATH).convert("RGBA"), (530, 720), 18)
master_bg = checker((530, 720))
master_bg.paste(master, ((530 - master.width) // 2, (720 - master.height) // 2), master)
board.paste(master_bg, (67, 190))
assembly_bg = checker(CANVAS_SIZE)
assembly_bg.paste(assembly, (0, 0), assembly)
display = fit(assembly_bg, (540, 740))
board.paste(display, (674 + (540 - display.width) // 2, 180))
board.paste(display, (1302 + (540 - display.width) // 2, 180))
ox, oy = 1302, 180
sx = display.width / CANVAS_SIZE[0]
sy = display.height / CANVAS_SIZE[1]
def pt(x, y):
return (round(ox + x * sx), round(oy + y * sy))
overlay = ImageDraw.Draw(board)
chains = [
[pt(300, 90), pt(300, 215), pt(300, 360)],
[pt(228, 237), pt(219, 289), pt(210, 372)],
[pt(372, 237), pt(381, 289), pt(418, 214)],
[pt(300, 359), pt(266, 382), pt(260, 564), pt(260, baselines["shin-boot-b"])],
[pt(300, 359), pt(334, 382), pt(340, 564), pt(340, baselines["shin-boot-a"])],
]
for chain in chains:
for start, end in zip(chain, chain[1:]):
overlay.line((*start, *end), fill=(69, 211, 255), width=4)
for x, y in chain:
overlay.ellipse((x - 6, y - 6, x + 6, y + 6), outline=(255, 87, 115), width=3)
baseline_y = pt(300, max(baselines.values()))[1]
overlay.line((1318, baseline_y, 1826, baseline_y), fill=(255, 204, 75), width=3)
draw.text((1286, 853), f"A/B 固定:画面右持扇,画面左放松|脚底差 {abs(baselines['shin-boot-b'] - baselines['shin-boot-a'])} px", font=text_font, fill=(240, 244, 252))
draw.text((1286, 883), "腰部替换件不重复叠加;三段马尾与八片衣摆进入动作极限测试。", font=text_font, fill=muted)
PREVIEW_PATH.parent.mkdir(parents=True, exist_ok=True)
board.save(PREVIEW_PATH, quality=95)
print(ASSEMBLY_PATH)
print(LAYOUT_PATH)
print(PREVIEW_PATH)
print(json.dumps(layout_manifest["validation"], ensure_ascii=False))
if __name__ == "__main__":
main()