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

403 lines
15 KiB
Python

from __future__ import annotations
import copy
import json
import math
import sys
from pathlib import Path
from PIL import Image, ImageDraw, ImageFont
ROOT = Path(r"C:\milimoe\osm-game")
TOOLS_DIR = ROOT / "tools"
if str(TOOLS_DIR) not in sys.path:
sys.path.insert(0, str(TOOLS_DIR))
from build_xinyin_down_assembly import ( # noqa: E402
FONT_PATH,
LAYOUT,
MANIFEST_PATH,
PARTS_DIR,
paste_part,
)
CHARACTER = ROOT / "assets/images/2d-game-characters/02-xinyin"
OUTPUT_DIR = CHARACTER / "motion/down/v1"
PREVIEW_PATH = CHARACTER / "previews/xinyin-down-motion-validation-v1.png"
CANVAS_SIZE = (600, 760)
FRAME_SPECS = [
{
"name": "idle-inhale",
"label": "IDLE · INHALE",
"durationMs": 420,
"note": "胸腔与头部轻微上提;双臂随肩上移,右后方马尾略晚跟随。",
"body_y": -3,
"head_y": -4,
"hair": (1, 45, 44),
"arm": (-10, -153),
"cape": -9,
"coat": (-2, 2),
},
{
"name": "idle-neutral",
"label": "IDLE · NEUTRAL",
"durationMs": 260,
"note": "DOWN 装配 v1 的固定正面基准姿势。",
"body_y": 0,
"head_y": 0,
"hair": (0, 48, 48),
"arm": (-10, -154),
"cape": -10,
"coat": (0, 0),
},
{
"name": "idle-exhale",
"label": "IDLE · EXHALE",
"durationMs": 420,
"note": "胸腔与头部下沉;软性部件收回,双脚基线保持不动。",
"body_y": 2,
"head_y": 3,
"hair": (-1, 51, 53),
"arm": (-11, -155),
"cape": -11,
"coat": (2, -2),
},
{
"name": "throw-ready",
"label": "THROW · READY",
"durationMs": 150,
"note": "画面左侧持扇手上提,身体主轴仍保持正面。",
"body_y": 0,
"head_y": 0,
"torso_rotation": -1,
"hair": (1, 45, 43),
"arm": (-22, -151),
"cape": -22,
"coat": (-2, 3),
},
{
"name": "throw-windup",
"label": "THROW · WINDUP",
"durationMs": 110,
"note": "持扇臂收至头侧蓄势;右后方马尾与衣摆反向压缩。",
"body_y": 0,
"head_y": -1,
"torso_rotation": 3,
"head_rotation": 1,
"hair": (3, 40, 36),
"arm": (-30, 170),
"cape": -28,
"coat": (-5, 5),
},
{
"name": "throw-release",
"label": "THROW · RELEASE",
"durationMs": 90,
"note": "身体保持正面,持扇臂向画面左侧完全展开;张手和单枚脱手羽刃替换中性持握。",
"body_y": 0,
"head_y": -1,
"torso_rotation": -3,
"head_rotation": -1,
"hair": (5, 56, 62),
"arm": (-90, -90),
"cape": -78,
"coat": (6, -6),
"release": True,
},
{
"name": "throw-recover",
"label": "THROW · RECOVER",
"durationMs": 180,
"note": "手臂回收;马尾与衣摆越过中位后准备回到待机。",
"body_y": 1,
"head_y": 1,
"torso_rotation": -1,
"head_rotation": 1,
"hair": (-3, 54, 58),
"arm": (-38, -151),
"cape": -34,
"coat": (3, -4),
},
]
def rotated_joint(record, target, scale, angle):
root = record["rootPivot"]["outputPixels"]
next_joint = record["nextJoint"]["outputPixels"]
dx = (next_joint["x"] - root["x"]) * scale
dy = (next_joint["y"] - root["y"]) * scale
radians = math.radians(angle)
return (
target[0] + math.cos(radians) * dx + math.sin(radians) * dy,
target[1] - math.sin(radians) * dx + math.cos(radians) * dy,
)
def load_parts():
manifest = json.loads(MANIFEST_PATH.read_text(encoding="utf-8"))
records = {record["name"]: record for record in manifest["parts"]}
images = {
name: Image.open(PARTS_DIR / record["file"]).convert("RGBA")
for name, record in records.items()
}
return records, images
def build_transforms(spec, records):
transforms = {entry["name"]: copy.deepcopy(entry) for entry in LAYOUT}
body_y = spec.get("body_y", 0)
head_y = spec.get("head_y", 0)
torso_rotation = spec.get("torso_rotation", 0)
head_rotation = spec.get("head_rotation", 0)
# The pelvis and legs remain locked to the ground. Breathing occurs above the waist.
transforms["torso-upper"]["y"] += body_y
transforms["torso-upper"]["rotation"] += torso_rotation
for name in ("shoulder-armor-a", "shoulder-armor-b"):
transforms[name]["y"] += body_y
for name in ("neck", "head-face", "hair-front", "hair-ornament-long"):
transforms[name]["y"] += head_y
for name in ("head-face", "hair-front", "hair-ornament-long"):
transforms[name]["rotation"] += head_rotation
left_coat_delta, right_coat_delta = spec["coat"]
for index in range(1, 5):
transforms[f"coat-panel-0{index}"]["rotation"] += left_coat_delta * (5 - index) / 4
for index in range(5, 9):
transforms[f"coat-panel-0{index}"]["rotation"] += right_coat_delta * (index - 4) / 4
# Relaxed B arm follows the breathing motion but does not participate in the throw.
for name in ("outer-sleeve-cape-b", "upper-arm-b", "forearm-b", "hand-relaxed-b"):
transforms[name]["y"] += body_y
transforms["outer-sleeve-cape-b"]["rotation"] += torso_rotation * 0.5
transforms["upper-arm-b"]["rotation"] += torso_rotation * 0.5
# Preserve the overlap offsets validated by the neutral assembly while adding lag.
root_angle, middle_angle, tip_angle = spec["hair"]
hair_root = transforms["ponytail-root"]
hair_root["x"] += torso_rotation * 0.7
hair_root["y"] += head_y
hair_root["rotation"] = root_angle
hair_middle = transforms["ponytail-middle"]
hair_middle["x"] += torso_rotation * 1.2
hair_middle["y"] += head_y * 0.7
hair_middle["rotation"] = middle_angle
hair_tip = transforms["ponytail-tip"]
hair_tip["x"] += torso_rotation * 2.0
hair_tip["y"] += head_y * 0.4
hair_tip["rotation"] = tip_angle
upper_rotation, forearm_rotation = spec["arm"]
shoulder = (226 + torso_rotation * 0.8, 241 + body_y)
upper = transforms["upper-arm-a"]
upper.update({"x": shoulder[0], "y": shoulder[1], "rotation": upper_rotation})
elbow_joint = rotated_joint(records["upper-arm-a"], shoulder, upper["scale"], upper_rotation)
elbow = (elbow_joint[0] + 2, elbow_joint[1] - 4)
forearm = transforms["forearm-a"]
forearm_scale = 0.34 if spec.get("release") else 0.38
forearm.update({"x": elbow[0], "y": elbow[1], "rotation": forearm_rotation, "scale": forearm_scale})
wrist = rotated_joint(records["forearm-a"], elbow, forearm_scale, forearm_rotation)
hand = transforms["hand-fan-grip-a"]
hand.update({"x": wrist[0], "y": wrist[1], "rotation": forearm_rotation + 147})
cape = transforms["outer-sleeve-cape-a"]
cape.update({"x": shoulder[0], "y": shoulder[1], "rotation": spec["cape"]})
if spec.get("release"):
hand["visible"] = False
return transforms, shoulder, elbow, wrist
def serializable_transform(name, transform):
return {
"Name": name,
"X": round(transform["x"], 2),
"Y": round(transform["y"], 2),
"Rotation": round(transform["rotation"], 2),
"Scale": transform["scale"],
"Visible": transform.get("visible", True),
}
def render_frame(spec, records, images):
transforms, shoulder, elbow, wrist = build_transforms(spec, records)
canvas = Image.new("RGBA", CANVAS_SIZE, (0, 0, 0, 0))
serialized = []
for entry in LAYOUT:
name = entry["name"]
transform = transforms[name]
serialized.append(serializable_transform(name, transform))
if not transform.get("visible", True):
continue
pivot = records[name]["rootPivot"]["outputPixels"]
paste_part(
canvas,
images[name],
(pivot["x"], pivot["y"]),
(transform["x"], transform["y"]),
transform["scale"],
transform["rotation"],
)
if spec.get("release"):
open_hand = {
"x": wrist[0],
"y": wrist[1],
"rotation": -95,
"scale": 0.27,
"visible": True,
}
blade = {
"x": max(24, wrist[0] - 68),
"y": wrist[1] - 8,
"rotation": -90,
"scale": 0.32,
"visible": True,
}
for name, transform in (("weapon-blade-single", blade), ("hand-throw-open-a", open_hand)):
pivot = records[name]["rootPivot"]["outputPixels"]
paste_part(
canvas,
images[name],
(pivot["x"], pivot["y"]),
(transform["x"], transform["y"]),
transform["scale"],
transform["rotation"],
)
serialized.append(serializable_transform(name, transform))
joints = {
"Shoulder": [round(shoulder[0], 2), round(shoulder[1], 2)],
"Elbow": [round(elbow[0], 2), round(elbow[1], 2)],
"Wrist": [round(wrist[0], 2), round(wrist[1], 2)],
}
return canvas, serialized, joints
def checker(size, cell=18):
image = Image.new("RGB", size, (235, 239, 245))
draw = ImageDraw.Draw(image)
for y in range(0, size[1], cell):
for x in range(0, size[0], cell):
if (x // cell + y // cell) % 2:
draw.rectangle((x, y, x + cell - 1, y + cell - 1), fill=(215, 222, 231))
return image
def make_preview(frames):
board = Image.new("RGB", (1560, 1050), (17, 21, 30))
draw = ImageDraw.Draw(board)
title_font = ImageFont.truetype(str(FONT_PATH), 38)
label_font = ImageFont.truetype(str(FONT_PATH), 21)
note_font = ImageFont.truetype(str(FONT_PATH), 17)
draw.text((42, 25), "心音|运行时 DOWN 动作验证 v1", font=title_font, fill=(242, 246, 252))
draw.text((44, 78), "严格正面身体 · 固定脚底基线 · 待机呼吸 3 帧 + 向画面左侧投掷 4 帧", font=note_font, fill=(151, 169, 198))
cells = [(42 + 378 * col, 120 + 455 * row) for row in range(2) for col in range(4)]
for (spec, frame), (x, y) in zip(frames, cells):
draw.rounded_rectangle((x, y, x + 352, y + 425), radius=14, fill=(25, 31, 43), outline=(65, 82, 112), width=2)
draw.text((x + 16, y + 13), spec["label"], font=label_font, fill=(241, 245, 252))
preview = frame.copy()
preview.thumbnail((324, 346), Image.Resampling.LANCZOS)
bg = checker((324, 346))
bg.paste(preview, ((324 - preview.width) // 2, (346 - preview.height) // 2), preview)
board.paste(bg, (x + 14, y + 52))
draw.text((x + 16, y + 402), f"{spec['durationMs']} ms", font=note_font, fill=(151, 169, 198))
draw.text((1176, 590), "验证重点", font=label_font, fill=(241, 245, 252))
notes = [
"• 身体主轴保持正面,不借侧身强化动作",
"• 双脚与地面原点在全部帧中锁定",
"• A 手臂按肩—肘—腕链自动连接",
"• 释放帧使用张手与单枚脱手羽刃替换件",
]
for index, note in enumerate(notes):
draw.text((1178, 635 + index * 36), note, font=note_font, fill=(174, 188, 211))
PREVIEW_PATH.parent.mkdir(parents=True, exist_ok=True)
board.save(PREVIEW_PATH, quality=95)
def main():
records, images = load_parts()
OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
frames = []
manifest_frames = []
baselines = []
bounds = []
edge_transparent = True
for spec in FRAME_SPECS:
frame, transforms, joints = render_frame(spec, records, images)
frame_path = OUTPUT_DIR / f"{spec['name']}.png"
frame.save(frame_path)
frames.append((spec, frame))
bbox = frame.getchannel("A").getbbox()
if bbox is None:
raise ValueError(f"Frame {spec['name']} is fully transparent")
bounds.append(bbox)
baselines.append(bbox[3] - 1)
alpha = frame.getchannel("A")
edges = [
alpha.crop((0, 0, CANVAS_SIZE[0], 1)),
alpha.crop((0, CANVAS_SIZE[1] - 1, CANVAS_SIZE[0], CANVAS_SIZE[1])),
alpha.crop((0, 0, 1, CANVAS_SIZE[1])),
alpha.crop((CANVAS_SIZE[0] - 1, 0, CANVAS_SIZE[0], CANVAS_SIZE[1])),
]
edge_transparent = edge_transparent and all(edge.getbbox() is None for edge in edges)
manifest_frames.append({
"name": spec["name"],
"label": spec["label"],
"file": frame_path.name,
"durationMs": spec["durationMs"],
"note": spec["note"],
"joints": joints,
"transforms": transforms,
})
make_preview(frames)
manifest = {
"characterId": "02-xinyin",
"direction": "down",
"runtimeDirection": "down",
"version": 1,
"status": "art-motion-validated",
"canvas": {"width": CANVAS_SIZE[0], "height": CANVAS_SIZE[1], "origin": "top-left", "units": "pixels"},
"baseLayout": "assets/images/2d-game-characters/02-xinyin/assembled/down/assembly-layout-v1.json",
"sourceManifests": [
"assets/images/2d-game-characters/02-xinyin/parts/down/v1/parts-manifest.json"
],
"sequence": ["idle-inhale", "idle-neutral", "idle-exhale", "idle-neutral", "throw-ready", "throw-windup", "throw-release", "throw-recover", "idle-neutral"],
"loopNotes": {
"idle": "inhale → neutral → exhale → neutral",
"throw": "ready → windup → release → recover",
},
"frames": manifest_frames,
"validation": {
"edgeTransparent": edge_transparent,
"baselineYByFrame": dict(zip((spec["name"] for spec in FRAME_SPECS), baselines)),
"baselineDeltaPixels": max(baselines) - min(baselines),
"visibleAlphaBoundsByFrame": {
spec["name"]: {"x": bbox[0], "y": bbox[1], "width": bbox[2] - bbox[0], "height": bbox[3] - bbox[1]}
for spec, bbox in zip(FRAME_SPECS, bounds)
},
"jointChains": [
"upper-arm-a → forearm-a → hand",
"ponytail-root / ponytail-middle / ponytail-tip with neutral-overlap offsets",
],
},
"warnings": [
"This is an art-side motion validation set, not an engine animation resource.",
"DOWN keeps the torso front-facing while the fan-side arm releases toward screen-left for readability.",
"Projectile and VFX aim remain free-angle at runtime; the body animation is four-cardinal.",
],
}
manifest_path = OUTPUT_DIR / "motion-manifest.json"
manifest_path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
print(manifest_path)
print(PREVIEW_PATH)
print(json.dumps(manifest["validation"], ensure_ascii=False, indent=2))
if __name__ == "__main__":
main()