# -*- coding: utf-8 -*- """转换流程(与界面无关):识别输入格式 → 必要时先转 PMX → 再转 VRM。 import pipeline outs = pipeline.convert_file(path, opts, log) # → [输出文件路径, ...] 压缩包(模型网站下载的整包:zip / 7z / rar / tar.gz 等)会先解压到临时目录,再转换里面的模型: 有 PMX 就转 PMX,没有再转其它能识别的格式;包里只有另一个压缩包时再解一层。输出放在压缩包 旁边(或指定的输出文件夹),临时目录随后删除。zip 用 Python 自带的 zipfile(处理 GBK / cp932 文件名),其它格式见 formats/archive.py(7-Zip / WinRAR / Bandizip / Windows 自带的 tar)。 opts 是纯 JSON 可序列化的 dict(界面直接存取),缺的键用 DEFAULTS 补齐: target "vrm"(默认)| "pmx"(非 PMX 输入只转到 PMX 为止) output {"mode": "app" | "beside" | "folder", "folder": 路径, "subfolder": 是否建「名字_日期_序号」子文件夹} app = 程序目录下的 vrm 文件夹(界面用;路径由调用方放在 "app_folder",没有时同 beside) vrm {"spec": "1.0" | "0.x", "avatar_only", "spring", "spring_skirt", "spring_stiffness", "auto_spring", "morphs", "gaze", "combo_expr", "extra_expr", "outline", "tpose", "double_sided", "collapse_bones", "auto_thumb", "tex_max": 0 | 4096 | 2048 | 1024, "tex_jpeg", "tex_no_mip"} avatar_only:只转人物,道具(认不出人形骨架)和只有衣服 / 配件的模型跳过(见 not_an_avatar); 一个文件里的模型全被跳过时 convert_file 返回 [] meta VRM 作者 / 许可信息(键见 vrmconv/vrm_ext.build_vrm1),标题用模型文件名 fbx {"alpha": "auto" | "keep" | "strip", "auto_facing", "face_180", "morphs", "center", "flip_z"} uemodel {"alpha", "align_ref"} psk {"jp_bones", "ik", "morphs", "alpha"} xps {"jp_bones", "ik", "hide_unused", "double_sided", "edge"} jobs 同时转几个(多个文件、或一个包里的几个模型):0 = 自动(见 parallel.jobs_for),1 = 一个一个转 log(msg, tag=None):tag 为 None / "info" / "ok" / "warn" / "err" / "head"。 """ import contextlib import copy import io import os import re import shutil import sys import tempfile import time import traceback import zipfile _HERE = os.path.dirname(os.path.abspath(__file__)) for _p in (_HERE, os.path.join(os.path.dirname(_HERE), "formats")): if _p not in sys.path: sys.path.insert(0, _p) import archive # noqa: E402 import parallel # noqa: E402 KINDS = {".pmx": "pmx", ".vrm": "vrm", ".fbx": "fbx", ".unitypackage": "unitypackage", ".uemodel": "uemodel", ".psk": "psk", ".pskx": "psk", ".xps": "xps", ".zip": "zip"} ARCHIVES = {"zip", "7z", "rar", "tar"} CONVERTIBLE = {"pmx", "fbx", "unitypackage", "uemodel", "psk", "xps"} | ARCHIVES DEFAULTS = { "target": "vrm", "jobs": 0, "output": {"mode": "beside", "folder": "", "subfolder": True}, "vrm": {"spec": "1.0", "avatar_only": True, "spring": True, "spring_skirt": True, "spring_stiffness": 1.0, "auto_spring": True, "gaze": True, "combo_expr": True, "extra_expr": True, "morphs": True, "outline": False, "unity_outline": True, "tpose": False, "double_sided": False, "collapse_bones": True, "auto_thumb": True, "tex_max": 0, "tex_jpeg": False, "tex_no_mip": False}, "meta": {"author": "", "version": "", "contact": "", "copyright": "", "license_url": "", "avatar_permission": "everyone", "commercial_usage": "personalNonProfit", "credit_notation": "required", "allow_redistribution": False, "modification": "prohibited"}, "fbx": {"alpha": "auto", "auto_facing": True, "face_180": False, "morphs": True, "center": True, "flip_z": True}, "uemodel": {"alpha": True, "align_ref": ""}, "psk": {"jp_bones": True, "ik": True, "morphs": True, "alpha": True}, "xps": {"jp_bones": True, "ik": True, "hide_unused": True, "double_sided": True, "edge": False}, } def classify(path): """→ "pmx" / "vrm" / "fbx" / "unitypackage" / "uemodel" / "psk" / "xps" / "zip" / "7z" / "rar" / "tar",不支持的为 None(分卷压缩包只认第一卷)。""" return KINDS.get(os.path.splitext(path)[1].lower()) or archive.kind(path) def merged(opts): """用户选项和 DEFAULTS 合并(两层),不改动传入的 dict。""" out = copy.deepcopy(DEFAULTS) for k, v in (opts or {}).items(): if isinstance(v, dict) and isinstance(out.get(k), dict): out[k].update(v) else: out[k] = v return out def find_inputs(folder): """文件夹里(递归)所有能转换或预览的文件。""" found = [] for d, dirs, files in os.walk(folder): dirs[:] = [x for x in dirs if not x.startswith(".")] for f in sorted(files): if classify(f): found.append(os.path.join(d, f)) return found def _score(text): """文件名解码结果像不像正常的中日文:常用汉字、假名、ASCII 加分,半角片假名等乱码特征扣分。""" sc = 0 for ch in text: o = ord(ch) if o < 0x80 or 0x4E00 <= o <= 0x9FFF or 0x3040 <= o <= 0x30FF or 0x3000 <= o <= 0x303F or 0xFF01 <= o <= 0xFF5E: sc += 1 elif 0xFF61 <= o <= 0xFF9F or 0xE000 <= o <= 0xF8FF: sc -= 3 # 半角片假名 / 私用区:GBK 被当成 cp932 解的典型样子 return sc def _decodings(raw, first): """一个文件名的候选解码,按「常用字多」排序(同分时 first 优先),只保留严格解码得通的。 同一个包里常混着 GBK(中文系统)和 cp932(日文系统)的名字,而一种编码的字节按另一种解, 得到的多半是生僻字(「武器」的 cp932 字节按 GBK 解成「晲婍」)。用 GB2312 能不能编码当作 「常用字」的判断:它收了常用汉字和日文假名,GBK 扩展区的生僻字和半角片假名都不在里面。 """ tries = [raw] # cp932 的「ダメ文字」:第二字节是 0x5C(反斜杠),有的打包工具把它当路径分隔符改成了 / fixed = re.sub(rb"([\x81-\x9f\xe0-\xfc])/", rb"\1\\", raw) if fixed != raw: tries.append(fixed) out = [] for r in tries: for enc in (first, "gbk", "cp932", "utf-8"): try: name = r.decode(enc) except UnicodeDecodeError: continue if name not in out: out.append(name) if not out: return [raw.decode(first, "replace")] def common(n): k = 0 for ch in n: try: ch.encode("gb2312") k += 1 except UnicodeEncodeError: pass return k order = {n: i for i, n in enumerate(out)} out.sort(key=lambda n: (-common(n), order[n])) return out def zip_members(zf): """→ [(ZipInfo, [候选文件名, …])],第一个是默认用的。 没设 UTF-8 标志的压缩包,文件名是打包那台电脑的本地编码(中文系统 GBK,日文系统 cp932), 而且同一个包里可能两种混着(作者的日文原文件 + 后加的中文文件)。先给整包选一种主编码 (严格解得通、且「像正常中日文」得分最高的),每个文件再按常用字多少挑解法(见 _decodings), 解压后还会用 PMX 里记录的贴图路径纠正(见 extract_zip)。 """ infos = zf.infolist() legacy = [i.filename.encode("cp437") for i in infos if not i.flag_bits & 0x800] best, best_score = "gbk", None for enc in ("utf-8", "gbk", "cp932"): try: text = "".join(r.decode(enc) for r in legacy) except UnicodeDecodeError: continue sc = _score(text) + (len(text) if enc == "utf-8" else 0) # 严格 UTF-8 解得通基本就是它 if best_score is None or sc > best_score: best, best_score = enc, sc return [(i, [i.filename] if i.flag_bits & 0x800 else _decodings(i.filename.encode("cp437"), best)) for i in infos] def _safe_parts(name): parts = [p for p in name.replace("\\", "/").split("/") if p not in ("", ".", "..")] if parts and ":" in parts[0]: # 盘符 parts = parts[1:] return parts def extract_zip(path, dest): """安全解压(去掉绝对路径和 ..,不会写到 dest 外面),返回解出的文件数。 文件名按 zip_members 的默认解码落盘后,再读每个 PMX:某个文件换一种解码正好是 PMX 引用的 贴图路径(或 PMX 自己的模型名),就改成那个名字——否则贴图对不上,转出来没有贴图。 """ import pmxio entries = [] # (落盘相对路径, [候选相对路径]) n = 0 with zipfile.ZipFile(path) as zf: for info, names in zip_members(zf): if info.is_dir(): continue cands = ["/".join(_safe_parts(x)) for x in names] cands = [c for c in cands if c] if not cands: continue target = os.path.join(dest, *cands[0].split("/")) os.makedirs(os.path.dirname(target), exist_ok=True) with zf.open(info) as src, open(target, "wb") as f: shutil.copyfileobj(src, f) entries.append((cands[0], cands)) n += 1 if all(len(c) == 1 for _, c in entries): return n wanted = set() # PMX 期望存在的相对路径(小写) pmx_names = {} # PMX 相对路径 → 内部模型名 for rel, _ in entries: if not rel.lower().endswith(".pmx"): continue try: m = pmxio.read_pmx(os.path.join(dest, *rel.split("/"))) except Exception: # noqa: BLE001 读不了就不纠正 continue base = rel.rsplit("/", 1)[0] + "/" if "/" in rel else "" for t in m["textures"]: wanted.add((base + "/".join(_safe_parts(t))).lower()) pmx_names[rel] = (m.get("name") or "").strip() for rel, cands in entries: if len(cands) < 2: continue fix = None if rel.lower() not in wanted: fix = next((c for c in cands[1:] if c.lower() in wanted), None) if fix is None and rel in pmx_names: stem = lambda c: os.path.splitext(c.rsplit("/", 1)[-1])[0] if stem(rel) != pmx_names[rel]: fix = next((c for c in cands[1:] if stem(c) == pmx_names[rel]), None) if fix: os.renames(os.path.join(dest, *rel.split("/")), os.path.join(dest, *fix.split("/"))) return n GAMES = {"崩坏:星穹铁道": "星穹铁道"} # 下载站的游戏名 → 简称 def nice_name(stem): """「<名字>_by_<游戏>_<哈希>」(模之屋的下载命名)→「<游戏>—<名字>」,去掉「(修模绑骨后)」 这类说明和结尾的版本号;「(星)」这种有意义的括号保留。其它名字原样返回。""" name, sep, rest = stem.partition("_by_") if not sep: return stem game = rest.rsplit("_", 1)[0] game = GAMES.get(game, game) name = name.strip("【】") m = re.search(r"[((][^((]*$", name) if m and re.search(r"修|绑|更新|版", m.group()): name = name[:m.start()] name = re.sub(r"\d+(\.\d+)*$", "", name) for pre in (game + "—", game + "_"): if name.startswith(pre): name = name[len(pre):] return game + "—" + name.strip("_— ") def output_dir(path, opts): """按 output 选项决定这个源文件的输出目录(会建好)。""" o = opts["output"] if o.get("mode") == "folder" and o.get("folder"): base = o["folder"] elif o.get("mode") == "app" and o.get("app_folder"): base = o["app_folder"] else: base = os.path.dirname(os.path.abspath(path)) if o.get("subfolder", True): stem = nice_name(os.path.splitext(os.path.basename(path))[0]) day = time.strftime("%Y%m%d") for n in range(1, 10000): d = os.path.join(base, "%s_%s_%03d" % (stem, day, n)) if not os.path.exists(d): base = d break os.makedirs(base, exist_ok=True) return base class _LogWriter(io.TextIOBase): """把 print() 的输出转成 log 回调(fbx2pmx 用 print 汇报进度)。""" def __init__(self, log): self._log = log self._buf = "" def write(self, s): self._buf += s while "\n" in self._buf: line, self._buf = self._buf.split("\n", 1) if line.strip(): self._log(line.rstrip(), None) return len(s) def flush(self): if self._buf.strip(): self._log(self._buf.rstrip(), None) self._buf = "" def _fmt_opts(opts, kind): """某个输入格式的选项。转 VRM 时格式自己的「导出表情」跟着 VRM 的「表情」开关走(界面里只显示那一个; 格式的开关只在「只转 PMX」时显示和生效)。""" o = opts[kind] if opts["target"] != "pmx" and "morphs" in o: o = dict(o, morphs=opts["vrm"]["morphs"]) return o def to_pmx(path, kind, out_dir, opts, log): """非 PMX 输入 → PMX,返回写出的 PMX 路径列表(unitypackage 可能有多个)。""" stem = os.path.splitext(os.path.basename(path))[0] # 有的转换器只在拷贝贴图时才建输出目录:没有贴图的模型(白模)写 PMX 时目录还不存在 os.makedirs(out_dir, exist_ok=True) if kind in ("fbx", "unitypackage"): fbxs, dest = _unpack_fbxs(path, log) if kind == "unitypackage" else ([path], None) try: return _fbxs_to_pmx(fbxs, out_dir, _fmt_opts(opts, "fbx"), log) finally: if dest: shutil.rmtree(dest, ignore_errors=True) out = os.path.join(out_dir, stem + ".pmx") if kind == "uemodel": import uemodel2pmx o = opts["uemodel"] uemodel2pmx.convert(path, out, scale_mode="auto", log=log, name=stem, remove_alpha=o["alpha"], align_to=o.get("align_ref") or None, force_double_sided=opts["vrm"]["double_sided"]) elif kind == "psk": import psk2pmx o = _fmt_opts(opts, "psk") psk2pmx.convert(path, out, scale_mode="auto", log=log, name=stem, jp_bones=o["jp_bones"], make_ik=o["ik"], export_morphs=o["morphs"], remove_alpha=o["alpha"], force_double_sided=opts["vrm"]["double_sided"]) elif kind == "xps": import xps2pmx o = opts["xps"] xps2pmx.convert(path, out, scale_mode="auto", log=log, name=stem, jp_bones=o["jp_bones"], make_ik=o["ik"], hide_unused=o["hide_unused"], all_double_sided=o["double_sided"], enable_edge=o["edge"], force_double_sided=opts["vrm"]["double_sided"]) else: raise ValueError("不支持的输入:%s" % kind) return [out] def _unpack_fbxs(path, log): """unitypackage 解到临时目录(几百个资源文件,转完就删)→ ([FBX,大的在前], 临时目录)。""" from unitypackage_unpack import unpack dest = tempfile.mkdtemp(prefix="vrmify_unitypackage_") with contextlib.redirect_stdout(_LogWriter(log)): unpack(path, dest, verbose=False) n = sum(len(fs) for _, _, fs in os.walk(dest)) fbxs = [p for p in find_files(dest, ".fbx") if os.path.getsize(p) > 1024] log("解包 %s:%d 个文件,%d 个 FBX" % (os.path.basename(path), n, len(fbxs)), "info") if not fbxs: shutil.rmtree(dest, ignore_errors=True) raise RuntimeError("包中没有 FBX 文件") fbxs.sort(key=lambda p: -os.path.getsize(p)) return fbxs, dest def _unique_names(paths): """包里每个模型的输出名(文件名去掉扩展名);不同文件夹下的同名模型加 _2、_3,免得输出互相覆盖。""" names, used = [], set() for p in paths: base = name = os.path.splitext(os.path.basename(p))[0] k = 2 while name.lower() in used: name = "%s_%d" % (base, k) k += 1 used.add(name.lower()) names.append(name) return names def _fbx_to_pmx(fbx, out, name, o, log): """→ fbx2pmx.convert 的统计(其中 ["alpha"]["png_alpha"] 是已经算好的贴图透明统计)。""" import fbx2pmx log("读取 FBX:%s" % os.path.basename(fbx), "info") w = _LogWriter(log) with contextlib.redirect_stdout(w): scene = fbx2pmx.Scene(fbx) st = fbx2pmx.convert(scene, out, scale_mode="auto", flip_z=o["flip_z"], name=name, center=o["center"], morphs=o["morphs"], alpha_mode=o["alpha"], auto_facing=o["auto_facing"], face_180=o["face_180"], threads=parallel.threads()) w.flush() return st def _fbxs_to_pmx(fbxs, out_dir, o, log): """FBX → PMX(写进 out_dir,贴图在 out_dir/textures),返回 PMX 路径列表。""" outs = [] for fbx, name in zip(fbxs, _unique_names(fbxs)): out = os.path.join(out_dir, name + ".pmx") _fbx_to_pmx(fbx, out, name, o, log) outs.append(out) return outs def fbx_to_vrm(fbx, name, out_dir, opts, log, edits=None): """一个 FBX → VRM;中间的 PMX 和贴图放自己的临时目录。→ [VRM 路径],被「只转换人物」跳过时为 []。 并行时在子进程里跑(parallel.run)。""" import pmxio work = tempfile.mkdtemp(prefix="vrmify_work_") try: pmx = os.path.join(work, name + ".pmx") st = _fbx_to_pmx(fbx, pmx, name, _fmt_opts(opts, "fbx"), log) n_ol = st.get("unity_outline", 0) if opts["vrm"].get("unity_outline", True) else 0 if n_ol: # Unity 材质里的描边是源模型的设定,跟「描边(按 PMX 轮廓线)」这个针对 MMD # 模型的开关无关,所以单独透传,避免用户没勾那个选项时描边被整条丢掉。 log("材质:%d 个 Unity 材质开了描边(_Outline_Width),已转成 MToon 轮廓线" % n_ol, "info") # 中间的 PMX 只读一次,「是不是人物」的检查和转 VRM 共用 return _to_vrm(pmx, out_dir, opts, log, edits=edits, model=pmxio.read_pmx(pmx), tex_alpha=st["alpha"]["png_alpha"], unity_outline=bool(n_ol), step="PMX → VRM:%s.pmx" % name) finally: shutil.rmtree(work, ignore_errors=True) def _to_vrm(pmx, out_dir, opts, log, name=None, edits=None, model=None, step=None, **known): """PMX → [VRM 路径]。opts["vrm"]["avatar_only"] 时先看是不是人物(not_an_avatar),不是就跳过、返回 []; 检查用的模型和顶点权重接着给转换用。step:确定要转时先记一行日志。known 见 pmx_to_vrm。""" if opts["vrm"].get("avatar_only", True): import pmxio from vrmconv import mesh if model is None: model = pmxio.read_pmx(pmx) weights = mesh.vertex_weights(model["vertices"], len(model["bones"]), {}) why = not_an_avatar(model, weights) if why: log("跳过 %s:%s(如需转换,请在「转换」页关闭「只转换人物」)" % (name or os.path.splitext(os.path.basename(pmx))[0], why), "warn") return [] known["raw_weights"] = weights if step: log(step, "info") return [pmx_to_vrm(pmx, out_dir, opts, log, name=name, edits=edits, model=model, **known)] def _fbxs_to_vrm(fbxs, out_dir, opts, log, edits=None, name=None): """几个 FBX(unitypackage 里常有好几套服装)→ VRM(见 _convert_each)。 name:只有一个 FBX 时用它当输出名(压缩包里有同名模型时由调用方改过名)。""" names = [name] if name and len(fbxs) == 1 else _unique_names(fbxs) if len(fbxs) == 1: return fbx_to_vrm(fbxs[0], names[0], out_dir, opts, log, edits=edits) return _convert_each([(fbx_to_vrm, (fbx, names[i], out_dir, opts), {"edits": edits}) for i, fbx in enumerate(fbxs)], names, [os.path.getsize(f) for f in fbxs], opts, log, "包中") SMALL_MODEL = 1 << 20 # 输入文件小于 1 MB 的模型(道具、配件)转得比开子进程还快,不为它们并行 UNKNOWN_GB = 1.0 # 看不到里面的包(unitypackage / 7z / rar / tar)按这么多估 def _model_gb(size): """一个模型文件(PMX / FBX / …,size 字节)转换时的进程内存峰值估计(GB)。 实测 VRM 1.0(主要花在 PMX 读进来的逐顶点字典上):PMX 约 0.09 GB + 文件大小 × 28 (爱弥斯 16 MB → 0.51 GB,开拓者 2.2 MB → 0.15 GB);FBX 更省(12 MB → 0.14 GB)。按 × 35 估、留余量。""" return min(parallel.GB_PER_JOB, 0.15 + size * 35 / 1024 ** 3) def memory_estimate(path): """转换这个文件时的进程内存峰值估计(GB),给 parallel.jobs_for 决定同时转几个。 压缩包里的模型是一个一个转的,按最大的那个估:zip 直接看目录;看不到里面的按 UNKNOWN_GB (Marycia 154 MB 的 unitypackage 实测峰值 0.44 GB)。""" kind = classify(path) try: if kind == "zip": with zipfile.ZipFile(path) as zf: infos = zf.infolist() inner = [classify(i.filename) for i in infos] if any(k in ARCHIVES or k == "unitypackage" for k in inner): return UNKNOWN_GB sizes = [i.file_size for i, k in zip(infos, inner) if k in CONVERTIBLE] return _model_gb(max(sizes)) if sizes else UNKNOWN_GB if kind in ARCHIVES or kind == "unitypackage": return UNKNOWN_GB return _model_gb(os.path.getsize(path)) except (OSError, zipfile.BadZipFile, ValueError): return UNKNOWN_GB def _convert_each(tasks, names, sizes, opts, log, where): """几个模型(unitypackage 里的几套服装、压缩包里的几个模型)→ 输出路径列表:能并行时同时转, 各自的日志前面带上模型名(parallel.run);某个模型失败不影响其它的,都失败才报错。 tasks:[(func, args, kwargs)],按 func(*args, log=…, **kwargs) 调用、返回输出路径列表; func 要是模块顶层函数(子进程按名字导入)。names / sizes:每个任务的模型名、输入文件大小。 where:日志里说「包里」还是「压缩包里」。 """ if len(tasks) == 1: # 只有一个:直接转,出错照常抛出 func, args, kw = tasks[0] return func(*args, log=log, **kw) big = sum(1 for s in sizes if s >= SMALL_MODEL) # 一个人物 + 几个小道具:一个一个转更快 jobs = parallel.jobs_for(big, opts.get("jobs"), [_model_gb(s) for s in sizes if s >= SMALL_MODEL]) if big > 1 else 1 keyed = [(i,) + tuple(t) for i, t in enumerate(tasks)] if jobs > 1: log("%s共有 %d 个模型,并行转换 %d 个" % (where, len(tasks), jobs), "info") results = parallel.run(keyed, jobs, lambda i: (lambda m, t=None: log("[%s] %s" % (names[i], m), t))) else: results = {} for i, func, args, kw in keyed: try: results[i] = (True, func(*args, log=log, **kw)) except Exception as e: # noqa: BLE001 一个模型失败不影响其它的 results[i] = (False, ("%s: %s" % (type(e).__name__, e), traceback.format_exc())) outs, errors = [], [] for i in range(len(tasks)): ok, r = results.get(i, (False, ("没有执行", ""))) if ok: outs += r else: errors.append(r[0]) log("%s 转换失败:%s" % (names[i], r[1] or r[0]), "err") if errors and not outs: raise RuntimeError(errors[0]) return outs def find_files(root, ext): return [os.path.join(d, f) for d, _, fs in os.walk(root) for f in fs if f.lower().endswith(ext)] def pmx_to_vrm(pmx, out_dir, opts, log, name=None, edits=None, **known): """PMX → VRM,返回 VRM 路径。edits:界面里对这个模型做的调整(见 vrm_edit),转完套上。 known:调用方已经读好 / 算好的 model、raw_weights、tex_alpha(见 pmx2vrm.convert)。""" import pmx2vrm o = opts["vrm"] stem = name or os.path.splitext(os.path.basename(pmx))[0] out = os.path.join(out_dir, stem + ".vrm") spec = "1.0" if str(o["spec"]).startswith("1") else "0.x" meta = dict(opts.get("meta") or {}, title=stem) pmx2vrm.convert(pmx, out, spec=spec, meta=meta, log=log, max_morphs=None if o["morphs"] else 0, force_double_sided=o["double_sided"], tpose=o["tpose"], outline=o["outline"], spring=o["spring"], spring_skirt=o["spring_skirt"], spring_stiffness=float(o["spring_stiffness"]), tex_max=int(o.get("tex_max") or 0), tex_jpeg=bool(o.get("tex_jpeg")), tex_no_mip=bool(o.get("tex_no_mip", False)), auto_spring=bool(o.get("auto_spring", True)), gaze=bool(o.get("gaze", True)), combo_expr=bool(o.get("combo_expr", True)), extra_expr=bool(o.get("extra_expr", True)), collapse_bones=bool(o.get("collapse_bones", True)), threads=parallel.threads(), **known) if edits: import vrm_edit if not vrm_edit.is_empty(edits): n = vrm_edit.apply(out, edits) log("已应用保存的调整(%d 项)" % n, "info") return out def convert_file(path, opts=None, log=None, out_dir=None, edits=None): """转换一个文件,返回输出文件列表。out_dir 不给时按 opts["output"] 决定; edits:这个文件在界面里的调整(vrm_edit),套到每个输出的 VRM 上。""" opts = merged(opts) log = log or (lambda m, t=None: None) kind = classify(path) if kind not in CONVERTIBLE: raise ValueError("无法转换此文件:%s" % os.path.basename(path)) out_dir = out_dir or output_dir(path, opts) log("→ %s" % os.path.basename(path), "head") log("输出目录:%s" % out_dir, "info") if kind in ARCHIVES: return _convert_archive(path, kind, out_dir, opts, log, edits) return _convert_model(path, kind, out_dir, opts, log, edits) def extract_archive(path, kind, dest, log=None): """解压任意支持的压缩包,返回文件数。""" if kind == "zip": return extract_zip(path, dest) return archive.extract(path, dest, log) def _convert_archive(path, kind, out_dir, opts, log, edits=None): tmp = tempfile.mkdtemp(prefix="vrmify_%s_" % kind) try: n = extract_archive(path, kind, tmp, log) found = find_inputs(tmp) inner = [p for p in found if classify(p) in CONVERTIBLE - ARCHIVES] if not inner: # 包里套包(zip 里放 7z 之类):再解一层 for i, p in enumerate(x for x in found if classify(x) in ARCHIVES): sub = os.path.join(tmp, "__inner%d" % i) log("解压内层压缩包 %s" % os.path.relpath(p, tmp), "info") n += extract_archive(p, classify(p), sub, log) inner += [q for q in find_inputs(sub) if classify(q) in CONVERTIBLE - ARCHIVES] pmx = [p for p in inner if classify(p) == "pmx"] todo = pmx or inner # 有 PMX 就只转 PMX(同包里的 FBX 等通常是同一个模型) log("解压出 %d 个文件,其中模型 %d 个:%s" % (n, len(todo), "、".join( os.path.relpath(p, tmp) for p in todo)), "info") if not todo: raise RuntimeError("压缩包中没有可转换的模型(PMX / FBX / uemodel / psk / xps)") names = _unique_names(todo) # 只转 PMX 时几个模型的贴图都写进输出目录的同一个 textures 文件夹:一个一个转 each = dict(opts, jobs=1) if opts["target"] == "pmx" else opts return _convert_each([(_convert_inner, (p, os.path.relpath(p, tmp), out_dir, opts), {"edits": edits, "name": names[i]}) for i, p in enumerate(todo)], names, [os.path.getsize(p) for p in todo], each, log, "压缩包中") finally: shutil.rmtree(tmp, ignore_errors=True) def _convert_inner(path, rel, out_dir, opts, log, edits=None, name=None): """压缩包里的一个模型(rel:在包里的相对路径,日志用)。并行时在子进程里跑(见 _convert_each)。""" log("→ %s" % rel, "head") return _convert_model(path, classify(path), out_dir, opts, log, edits, name=name) def _convert_model(path, kind, out_dir, opts, log, edits=None, name=None): """name:转 VRM 时的输出名(不给时用文件名;unitypackage 里的几个模型各用各的文件名)。""" if kind == "pmx": return _to_vrm(path, out_dir, opts, log, name=name, edits=edits) if opts["target"] == "pmx": # 只转 PMX:道具在 MMD 里照样有用,不挑 pmxs = to_pmx(path, kind, out_dir, opts, log) for p in pmxs: log("已写出 %s" % os.path.basename(p), "ok") return pmxs # 转 VRM 时中间的 PMX 和它的贴图只是过渡:放临时目录,转完删掉,输出目录只留 VRM if kind in ("fbx", "unitypackage"): fbxs, dest = _unpack_fbxs(path, log) if kind == "unitypackage" else ([path], None) try: return _fbxs_to_vrm(fbxs, out_dir, opts, log, edits, name=name if kind == "fbx" else None) finally: if dest: shutil.rmtree(dest, ignore_errors=True) work = tempfile.mkdtemp(prefix="vrmify_work_") try: outs = [] for p in to_pmx(path, kind, work, opts, log): outs += _to_vrm(p, out_dir, opts, log, name=name, edits=edits, step="PMX → VRM:%s" % os.path.basename(p)) return outs finally: shutil.rmtree(work, ignore_errors=True) def not_an_avatar(model, weights=None): """看起来不是人物时返回原因,否则 None(「只转换人物」用)。 * 道具:骨架里认不出头或腰(剑、椅子、请柬……一般只有一两根骨)。模之屋的模型包里常带着。 * 只有衣服 / 配件:VRChat 等的模型包里常有单独的服装 FBX,骨架是完整的,网格只有衣服。判断: 头部(头骨及其子骨,包括头发、眼睛)没挂任何顶点,或者两只手都没挂顶点(认不出手时不看手)。 model:PMX 路径或读好的模型(pmxio.read_pmx);weights:已经算好的不带别名的顶点权重。 """ import pmxio from vrmconv import mesh from vrmconv.humanoid import _map_humanoid m = model if isinstance(model, dict) else pmxio.read_pmx(model) human = _map_humanoid(m["bones"], True, {}) parents = [b["parent"] for b in m["bones"]] def subtree(root): out, grew = {root}, True while grew: grew = False for i, p in enumerate(parents): if p in out and i not in out: out.add(i) grew = True return out if "head" not in human or "hips" not in human: return "未识别到人形骨架,可能是道具" if weights is None: weights = mesh.vertex_weights(m["vertices"], len(m["bones"]), {}) used = {b for wl in weights for b, w in wl if w > 0.3} if not used & subtree(human["head"]): return "头部没有网格,可能只有服装或配件" hands = [human[h] for h in ("leftHand", "rightHand") if h in human] if len(hands) == 2 and not used & (subtree(hands[0]) | subtree(hands[1])): return "手部没有网格,可能只有服装或配件" return None