导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
This commit is contained in:
@@ -0,0 +1,329 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""网格:顶点权重整理、按材质切成 glTF primitive、写 accessor、按表情分成几个网格。"""
|
||||
import heapq
|
||||
import math
|
||||
|
||||
import vrmio
|
||||
|
||||
|
||||
def _weights_of(v, nb, alias):
|
||||
"""一个顶点的 [(PMX 骨, 权重)](见 vertex_weights)。"""
|
||||
wt = v["wtype"]
|
||||
bs = [x for x in v["wbones"] if 0 <= x < nb]
|
||||
if not bs:
|
||||
bs = [0]
|
||||
if wt == 0:
|
||||
return [(alias.get(bs[0], bs[0]), 1.0)]
|
||||
if wt in (1, 3): # BDEF2 / SDEF(SDEF 退化成线性混合)
|
||||
# 和下面的通用算法结果完全相同,只是不建字典、不排序(顶点大多是这种)
|
||||
w0 = v["wweights"][0] if v["wweights"] else 1.0
|
||||
a = alias.get(bs[0], bs[0])
|
||||
b = bs[1] if len(bs) > 1 else bs[0]
|
||||
b = alias.get(b, b)
|
||||
wa, wb = max(0.0, w0), max(0.0, 1.0 - w0)
|
||||
if a == b:
|
||||
tot = wa + wb
|
||||
return [(a, 1.0 if tot <= 1e-9 else tot / tot)]
|
||||
if wb > wa:
|
||||
a, b, wa, wb = b, a, wb, wa
|
||||
tot = wa + wb
|
||||
if tot <= 1e-9:
|
||||
return [(a, 1.0)]
|
||||
return [(a, wa / tot), (b, wb / tot)]
|
||||
# BDEF4 / QDEF
|
||||
ws = list(v["wweights"]) + [0.0] * 4
|
||||
wl = [(bs[k] if k < len(bs) else bs[0], ws[k]) for k in range(4)]
|
||||
if sum(x[1] for x in wl) <= 1e-9:
|
||||
wl = [(bs[0], 1.0)]
|
||||
acc = {}
|
||||
for b_, w in wl:
|
||||
b_ = alias.get(b_, b_)
|
||||
acc[b_] = acc.get(b_, 0.0) + max(0.0, w)
|
||||
wl = sorted(acc.items(), key=lambda x: -x[1])[:4]
|
||||
tot = sum(w for _, w in wl)
|
||||
if tot <= 1e-9:
|
||||
return [(wl[0][0] if wl else bs[0], 1.0)]
|
||||
return [(b_, w / tot) for b_, w in wl]
|
||||
|
||||
|
||||
def vertex_weights(verts, nb, alias, base=None):
|
||||
"""逐顶点 [(PMX 骨, 权重)]:已归一、已按付与别名合并、最多 4 个。
|
||||
|
||||
base:同一批顶点不带别名(alias={})的结果。给了就只重算挂在别名骨上的顶点——网格要带别名的、
|
||||
骨骼表情烘焙要不带的,两份不用各从头算一遍。
|
||||
"""
|
||||
if not nb:
|
||||
return [[(0, 1.0)] for _ in verts]
|
||||
if base is not None and 0 not in alias: # 没有有效骨的顶点算到骨 0 上
|
||||
if not alias:
|
||||
return base
|
||||
keys = set(alias)
|
||||
out = list(base)
|
||||
for i, v in enumerate(verts):
|
||||
if not keys.isdisjoint(v["wbones"]):
|
||||
out[i] = _weights_of(v, nb, alias)
|
||||
return out
|
||||
return [_weights_of(v, nb, alias) for v in verts]
|
||||
|
||||
|
||||
LIMB_PART = {"Shoulder": "肩", "UpperArm": "上臂", "LowerArm": "前臂", "Hand": "手",
|
||||
"UpperLeg": "大腿", "LowerLeg": "小腿", "Foot": "脚", "Toes": "脚趾"}
|
||||
|
||||
|
||||
def mirror_mismatches(verts, raw_weights, vweights, human, min_count=20):
|
||||
"""左右对称位置的顶点绑在四肢的不同部位上(一边大腿、一边小腿之类)→
|
||||
[(顶点对数, 右侧骨, 右侧部位, 左侧骨, 左侧部位)](骨是 PMX 索引,部位是 humanoid 骨位去掉 left / right)。
|
||||
|
||||
多半是模型镜像权重时弄错了:在 MMD 里同样会变形(膝盖一弯,绑在大腿上的鞋子就被扯开),
|
||||
转换器不改模型,只在日志里提示。PMX 坐标里角色的左边是 +X。只算两边都主要(≥ 0.5)挂在
|
||||
四肢的 humanoid 骨上、而且各自几乎不挂对面那个部位(< 0.2)的顶点对,关节处正常的混合权重不算。
|
||||
"""
|
||||
part = {}
|
||||
for s, b in human.items():
|
||||
for side in ("left", "right"):
|
||||
if s.startswith(side):
|
||||
part[b] = s[len(side):]
|
||||
if not part:
|
||||
return []
|
||||
|
||||
def key(x, y, z):
|
||||
return (round(x, 3), round(y, 3), round(z, 3))
|
||||
|
||||
def dom(wl):
|
||||
return max(wl, key=lambda t: t[1])
|
||||
|
||||
def on(wl, p):
|
||||
return sum(w for b, w in wl if part.get(b) == p)
|
||||
|
||||
left = {key(*v["pos"]): i for i, v in enumerate(verts) if v["pos"][0] > 1e-4}
|
||||
groups = {}
|
||||
for i, v in enumerate(verts):
|
||||
x, y, z = v["pos"]
|
||||
if x >= -1e-4:
|
||||
continue
|
||||
j = left.get(key(-x, y, z))
|
||||
if j is None:
|
||||
continue
|
||||
(br, wr), (bl, wl) = dom(vweights[i]), dom(vweights[j])
|
||||
pr, pl = part.get(br), part.get(bl)
|
||||
if not pr or not pl or pr == pl or wr < 0.5 or wl < 0.5:
|
||||
continue
|
||||
if on(vweights[i], pl) >= 0.2 or on(vweights[j], pr) >= 0.2:
|
||||
continue
|
||||
k = (dom(raw_weights[i])[0], pr, dom(raw_weights[j])[0], pl)
|
||||
groups[k] = groups.get(k, 0) + 1
|
||||
return sorted(((n,) + k for k, n in groups.items() if n >= min_count), reverse=True)
|
||||
|
||||
|
||||
def build_primitives(model, xf, xf_dir, vpos, vnrm, vweights, reverse_winding, make_material):
|
||||
"""按 PMX 材质切网格。make_material(PMX 材质号, 材质) → glTF 材质号(只给有面的材质调用)。
|
||||
|
||||
返回 (prims, mat_gidx):prims 每项含 local(PMX 顶点 → 本 primitive 顶点)、顶点数据、
|
||||
索引和 glTF 材质号;mat_gidx:PMX 材质号 → glTF 材质号(0 面的材质不在里面)。
|
||||
"""
|
||||
verts = model["vertices"]
|
||||
faces = model["faces"]
|
||||
prims = []
|
||||
mat_gidx = {}
|
||||
cursor = 0
|
||||
for mi_, mat in enumerate(model["materials"]):
|
||||
cnt = mat["faces"]
|
||||
tri_count = cnt // 3
|
||||
positions, normals, uvs, joints, weights = [], [], [], [], []
|
||||
local = {}
|
||||
idxs = []
|
||||
|
||||
def get_local(vi):
|
||||
j = local.get(vi)
|
||||
if j is not None:
|
||||
return j
|
||||
v = verts[vi]
|
||||
p = xf(vpos[vi])
|
||||
n = xf_dir(vnrm[vi])
|
||||
ln = math.sqrt(n[0] * n[0] + n[1] * n[1] + n[2] * n[2]) or 1.0
|
||||
n = (n[0] / ln, n[1] / ln, n[2] / ln)
|
||||
j = len(positions) // 3
|
||||
local[vi] = j
|
||||
positions.extend(p)
|
||||
normals.extend(n)
|
||||
uvs.extend(v["uv"])
|
||||
# JOINTS_0 的值是「skin.joints 数组的下标」,不是 glTF 节点号!
|
||||
# 这里先写 PMX 骨索引 b,去掉无用节点后由 remap_joints 换成 joints 里的位置。以前错写成节点号 bone_node(b),
|
||||
# 拓扑排序一旦重排骨骼(remap 非恒等)权重就整体串位——
|
||||
# 症状是 Blender 里动某根骨头、别处的顶点跟着跑。
|
||||
wl = list(vweights[vi])
|
||||
while len(wl) < 4:
|
||||
wl.append((wl[0][0], 0.0))
|
||||
joints.extend([b for b, _ in wl[:4]])
|
||||
weights.extend([w for _, w in wl[:4]])
|
||||
return j
|
||||
|
||||
for t in range(tri_count):
|
||||
a = faces[cursor + t * 3]
|
||||
b = faces[cursor + t * 3 + 1]
|
||||
c = faces[cursor + t * 3 + 2]
|
||||
ia, ib, ic = get_local(a), get_local(b), get_local(c)
|
||||
if reverse_winding:
|
||||
ia, ic = ic, ia
|
||||
idxs.extend([ia, ib, ic])
|
||||
cursor += cnt
|
||||
|
||||
if not idxs:
|
||||
continue
|
||||
# 以前 primitive 直接用 PMX 材质号,PMX 里有 0 面材质时
|
||||
# 后面的材质会整体错一位;现在用实际写出的 glTF 材质号
|
||||
mat_gidx[mi_] = make_material(mi_, mat)
|
||||
prims.append({"local": local, "vcount": len(local),
|
||||
"idxs": idxs, "pos": positions, "nrm": normals,
|
||||
"uv": uvs, "jn": joints, "wt": weights,
|
||||
"mat": mat_gidx[mi_], "mat_name": mat.get("name") or "", "tmap": {}})
|
||||
return prims, mat_gidx
|
||||
|
||||
|
||||
def remap_joints(prims, slot):
|
||||
"""JOINTS_0 里的 PMX 骨序号 → skin.joints 里的位置(slot:PMX 骨 → 位置)。
|
||||
|
||||
不在 slot 里的骨(去掉的节点)只会以权重 0 出现(凑满 4 个的占位),换成本顶点第一根骨。
|
||||
"""
|
||||
for pr in prims:
|
||||
jn = pr["jn"]
|
||||
for k in range(0, len(jn), 4):
|
||||
first = slot.get(jn[k], 0)
|
||||
for q in range(k, k + 4):
|
||||
jn[q] = slot.get(jn[q], first)
|
||||
|
||||
|
||||
def write_accessors(gb, prims):
|
||||
"""顶点属性和索引写进 GLB,结果放在 pr["acc"] / pr["indices"]。"""
|
||||
for pr in prims:
|
||||
pr["acc"] = {
|
||||
"POSITION": gb.add_accessor(pr["pos"], vrmio.FLOAT, "VEC3", 34962),
|
||||
"NORMAL": gb.add_accessor(pr["nrm"], vrmio.FLOAT, "VEC3", 34962),
|
||||
"TEXCOORD_0": gb.add_accessor(pr["uv"], vrmio.FLOAT, "VEC2", 34962),
|
||||
"JOINTS_0": gb.add_accessor(pr["jn"], vrmio.UNSIGNED_SHORT,
|
||||
"VEC4", 34962),
|
||||
"WEIGHTS_0": gb.add_accessor(pr["wt"], vrmio.FLOAT, "VEC4", 34962),
|
||||
}
|
||||
pr["indices"] = gb.add_accessor(pr["idxs"], vrmio.UNSIGNED_INT,
|
||||
"SCALAR", 34963, minmax=False)
|
||||
|
||||
|
||||
# 多分一个网格折合多少「顶点 × morph target」:省下的不到这么多(密集存储约 1.2 MB)就不分
|
||||
MESH_COST = 100000
|
||||
MAX_MESHES = 8
|
||||
|
||||
|
||||
def group_meshes(prims, n_targets):
|
||||
"""按表情把 primitive 分成几个网格 → [(primitive 序号列表, 全局 morph target 序号列表)],按首个 primitive 排。
|
||||
|
||||
glTF 要求同一个网格里每个 primitive 带同样的 morph target,读取端(three.js、Unity)又多半按
|
||||
「顶点数 × target 数」展开成密集数组:全塞在一个网格里时,身体、衣服也要陪着脸带上全部表情
|
||||
(13 万顶点 × 180 个表情 ≈ 270 MB)。这里像 VRoid 的 Face / Body / Hair 那样分开:从「target 集合
|
||||
相同的放一起」开始,每次合并代价最小的两组(代价 = 网格顶点数 × target 数),直到再合并多出的
|
||||
比 MESH_COST 多、且网格数不超过 MAX_MESHES。哪个 primitive 都没动到的 target 放进 target 最多的网格,
|
||||
让表情还能引用它。
|
||||
"""
|
||||
by_set = {}
|
||||
for i, pr in enumerate(prims):
|
||||
by_set.setdefault(frozenset(pr["tmap"]), []).append(i)
|
||||
groups = {} # id → [target 集合, 顶点数, primitive 序号]
|
||||
for k, (ts, ids) in enumerate(by_set.items()):
|
||||
groups[k] = [ts, sum(prims[i]["vcount"] for i in ids), ids]
|
||||
|
||||
def extra(a, b):
|
||||
ta, va, _ = groups[a]
|
||||
tb, vb, _ = groups[b]
|
||||
return (va + vb) * len(ta | tb) - va * len(ta) - vb * len(tb)
|
||||
|
||||
heap = [(extra(a, b), a, b) for a in groups for b in groups if a < b]
|
||||
heapq.heapify(heap)
|
||||
nxt = len(groups)
|
||||
while heap and len(groups) > 1:
|
||||
d, a, b = heapq.heappop(heap)
|
||||
if a not in groups or b not in groups:
|
||||
continue
|
||||
if d > MESH_COST and len(groups) <= MAX_MESHES:
|
||||
break
|
||||
ta, va, ia = groups.pop(a)
|
||||
tb, vb, ib = groups.pop(b)
|
||||
groups[nxt] = [ta | tb, va + vb, sorted(ia + ib)]
|
||||
for c in list(groups):
|
||||
if c != nxt:
|
||||
heapq.heappush(heap, (extra(c, nxt), c, nxt))
|
||||
nxt += 1
|
||||
out = sorted(([ids, set(ts)] for ts, _, ids in groups.values()), key=lambda g: g[0][0])
|
||||
used = set().union(*(ts for _, ts in out))
|
||||
orphans = set(range(n_targets)) - used
|
||||
if orphans:
|
||||
max(out, key=lambda g: len(g[1]))[1].update(orphans)
|
||||
return [(ids, sorted(ts)) for ids, ts in out]
|
||||
|
||||
|
||||
def _zero_target(gb, pr, sparse):
|
||||
"""这个 primitive 上的全零 morph target(同一个 primitive 共用一个)。"""
|
||||
if "zero" not in pr:
|
||||
if sparse: # 稀疏 accessor 至少要一项
|
||||
pr["zero"] = gb.add_sparse_accessor(pr["vcount"], [], [], "VEC3")
|
||||
else:
|
||||
pr["zero"] = gb.add_accessor([0.0] * (pr["vcount"] * 3), vrmio.FLOAT, "VEC3", 34962)
|
||||
return pr["zero"]
|
||||
|
||||
|
||||
def build_meshes(gb, prims, groups, target_names, name, sparse=True, prim_names=False):
|
||||
"""group_meshes 的分组 → (glTF meshes, where)。where[全局 target 序号] = [(网格号, 网格内序号)]。
|
||||
|
||||
prim_names:morph target 名也写进每个 primitive 的 extras(VRM 0.x:UniVRM 自己导出时两处都写,
|
||||
老版本的读取端只看 primitive,读不到时 BlendShape 名变成编号)。"""
|
||||
meshes = []
|
||||
where = [[] for _ in target_names]
|
||||
for mi, (ids, slots) in enumerate(groups):
|
||||
m = {"name": name if len(groups) == 1 else _mesh_name(prims, ids, name), "primitives": []}
|
||||
for i in ids:
|
||||
pr = prims[i]
|
||||
p = {"attributes": pr["acc"], "indices": pr["indices"], "material": pr["mat"]}
|
||||
if slots:
|
||||
p["targets"] = [{"POSITION": pr["tmap"][s] if s in pr["tmap"] else _zero_target(gb, pr, sparse)}
|
||||
for s in slots]
|
||||
if prim_names:
|
||||
p["extras"] = {"targetNames": [target_names[s] for s in slots]}
|
||||
m["primitives"].append(p)
|
||||
if slots:
|
||||
m["extras"] = {"targetNames": [target_names[s] for s in slots]}
|
||||
for j, s in enumerate(slots):
|
||||
where[s].append((mi, j))
|
||||
meshes.append(m)
|
||||
used = set()
|
||||
for m in meshes: # 网格名会成为 Unity 里的物体名,别重
|
||||
base, k = m["name"], 2
|
||||
while m["name"] in used:
|
||||
m["name"] = "%s_%d" % (base, k)
|
||||
k += 1
|
||||
used.add(m["name"])
|
||||
return meshes, where
|
||||
|
||||
|
||||
def _mesh_name(prims, ids, name):
|
||||
"""几个网格时按里面最大的 primitive 的材质起名(在 Unity 的层级里一眼能认出是哪一块)。"""
|
||||
big = max(ids, key=lambda i: prims[i]["vcount"])
|
||||
return prims[big].get("mat_name") or name
|
||||
|
||||
|
||||
def remap_binds(expr, where, mesh_nodes, is1):
|
||||
"""表情绑定里的全局 morph target 序号 → 各网格里的(一个 target 分在几个网格时拆成几个绑定)。
|
||||
|
||||
1.0 的 node 是网格节点(mesh_nodes[网格号]),0.x 的 mesh 是网格号。哪个网格都没有的 target
|
||||
(group_meshes 已经避免)就丢掉这个绑定。
|
||||
"""
|
||||
if is1:
|
||||
for grp in (expr["preset"], expr["custom"]):
|
||||
for obj in grp.values():
|
||||
if "morphTargetBinds" not in obj:
|
||||
continue
|
||||
obj["morphTargetBinds"] = [{"node": mesh_nodes[m], "index": j, "weight": b["weight"]}
|
||||
for b in obj["morphTargetBinds"] for m, j in where[b["index"]]]
|
||||
if not obj["morphTargetBinds"]:
|
||||
del obj["morphTargetBinds"]
|
||||
else:
|
||||
for g in expr["blend_groups"]:
|
||||
g["binds"] = [{"mesh": m, "index": j, "weight": b["weight"]}
|
||||
for b in g["binds"] for m, j in where[b["index"]]]
|
||||
Reference in New Issue
Block a user