60cce66993
Tests / test (push) Has been cancelled
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
200 lines
9.4 KiB
Python
200 lines
9.4 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""没有物理的模型(FBX / psk / xps 转来的 PMX 常见):按骨骼名和骨架结构自动补一套 MMD 刚体,
|
||
再交给 springbone._build_springs 按同一套规则转成 VRM SpringBone。
|
||
|
||
* 摆动链(动态刚体,mode 1):名字像头发 / 裙摆 / 袖子 / 飘带 / 尾巴的非人形骨;
|
||
另外挂在头骨下面、不像五官和头饰的非人形骨也算头发(Query 酱的头发骨叫 H01_Front、H02_L)。
|
||
兽耳(Ear_0_L → Ear_1_L → … 这种挂在头下、连成多节的链)单独识别:_FACE 里的 ear/耳
|
||
是为了挡住人形模型的单根耳饰 / 表情骨,但兽耳必须能摆,否则导出的 VRM 耳朵完全不动。
|
||
胸部骨、扭转骨、IK、辅助骨不动。
|
||
* 碰撞体(跟随骨骼的刚体,mode 0):头(球)、胸 / 腰(球)、上下臂和大小腿(胶囊),
|
||
尺寸按身高比例给。
|
||
裙摆 / 头发的区分、抽稀、硬度、碰撞的取舍都沿用 _build_springs(按挂点和高度自动判断)。
|
||
"""
|
||
import math
|
||
import re
|
||
|
||
_SWING = re.compile(
|
||
r"hair|kami|髪|ahoge|bang|fringe|pony|twin|braid|"
|
||
r"skirt|スカート|suso|裾|dress|"
|
||
r"sode|sleeve|袖|"
|
||
r"ribbon|ribon|リボン|necktie|cape|cloak|mantle|scarf|マフラー|tassel|frill|フリル|"
|
||
r"tail|尻尾|shippo|しっぽ|coat|jacket_?(?:l|r|b|f)", re.I)
|
||
_NEVER = re.compile(
|
||
r"mune|bust|breast|chichi|oppai|胸|pai_|^pai|twist|twst|捩|roll|(?:^|_)ik|ik(?:$|_)|helper|ctrl|"
|
||
r"control|adj|root|dummy|ダミー|先$|tip$|nub$|ndl|offset|target|master|aim|socket|attach|"
|
||
r"weapon|gun|holster|pocket|pouch|buckle|shell|prop|point", re.I)
|
||
_FACE = re.compile(
|
||
r"eye|目|jaw|顎|tongue|舌|teeth|tooth|歯|mouth|口|brow|眉|lid|瞼|cheek|頬|nose|鼻|face|顔|"
|
||
r"lip|唇|chin|smile|crease|corner|nostril|temple|forehead|lash|pupil|iris|dimple|"
|
||
r"hat|cap|crown|glass|megane|眼鏡|horn|角|acc|ear|耳|head_?end|headtop|top$", re.I)
|
||
# 兽耳:日语模型常写作 mimi / みみ。耳环、耳机之类是挂件,不是耳朵骨
|
||
_EAR = re.compile(r"ear|耳|mimi|みみ", re.I)
|
||
_EAR_NOT = re.compile(
|
||
r"earring|ear_ring|ear_?pierce|pierce|耳环|耳饰|earphone|headphone|イヤホン|イヤリング", re.I)
|
||
|
||
|
||
def _ear_chains(bones, parents, nb, human, alias, head, under):
|
||
"""→ 兽耳骨集合。条件:挂在头骨下、名字像耳朵、且至少两节连成链。
|
||
|
||
_FACE 把 ear/耳 当五官挡掉了,但那只该挡人形模型的单根耳饰 / 表情骨;
|
||
Ear_0_L → Ear_1_L → Ear_2_L 这种多节兽耳是正经的动骨链,要放行。
|
||
只认「有同组父骨或子骨」的骨,孤零零一根 ear 骨仍交给 _FACE 拦住。
|
||
"""
|
||
if head is None:
|
||
return set()
|
||
ear = {b for b in range(nb)
|
||
if b not in human and b not in alias
|
||
and _EAR.search(bones[b]["name"] or "")
|
||
and not _EAR_NOT.search(bones[b]["name"] or "")
|
||
and under(b, head)}
|
||
if len(ear) < 2:
|
||
return set()
|
||
has_child = {parents[b] for b in ear if parents[b] in ear}
|
||
return {b for b in ear if parents[b] in ear or b in has_child}
|
||
|
||
_ARM_SEG = (("leftUpperArm", "leftLowerArm"), ("leftLowerArm", "leftHand"),
|
||
("rightUpperArm", "rightLowerArm"), ("rightLowerArm", "rightHand"))
|
||
_LEG_SEG = (("leftUpperLeg", "leftLowerLeg"), ("leftLowerLeg", "leftFoot"),
|
||
("rightUpperLeg", "rightLowerLeg"), ("rightLowerLeg", "rightFoot"))
|
||
|
||
|
||
def _rot_for_dir(d):
|
||
"""胶囊沿局部 Y:求 PMX 刚体旋转(Ry·Rx·Rz,取 ry=0)使 Y 轴指向 d。"""
|
||
n = math.sqrt(sum(x * x for x in d)) or 1.0
|
||
dx, dy, dz = (x / n for x in d)
|
||
rz = math.asin(max(-1.0, min(1.0, -dx)))
|
||
rx = math.atan2(dz, dy)
|
||
return (rx, 0.0, rz)
|
||
|
||
|
||
def _rb(name, bone, pos, mode, radius, height=0.0, rot=(0.0, 0.0, 0.0)):
|
||
return {"name": name, "name_en": name, "bone": bone, "group": 1 if mode else 0, "mask": 0xFFFF,
|
||
"shape": 2 if height > 0 else 0, "size": (radius, height, 0.0), "pos": tuple(pos),
|
||
"rot": tuple(rot), "mass": 1.0, "move_damp": 0.5, "rot_damp": 0.5, "repulsion": 0.0,
|
||
"friction": 0.5, "mode": mode}
|
||
|
||
|
||
def _leaf_tails(model, dyn, children):
|
||
"""链尾骨没有子骨时(FBX 里的单根发束骨很常见),按它带动的顶点估计长度:
|
||
以这根骨为主权重的顶点里离骨头最远的那个,取 90% 当 tail。
|
||
不估的话 tail 只有默认的一小截,整条链被当成「过短」不做物理。"""
|
||
bones = model["bones"]
|
||
dset = set(dyn)
|
||
leaves = [b for b in dyn if not any(c in dset for c in children[b])
|
||
and not any(c not in dset for c in children[b])]
|
||
if not leaves:
|
||
return
|
||
far = {b: (0.0, None) for b in leaves}
|
||
for v in model.get("vertices") or []:
|
||
ws = v.get("wweights") or [1.0]
|
||
bs = v.get("wbones") or []
|
||
if not bs:
|
||
continue
|
||
k = max(range(min(len(bs), len(ws)) or 1), key=lambda i: ws[i] if i < len(ws) else 0)
|
||
b = bs[k]
|
||
if b in far:
|
||
p, q = v["pos"], bones[b]["pos"]
|
||
d = sum((p[i] - q[i]) ** 2 for i in range(3))
|
||
if d > far[b][0]:
|
||
far[b] = (d, p)
|
||
for b, (d, p) in far.items():
|
||
if p is None:
|
||
continue
|
||
q = bones[b]["pos"]
|
||
off = tuple((p[i] - q[i]) * 0.9 for i in range(3))
|
||
cur = bones[b].get("tail")
|
||
cur_len = math.sqrt(sum(x * x for x in cur)) if bones[b].get("tail_kind") == 0 and cur else 0.0
|
||
if math.sqrt(d) * 0.9 > cur_len:
|
||
bones[b]["tail_kind"] = 0
|
||
bones[b]["tail"] = off
|
||
|
||
|
||
def needed(model):
|
||
"""模型里没有任何会动的刚体(mode 1/2)时才自动补。"""
|
||
return not any(rb.get("mode") in (1, 2) for rb in model.get("rigid_bodies") or [])
|
||
|
||
|
||
def synthesize(model, parents, alias, human_b, log=None):
|
||
"""往 model["rigid_bodies"] 里追加自动生成的刚体。返回 (摆动骨数, 碰撞体数)。"""
|
||
bones = model["bones"]
|
||
nb = len(bones)
|
||
human = set(human_b.values())
|
||
head = human_b.get("head")
|
||
ys = [v["pos"][1] for v in model.get("vertices") or []] or [b["pos"][1] for b in bones] or [0.0]
|
||
H = max(1e-6, max(ys) - min(ys)) # 模型身高(PMX 单位)
|
||
children = [[] for _ in range(nb)]
|
||
for i, p in enumerate(parents):
|
||
if 0 <= p < nb:
|
||
children[p].append(i)
|
||
|
||
def under(b, anc):
|
||
p = parents[b]
|
||
seen = set()
|
||
while 0 <= p < nb and p not in seen:
|
||
if p == anc:
|
||
return True
|
||
if p in human: # 中间隔着别的人形骨:不算直接挂在 anc 下面
|
||
return False
|
||
seen.add(p)
|
||
p = parents[p]
|
||
return False
|
||
|
||
ear_dyn = _ear_chains(bones, parents, nb, human, alias, head, under)
|
||
|
||
def swing(b):
|
||
if b in human or b in alias:
|
||
return False
|
||
nm = bones[b]["name"] or ""
|
||
if b in ear_dyn: # 多节兽耳链优先于 _FACE 的「五官」排除
|
||
return True
|
||
if _NEVER.search(nm):
|
||
return False
|
||
if _SWING.search(nm):
|
||
return True
|
||
# 名字看不出来、挂在头下面的:只有模型里一根名字像头发的骨都没有时才当头发
|
||
# (Query 酱的 H01_Front)。有表情骨架的模型头下面是几十根嘴唇 / 眼睑骨,不能动
|
||
return by_struct and head is not None and under(b, head) and not _FACE.search(nm)
|
||
|
||
by_struct = not any(re.search(r"hair|kami|髪|bang|fringe|pony|twin|braid", bones[b]["name"] or "", re.I)
|
||
for b in range(nb) if b not in human)
|
||
dyn = [b for b in range(nb) if swing(b)]
|
||
_leaf_tails(model, dyn, children)
|
||
rbs = model.setdefault("rigid_bodies", [])
|
||
for b in dyn:
|
||
nm = (bones[b]["name"] or "").lower()
|
||
lower = bool(re.search(r"skirt|スカート|suso|裾|dress", nm))
|
||
rbs.append(_rb("auto_" + (bones[b]["name"] or str(b)), b, bones[b]["pos"], 1,
|
||
H * (0.02 if lower else 0.012)))
|
||
|
||
# ---- 碰撞体
|
||
n_col = 0
|
||
pos = {k: bones[v]["pos"] for k, v in human_b.items()}
|
||
if "head" in human_b:
|
||
c = pos["head"]
|
||
rbs.append(_rb("auto_col_head", human_b["head"], (c[0], c[1] + H * 0.045, c[2]), 0, H * 0.055))
|
||
n_col += 1
|
||
for k, r in (("upperChest", 0.065), ("chest", 0.065), ("spine", 0.06), ("hips", 0.06)):
|
||
if k in human_b and not (k == "chest" and "upperChest" in human_b):
|
||
rbs.append(_rb("auto_col_" + k, human_b[k], pos[k], 0, H * r))
|
||
n_col += 1
|
||
for a, b in _ARM_SEG + _LEG_SEG:
|
||
if a not in human_b or b not in human_b:
|
||
continue
|
||
p0, p1 = pos[a], pos[b]
|
||
d = [p1[k] - p0[k] for k in range(3)]
|
||
ln = math.sqrt(sum(x * x for x in d))
|
||
if ln < 1e-6:
|
||
continue
|
||
r = H * (0.04 if "UpperLeg" in a else 0.03 if "LowerLeg" in a else 0.028)
|
||
mid = [(p0[k] + p1[k]) / 2 for k in range(3)]
|
||
rbs.append(_rb("auto_col_" + a, human_b[a], mid, 0, r, max(0.0, ln - 2 * r) or ln * 0.5,
|
||
_rot_for_dir(d)))
|
||
n_col += 1
|
||
if log and dyn:
|
||
log("物理:模型不含物理刚体,已按骨骼名和骨架结构自动添加 %d 根摆动骨(头发、裙摆、袖子、飘带、兽耳等)"
|
||
"和 %d 个身体碰撞体" % (len(dyn), n_col))
|
||
if log and ear_dyn:
|
||
log("物理:识别到 %d 根兽耳骨,已加入摆动链" % len(ear_dyn))
|
||
return len(dyn), n_col
|