60cce66993
Tests / test (push) Has been cancelled
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
130 lines
6.7 KiB
Python
130 lines
6.7 KiB
Python
# -*- 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,
|
||
}
|