初始化 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
+129
View File
@@ -0,0 +1,129 @@
# -*- coding: utf-8 -*-
"""VRM 扩展本体:VRM 1.0 的 VRMC_vrm、VRM 0.x 的 VRM(meta / humanoid / firstPerson / lookAt / 表情)。"""
def _look_deg(look):
"""视线最大转角(morphbake.eye_look_range 的结果;没有时左右上下都 10°)。"""
return look or {"lookLeft": 10.0, "lookRight": 10.0, "lookDown": 10.0, "lookUp": 10.0}
def _degmap(xr, yr):
return {"curve": [0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0, 0.0],
"xRange": xr, "yRange": yr}
def _pick(meta, key, allowed, default):
v = meta.get(key)
return v if v in allowed else default
def build_vrm1(meta, title, human, mesh_nodes, expr, look=None):
"""VRMC_vrm。meta:用户给的作者 / 许可等;expr:expressions.build_expressions 的结果;mesh_nodes:网格节点。
默认值和以前一致:谁都可以「扮演」(avatarPermission=everyone,不然有的应用拒绝加载),
其余取保守值(仅个人非商用、禁止再分发和修改、要求署名)——转换的大多是别人的模型,
放宽要由用户在界面里明确选。
"""
author = meta.get("author") or ""
vrm_ext = {
"specVersion": "1.0",
"humanoid": {"humanBones": {k: {"node": v}
for k, v in human.items()}},
"meta": {
"name": title,
"version": meta.get("version") or "1",
"authors": [author] if author else ["unknown"],
"copyrightInformation": meta.get("copyright") or "",
"contactInformation": meta.get("contact") or "",
"thirdPartyLicenses": "",
# thumbnailImage 规范要求是图片索引(整数);没有缩略图就不写,
# 写 null 过不了 VRM 1.0 schema 校验。缩略图由 vrm_edit 写入。
"licenseUrl": meta.get("license_url") or "https://vrm.dev/licenses/1.0/",
"avatarPermission": _pick(meta, "avatar_permission",
("onlyAuthor", "onlySeparatelyLicensedPerson", "everyone"),
"everyone"),
"allowExcessivelyViolentUsage": False,
"allowExcessivelySexualUsage": False,
"commercialUsage": _pick(meta, "commercial_usage",
("personalNonProfit", "personalProfit", "corporation"),
"personalNonProfit"),
"allowPoliticalOrReligiousUsage": False,
"allowAntisocialOrHateUsage": False,
"creditNotation": _pick(meta, "credit_notation", ("required", "unnecessary"), "required"),
"allowRedistribution": bool(meta.get("allow_redistribution", False)),
"modification": _pick(meta, "modification",
("prohibited", "allowModification", "allowModificationRedistribution"),
"prohibited"),
},
"firstPerson": {"meshAnnotations": [{"node": n, "type": "auto"} for n in mesh_nodes]},
}
if expr["preset"] or expr["custom"]:
vrm_ext["expressions"] = {}
if expr["preset"]:
vrm_ext["expressions"]["preset"] = expr["preset"]
if expr["custom"]:
vrm_ext["expressions"]["custom"] = expr["custom"]
if "leftEye" in human or "rightEye" in human:
d = _look_deg(look)
vrm_ext["lookAt"] = {
"type": "bone",
"offsetFromHeadBone": [0.0, 0.06, 0.0],
"rangeMapHorizontalInner": {"inputMaxValue": 90.0, "outputScale": d["lookLeft"]},
"rangeMapHorizontalOuter": {"inputMaxValue": 90.0, "outputScale": d["lookLeft"]},
"rangeMapVerticalDown": {"inputMaxValue": 90.0, "outputScale": d["lookDown"]},
"rangeMapVerticalUp": {"inputMaxValue": 90.0, "outputScale": d["lookUp"]},
}
return vrm_ext
def build_vrm0(meta, title, human, expr, material_props, look=None, n_meshes=1, secondary=None):
"""VRM 0.x 的 VRM 扩展。material_props:materials.MaterialBuilder.props_0x;
secondary:springbone_v0.to_secondary 的结果(没有物理时 None)。"""
return {
"exporterVersion": "VRMify Enhanced",
"specVersion": "0.0",
"meta": {
"title": title,
"version": meta.get("version") or "1",
"author": meta.get("author") or "",
"contactInformation": meta.get("contact") or "",
"reference": "",
"allowedUserName": {"everyone": "Everyone",
"onlySeparatelyLicensedPerson": "ExplicitlyLicensedPerson",
"onlyAuthor": "OnlyAuthor"}.get(
meta.get("avatar_permission"), "Everyone"),
"violentUssageName": "Disallow",
"sexualUssageName": "Disallow",
"commercialUssageName": ("Allow" if meta.get("commercial_usage") in
("personalProfit", "corporation") else "Disallow"),
"otherPermissionUrl": "",
# 0.x 只有 licenseName 这一项能表达再分发:没给许可链接时按「是否允许再分发」选,
# 给了链接就是 Other + 链接(作者 / 改编 / 署名之类的条件写在链接的文档里)
"licenseName": ("Other" if meta.get("license_url") or meta.get("allow_redistribution")
else "Redistribution_Prohibited"),
"otherLicenseUrl": meta.get("license_url") or "",
},
"humanoid": {
"humanBones": [{"bone": k, "node": v, "useDefaultValues": True}
for k, v in human.items()],
"armStretch": 0.05, "legStretch": 0.05,
"upperArmTwist": 0.5, "lowerArmTwist": 0.5,
"upperLegTwist": 0.5, "lowerLegTwist": 0.5,
"feetSpacing": 0.0, "hasTranslationDoF": False,
},
"firstPerson": {
"firstPersonBone": human.get("head", 0),
"firstPersonBoneOffset": {"x": 0.0, "y": 0.06, "z": 0.0},
"meshAnnotations": [{"firstPersonFlag": "Auto", "mesh": k} for k in range(n_meshes)],
"lookAtTypeName": ("Bone" if ("leftEye" in human or
"rightEye" in human)
else "BlendShape"),
"lookAtHorizontalInner": _degmap(90, _look_deg(look)["lookLeft"]),
"lookAtHorizontalOuter": _degmap(90, _look_deg(look)["lookLeft"]),
"lookAtVerticalDown": _degmap(90, _look_deg(look)["lookDown"]),
"lookAtVerticalUp": _degmap(90, _look_deg(look)["lookUp"]),
},
"blendShapeMaster": {"blendShapeGroups": expr["blend_groups"]},
"secondaryAnimation": secondary or {"boneGroups": [], "colliderGroups": []},
"materialProperties": material_props,
}