Files
Black-Cyan 60cce66993
Tests / test (push) Has been cancelled
初始化 VRMify 增强版(VRMify Enhanced)
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
2026-11-15 23:21:59 +08:00

546 lines
22 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""转换好的 VRM 再调整(不用重新转换):预设表情指定和强度、视线范围、SpringBone 参数、标题、缩略图。
import vrm_edit
info = vrm_edit.describe(path) # 界面要的:可选表情、当前预设指定、物理链、标题
vrm_edit.apply(path, edits) # 套用调整,原地改写文件
edits(纯 JSON,界面按源文件存):
{"title": "名字",
"expressions": {"happy": "笑い", "blink": "", ...}, 预设 → 来源表情 id("" = 不设这个预设)
"intensity": {"angry": 0.8, ...}, 预设强度 ×(形态键权重相乘,单个权重最多到 1)
"lookAt": {"h": 15.0, "down": 10.0, "up": 7.0}, 视线最大转角(度):左右 / 向下 / 向上;不给 = 转换时的值
"spring": {"stiffness": 1.0, "drag": 1.0, "gravity": 0.0, 整体:硬度 ×、阻尼 ×、重力 +
"chains": {"链 key": {"stiffness": 1.0, "gravity": 0.0, "off": false}}},
"thumbnails": {"模型名": {"path": "缩略图 PNG 的路径", "auto": true}}}
缩略图按模型分开(一个包里几个模型各用各的):模型名 = 输出 VRM 的文件名去掉扩展名(model_key)。
旧版的 "thumbnail": "路径" 对这个文件的所有模型都有效,没有按模型设置的模型仍然用它。
可重复套用:第一次调整时把原始的表情 / 物理 / meta 存进 glTF 根节点的 extras.vrmconv_base,
以后每次都先还原再套用,不会越调越歪;edits 为空就是还原成转换时的样子。
来源表情 id:转换时给预设表情记了来源 PMX 表情名(extras.source),自定义表情就是它的名字。
"""
import copy
import os
import time
import vrmio
from vrmconv import morphbake
PRESETS_1 = ["happy", "angry", "sad", "relaxed", "surprised", "neutral",
"aa", "ih", "ou", "ee", "oh", "blink", "blinkLeft", "blinkRight",
"lookUp", "lookDown", "lookLeft", "lookRight"]
PRESETS_0 = ["joy", "angry", "sorrow", "fun", "neutral", "a", "i", "u", "e", "o",
"blink", "blink_l", "blink_r", "lookup", "lookdown", "lookleft", "lookright"]
BASE_KEY = "vrmconv_base"
SPRING_DEFAULTS = {"stiffness": 1.0, "gravityPower": 0.0, "dragForce": 0.5}
def _uniq(name, used):
if name not in used:
return name
k = 2
while "%s_%d" % (name, k) in used:
k += 1
return "%s_%d" % (name, k)
def _num(v, default):
try:
v = float(v)
except (TypeError, ValueError):
return default
return v if v == v and abs(v) < 1e6 else default
# ------------------------------------------------------------- baseline --
def _base(g, create):
"""glTF 根 extras 里的原始值;create=True 时没有就现在记下来。"""
ext = g.get("extensions", {})
b = g.get("extras", {}).get(BASE_KEY)
if b is not None or not create:
return b
if "VRMC_vrm" in ext:
v = ext["VRMC_vrm"]
b = {"spec": "1.0", "expressions": copy.deepcopy(v.get("expressions")),
"meta": copy.deepcopy(v["meta"]),
"springBone": copy.deepcopy(ext.get("VRMC_springBone"))}
else:
v = ext["VRM"]
b = {"spec": "0.x", "groups": copy.deepcopy(v.get("blendShapeMaster", {}).get("blendShapeGroups", [])),
"meta": copy.deepcopy(v["meta"])}
b["thumb"] = None
_base_look(b, v)
_base_secondary(b, v)
g.setdefault("extras", {})[BASE_KEY] = b
return b
_LOOK_1 = {"h": ("rangeMapHorizontalInner", "rangeMapHorizontalOuter"), "down": ("rangeMapVerticalDown",),
"up": ("rangeMapVerticalUp",)}
_LOOK_0 = {"h": ("lookAtHorizontalInner", "lookAtHorizontalOuter"), "down": ("lookAtVerticalDown",),
"up": ("lookAtVerticalUp",)}
def _base_look(b, vrm):
"""基准里记下转换时的视线设置(以前调整过、基准里还没有这一项的文件,补记当前的——
那时还没有视线调整,当前值就是转换时的值)。"""
if "look" not in b:
b["look"] = copy.deepcopy(vrm.get("lookAt") if b["spec"] == "1.0" else
{k: vrm.get("firstPerson", {}).get(k) for ks in _LOOK_0.values() for k in ks})
def _base_secondary(b, vrm):
"""0.x 的基准里记下转换时的物理(以前调整过、基准里还没有这一项的文件,补记当前的——
那时还不能调 0.x 的物理,当前值就是转换时的值)。"""
if b["spec"] != "1.0" and "secondary" not in b:
b["secondary"] = copy.deepcopy(vrm.get("secondaryAnimation"))
def _subtree(nodes, roots):
out, stack = [], list(roots)
while stack:
n = stack.pop(0)
if 0 <= n < len(nodes) and n not in out:
out.append(n)
stack[:0] = nodes[n].get("children", [])
return out
def _look_deg(b):
"""基准里的视线最大转角 → {"h", "down", "up"}(度),没有视线设置时 None。"""
look = b.get("look") or {}
out = {}
for k, names in (_LOOK_1 if b["spec"] == "1.0" else _LOOK_0).items():
m = look.get(names[0])
if not m:
return None
out[k] = m.get("outputScale") if b["spec"] == "1.0" else m.get("yRange")
return out
def _apply_look(vrm, b, edits, g=None):
"""视线:先还原转换时的设置,再套用 edits(左右 / 向下 / 向上的最大转角)。
转换时补的视线表情(lookLeft 等,横向场 + 深度场两个绑定,见 morphbake.split_gaze)按新角度重算权重。"""
is1 = b["spec"] == "1.0"
if is1:
if b.get("look") is not None:
vrm["lookAt"] = copy.deepcopy(b["look"])
else:
for k, m in (b.get("look") or {}).items():
if m is not None:
vrm.setdefault("firstPerson", {})[k] = copy.deepcopy(m)
if not edits or _look_deg(b) is None:
return
target = vrm["lookAt"] if is1 else vrm["firstPerson"]
for k, names in (_LOOK_1 if is1 else _LOOK_0).items():
deg = _num(edits.get(k), None)
if deg is None:
continue
deg = min(90.0, max(0.0, deg))
for n in names:
target[n]["outputScale" if is1 else "yRange"] = deg
if g is not None:
_gaze_weights(g, vrm, is1, edits)
def _target_name(g, bind, is1):
"""表情绑定指向的 morph target 名(找不到时 None)。1.0 的 node 是网格节点,0.x 的 mesh 是网格号。"""
try:
m = g["nodes"][bind["node"]]["mesh"] if is1 else bind["mesh"]
names = g["meshes"][m]["extras"]["targetNames"]
return names[bind["index"]] if 0 <= bind["index"] < len(names) else None
except (KeyError, IndexError, TypeError):
return None
def _gaze_weights(g, vrm, is1, edits):
depth = set(morphbake.GAZE_DEPTH.values())
for p, key in morphbake.GAZE_KEY.items():
deg = _num(edits.get(key), None)
if deg is None:
continue
axis = "h" if key == "h" else "v"
wt, wd = morphbake.gaze_weights(deg, axis)
if is1:
obj = (vrm.get("expressions") or {}).get("preset", {}).get(p)
binds = obj and (obj.get("extras") or {}).get("source") == p and obj.get("morphTargetBinds")
scale = 1.0
else:
gr = next((x for x in vrm.get("blendShapeMaster", {}).get("blendShapeGroups", [])
if x.get("name") == p and x.get("presetName") == p.lower()), None)
binds = gr and gr.get("binds")
scale = 100.0
# 只认转换时补的那种:横向场 + 深度场(眼睛分在几个网格里时每个网格各一对)
names = [_target_name(g, bd, is1) for bd in binds or ()]
if not names or None in names or len(set(names)) != 2 or not depth.intersection(names):
continue
for bd, n in zip(binds, names):
bd["weight"] = round((wd if n in depth else wt) * scale, 6)
def _apply_intensity(vrm, is1, edits):
"""预设强度:把预设里的形态键权重乘上系数(单个权重最多到 1 / 100)。材质颜色、贴图偏移不变。"""
for p, f in (edits or {}).items():
f = _num(f, 1.0)
if f == 1.0:
continue
f = max(0.0, f)
if is1:
obj = ((vrm.get("expressions") or {}).get("preset") or {}).get(p)
for bd in (obj or {}).get("morphTargetBinds", []):
bd["weight"] = round(min(1.0, bd["weight"] * f), 4)
else:
for gr in vrm.get("blendShapeMaster", {}).get("blendShapeGroups", []):
if gr.get("presetName") == p:
for bd in gr.get("binds", []):
bd["weight"] = round(min(100.0, bd["weight"] * f), 2)
def _sources_1(expressions):
"""VRM 1.0 原始表情 → (pool {id: 表情}, 预设指定 {预设: id})。"""
pool, assign = {}, {}
for p, obj in ((expressions or {}).get("preset") or {}).items():
sid = (obj.get("extras") or {}).get("source") or "@" + p
if sid in pool:
sid = "@" + p
pool[sid] = obj
assign[p] = sid
for name, obj in ((expressions or {}).get("custom") or {}).items():
pool[_uniq(name, pool)] = obj
return pool, assign
def _sources_0(groups):
pool, assign = {}, {}
for gr in groups:
sid = _uniq(gr.get("name") or "expression", pool)
pool[sid] = gr
p = str(gr.get("presetName") or "unknown").lower()
if p in PRESETS_0 and p not in assign:
assign[p] = sid
return pool, assign
def _chain_keys(springs):
keys, used = [], set()
for i, sp in enumerate(springs or []):
k = _uniq(sp.get("name") or "spring%d" % i, used)
used.add(k)
keys.append(k)
return keys
# 1.0 关节参数名 → 0.x 组参数名(硬度是规范里拼错的 stiffiness)
_FIELDS_0 = {"stiffness": "stiffiness", "gravityPower": "gravityPower", "dragForce": "dragForce"}
def _group_keys(groups):
return _chain_keys([{"name": grp.get("comment")} for grp in groups])
def _label(sid):
return sid[1:] if sid.startswith("@") else sid
# -------------------------------------------------------------- describe --
def describe(path):
"""→ 界面要的信息(都按转换时的原始值,不含已套用的调整)。"""
g, _ = vrmio.read_glb(path)
ext = g.get("extensions", {})
if "VRMC_vrm" not in ext and "VRM" not in ext:
raise ValueError("不是 VRM 文件")
b = _base(g, create=True)
out = {"spec": b["spec"], "springs": []}
if b["spec"] == "1.0":
pool, assign = _sources_1(b["expressions"])
out["presets"] = PRESETS_1
out["title"] = b["meta"].get("name", "")
sb = b.get("springBone") or {}
for k, sp in zip(_chain_keys(sb.get("springs")), sb.get("springs") or []):
out["springs"].append({
"key": k, "name": sp.get("name") or k,
"joints": [{"node": j["node"], **{f: j.get(f, d) for f, d in SPRING_DEFAULTS.items()}}
for j in sp.get("joints", [])]})
else:
pool, assign = _sources_0(b["groups"])
out["presets"] = PRESETS_0
out["title"] = b["meta"].get("title", "")
# 0.x 的一个摆动组 = 界面里的一条链;组根下面整棵子树都是关节,参数整组共用
_base_secondary(b, ext["VRM"])
groups = (b.get("secondary") or {}).get("boneGroups") or []
for k, grp in zip(_group_keys(groups), groups):
par = {f: grp.get(f0, SPRING_DEFAULTS[f]) for f, f0 in _FIELDS_0.items()}
out["springs"].append({
"key": k, "name": grp.get("comment") or k,
"joints": [dict(node=n, **par) for n in _subtree(g["nodes"], grp.get("bones") or [])]})
out["expressions"] = [{"id": sid, "label": _label(sid)} for sid in pool]
out["assign"] = assign
_base_look(b, ext["VRMC_vrm"] if b["spec"] == "1.0" else ext["VRM"])
out["look"] = _look_deg(b) # 转换时的视线最大转角(没有视线设置时 None)
return out
# ----------------------------------------------------------------- apply --
def _apply_expr_1(vrm, base_expr, edits):
pool, assign = _sources_1(base_expr)
for p, sid in (edits or {}).items():
if p in PRESETS_1:
if not sid:
assign.pop(p, None)
elif sid in pool:
assign[p] = sid
preset, custom, used = {}, {}, set(assign.values())
for p in PRESETS_1:
sid = assign.get(p)
if sid:
obj = copy.deepcopy(pool[sid])
if sid.startswith("@"):
obj.pop("extras", None)
else:
obj["extras"] = dict(obj.get("extras") or {}, source=sid)
preset[p] = obj
for sid, obj in pool.items():
if sid in used:
continue
obj = copy.deepcopy(obj)
obj.pop("extras", None)
# 规范:自定义表情名不能和预设名重名
name = _uniq(_label(sid) if not sid.startswith("@") else "orig_" + sid[1:],
set(custom) | set(PRESETS_1))
custom[name] = obj
expressions = {}
if preset:
expressions["preset"] = preset
if custom:
expressions["custom"] = custom
if expressions:
vrm["expressions"] = expressions
else:
vrm.pop("expressions", None)
def _apply_expr_0(vrm, base_groups, edits):
pool, assign = _sources_0(base_groups)
for p, sid in (edits or {}).items():
if p in PRESETS_0:
if not sid:
assign.pop(p, None)
elif sid in pool:
assign[p] = sid
by_sid = {}
for p, sid in assign.items():
by_sid.setdefault(sid, []).append(p)
groups = []
for sid, gr in pool.items():
ps = by_sid.get(sid) or ["unknown"]
for k, p in enumerate(ps): # 一个表情指定给多个预设:复制一份
ng = copy.deepcopy(gr)
ng["presetName"] = p
if k:
ng["name"] = "%s_%s" % (ng.get("name") or sid, p)
groups.append(ng)
vrm.setdefault("blendShapeMaster", {})["blendShapeGroups"] = groups
def _apply_spring(g, base_sb, edits):
ext = g["extensions"]
used = g.setdefault("extensionsUsed", [])
if base_sb is None:
return
sb = copy.deepcopy(base_sb)
if edits:
gs = _num(edits.get("stiffness"), 1.0)
gd = _num(edits.get("drag"), 1.0)
gg = _num(edits.get("gravity"), 0.0)
chains = edits.get("chains") or {}
springs = []
for k, sp in zip(_chain_keys(sb.get("springs")), sb.get("springs") or []):
c = chains.get(k) or {}
if c.get("off"):
continue
cs, cg = _num(c.get("stiffness"), 1.0), _num(c.get("gravity"), 0.0)
for j in sp.get("joints", []):
st = j.get("stiffness", SPRING_DEFAULTS["stiffness"])
gp = j.get("gravityPower", SPRING_DEFAULTS["gravityPower"])
dr = j.get("dragForce", SPRING_DEFAULTS["dragForce"])
j["stiffness"] = round(max(0.0, st * gs * cs), 4)
j["gravityPower"] = round(max(0.0, gp + gg + cg), 4)
j["dragForce"] = round(min(1.0, max(0.0, dr * gd)), 4)
springs.append(sp)
sb["springs"] = springs
if sb.get("springs"):
ext["VRMC_springBone"] = sb
if "VRMC_springBone" not in used:
used.append("VRMC_springBone")
else: # 全部关掉:规范要求 springs 非空,整个扩展去掉
ext.pop("VRMC_springBone", None)
if "VRMC_springBone" in used:
used.remove("VRMC_springBone")
def _apply_secondary(vrm, base_sa, edits):
"""0.x:和 _apply_spring 一样的倍率 / 按链覆盖 / 关闭,作用在每个摆动组的参数上。"""
if base_sa is None:
return
sa = copy.deepcopy(base_sa)
if edits:
gs = _num(edits.get("stiffness"), 1.0)
gd = _num(edits.get("drag"), 1.0)
gg = _num(edits.get("gravity"), 0.0)
chains = edits.get("chains") or {}
groups = []
for k, grp in zip(_group_keys(sa.get("boneGroups") or []), sa.get("boneGroups") or []):
c = chains.get(k) or {}
if c.get("off"):
continue
cs, cg = _num(c.get("stiffness"), 1.0), _num(c.get("gravity"), 0.0)
st = grp.get("stiffiness", SPRING_DEFAULTS["stiffness"])
gp = grp.get("gravityPower", SPRING_DEFAULTS["gravityPower"])
dr = grp.get("dragForce", SPRING_DEFAULTS["dragForce"])
grp["stiffiness"] = round(max(0.0, st * gs * cs), 4)
grp["gravityPower"] = round(max(0.0, gp + gg + cg), 4)
grp["dragForce"] = round(min(1.0, max(0.0, dr * gd)), 4)
groups.append(grp)
sa["boneGroups"] = groups
vrm["secondaryAnimation"] = sa
def _drop_thumb(g, bin_data, thumb):
"""去掉上一次加的缩略图。它总是追加在最后,在末尾时连数据一起截掉。"""
if not thumb:
return bin_data
tex, img, bv = thumb.get("texture"), thumb.get("image"), thumb.get("bufferView")
if tex is not None and tex == len(g.get("textures", [])) - 1:
g["textures"].pop()
if not g["textures"]:
del g["textures"]
if img is not None and img == len(g.get("images", [])) - 1:
g["images"].pop()
if not g["images"]:
del g["images"]
bvs = g.get("bufferViews", [])
if bv is not None and bv == len(bvs) - 1:
v = bvs.pop()
if v.get("byteOffset", 0) + v["byteLength"] >= len(bin_data) - 3:
bin_data = bin_data[:v.get("byteOffset", 0)]
return bin_data
def _add_thumb(g, bin_data, png, is1):
bin_data = bytearray(bin_data)
while len(bin_data) % 4:
bin_data += b"\x00"
off = len(bin_data)
bin_data += png
bvs = g.setdefault("bufferViews", [])
bvs.append({"buffer": 0, "byteOffset": off, "byteLength": len(png)})
imgs = g.setdefault("images", [])
mime = "image/jpeg" if png[:3] == b"\xff\xd8\xff" else "image/png"
imgs.append({"name": "thumbnail", "bufferView": len(bvs) - 1, "mimeType": mime})
thumb = {"bufferView": len(bvs) - 1, "image": len(imgs) - 1, "texture": None}
if not is1: # 0.x 的 meta.texture 是贴图(texture)序号
texs = g.setdefault("textures", [])
if not g.get("samplers"):
g["samplers"] = [vrmio.default_sampler()]
texs.append({"sampler": 0, "source": len(imgs) - 1})
thumb["texture"] = len(texs) - 1
return bytes(bin_data), thumb
def model_key(path):
"""缩略图按模型存的键:VRM 文件名去掉扩展名。"""
return os.path.splitext(os.path.basename(path))[0]
def thumb_for(edits, path):
"""这个 VRM 的缩略图 PNG 路径:按模型设置的,否则旧版对所有模型的那张;没有 → None。"""
t = ((edits or {}).get("thumbnails") or {}).get(model_key(path))
return (t or {}).get("path") or (edits or {}).get("thumbnail") or None
def is_empty(edits):
if not edits:
return True
sp = edits.get("spring") or {}
neutral_spring = (_num(sp.get("stiffness"), 1.0) == 1.0 and _num(sp.get("drag"), 1.0) == 1.0
and _num(sp.get("gravity"), 0.0) == 0.0
and not any(c.get("off") or _num(c.get("stiffness"), 1.0) != 1.0
or _num(c.get("gravity"), 0.0) != 0.0
for c in (sp.get("chains") or {}).values()))
return (not edits.get("title") and not edits.get("expressions") and neutral_spring
and not edits.get("thumbnail") and not edits.get("lookAt")
and not any((t or {}).get("path") for t in (edits.get("thumbnails") or {}).values())
and all(_num(v, 1.0) == 1.0 for v in (edits.get("intensity") or {}).values()))
def apply(path, edits, out_path=None):
"""把 edits 套到 VRM 上(先还原成转换时的样子再套),写到 out_path(默认原地)。返回改了几项。"""
g, bin_data = vrmio.read_glb(path)
ext = g.get("extensions", {})
if "VRMC_vrm" not in ext and "VRM" not in ext:
raise ValueError("不是 VRM 文件")
edits = edits or {}
empty = is_empty(edits)
b = _base(g, create=not empty)
if b is None: # 从没调过、这次也没有调整
if out_path and out_path != path:
vrmio.write_glb(g, bin_data, out_path)
return 0
is1 = b["spec"] == "1.0"
vrm = ext["VRMC_vrm"] if is1 else ext["VRM"]
# ---- 还原
bin_data = _drop_thumb(g, bin_data, b.get("thumb"))
b["thumb"] = None
vrm["meta"] = copy.deepcopy(b["meta"])
n = 0
# ---- 套用
_base_look(b, vrm)
if is1:
_apply_expr_1(vrm, b["expressions"], edits.get("expressions"))
_apply_spring(g, b.get("springBone"), edits.get("spring"))
else:
_apply_expr_0(vrm, b["groups"], edits.get("expressions"))
_base_secondary(b, vrm)
_apply_secondary(vrm, b.get("secondary"), edits.get("spring"))
_apply_intensity(vrm, is1, edits.get("intensity"))
_apply_look(vrm, b, edits.get("lookAt"), g)
n += bool(edits.get("expressions")) + bool(edits.get("spring")) + bool(edits.get("lookAt"))
n += any(_num(v, 1.0) != 1.0 for v in (edits.get("intensity") or {}).values())
if edits.get("title"):
vrm["meta"]["name" if is1 else "title"] = str(edits["title"])
n += 1
thumb = thumb_for(edits, path)
if thumb and os.path.isfile(thumb):
with open(thumb, "rb") as f:
png = f.read()
bin_data, b["thumb"] = _add_thumb(g, bin_data, png, is1)
if is1:
vrm["meta"]["thumbnailImage"] = b["thumb"]["image"]
else:
vrm["meta"]["texture"] = b["thumb"]["texture"]
n += 1
if empty: # 全部还原:不留痕迹
del g["extras"][BASE_KEY]
if not g["extras"]:
del g["extras"]
if g.get("buffers"):
g["buffers"][0]["byteLength"] = len(bin_data)
_write(g, bin_data, out_path or path)
return n
def _write(g, bin_data, path):
tmp = path + ".tmp"
vrmio.write_glb(g, bin_data, tmp)
for k in range(20): # 预览正在读这个文件时 Windows 不让替换,稍等再试
try:
os.replace(tmp, path)
return
except PermissionError:
if k == 19:
raise
time.sleep(0.1)