Files
VRMify-Enhanced/tools/batch_convert.py
T
Black-Cyan 60cce66993
Tests / test (push) Has been cancelled
初始化 VRMify 增强版(VRMify Enhanced)
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
2026-11-15 23:21:59 +08:00

147 lines
7.1 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""批量把一个目录下的 PMX 转成 VRM。
python tools/batch_convert.py [模型目录] [-o 输出目录] [--only 关键字 ...]
[--variants both|spring|nospring] [--spec 1.0|0.x]
[-j 进程数] [--report 结果.json]
* 模型目录下每个子文件夹算一个角色,递归找其中所有 .pmx;子文件夹里的 .zip
(作者常把道具、差分模型打包在里面)也会解出其中的 .pmx 一起转。解压在临时
目录里进行(连同角色文件夹的贴图一起复制过去,相对路径才找得到),不改动
模型目录本身。
* 输出:<输出目录>/有SpringBone/<角色>/<名>.vrm 和 <输出目录>/无SpringBone/<角色>/<名>.vrm
(--variants 只要其中一种时不分这一层)。
* 角色文件夹名形如「<名字>_by_<游戏>_<哈希>」(模之屋的下载格式)时整理成
「<游戏>—<名字>」,并去掉「(修模绑骨后)」这类说明和结尾的版本号;其它名字原样使用。
* 最后打印每个模型的结果;用占位骨补齐 humanoid 的(道具、非人形)会标出来。
"""
import argparse
import glob
import json
import os
import shutil
import sys
import tempfile
import time
import zipfile
from concurrent.futures import ProcessPoolExecutor
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path[:0] = [os.path.join(ROOT, "convert"), os.path.join(ROOT, "formats")]
import pipeline # noqa: E402
char_name = pipeline.nice_name # 角色文件夹名 → 输出用的角色名
def collect(model_dir, extract_dir, only=None):
"""→ [(角色文件夹名, pmx 路径, 来源)];only = 文件夹名须包含其中之一的关键字。"""
jobs = []
for d in sorted(glob.glob(os.path.join(model_dir, "*"))):
if not os.path.isdir(d):
continue
folder = os.path.basename(d)
if only and not any(k in folder for k in only):
continue
have = set()
for p in sorted(glob.glob(os.path.join(d, "**", "*.pmx"), recursive=True)):
jobs.append((folder, p, "folder"))
have.add(os.path.basename(p))
zips = sorted(glob.glob(os.path.join(d, "*.zip")))
if not zips:
continue
copy = os.path.join(extract_dir, folder)
for z in zips:
with zipfile.ZipFile(z) as zf:
for info, names in pipeline.zip_members(zf):
base = os.path.basename(names[0])
if not base.lower().endswith(".pmx") or base in have:
continue
if not os.path.isdir(copy):
shutil.copytree(d, copy, ignore=shutil.ignore_patterns(
"*.zip", "*.vrm", "*.pmx"))
dst = os.path.join(copy, base)
with zf.open(info) as src, open(dst, "wb") as f:
shutil.copyfileobj(src, f)
jobs.append((folder, dst, "zip:" + os.path.basename(z)))
have.add(base)
return jobs
def run(job):
folder, pmx, src, out_dir, variants, spec = job
sys.path[:0] = [os.path.join(ROOT, "convert"), os.path.join(ROOT, "formats")]
import pmx2vrm
stem = os.path.splitext(os.path.basename(pmx))[0]
res = {"folder": folder, "char": char_name(folder), "pmx": pmx, "src": src, "stem": stem}
for label, spring in variants:
sub = [out_dir] + ([label] if len(variants) > 1 else []) + [res["char"], stem + ".vrm"]
out = os.path.join(*sub)
logs = []
t = time.time()
try:
st = pmx2vrm.convert(pmx, out, spec=spec, spring=spring, meta={"title": stem},
log=lambda m, tag=None: logs.append((tag, m)))
res[label] = {"ok": True, "out": out, "mb": st["bytes"] / 1048576.0,
"sec": time.time() - t, "logs": logs}
except Exception as e: # noqa: BLE001 一个模型失败不影响其它
import traceback
res[label] = {"ok": False, "err": "%s: %s" % (type(e).__name__, e),
"tb": traceback.format_exc()[-2000:], "logs": logs}
return res
def main(argv=None):
ap = argparse.ArgumentParser(description="批量把目录下的 PMX 转成 VRM")
ap.add_argument("models", nargs="?", default=os.path.join(ROOT, "model"),
help="模型目录(每个子文件夹一个角色),默认 ./model")
ap.add_argument("-o", "--out", default=os.path.join(ROOT, "vrm"), help="输出目录,默认 ./vrm")
ap.add_argument("--only", nargs="+", metavar="关键字",
help="只转文件夹名包含这些关键字的角色,如 --only 穗穗 爱弥斯")
ap.add_argument("--variants", choices=("both", "spring", "nospring"), default="both",
help="同时输出有 / 无 SpringBone 两份(默认),或只要其中一种")
ap.add_argument("--spec", choices=("1.0", "0.x"), default="1.0", help="VRM 版本,默认 1.0")
ap.add_argument("-j", "--jobs", type=int, default=max(1, min(6, (os.cpu_count() or 2) - 1)),
help="并行进程数")
ap.add_argument("--report", help="把每个模型的结果和日志写成 JSON(给 tools/qa 用)")
a = ap.parse_args(argv)
variants = {"both": [("有SpringBone", True), ("无SpringBone", False)],
"spring": [("有SpringBone", True)],
"nospring": [("无SpringBone", False)]}[a.variants]
if a.spec != "1.0" and a.variants != "nospring":
print("提示:VRM 0.x 不输出 SpringBone,「有SpringBone」那份会和「无」一样")
extract = tempfile.mkdtemp(prefix="vrmify_zip_")
try:
jobs = collect(a.models, extract, a.only)
names = [(char_name(f), os.path.basename(p)) for f, p, _ in jobs]
dup = {n for n in names if names.count(n) > 1}
if dup:
sys.exit("输出文件重名:%s" % sorted(dup))
print("共 %d 个 PMX → %s" % (len(jobs), a.out))
args = [(f, p, s, a.out, variants, a.spec) for f, p, s in jobs]
with ProcessPoolExecutor(max_workers=a.jobs) as ex:
results = list(ex.map(run, args))
finally:
shutil.rmtree(extract, ignore_errors=True)
n_fail = 0
for r in results:
oks = [r[label]["ok"] for label, _ in variants]
n_fail += oks.count(False)
first = r[variants[0][0]]
ph = sum(1 for _, m in first.get("logs", []) if "占位骨骼" in m)
print("%s %-16s %-28s %s%s" % (
"OK " if all(oks) else "FAIL", r["char"][:16], r["stem"][:28],
("占位骨 %d 根" % ph) if ph else "",
"" if all(oks) else " " + "; ".join(r[l].get("err", "") for l, _ in variants)))
if a.report:
with open(a.report, "w", encoding="utf-8") as f:
json.dump({"variants": [l for l, _ in variants], "results": results}, f,
ensure_ascii=False, indent=1)
print("完成:%d 个模型,失败 %d 次" % (len(results), n_fail))
return 1 if n_fail else 0
if __name__ == "__main__":
sys.exit(main())