初始化 VRMify 增强版(VRMify Enhanced)
Tests / test (push) Has been cancelled

导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
This commit is contained in:
2026-11-15 23:21:59 +08:00
commit 60cce66993
114 changed files with 56114 additions and 0 deletions
+545
View File
@@ -0,0 +1,545 @@
# -*- 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)