初始化 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
+191
View File
@@ -0,0 +1,191 @@
# -*- coding: utf-8 -*-
"""合成一个很小的 MMD 人形 PMX,给测试用(仓库里不能放真实模型:模型的许可不允许再分发)。
骨架用 MMD 标准日文骨名(A 姿势的手臂、双眼),每根骨挂一个小方块网格;
头上一条三节的头发链挂物理刚体(→ SpringBone);两张贴图:一张不透明、一张带透明;
几个标准表情(まばたき / あ / にこり / 笑い)和一个材质表情。
eyes=True 时再加:眼珠(挂在左右眼骨上)、骨骼表情「寄り目」、含骨骼表情的グループ「見開く」、
一块漫符面片(独立材质)和移动它 UV 的 UV 表情「怒マーク」。
"""
import math
import os
import sys
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
for _p in ("formats", "convert"):
_d = os.path.join(ROOT, _p)
if _d not in sys.path:
sys.path.insert(0, _d)
import pmxio # noqa: E402
import vrmio # noqa: E402
# 名字, 父骨, 位置(MMD 单位:脸朝 -Z,角色左手在 +X)
_BONES = [
("センター", None, (0, 8, 0)),
("下半身", "センター", (0, 11, 0)),
("上半身", "センター", (0, 11.5, 0)),
("上半身2", "上半身", (0, 13, 0)),
("首", "上半身2", (0, 15.5, 0)),
("頭", "首", (0, 16.5, 0)),
("左目", "頭", (0.35, 17.4, -0.8)),
("右目", "頭", (-0.35, 17.4, -0.8)),
]
for _s, _x in (("左", 1), ("右", -1)):
_BONES += [
(_s + "肩", "上半身2", (0.4 * _x, 15, 0)),
(_s + "腕", _s + "肩", (1.4 * _x, 15, 0)),
(_s + "ひじ", _s + "腕", (3.2 * _x, 13.7, 0)),
(_s + "手首", _s + "ひじ", (4.9 * _x, 12.5, 0)),
(_s + "足", "下半身", (0.9 * _x, 10.5, 0)),
(_s + "ひざ", _s + "足", (0.9 * _x, 6, 0)),
(_s + "足首", _s + "ひざ", (0.9 * _x, 1.2, 0)),
(_s + "つま先", _s + "足首", (0.9 * _x, 0.2, -1.2)),
]
_BONES += [
("髪1", "頭", (0, 17.5, 0.9)),
("髪2", "髪1", (0, 15.6, 1.2)),
("髪3", "髪2", (0, 13.7, 1.4)),
("髪先", "髪3", (0, 11.8, 1.5)),
]
# VRChat 风格的英文骨名(build(english=True))。FBX 导出(fbxout)会把非 ASCII 的名字换成下划线,
# 日文骨名的模型导出成 FBX 后就认不出人形骨架了
EN = {"センター": "Root", "下半身": "Hips", "上半身": "Spine", "上半身2": "Chest", "首": "Neck", "頭": "Head",
"左目": "Eye.L", "右目": "Eye.R", "髪1": "Hair1", "髪2": "Hair2", "髪3": "Hair3"}
for _s, _t in (("左", "L"), ("右", "R")):
EN.update({_s + "肩": "Shoulder." + _t, _s + "腕": "Upper_arm." + _t, _s + "ひじ": "Lower_arm." + _t,
_s + "手首": "Hand." + _t, _s + "足": "Upper_leg." + _t, _s + "ひざ": "Lower_leg." + _t,
_s + "足首": "Foot." + _t, _s + "つま先": "Toe." + _t})
def _png(w, h, alpha):
rows = []
for y in range(h):
r = bytearray()
for x in range(w):
a = 255 if not alpha else (0 if (x // 8 + y // 8) % 2 else 255)
r += bytes(((x * 255) // max(1, w - 1), (y * 255) // max(1, h - 1), 128, a))
rows.append(bytes(r))
return vrmio.encode_png(w, h, rows)
def _box(model, center, half, bone):
"""以 center 为中心、半边长 half 的方块,权重全给 bone。返回三角形索引(从外面看顺时针,MMD 的正面)。"""
v0 = len(model["vertices"])
cx, cy, cz = center
for k in range(8):
dx = half if k & 1 else -half
dy = half if k & 2 else -half
dz = half if k & 4 else -half
n = math.sqrt(3)
model["vertices"].append({
"pos": (cx + dx, cy + dy, cz + dz), "normal": (dx / half / n, dy / half / n, dz / half / n),
"uv": ((dx / half + 1) / 2, (dy / half + 1) / 2), "wtype": 0, "wbones": [bone],
"wweights": [1.0], "edge": 1.0})
quads = [(0, 2, 3, 1), (4, 5, 7, 6), (0, 1, 5, 4), (2, 6, 7, 3), (0, 4, 6, 2), (1, 3, 7, 5)]
tris = []
for a, b, c, d in quads:
tris += [v0 + a, v0 + b, v0 + c, v0 + a, v0 + c, v0 + d]
return tris
def _material(name, tex, faces, toon=-1):
return {"name": name, "name_en": name, "diffuse": (1.0, 1.0, 1.0, 1.0), "specular": (0, 0, 0),
"shininess": 5.0, "ambient": (0.5, 0.5, 0.5), "flag": 0x01 | 0x02 | 0x04 | 0x10,
"edge_color": (0, 0, 0, 1), "edge_size": 1.0, "tex": tex, "sph": -1, "sph_mode": 0,
"toon_flag": 1 if toon >= 0 else 0, "toon": toon, "memo": "", "faces": faces}
def build(folder, name="合成モデル", tex_size=256, eyes=False, english=False):
"""在 folder 里写出 <name>.pmx 和贴图,返回 PMX 路径。english:骨名换成英文(见 EN)。"""
os.makedirs(os.path.join(folder, "tex"), exist_ok=True)
with open(os.path.join(folder, "tex", "body.png"), "wb") as f:
f.write(_png(tex_size, tex_size, alpha=False))
with open(os.path.join(folder, "tex", "hair.png"), "wb") as f:
f.write(_png(64, 64, alpha=True))
m = pmxio.new_model(name)
m["textures"] = ["tex\\body.png", "tex\\hair.png"]
index = {n: i for i, (n, _, _) in enumerate(_BONES)}
for i, (n, parent, pos) in enumerate(_BONES):
flag = 0x0001 | 0x0002 | 0x0008 | 0x0010
if n == "センター":
flag |= 0x0004
m["bones"].append({"name": n, "name_en": n, "pos": pos, "parent": index[parent] if parent else -1,
"layer": 0, "flag": flag, "tail": -1})
for n, _, _ in _BONES: # tail:第一个子骨
kids = [index[c] for c, p, _ in _BONES if p == n]
if kids:
m["bones"][index[n]]["tail"] = kids[0]
body, hair = [], []
for n, _, pos in _BONES:
if n.startswith("髪"):
hair += _box(m, pos, 0.35, index[n])
elif not n.endswith("目"):
body += _box(m, pos, 0.5 if n != "頭" else 1.0, index[n])
m["faces"] = body + hair
m["materials"] = [_material("体", 0, len(body), toon=1), _material("髪", 1, len(hair))]
if eyes:
eye = []
for n in ("左目", "右目"):
x, y, z = _BONES[index[n]][2]
eye += _box(m, (x, y, z - 0.25), 0.12, index[n]) # 眼骨在眼珠后面
v0 = len(m["vertices"])
for k, (dx, dy) in enumerate(((0, 0), (1, 0), (1, 1), (0, 1))):
m["vertices"].append({"pos": (0.6 + dx * 0.4, 18 + dy * 0.4, -1.05), "normal": (0, 0, -1),
"uv": (dx * 0.25, dy * 0.25), "wtype": 0, "wbones": [index["頭"]],
"wweights": [1.0], "edge": 0.0})
emo = [v0, v0 + 1, v0 + 2, v0, v0 + 2, v0 + 3]
m["faces"] += eye + emo
m["materials"] += [_material("目", 0, len(eye)), _material("漫符", 1, len(emo))]
# 表情:动头部方块(「頭」是第 6 根有网格的骨 → 第 6 个方块)
hv = 5 * 8
m["morphs"] = [
{"name": "まばたき", "name_en": "blink", "panel": 1, "kind": 1,
"offsets": [(hv + k, (0.0, -0.2, 0.0)) for k in range(4)]},
{"name": "あ", "name_en": "a", "panel": 2, "kind": 1,
"offsets": [(hv + k, (0.0, -0.3, 0.0)) for k in range(2)]},
{"name": "にこり", "name_en": "smile", "panel": 3, "kind": 1,
"offsets": [(hv + k, (0.1, 0.1, 0.0)) for k in range(4, 8)]},
{"name": "笑い", "name_en": "laugh", "panel": 3, "kind": 1,
"offsets": [(hv + k, (0.2, 0.0, 0.0)) for k in range(4, 8)]},
{"name": "照れ", "name_en": "blush", "panel": 4, "kind": 8,
"offsets": [(0, 0, (1, 0.8, 0.8, 1) + (1,) * 24)]},
]
if eyes:
s = math.sin(math.radians(5))
c = math.cos(math.radians(5))
m["morphs"] += [
# 两眼往中间转 10°(PMX 四元数 x, y, z, w;左眼在 +X,绕 Y 转正角朝 -X)
{"name": "寄り目", "name_en": "cross", "panel": 2, "kind": 2,
"offsets": [(index["左目"], (0, 0, 0), (0, s, 0, c)), (index["右目"], (0, 0, 0), (0, -s, 0, c))]},
{"name": "見開く", "name_en": "wide", "panel": 2, "kind": 0,
"offsets": [(0, -0.5), (5, 1.0)]}, # まばたき × -0.5 + 寄り目
# 漫符面片的 UV 整体移到贴图右边一格
{"name": "怒マーク", "name_en": "anger", "panel": 4, "kind": 3,
"offsets": [(v0 + k, (0.5, 0.25, 0, 0)) for k in range(4)]},
]
# 物理:頭(跟随骨骼)+ 头发三节(物理)
def rb(nm, bone, pos, mode, r=0.6):
return {"name": nm, "name_en": nm, "bone": index[bone], "group": 1 if mode else 0,
"mask": 0xFFFF & ~(1 << 1), "shape": 0, "size": (r, 0, 0), "pos": pos, "rot": (0, 0, 0),
"mass": 1.0, "move_damp": 0.5, "rot_damp": 0.5, "repulsion": 0.0, "friction": 0.5,
"mode": mode}
m["rigid_bodies"] = [rb("頭", "頭", (0, 17.2, 0), 0, 1.6), rb("髪1", "髪1", (0, 16.5, 1.0), 0),
rb("髪2", "髪2", (0, 14.6, 1.3), 1), rb("髪3", "髪3", (0, 12.7, 1.45), 1)]
def joint(nm, a, b, pos):
return {"name": nm, "name_en": nm, "type": 0, "rb_a": a, "rb_b": b, "pos": pos, "rot": (0, 0, 0),
"move_min": (0, 0, 0), "move_max": (0, 0, 0), "rot_min": (-0.5, -0.5, -0.5),
"rot_max": (0.5, 0.5, 0.5), "spring_move": (0, 0, 0), "spring_rot": (10, 10, 10)}
m["joints"] = [joint("髪1-2", 1, 2, (0, 15.6, 1.2)), joint("髪2-3", 2, 3, (0, 13.7, 1.4))]
if english:
for b in m["bones"]:
b["name"] = b["name_en"] = EN.get(b["name"], b["name"])
path = os.path.join(folder, name + ".pmx")
pmxio.write_pmx(m, path)
return path
+594
View File
@@ -0,0 +1,594 @@
# -*- coding: utf-8 -*-
"""界面启动的兜底逻辑:数据目录写不了时改放 %APPDATA%,没有 WebView2 / 窗口起不来时改用浏览器。"""
import json
import os
import re
import sys
import tempfile
import types
import unittest
from unittest import mock
HERE = os.path.dirname(os.path.abspath(__file__))
UI = os.path.join(os.path.dirname(HERE), "ui")
if UI not in sys.path:
sys.path.insert(0, UI)
os.environ.setdefault("VRMIFY_DATA", tempfile.mkdtemp(prefix="m2v_data_"))
import app # noqa: E402
import server # noqa: E402
import logtext # noqa: E402,I100
import version # noqa: E402
class VersionTest(unittest.TestCase):
def test_semver(self):
self.assertRegex(version.__version__, r"^\d+\.\d+\.\d+$")
class DataDirTest(unittest.TestCase):
def test_env_override(self):
with mock.patch.dict(os.environ, {"VRMIFY_DATA": "X:/somewhere"}):
self.assertEqual(server._data_dir(), "X:/somewhere")
def test_beside_program(self):
env = {k: v for k, v in os.environ.items() if k != "VRMIFY_DATA"}
with mock.patch.dict(os.environ, env, clear=True), mock.patch.object(server, "_writable", lambda d: True):
self.assertEqual(server._data_dir(), server.ROOT)
def test_fallback_to_appdata(self):
env = {k: v for k, v in os.environ.items() if k != "VRMIFY_DATA"}
env["APPDATA"] = "Y:/AppData/Roaming"
with mock.patch.dict(os.environ, env, clear=True), mock.patch.object(server, "_writable", lambda d: False):
self.assertEqual(server._data_dir(), os.path.join("Y:/AppData/Roaming", "VRMify"))
def test_appdata_renamed_from_old_name(self):
"""改名前的 %APPDATA%\\Model-To-VRM 还在、新的没有时改名过去,里面的设置跟着走。"""
base = tempfile.mkdtemp(prefix="m2v_appdata_")
os.makedirs(os.path.join(base, "Model-To-VRM"))
open(os.path.join(base, "Model-To-VRM", "settings.json"), "w").close()
env = {k: v for k, v in os.environ.items() if k != "VRMIFY_DATA"}
env["APPDATA"] = base
with mock.patch.dict(os.environ, env, clear=True), mock.patch.object(server, "_writable", lambda d: False):
self.assertEqual(server._data_dir(), os.path.join(base, "VRMify"))
self.assertTrue(os.path.isfile(os.path.join(base, "VRMify", "settings.json")))
self.assertFalse(os.path.exists(os.path.join(base, "Model-To-VRM")))
def test_writable(self):
self.assertTrue(server._writable(tempfile.mkdtemp(prefix="m2v_w_")))
class OutputDefaultTest(unittest.TestCase):
"""界面默认保存到程序目录下的 vrm;旧设置文件里是旧默认值(源文件旁)的换成新默认。"""
def load(self, saved):
path = os.path.join(tempfile.mkdtemp(prefix="m2v_set_"), "settings.json")
if saved is not None:
with open(path, "w", encoding="utf-8") as f:
json.dump(saved, f)
with mock.patch.object(server, "SETTINGS", path):
return server.Backend._load_settings(None)[0]["output"]
def test_fresh(self):
self.assertEqual(self.load(None)["mode"], "app")
def test_old_default_migrates(self):
old = {"opts": {"output": {"mode": "beside", "folder": "", "subfolder": True}}}
self.assertEqual(self.load(old)["mode"], "app")
def test_own_choice_kept(self):
mine = {"opts": {"output": {"mode": "folder", "folder": "D:/out", "subfolder": True}}}
self.assertEqual(self.load(mine)["mode"], "folder")
# 新版存过的「源文件旁」是自己选的
self.assertEqual(self.load({"v": 2, "opts": {"output": {"mode": "beside", "folder": "", "subfolder": True}}})["mode"],
"beside")
def test_app_folder_used(self):
import pipeline
out = tempfile.mkdtemp(prefix="m2v_app_")
opts = pipeline.merged({"output": {"mode": "app", "app_folder": out, "subfolder": False}})
self.assertEqual(pipeline.output_dir("X:/models/a.pmx", opts), out)
opts["output"].pop("app_folder") # 没给路径(命令行)时同「源文件旁」
self.assertEqual(pipeline.output_dir(os.path.join(out, "a.pmx"), opts), out)
class LayoutTest(unittest.TestCase):
"""拖动调的栏宽存进 settings.json:只收认识的键、夹在范围里;传 None 是恢复默认。"""
def test_widths_saved_and_clamped(self):
path = os.path.join(tempfile.mkdtemp(prefix="m2v_ui_"), "settings.json")
with mock.patch.object(server, "SETTINGS", path):
b = server.Backend.__new__(server.Backend)
b.lock = __import__("threading").RLock()
b.opts, b.lang, b.ui = server.Backend._load_settings(None)
self.assertEqual(b.ui, {})
b.set_options(ui={"left": 520.6, "side": 50, "bogus": 3, "sideWide": "x"})
self.assertEqual(b.ui, {"left": 520, "side": 220})
b.set_options(ui={"sideWide": 400})
b.set_options(ui={"left": None})
self.assertEqual(server.Backend._load_settings(None)[2], {"side": 220, "sideWide": 400})
class SkippedStatusTest(unittest.TestCase):
"""文件里的模型全被「只转换人物」跳过:状态是「已跳过」不是「完成」;关掉这个选项后回到「待转换」。"""
def test_skipped(self):
tmp = tempfile.mkdtemp(prefix="m2v_skip_")
prop = os.path.join(tmp, "剑.pmx")
with open(prop, "wb") as f:
f.write(b"PMX ")
with mock.patch.object(server, "SETTINGS", os.path.join(tmp, "settings.json")), \
mock.patch.object(server, "EDITS", os.path.join(tmp, "edits.json")):
b = server.Backend()
try:
b.add_paths([prop])
fid = next(iter(b.files))
with mock.patch.object(server.pipeline, "convert_file", return_value=[]):
b._run([fid], b.opts)
self.assertEqual(b.files[fid]["status"], "skipped")
end = [e for _, e in b.events if e["type"] == "busy" and not e["busy"]][-1]
self.assertEqual((end["done"], end["skipped"], end["failed"]), (0, 1, 0))
b.set_options(dict(b.opts, vrm=dict(b.opts["vrm"], avatar_only=False)))
self.assertEqual(b.files[fid]["status"], "pending")
finally:
b.close()
class PreviewCacheTest(unittest.TestCase):
"""还没转换的文件(压缩包、FBX …)预览时先转一份临时 VRM:换了转换设置要重新转,同样的设置用缓存,
连点不重复转,转的途中又换了设置时旧的那份不推给页面,每个文件只留最近几份。"""
def setUp(self):
import threading
self.tmp = tempfile.mkdtemp(prefix="m2v_pv_")
src = os.path.join(self.tmp, "a.fbx")
with open(src, "wb") as f:
f.write(b"Kaydara FBX Binary")
self.patches = [mock.patch.object(server, "SETTINGS", os.path.join(self.tmp, "settings.json")),
mock.patch.object(server, "EDITS", os.path.join(self.tmp, "edits.json")),
mock.patch.object(server.pipeline, "convert_file", self.fake)]
for p in self.patches:
p.start()
self.calls, self.gate = [], threading.Event()
self.gate.set()
self.b = server.Backend()
self.b.add_paths([src])
self.fid = next(iter(self.b.files))
def tearDown(self):
self.gate.set()
self.b.close()
for p in self.patches:
p.stop()
def fake(self, src, opts, log=None, out_dir=None, edits=None):
self.gate.wait(10)
self.calls.append((opts["vrm"]["spec"], opts["vrm"]["spring_stiffness"]))
p = os.path.join(out_dir, "a.vrm")
with open(p, "wb") as f:
f.write(b"glTF")
return [p]
def wait(self):
import time
for _ in range(500):
with self.b.lock:
if not self.b.preview_jobs:
return
time.sleep(0.01)
self.fail("preview conversion did not finish")
def setopt(self, **vrm):
self.b.set_options(dict(self.b.opts, vrm=dict(self.b.opts["vrm"], **vrm)))
def shown(self):
"""推给页面的预览事件个数。"""
return len([e for _, e in self.b.events if e["type"] == "preview" and e.get("url")])
def test_settings_change_reconverts(self):
self.assertEqual(self.b.preview(self.fid), {"pending": True})
self.wait()
self.assertIn("url", self.b.preview(self.fid)) # 同样的设置:直接用缓存
self.assertEqual(self.calls, [("1.0", 1.0)])
self.setopt(spec="0.x")
self.assertEqual(self.b.preview(self.fid), {"pending": True}) # 换了版本:重新转
self.wait()
self.assertEqual(self.calls[-1], ("0.x", 1.0))
self.setopt(spec="1.0")
self.assertIn("url", self.b.preview(self.fid)) # 改回来:之前那份还在
self.assertEqual(len(self.calls), 2)
# 只改输出位置不算换设置
self.b.set_options(dict(self.b.opts, output={"mode": "folder", "folder": self.tmp, "subfolder": False}))
self.assertIn("url", self.b.preview(self.fid))
def test_no_duplicate_job(self):
self.gate.clear()
self.assertEqual(self.b.preview(self.fid), {"pending": True})
self.assertEqual(self.b.preview(self.fid), {"pending": True})
self.gate.set()
self.wait()
self.assertEqual(len(self.calls), 1)
self.assertEqual(self.shown(), 1)
def test_superseded_job_not_shown(self):
self.gate.clear()
self.b.preview(self.fid) # 1.0,还在转
self.setopt(spec="0.x")
self.b.preview(self.fid) # 用户换成 0.x 又点了预览
self.gate.set()
self.wait()
self.assertEqual(sorted(c[0] for c in self.calls), ["0.x", "1.0"])
self.assertEqual(self.shown(), 1) # 只推 0.x 那份
f = self.b.files[self.fid]
want = f["previews"][f["preview_want"]]
self.assertEqual(f["preview_path"], want[1])
def test_old_previews_removed(self):
dirs = []
for k in range(5):
self.setopt(spring_stiffness=1.0 + k)
self.b.preview(self.fid)
self.wait()
dirs.append(os.path.dirname(self.b.files[self.fid]["preview_path"]))
cache = self.b.files[self.fid]["previews"]
self.assertEqual(len(cache), server._PREVIEW_KEEP)
self.assertEqual([os.path.isdir(d) for d in dirs], [False, False, True, True, True])
class AutoThumbTest(unittest.TestCase):
"""转换后自动生成的缩略图:记成 auto;手动设置过的不覆盖;不算「调整过」;关掉选项后转换不再带上。"""
def test_auto_vs_manual(self):
import base64
sys.path[:0] = [os.path.join(os.path.dirname(HERE), p) for p in ("convert", "formats")] + [HERE]
import pmx2vrm
import synth
import vrmio
tmp = tempfile.mkdtemp(prefix="m2v_thumb_")
pmx = synth.build(os.path.join(tmp, "src"))
vrm = os.path.join(tmp, "out.vrm")
pmx2vrm.convert(pmx, vrm)
png = "data:image/png;base64," + base64.b64encode(vrmio.encode_png(2, 2, [b"\xff" * 8] * 2)).decode()
with mock.patch.object(server, "SETTINGS", os.path.join(tmp, "settings.json")), \
mock.patch.object(server, "EDITS", os.path.join(tmp, "edits.json")), \
mock.patch.object(server, "EDITS_DIR", os.path.join(tmp, "edits")):
b = server.Backend()
try:
b.add_paths([pmx])
fid = next(iter(b.files))
f = b.files[fid]
f.update(status="done", outputs=b._outputs([vrm]))
def meta_thumb():
return vrmio.read_glb(vrm)[0]["extensions"]["VRMC_vrm"]["meta"].get("thumbnailImage")
self.assertTrue(b.tune_thumb(fid, png, auto=True)["ok"])
self.assertTrue(b.edits_for(f)["thumbnails"]["out"]["auto"]) # 按模型(VRM 文件名)存
self.assertIsNotNone(meta_thumb())
self.assertFalse(b._entry(f)["tuned"]) # 只有自动缩略图:不算调整过
b.tune_save(fid, {"title": "名前"}) # 调整面板保存:缩略图和标记都留着
self.assertTrue(b.edits_for(f)["thumbnails"]["out"]["auto"])
self.assertIsNotNone(meta_thumb())
b.set_options(dict(b.opts, vrm=dict(b.opts["vrm"], auto_thumb=False)))
self.assertNotIn("thumbnails", b._convert_edits(f)) # 关掉后转换不再套用自动截的
self.assertEqual(b._convert_edits(f)["title"], "名前")
self.assertTrue(b.tune_thumb(fid, png)["ok"]) # 手动设置:去掉标记
self.assertFalse(b.edits_for(f)["thumbnails"]["out"]["auto"])
self.assertTrue(b.tune_thumb(fid, png, auto=True)["skipped"])
self.assertIn("thumbnails", b._convert_edits(f))
finally:
b.close()
def test_per_model(self):
"""一个包里几个模型:缩略图各存各的、只写进自己的 VRM;旧版按文件存的那张分给各个模型。"""
import base64
sys.path[:0] = [os.path.join(os.path.dirname(HERE), p) for p in ("convert", "formats")] + [HERE]
import pmx2vrm
import synth
import vrm_edit
import vrmio
tmp = tempfile.mkdtemp(prefix="m2v_thumbs_")
pmx = synth.build(os.path.join(tmp, "src"))
vrms = [os.path.join(tmp, n + ".vrm") for n in ("a", "b")]
for v in vrms:
pmx2vrm.convert(pmx, v)
def png(c):
return "data:image/png;base64," + base64.b64encode(vrmio.encode_png(2, 2, [bytes([c]) * 8] * 2)).decode()
def thumb(v):
g, bin_data = vrmio.read_glb(v)
i = g["extensions"]["VRMC_vrm"]["meta"].get("thumbnailImage")
if i is None:
return None
bv = g["bufferViews"][g["images"][i]["bufferView"]]
return bin_data[bv.get("byteOffset", 0):bv.get("byteOffset", 0) + bv["byteLength"]]
with mock.patch.object(server, "SETTINGS", os.path.join(tmp, "settings.json")), mock.patch.object(server, "EDITS", os.path.join(tmp, "edits.json")), mock.patch.object(server, "EDITS_DIR", os.path.join(tmp, "edits")):
b = server.Backend()
try:
b.add_paths([pmx])
fid = next(iter(b.files))
f = b.files[fid]
f.update(status="done", outputs=b._outputs(vrms))
self.assertTrue(b.tune_thumb(fid, png(0x10), auto=True, model="a")["ok"])
self.assertIsNotNone(thumb(vrms[0]))
self.assertIsNone(thumb(vrms[1])) # 只写进 a
self.assertTrue(b.tune_thumb(fid, png(0x20), auto=True, model="b")["ok"])
self.assertNotEqual(thumb(vrms[0]), thumb(vrms[1]))
self.assertEqual(b.tune_info(fid, "b")["model"], "b")
self.assertTrue(b.tune_info(fid, "b")["thumbnail_auto"])
b.tune_thumb(fid, png(0x30), model="a") # 手动设置 a:a 不再自动更新,b 照常
self.assertTrue(b.tune_thumb(fid, png(0x40), auto=True, model="a")["skipped"])
self.assertTrue(b.tune_thumb(fid, png(0x50), auto=True, model="b")["ok"])
b.tune_thumb(fid, "", model="b") # 去掉 b 的,a 的留着
self.assertIsNone(thumb(vrms[1]))
self.assertIsNotNone(thumb(vrms[0]))
# 旧版:一张对所有模型;给 a 单独设置后 b 仍用旧的那张
old = os.path.join(tmp, "old.png")
with open(old, "wb") as fh:
fh.write(base64.b64decode(png(0x60).split(",", 1)[1]))
b.edits[b._key(f)] = {"thumbnail": old}
self.assertEqual(vrm_edit.thumb_for(b.edits_for(f), vrms[1]), old)
b.tune_thumb(fid, png(0x70), model="a")
e = b.edits_for(f)
self.assertNotIn("thumbnail", e)
self.assertEqual(e["thumbnails"]["b"]["path"], old)
self.assertNotEqual(e["thumbnails"]["a"]["path"], old)
finally:
b.close()
class LanguageTest(unittest.TestCase):
"""界面语言:没选过时跟系统;日志事件带英文版(convert/logtext.py)。"""
def test_default_follows_the_system(self):
tmp = tempfile.mkdtemp(prefix="m2v_lang_")
settings = os.path.join(tmp, "settings.json")
with mock.patch.object(server, "SETTINGS", settings), \
mock.patch.object(server, "EDITS", os.path.join(tmp, "edits.json")):
for sys_lang in ("en", "zh_CN"):
with mock.patch.object(server, "system_lang", return_value=sys_lang):
b = server.Backend()
try:
self.assertEqual(b.lang, sys_lang)
finally:
b.close()
with open(settings, "w", encoding="utf-8") as f:
json.dump({"v": 2, "lang": "zh_CN"}, f)
with mock.patch.object(server, "system_lang", return_value="en"):
b = server.Backend()
try:
self.assertEqual(b.lang, "zh_CN") # 选过的不变
finally:
b.close()
self.assertIn(server.system_lang(), server.LANGS)
def test_log_events_carry_english(self):
tmp = tempfile.mkdtemp(prefix="m2v_lang_")
with mock.patch.object(server, "SETTINGS", os.path.join(tmp, "settings.json")), \
mock.patch.object(server, "EDITS", os.path.join(tmp, "edits.json")):
b = server.Backend()
try:
b.log("完成,用时 1.5 秒", "ok")
b.log("没有对照的一句")
ev = [e for _, e in b.events if e["type"] == "log"][-2:]
self.assertEqual(ev[0]["en"], "Done in 1.5 s")
self.assertIsNone(ev[1]["en"])
finally:
b.close()
class StalePreviewTest(unittest.TestCase):
def test_sweep(self):
"""启动时删一天以前遗留的预览临时目录,新的不动。"""
root = tempfile.mkdtemp(prefix="m2v_tmproot_")
old, new, other = (os.path.join(root, n) for n in ("model2vrm_preview_old", "vrmify_preview_new", "keep_me"))
for d in (old, new, other):
os.makedirs(os.path.join(d, "sub"))
past = 1_000_000_000
for d in (old, other):
os.utime(os.path.join(d, "sub"), (past, past))
os.utime(d, (past, past))
with mock.patch.object(server.tempfile, "gettempdir", lambda: root):
server._sweep_stale_previews()
self.assertFalse(os.path.exists(old))
self.assertTrue(os.path.exists(new))
self.assertTrue(os.path.exists(other))
class WindowFallbackTest(unittest.TestCase):
"""pywebview 换成假模块,_browser_loop 换成记录调用,看 main() 走哪条路。"""
def run_main(self, webview2, start_error=None, loader=None):
"""webview2:注册表检测的结果;loader:WebView2 加载器报的版本(None = 没有)。→ (_browser_loop 的调用, backend, 假模块)"""
fake = types.ModuleType("webview")
fake.settings = {"WEBVIEW2_RUNTIME_PATH": None}
fake.create_window = lambda *a, **k: types.SimpleNamespace()
def start(cb=None, **kw):
if start_error:
raise start_error
fake.start = start
calls, made = [], []
real_serve = server.serve
def serve(port=0):
r = real_serve(port)
made.append(r[0])
return r
with mock.patch.dict(sys.modules, {"webview": fake}), mock.patch.object(app, "_webview2_ok", lambda: webview2), mock.patch.object(app, "_webview2_loader_version", lambda: loader), mock.patch.object(server, "serve", serve), mock.patch.object(app, "_browser_loop", lambda *a: calls.append(a)):
app.main(["--port", "0"])
return calls, made[0], fake
def test_window(self):
calls, b, fake = self.run_main(webview2=True)
self.assertEqual(calls, [])
self.assertIsNone(b.mode_note)
self.assertIsNone(fake.settings["WEBVIEW2_RUNTIME_PATH"])
def test_no_webview2(self):
calls, b, _ = self.run_main(webview2=False)
self.assertEqual(len(calls), 1)
self.assertTrue(calls[0][2]) # 打开浏览器
self.assertEqual(b.mode_note["kind"], "no_webview2")
self.assertEqual(b.state()["mode_note"]["kind"], "no_webview2")
with open(b.mode_note["log"], encoding="utf-8") as f:
self.assertIn("WebView2", f.read()) # 原因也写进 startup.log
def test_registry_misses_but_loader_finds(self):
"""注册表里没有记录、加载器却查到运行时(精简过的系统):照常开窗口,告诉 pywebview 用 WebView2。"""
calls, b, fake = self.run_main(webview2=False, loader="120.0.1.2")
self.assertEqual(calls, [])
self.assertIsNone(b.mode_note)
self.assertTrue(fake.settings["WEBVIEW2_RUNTIME_PATH"])
def test_window_fails(self):
calls, b, _ = self.run_main(webview2=True, start_error=RuntimeError("boom"))
self.assertEqual(len(calls), 1)
self.assertTrue(calls[0][2])
self.assertEqual(b.mode_note["kind"], "window_failed")
self.assertIn("boom", b.mode_note["zh"])
with open(b.mode_note["log"], encoding="utf-8") as f:
self.assertIn("Traceback", f.read())
def test_webview2_check_runs(self):
self.assertIsInstance(app._webview2_ok(), bool)
class ModelRouteTest(unittest.TestCase):
"""/model/<token>/<相对路径>:PMX 原生预览读模型和贴图的接口。"""
@classmethod
def setUpClass(cls):
cls.backend, cls.srv, cls.url = server.serve(0)
cls.tmp = tempfile.mkdtemp(prefix="m2v_route_")
cls.folder = os.path.join(cls.tmp, "模型")
os.makedirs(os.path.join(cls.folder, "tex"))
with open(os.path.join(cls.folder, "a.pmx"), "wb") as f:
f.write(b"PMX " + bytes([0, 0, 0, 64]))
with open(os.path.join(cls.folder, "tex", "s.spa"), "wb") as f:
f.write(b"BM" + bytes(60))
with open(os.path.join(cls.tmp, "secret.txt"), "w") as f:
f.write("outside")
try:
from PIL import Image
Image.new("RGB", (4, 4), (255, 0, 0)).save(os.path.join(cls.folder, "tex", "c.dds"))
cls.dds = True
except Exception: # noqa: BLE001
cls.dds = False
cls.base = cls.url.rstrip("/") + cls.backend.dir_url(os.path.join(cls.folder, "a.pmx")).rsplit("/", 1)[0]
@classmethod
def tearDownClass(cls):
cls.srv.shutdown()
cls.srv.server_close()
cls.backend.close()
def get(self, path):
import urllib.error
import urllib.request
try:
with urllib.request.urlopen(self.base + "/" + path) as r:
return r.status, r.headers.get("Content-Type"), r.read()
except urllib.error.HTTPError as e:
e.close()
return e.code, None, b""
def test_files(self):
st, ct, data = self.get("a.pmx")
self.assertEqual((st, data[:4]), (200, b"PMX "))
st, ct, _ = self.get("tex/s.spa")
self.assertEqual((st, ct), (200, "image/bmp")) # 球面贴图其实是 BMP
st, ct, _ = self.get("tex%5Cs.spa") # PMX 里写的是反斜杠路径
self.assertEqual(st, 200)
if self.dds:
st, ct, data = self.get("tex/c.dds")
self.assertEqual((st, ct, data[:4]), (200, "image/png", bytes([0x89]) + b"PNG"))
def test_moved_texture(self):
"""PMX 记的位置没有、文件夹里别处有同名贴图:和转换时一样按文件名找到。"""
deep = os.path.join(self.folder, "sub", "deep")
os.makedirs(deep, exist_ok=True)
with open(os.path.join(deep, "moved.png"), "wb") as f:
f.write(bytes([0x89]) + b"PNG\r\n\x1a\n")
self.assertEqual(self.get("moved.png")[:2], (200, "image/png"))
self.assertEqual(self.get("textures/moved.png")[0], 200)
self.assertEqual(self.get("nothere.png")[0], 404)
def test_outside_refused(self):
self.assertEqual(self.get("../secret.txt")[0], 404)
self.assertEqual(self.get("%2E%2E/secret.txt")[0], 404)
self.assertEqual(self.get("missing.png")[0], 404)
import urllib.error
import urllib.request
with self.assertRaises(urllib.error.HTTPError) as cm:
urllib.request.urlopen(self.url + "model/nosuchtoken/a.pmx")
cm.exception.close()
if __name__ == "__main__":
unittest.main()
class UploadTest(unittest.TestCase):
"""浏览器模式:拖入 / 选择的文件传到临时文件夹再加入列表。"""
def setUp(self):
self.tmp = tempfile.mkdtemp(prefix="m2v_up_")
self.p = mock.patch.object(server, "UPLOADS", os.path.join(self.tmp, "uploads"))
self.p.start()
self.backend, self.srv, self.url = server.serve(0)
def tearDown(self):
self.srv.shutdown()
self.srv.server_close()
self.backend.close()
self.p.stop()
import shutil
shutil.rmtree(self.tmp, ignore_errors=True)
def post(self, key, path, data):
import urllib.parse
import urllib.request
q = urllib.parse.urlencode({"key": key, "path": path})
with urllib.request.urlopen(urllib.request.Request(self.url + "api/upload?" + q, data=data, method="POST")) as r:
return json.loads(r.read())
def done(self, items):
import urllib.request
req = urllib.request.Request(self.url + "api/upload/done", data=json.dumps({"items": items}).encode(),
headers={"Content-Type": "application/json"}, method="POST")
with urllib.request.urlopen(req) as r:
return json.loads(r.read())
def test_folder(self):
self.assertEqual(self.post("k1", "模型/a.pmx", b"PMX data"), {"ok": True})
self.assertEqual(self.post("k1", "模型/tex/b.png", b"png"), {"ok": True})
added = self.done([{"key": "k1", "roots": ["模型"]}])["added"]
self.assertEqual(len(added), 1)
f = self.backend.files[added[0]]
self.assertTrue(f["path"].startswith(server.UPLOADS))
self.assertEqual(os.path.relpath(f["path"], server.UPLOADS).split(os.sep)[1:], ["模型", "a.pmx"])
self.assertTrue(os.path.isfile(os.path.join(os.path.dirname(f["path"]), "tex", "b.png")))
# 同样的东西再传一次:落在同一个位置(调整按路径保存),已经在列表里就不重复加
self.assertEqual(self.post("k1", "模型/a.pmx", b"PMX data"), {"ok": True})
self.assertEqual(self.done([{"key": "k1", "roots": ["模型"]}])["added"], [])
# 「保存在源文件旁边」:传进来的文件改存到程序目录
opts = {"output": {"mode": "beside"}}
self.assertEqual(self.backend._opts_for(f["path"], opts)["output"]["mode"], "app")
self.assertIs(self.backend._opts_for(os.path.join(self.tmp, "x.pmx"), opts), opts)
def test_paths_stay_inside(self):
self.post("k2", "../../evil.pmx", b"x")
self.post("k2", "a:b?.pmx", b"x")
names = sorted(os.listdir(self.backend._upload_dir("k2")))
self.assertEqual(names, ["a_b_.pmx", "evil.pmx"])
def test_lone_pmx_warns(self):
self.post("k3", "单独.pmx", b"x")
after = self.backend.events[-1][0] if self.backend.events else 0
self.assertEqual(len(self.done([{"key": "k3", "roots": ["单独.pmx"]}])["added"]), 1)
logs = [e["msg"] for s, e in self.backend.events if s > after and e["type"] == "log"]
self.assertTrue(any("单独.pmx" in m and "贴图" in m for m in logs), logs)
self.assertTrue(all(logtext.to_en(m) for m in logs))
File diff suppressed because it is too large Load Diff
+400
View File
@@ -0,0 +1,400 @@
# -*- coding: utf-8 -*-
"""FBX / Unity 资源相关的小函数:英文骨名、英文表情名、Unity 材质找贴图、欧拉角顺序、替换网格。
不需要真实模型(Unity 酱、Query 酱实测中发现的问题都在这里留了用例)。
"""
import io
import math
import os
import shutil
import sys
import tarfile
import tempfile
import unittest
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
for _p in (os.path.join(ROOT, "convert"), os.path.join(ROOT, "formats")):
if _p not in sys.path:
sys.path.insert(0, _p)
import fbx2pmx # noqa: E402
import unityasset # noqa: E402
import unitypackage_unpack # noqa: E402
from vrmconv.expressions import _preset_en # noqa: E402
from vrmconv.humanoid import _en_bone, _map_humanoid # noqa: E402
class BoneNameTest(unittest.TestCase):
def test_conventions(self):
cases = {
"Character1_Hips": ("slot", "hips"), "Character1_Spine1": ("slot", "chest"),
"Character1_LeftUpLeg": ("slot", "leftUpperLeg"), "Character1_LeftLeg": ("slot", "leftLowerLeg"),
"Chr_RightForeArm": ("slot", "rightLowerArm"), "mixamorig:LeftHand": ("slot", "leftHand"),
"J_Bip_C_UpperChest": ("slot", "upperChest"), "J_Bip_L_UpperArm": ("slot", "leftUpperArm"),
"thigh.L": ("slot", "leftUpperLeg"), "Bip001 R Calf": ("slot", "rightLowerLeg"),
"Bip001 Pelvis": ("slot", "hips"), "Eye_R": ("slot", "rightEye"),
"Character1_LeftHandThumb1": ("finger", ("left", "Thumb", 0)),
"Character1_RightHandIndex3": ("finger", ("right", "Index", 3)),
}
for name, want in cases.items():
self.assertEqual(_en_bone(name), want, name)
def test_not_humanoid(self):
for name in ("J_L_HairTail_00", "skirt_L_01", "Pai_L", "J_Mune_root_00", "Root", "H02_L",
"Character1_RightHandPinky4", "J_L_Sode_A00"):
self.assertIsNone(_en_bone(name), name)
def test_leg_without_upleg(self):
# 只有 Leg(没有 UpLeg / Thigh)时 Leg 是大腿
names = ["Hips", "Spine", "Leg_L", "Knee_L", "Foot_L"]
bones = [{"name": n, "name_en": n} for n in names]
human = _map_humanoid(bones, True, {})
self.assertEqual(human.get("leftUpperLeg"), 2)
self.assertEqual(human.get("leftLowerLeg"), 3)
def test_unity_finger_names(self):
"""Unity / VRChat 的「Index Proximal.L」:其余手指 1~3;拇指 Proximal / Intermediate / Distal = 0~2,
有 ThumbMetacarpal(VRM 1.0 风格)时 Metacarpal / Proximal / Distal = 0~2。"""
self.assertEqual(_en_bone("Index Proximal.L"), ("finger", ("left", "Index", 1)))
self.assertEqual(_en_bone("Little Distal.R"), ("finger", ("right", "Little", 3)))
self.assertEqual(_en_bone("Thumb Proximal.L"), ("finger", ("left", "Thumb", 0)))
self.assertEqual(_en_bone("Thumb Intermediate.L"), ("finger", ("left", "Thumb", 1)))
self.assertEqual(_en_bone("J_Bip_L_ThumbProximal", True), ("finger", ("left", "Thumb", 1)))
self.assertEqual(_en_bone("J_Bip_L_ThumbMetacarpal", True), ("finger", ("left", "Thumb", 0)))
names = ["Hips", "Spine", "Chest", "Neck", "Head", "Upper_arm.L", "Lower_arm.L", "Hand.L"] + ["%s %s.L" % (f, s) for f in ("Thumb", "Index", "Middle", "Ring", "Little")
for s in ("Proximal", "Intermediate", "Distal")]
human = _map_humanoid([{"name": n, "name_en": n} for n in names], True, {})
self.assertEqual(names[human["leftThumbMetacarpal"]], "Thumb Proximal.L")
self.assertEqual(names[human["leftThumbDistal"]], "Thumb Distal.L")
self.assertEqual(names[human["leftIndexProximal"]], "Index Proximal.L")
self.assertEqual(names[human["leftLittleDistal"]], "Little Distal.L")
def test_mmd_names_win(self):
bones = [{"name": "下半身", "name_en": ""}, {"name": "Hips", "name_en": ""}]
self.assertEqual(_map_humanoid(bones, True, {})["hips"], 0)
def test_mmd_names_win_over_earlier_name_en(self):
"""模型旁边另放的控制骨(左肩調整,英文名和本体一样是 L_Shoulder)排在前面,也不能抢走 左肩。"""
bones = [{"name": "左肩調整", "name_en": "L_Shoulder"}, {"name": "上半身3", "name_en": ""},
{"name": "左肩", "name_en": "L_Shoulder"}, {"name": "右肩調整", "name_en": "R_Shoulder"}]
human = _map_humanoid(bones, True, {})
self.assertEqual(human["leftShoulder"], 2)
self.assertEqual(human["rightShoulder"], 3) # 没有日文名的,英文名照常补位
class ExpressionNameTest(unittest.TestCase):
def test_presets(self):
cases = {"MTH_A": "aa", "Fcl_MTH_E": "ee", "vrc.v_oh": "oh", "EYE_DEF_C": "blink",
"Fcl_EYE_Close_L": "blinkLeft", "Blink_R": "blinkRight", "Fcl_ALL_Joy": "happy",
"Head_02_MouthOpen": "aa", "happy": "happy"}
for name, want in cases.items():
self.assertEqual(_preset_en(name, True), want, name)
self.assertEqual(_preset_en("Fcl_ALL_Joy", False), "joy")
self.assertEqual(_preset_en("vrc.blink_left", False), "blink_l")
def test_lookup(self):
from vrmconv.expressions import Lookup
lk = Lookup(["怒りA", "キリッ", "eyeBlink_L", "EyeBlink_R", "上L", "にこり2"])
self.assertEqual(lk.get("怒り"), "怒りA") # 变体后缀
self.assertEqual(lk.get("キリッ"), "キリッ") # 半角片假名
self.assertEqual(lk.get("にこり2"), "にこり2") # 全角数字
self.assertEqual(lk.all(("eyeBlinkLeft", "eyeBlinkRight")), ("eyeBlink_L", "EyeBlink_R"))
self.assertIsNone(lk.get("上")) # 单边的不算
self.assertIsNone(lk.all(("eyeBlinkLeft", "eyeWideRight")))
def test_en_parts_and_arkit(self):
from vrmconv.expressions import Lookup, _en_part, combo_recipes
lk = Lookup(["Fcl_BRW_Angry", "Fcl_EYE_Joy", "Mouth_Laugh1", "Mouth_Smile1", "Eye_Smile_L", "Fcl_ALL_Sorrow"])
self.assertEqual(_en_part(lk, "angry", 1), "Fcl_BRW_Angry")
self.assertEqual(_en_part(lk, "happy", 2), "Fcl_EYE_Joy") # 单边的 Eye_Smile_L 不算
self.assertEqual(_en_part(lk, "happy", 3), "Mouth_Smile1") # smile 先于 laugh
self.assertIsNone(_en_part(lk, "sad", 1)) # ALL 是整张脸,不当部位
# 只有 ARKit:各部位都从 ARKit 来;每个表情动不同的顶点,不会被当成重叠
names = ["browDownLeft", "browDownRight", "eyeSquintLeft", "eyeSquintRight", "mouthFrownLeft",
"mouthFrownRight", "browInnerUp"]
deltas = {n: {k: (0.0, 0.1, 0.0)} for k, n in enumerate(names)}
r = combo_recipes(deltas, {})
self.assertEqual(r["angry"], [("browDownLeft", 0.5, 1), ("browDownRight", 0.5, 1),
("eyeSquintLeft", 0.3, 2), ("eyeSquintRight", 0.3, 2),
("mouthFrownLeft", 0.4, 3), ("mouthFrownRight", 0.4, 3)])
self.assertEqual([n for n, _, _ in r["sad"]], ["browInnerUp", "mouthFrownLeft", "mouthFrownRight"])
def test_not_presets(self):
for name in ("MTH_SMILE1", "Fcl_BRW_Angry", "Key 1", "eye_a", "Basis", "EYE_SMILE1"):
self.assertIsNone(_preset_en(name, True), name)
MAT_U5 = """%YAML 1.1
%TAG !u! tag:unity3d.com,2011:
--- !u!21 &2100000
Material:
m_Name: mat_Body
m_SavedProperties:
m_TexEnvs:
- _BumpMap:
m_Texture: {fileID: 2800000, guid: bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb, type: 3}
- _MainTex:
m_Texture: {fileID: 2800000, guid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa, type: 3}
m_Floats: []
"""
MAT_U4 = """%YAML 1.1
--- !u!21 &2100000
Material:
m_Name: mat_Hair
m_SavedProperties:
m_TexEnvs:
data:
first:
name: _MainTex
second:
m_Texture: {fileID: 0}
data:
first:
name: _Main_Texture
second:
m_Texture: {fileID: 2800000, guid: cccccccccccccccccccccccccccccccc, type: 3}
m_Floats:
data:
first:
name: _Cutoff
"""
def _write(path, data):
with open(path, "wb" if isinstance(data, bytes) else "w", **({} if isinstance(data, bytes) else {"encoding": "utf-8"})) as f:
f.write(data)
class UnityAssetTest(unittest.TestCase):
def setUp(self):
self.tmp = tempfile.mkdtemp(prefix="m2v_unity_")
a = os.path.join(self.tmp, "Assets")
for sub in ("Chara/Models", "Chara/Materials", "Chara/Textures", "Other/Materials"):
os.makedirs(os.path.join(a, sub))
def tex(name, guid):
p = os.path.join(a, "Chara/Textures", name)
open(p, "wb").write(b"x")
open(p + ".meta", "w").write("fileFormatVersion: 2\nguid: %s\n" % guid)
tex("tex_body.tga", "a" * 32)
tex("tex_body_n.tga", "b" * 32)
tex("tex_hair.png", "c" * 32)
tex("tex_other.png", "d" * 32)
_write(os.path.join(a, "Chara/Materials/mat_Body.mat"), MAT_U5)
_write(os.path.join(a, "Chara/Materials/mat_Hair.mat"), MAT_U4)
# 别处的同名材质:不在 FBX 的上级链上,不该被选中
_write(os.path.join(a, "Other/Materials/mat_Body.mat"), MAT_U5.replace("a" * 32, "d" * 32))
self.models = os.path.join(a, "Chara/Models")
def tearDown(self):
shutil.rmtree(self.tmp, ignore_errors=True)
def test_lookup(self):
m = unityasset.material_textures(self.models)
self.assertEqual(os.path.basename(m["mat_Body"]), "tex_body.tga") # _MainTex,不是法线
self.assertEqual(os.path.basename(m["mat_Hair"]), "tex_hair.png") # Unity 4 格式、空的 _MainTex 跳过
def test_root(self):
self.assertEqual(os.path.basename(unityasset.find_root(self.models)), "Assets")
def test_solid_color_mat(self):
"""Toon 材质常常没有贴图,颜色只在 m_Colors 里:以前 `not guid_path` 直接返回 {},
这类材质全被当成默认白色丢掉。Unity 5 / Unity 4 两种写法都要认。"""
tmp = tempfile.mkdtemp(prefix="m2v_solid_")
try:
mats = os.path.join(tmp, "Assets", "Materials")
os.makedirs(mats)
u5 = """%YAML 1.1
%TAG !u! tag:unity3d.com,2011:
--- !u!21 &2100000
Material:
m_Name: mat_Black
m_SavedProperties:
m_Colors:
- _ShadeColor: {r: 0.5, g: 0.5, b: 0.5, a: 1}
- _Color: {r: 0, g: 0, b: 0, a: 1}
m_TexEnvs:
- _MainTex:
m_Texture: {fileID: 0}
m_Floats: []
"""
u4 = """%YAML 1.1
--- !u!21 &2100000
Material:
m_Name: mat_White
m_SavedProperties:
m_Colors:
data:
first:
name: _Color
second:
val: {r: 1, g: 1, b: 1, a: 1}
m_TexEnvs: []
"""
_write(os.path.join(mats, "mat_Black.mat"), u5)
_write(os.path.join(mats, "mat_White.mat"), u4)
props = unityasset.material_properties(mats)
self.assertIsNone(props["mat_Black"]["tex"])
self.assertEqual(props["mat_Black"]["color"], [0.0, 0.0, 0.0, 1.0])
self.assertIsNone(props["mat_White"]["tex"])
self.assertEqual(props["mat_White"]["color"], [1.0, 1.0, 1.0, 1.0])
# 兼容旧接口:只返回有贴图的材质
self.assertEqual(unityasset.material_textures(mats), {})
finally:
shutil.rmtree(tmp, ignore_errors=True)
def test_outline_settings(self):
"""UCTS / Toon shader 的描边只在 .mat 里(FBX 完全没有):宽度、颜色要读出来;
`_Outline_Width: 0` 是没开描边,不能一律给所有材质加轮廓线。"""
tmp = tempfile.mkdtemp(prefix="m2v_outline_")
try:
mats = os.path.join(tmp, "Assets", "Materials")
os.makedirs(mats)
def mat(nm, width):
return """%%YAML 1.1
--- !u!21 &2100000
Material:
m_Name: %s
m_ShaderKeywords: _EMISSIVE_SIMPLE _OUTLINE_NML
m_SavedProperties:
m_TexEnvs: []
m_Floats:
- _Outline_Width: %s
- _Farthest_Distance: 100
m_Colors:
- _Color: {r: 1, g: 1, b: 1, a: 1}
- _Outline_Color: {r: 0.2, g: 0.1, b: 0.3, a: 1}
""" % (nm, width)
_write(os.path.join(mats, "mat_Base.mat"), mat("mat_Base", 20))
_write(os.path.join(mats, "mat_NoOutline.mat"), mat("mat_NoOutline", 0))
props = unityasset.material_properties(mats)
ol = props["mat_Base"]["outline"]
self.assertAlmostEqual(ol["width"], 20.0)
self.assertEqual(ol["color"], [0.2, 0.1, 0.3])
self.assertEqual(ol["mode"], "NML")
self.assertIsNone(props["mat_NoOutline"]["outline"])
finally:
shutil.rmtree(tmp, ignore_errors=True)
def test_solid_png(self):
import vrmio
data = fbx2pmx._solid_png((0.0, 0.0, 0.0))
w, h, rows = vrmio.decode_rgba(data)
self.assertEqual((w, h), (4, 4))
self.assertEqual(rows[0][0][:3], (0, 0, 0))
self.assertEqual(rows[3][3][3], 255)
class UnitypackageTest(unittest.TestCase):
"""unitypackage 解包(流式读一遍):一个资源的成员挨着放,pathname 在 asset 前后都行。"""
def test_unpack(self):
tmp = tempfile.mkdtemp(prefix="m2v_up_")
try:
pkg = os.path.join(tmp, "a.unitypackage")
with tarfile.open(pkg, "w:gz") as tf:
for name, data in (
("a1/asset", b"FBX"), ("a1/asset.meta", b"m1"), ("a1/pathname", b"Assets/Chara/model.fbx"),
("a1/preview.png", b"png"),
("b2/pathname", b"Assets/Chara/tex.png"), ("b2/asset", b"PNG"), # pathname 在前
("c3/asset.meta", b"m3"), ("c3/pathname", b"Assets/Empty/"), # 文件夹资源:没有 asset
("d4/asset", b"lost")): # 没有 pathname
info = tarfile.TarInfo(name)
info.size = len(data)
tf.addfile(info, io.BytesIO(data))
out = os.path.join(tmp, "out")
unitypackage_unpack.unpack(pkg, out, verbose=False)
got = {}
for d, ds, fs in os.walk(out):
for x in ds:
got[os.path.relpath(os.path.join(d, x), out).replace("\\", "/")] = None
for x in fs:
with open(os.path.join(d, x), "rb") as f:
got[os.path.relpath(os.path.join(d, x), out).replace("\\", "/")] = f.read()
self.assertEqual(got, {
"Chara": None, "Chara/model.fbx": b"FBX", "Chara/model.fbx.meta": b"m1",
"Chara/model.fbx.pathname": b"Assets/Chara/model.fbx", "Chara/model.fbx.preview.png": b"png",
"Chara/tex.png": b"PNG", "Chara/tex.png.pathname": b"Assets/Chara/tex.png",
"Empty": None, "Empty.meta": b"m3", "Empty.pathname": b"Assets/Empty/",
"d4": b"lost"})
finally:
shutil.rmtree(tmp, ignore_errors=True)
class FbxMathTest(unittest.TestCase):
def test_rotation_order(self):
# 默认(XYZ)和以前一样:Rz·Ry·Rx
r = (30.0, 40.0, 50.0)
m_x = fbx2pmx.m_trs([0, 0, 0], (r[0], 0, 0), [1, 1, 1])
m_y = fbx2pmx.m_trs([0, 0, 0], (0, r[1], 0), [1, 1, 1])
m_z = fbx2pmx.m_trs([0, 0, 0], (0, 0, r[2]), [1, 1, 1])
want_xyz = fbx2pmx.m_mul(m_z, fbx2pmx.m_mul(m_y, m_x))
want_zxy = fbx2pmx.m_mul(m_y, fbx2pmx.m_mul(m_x, m_z)) # 4 = ZXY:先 Z 再 X 再 Y
for got, want in ((fbx2pmx.m_rot(r), want_xyz), (fbx2pmx.m_rot(r, 4), want_zxy)):
for a, b in zip(got, want):
self.assertAlmostEqual(a, b, places=9)
def test_pivot_is_translation(self):
class N:
def get(self, k):
return None
sc = fbx2pmx.Scene.__new__(fbx2pmx.Scene)
sc._props70 = lambda node: {"Lcl Rotation": [0.0, 0.0, 90.0], "RotationPivot": [1.0, 0.0, 0.0]}
m = fbx2pmx.Scene._local_matrix(sc, N())
# 绕 (1,0,0) 转 90°:原点 → (1,-1,0)
p = fbx2pmx.m_point(m, (0.0, 0.0, 0.0))
self.assertAlmostEqual(p[0], 1.0, places=6)
self.assertAlmostEqual(p[1], -1.0, places=6)
self.assertTrue(math.isfinite(p[2]))
class AlternateMeshTest(unittest.TestCase):
def rec(self, name, nv=100, lo=(0, 0, 0), hi=(1, 1, 1)):
return {"name": name, "nv": nv, "nt": nv * 2, "lo": list(lo), "hi": list(hi), "segs": [len(name)]}
def test_groups(self):
recs = [self.rec("Body", 500), self.rec("Finger_Pa"), self.rec("Finger_Nomal"), self.rec("Finger_Gu"),
self.rec("Head_01_Normal", 300, (0, 2, 0), (1, 3, 1)),
self.rec("Head_02_MouthOpen", 300, (0, 2, 0), (1, 3, 1)),
self.rec("Glove_L", 100, (5, 0, 0), (6, 1, 1))] # 同样的顶点数,但位置不同
groups = fbx2pmx._alternate_groups(recs)
got = {p["name"]: sorted(a["name"] for a in alts) for p, alts in groups}
self.assertEqual(got, {"Finger_Nomal": ["Finger_Gu", "Finger_Pa"],
"Head_01_Normal": ["Head_02_MouthOpen"]})
class AutoPhysTest(unittest.TestCase):
"""自动物理的兽耳识别:BlackCyan 的 Ear_0_L…Ear_3_R 八根骨曾全被 _FACE 当五官排除。"""
def _sway(self, spec):
# spec: [(骨名, 父骨序号, 位置)],0 = 头、1 = 腰(humanoid)
from vrmconv import autophys
bones = [{"name": n, "name_en": n, "pos": p, "parent": q, "layer": 0,
"flag": 0x001F, "tail": -1} for n, q, p in spec]
model = {"bones": bones, "rigid_bodies": [], "vertices": []}
autophys.synthesize(model, [q for _, q, _ in spec], {}, {"head": 0, "hips": 1})
return {rb["name"] for rb in model["rigid_bodies"] if rb["mode"] == 1}
def test_animal_ear_chains_sway(self):
got = self._sway([
("Head", -1, (0, 10, 0)), ("Hips", -1, (0, 0, 0)),
("Ear_0_L", 0, (1, 10.2, 0)), ("Ear_1_L", 2, (1.2, 10.5, 0)),
("Ear_0_R", 0, (-1, 10.2, 0)), ("Ear_1_R", 4, (-1.2, 10.5, 0)),
("Earring_L", 0, (1.5, 9.5, 0)), # 耳环是挂件,不能跟着摆
("Hair_0", 0, (0, 11, 0)), # 有头发骨时结构推断关闭,兽耳仍要识别
])
for nm in ("Ear_0_L", "Ear_1_L", "Ear_0_R", "Ear_1_R", "Hair_0"):
self.assertIn("auto_" + nm, got)
self.assertNotIn("auto_Earring_L", got)
def test_single_ear_bone_does_not_sway(self):
"""人形模型单根的耳朵 / 表情骨仍由 _FACE 拦住(有头发骨和没头发骨两种结构都要挡)。"""
for extra in ([("Hair_0", 0, (0, 11, 0))], []):
got = self._sway([("Head", -1, (0, 10, 0)), ("Hips", -1, (0, 0, 0)),
("Ear_L", 0, (1, 10.2, 0))] + extra)
self.assertNotIn("auto_Ear_L", got)
if __name__ == "__main__":
unittest.main()
+115
View File
@@ -0,0 +1,115 @@
# -*- coding: utf-8 -*-
"""转换日志的英文版(convert/logtext.py):源码里每条中文日志 / 报错都要有翻译,翻译要对。"""
import ast
import os
import sys
import unittest
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
for _p in ("convert", "formats"):
_d = os.path.join(ROOT, _p)
if _d not in sys.path:
sys.path.insert(0, _d)
import logtext # noqa: E402
LOG_CALLS = {"log", "_log", "_l", "lg", "say", "warn", "_warn", "note", "_note"}
PRINTS = {"fbx2pmx.py"} # 转换时 print() 被转成日志(pipeline._LogWriter)
SKIP = {"app.py"} # 启动器的控制台提示,不进日志
# 几段拼起来的日志:句式在 TEMPLATES 里拆成了几条(「表情预设:%s」+「%s · 未找到:%s」)
COMPOSITE = {"表情预设:%s%s"}
def _cjk(s):
return bool(logtext._CJK.search(s))
def _template(node):
if isinstance(node, ast.Constant) and isinstance(node.value, str):
return node.value
if isinstance(node, ast.BinOp) and isinstance(node.op, ast.Mod):
return _template(node.left)
if isinstance(node, ast.BinOp) and isinstance(node.op, ast.Add):
return (_template(node.left) or "%s") + (_template(node.right) or "%s")
if isinstance(node, ast.JoinedStr):
return "".join(v.value if isinstance(v, ast.Constant) else "%s" for v in node.values)
return None
def source_messages():
"""→ [(位置, 句式, [参数里的中文片段])]:转换器和界面服务器里的 log(...) 和 raise X("...")。"""
out = []
for d in ("convert", "formats", "ui"):
for dp, _, fs in os.walk(os.path.join(ROOT, d)):
if "vendor" in dp or "__pycache__" in dp:
continue
for fn in fs:
if not fn.endswith(".py") or fn in SKIP:
continue
path = os.path.join(dp, fn)
with open(path, encoding="utf-8") as f:
tree = ast.parse(f.read())
names = LOG_CALLS | ({"print"} if fn in PRINTS else set())
for node in ast.walk(tree):
if isinstance(node, ast.Raise) and isinstance(node.exc, ast.Call) and node.exc.args:
arg = node.exc.args[0]
elif isinstance(node, ast.Call) and node.args and \
(node.func.id if isinstance(node.func, ast.Name) else
getattr(node.func, "attr", None)) in names:
arg = node.args[0]
else:
continue
t = _template(arg)
if not t or not _cjk(t):
continue
frags = [c.value for c in ast.walk(arg) if isinstance(c, ast.Constant)
and isinstance(c.value, str) and _cjk(c.value) and c.value != t]
out.append(("%s:%d" % (os.path.relpath(path, ROOT), node.lineno), t.strip(), frags))
return out
class LogTextTest(unittest.TestCase):
def test_every_message_has_a_translation(self):
known = {k.strip() for k in logtext.TEMPLATES}
missing = []
for where, t, frags in source_messages():
if t not in known and t not in COMPOSITE:
missing.append("%s %s" % (where, t))
for f in frags:
# 拼接用的片段(「视线:」+ note)随整句检查;带占位符或单独成词的要在表里
if f.strip() not in known and not any(f in k for k in known | COMPOSITE):
missing.append("%s 片段 %s" % (where, f))
self.assertEqual(missing, [], "logtext.TEMPLATES 里缺这些句式:\n" + "\n".join(missing))
def test_templates_are_consistent(self):
"""英文里引用的参数个数和中文占位符个数一致。"""
import re
for zh, en in logtext.TEMPLATES.items():
n = len([m for m in logtext._PH.findall(zh) if m != "%%"])
used = {int(i) for i in re.findall(r"\{(\d+)\}", en)}
self.assertTrue(used <= set(range(n)), zh)
self.assertEqual(len(used), n, zh)
def test_translations(self):
cases = {
"[艾尔莎-人类形态] 网格:按表情分为 2 个(身体:13 个表情、脸:181 个表情)":
"[艾尔莎-人类形态] Mesh: split into 2 by morphs (身体: 13 morphs, 脸: 181 morphs)",
"绕序自动判定(手性修正后):与法线同向 16 面 / 反向 3892 面 → 需要反转":
"Winding (after the handedness fix): 16 faces agree with the normals / 3892 oppose → flip",
"T-pose:左 上臂 37.0° · 前臂 0.0°": "T-pose: left upper arm 37.0° · forearm 0.0°",
"表情预设:无 · 未找到:happy、blink": "Preset expressions: none · not found: happy, blink",
"SpringBone:308 个链间横向关节(裙摆等)无法表达,已舍弃;已按裙片朝向修正 273 处裙摆与腿的碰撞方向,减少裙片被腿分开":
"SpringBone: 308 sideways joints between chains (skirts …) can't be expressed and were dropped; "
"273 skirt–leg collisions were adjusted to the skirt panels' direction so the legs split the skirt less",
"已写出 奥黛塔.vrm(26.26 MB)· 节点 551 · morph target 70 · 表情 74":
"Wrote 奥黛塔.vrm (26.26 MB) · 551 nodes · 70 morph targets · 74 expressions",
"ValueError: 不是 VRM 文件": "ValueError: Not a VRM file",
}
for zh, en in cases.items():
self.assertEqual(logtext.to_en(zh), en)
self.assertIsNone(logtext.to_en("没有这句日志"))
self.assertIsNone(logtext.to_en("plain English"))
if __name__ == "__main__":
unittest.main()