Files
VRMify-Enhanced/convert/pmx2vrm.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

493 lines
28 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 -*-
"""pmx2vrm.py - 把 PMX 模型转成 VRM(glTF 2.0 / GLB 容器),纯 Python 标准库。
不需要 Blender、不需要 mmd_tools、不需要 Unity。
坐标约定(数值均指文件里存的原始数字)
--------
PMX(MMD) 正面 -Z,角色左手侧 +X,Y 向上(DirectX 左手系,逆时针缠绕)
VRM 0.x 正面 -Z,角色左手侧 -X,Y 向上(glTF 右手系、逆时针为正面)
VRM 1.0 正面 +Z,角色左手侧 +X,Y 向上
所以:
* PMX(DirectX 左手系)与 glTF(右手系)手性相反:同一组数字直接
解释是镜像人形,必须反射一个轴——转 0.x 取反 X;转 1.0 取反 Z。
* 两种情况三角绕序都要反转(反射把「外面看逆时针」颠倒了)。
* 尺寸:MMD 模型约 20 单位高,VRM 用米,默认按 1.6 m 归一。
用法:
python pmx2vrm.py model.pmx -o model.vrm
python pmx2vrm.py model.pmx --spec 0x --title "名字" --author "作者"
"""
import argparse
import os
import sys
# 让 `python convert/pmx2vrm.py ...` 也能直接跑:脚本自己所在目录(convert/)和同级的
# formats/ 都要进 sys.path。以前这里只加了 convert/,于是 `import pmxio` 之类会
# ModuleNotFoundError —— 而 README 里给的命令行用法就是这么调的。
_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 pmxio # noqa: E402
import vrmio # noqa: E402
from vrmconv import autophys, checks, expressions, mesh, morphbake, skeleton, springbone_v0, textures, vrm_ext # noqa: E402
from vrmconv.materials import MaterialBuilder # noqa: E402
from vrmconv.springbone import _build_springs # noqa: E402
# ---------------------------------------------------------------- 主流程 --
def convert(pmx_path, vrm_path, spec="1.0", scale_mode="auto",
rotate="auto", reverse_winding="auto", meta=None,
max_morphs=None, log=None, force_double_sided=False,
tpose=False, outline=False, unity_outline=False, sparse_morphs=True,
spring=True, spring_skirt=True, spring_stiffness=1.0,
spring_gravity=0.0, spring_gravity_skirt=0.1, spring_center=True,
spring_opts=None, tex_max=0, tex_jpeg=False, tex_no_mip=False, auto_spring=True, gaze=True,
combo_expr=True, extra_expr=True, collapse_bones=True, model=None, raw_weights=None, tex_alpha=None,
threads=4):
"""PMX → VRM,返回统计 dict。log(msg, tag=None) 用于输出进度。
各阶段在 vrmconv/ 里:skeleton(骨骼、T-pose、节点)→ springbone(物理)→
mesh + materials(网格、MToon)→ expressions(表情)→ vrm_ext(VRM 扩展)。
auto_spring:模型完全没有物理刚体时,按骨骼名 / 结构自动补(vrmconv/autophys)。
tex_max / tex_jpeg:贴图最大边长(0 = 原样)/ 不透明贴图改存 JPEG(需要 Pillow,见 vrmconv/textures)。
tex_no_mip:贴图采样器禁用 mipmap,缓解 UV 岛无 gutter 时沿接缝渗出的白边(默认 False)。
gaze:有左右眼骨时补 lookUp / lookDown / lookLeft / lookRight 表情(转眼骨烘焙成顶点偏移,
见 vrmconv/morphbake;模型自己有对应表情时不补)。
combo_expr:情绪预设(happy / angry / sad / relaxed / surprised)组合眉、眼、嘴的表情,
像 VRoid 一样整张脸一起变(见 vrmconv/expressions.COMBO);False 时每个预设只对应一个表情。
extra_expr:补充自定义表情 hideHighlight(关掉眼睛高光)和 tongue(吐舌),见 expressions.add_extras。
collapse_bones:没有权重的中间骨(全ての親 / センター / グルーブ / 腰 / 肩P 之类)也去掉,
层级像 VRoid(Root > Hips);False 时留着它们(连接保留骨所需的祖先)。IK、合并掉的付与骨、末端骨这类完全不起作用的骨总会去掉(见 _prune_nodes)。
meta:title / author / version / contact / copyright / license_url / avatar_permission /
commercial_usage / credit_notation / allow_redistribution / modification(见 vrm_ext)。
model / raw_weights / tex_alpha:调用方已经有的,省得再算一遍——读好的 PMX(pmxio.read_pmx,
会被改动)、不带付与别名的顶点权重(mesh.vertex_weights(..., {}))、贴图透明统计
{normcase 绝对路径: vrmio.png_alpha_stats 的结果}(FBX 转换判断透明时已经解过贴图)。
threads:同时处理几张贴图(解码、瘦身)。
reverse_winding:
"auto"(默认)——用「几何面法线 vs 顶点法线」投票自动判定;
True / False ——手动强制反转 / 不反转。
手性说明(2026-09-18 重写):PMX(MMD / DirectX 左手系)数值上
脸朝 -Z、左手在 +X;同一组数字按 glTF 右手系直接解释是镜像人形,
必须做一次镜面反射(0.x 取反 x;1.0 取反 z)。反射会把
「从外面看逆时针」颠倒成顺时针,所以 auto 绕序判定(用反射后的
数据投票)正常会判「反转」。以前不做反射(或用 y180 纯旋转,
旋转改不了手性)会让转出的模型左右翻转。
"""
# 确保输出目录存在(CLI 直接调用时尤其容易漏建)
_odir = os.path.dirname(os.path.abspath(vrm_path))
try:
os.makedirs(_odir, exist_ok=True)
except OSError as e:
raise OSError("无法创建输出目录 %s:%s" % (_odir, e))
def _log(msg, tag=None):
if log is not None:
try:
log(msg, tag)
except TypeError:
log(msg)
if model is None:
model = pmxio.read_pmx(pmx_path)
skeleton.fix_facing(model, _log)
base_dir = os.path.dirname(os.path.abspath(pmx_path))
verts = model["vertices"]
bones = model["bones"]
faces = model["faces"]
materials = model["materials"]
is1 = str(spec).startswith("1")
# ---- 缩放
if scale_mode in ("auto", "mmd", None, ""):
ys = [v["pos"][1] for v in verts] or [0.0]
height = max(ys) - min(ys)
scale = (1.6 / height) if height > 1e-6 else 0.08
else:
scale = float(scale_mode)
# ---- 手性修正(2026-09-18 重写,别改回「绕 Y 旋转 180°」)
# PMX(左手系)数值:脸 -Z、左手 +X(实测小食Taberu:
# 両目 Z=-0.75,左腕 X=+1.34 / 右腕 X=-1.34)。
# glTF(右手系)里合法人形:脸 -Z ⇒ 左手 -X;脸 +Z ⇒ 左手 +X。
# 所以必须反射一个轴:0.x(脸 -Z)取反 x;1.0(脸 +Z)取反 z。
# y180 是纯旋转,改不了手性 → 转出的 VRM 左右翻转(实测 Blender 可见)。
# rotate="none" 仅用于调试(原样输出,左右是反的)。
if rotate in ("auto", "y180", None, ""): # y180 为旧值,视同 auto
mx, mz = (1.0, -1.0) if is1 else (-1.0, 1.0)
else: # "none"
mx, mz = 1.0, 1.0
def xf(p):
x, y, z = p
return (x * mx * scale, y * scale, z * mz * scale)
def xf_dir(p):
x, y, z = p
return (x * mx, y, z * mz)
def unit(left_amount, up_amount, front_amount):
if is1: # VRM 1.0:左 +X、前 +Z
return (left_amount, up_amount, front_amount)
return (-left_amount, up_amount, -front_amount)
_log("PMX:顶点 %d · 三角面 %d · 骨骼 %d · 材质 %d · 表情 %d"
% (len(verts), len(faces) // 3, len(bones), len(materials),
len(model["morphs"])))
# ---- 骨骼预处理(都在 PMX 坐标里做,最后统一过 xf):付与骨合并、humanoid、T-pose
# 骨骼表情烘焙用不带别名的权重,网格用带别名的:先算前者,后者只重算挂在别名骨上的顶点
if raw_weights is None:
raw_weights = mesh.vertex_weights(verts, len(bones), {})
bs = skeleton.prepare_bones(bones, is1, _log, weighted={b for wl in raw_weights for b, w in wl if w > 0})
vweights = mesh.vertex_weights(verts, len(bones), bs.alias, base=raw_weights)
for n, rb, rp, lb, lp in mesh.mirror_mismatches(verts, raw_weights, vweights, bs.human_b):
_log("权重:左右对称的 %d 对顶点,右侧主要绑在 %s(%s),左侧却绑在 %s(%s),"
"动作时这部分会变形。可能是模型的权重错误,建议在 PmxEditor 中检查"
% (n, bones[rb]["name"], mesh.LIMB_PART.get(rp, rp), bones[lb]["name"],
mesh.LIMB_PART.get(lp, lp)), "warn")
glob, bpos, vpos, vnrm, vmat = skeleton.apply_tpose(verts, bones, bs, vweights, tpose, _log)
# ---- 缠绕顺序自动判定:必须用「镜像后」的数据投票。
# 镜像反射会把「从外面看逆时针」颠倒成顺时针,所以正常情况下
# auto 在这里会判定为「需要反转」——这不是回到老 bug,
# 老 bug 是「没有反射时硬编码反转」。
if reverse_winding in ("auto", None, ""):
flip, ag, dis = pmxio.detect_winding(
[xf(p) for p in vpos], [xf_dir(n) for n in vnrm], faces)
reverse_winding = bool(flip)
_log("绕序自动判定(手性修正后):与法线同向 %d 面 / 反向 %d 面 → %s"
% (ag, dis, "需要反转" if flip else "保持不变"))
else:
reverse_winding = bool(reverse_winding)
_log("缩放:%.5f(MMD 单位 → 米)· 手性修正:%s · 绕序:%s"
% (scale,
("Z 轴取反" if is1 else "X 轴取反") if (mx, mz) != (1.0, 1.0) else "无",
"反转" if reverse_winding else "保持不变"))
# ---- 骨骼 → glTF 节点;humanoid 缺的必需骨位补占位
tree = skeleton.NodeTree(bones, bs, bpos, xf)
# 0.x 的两节拇指(没有掌根那节):补上 ThumbProximal,和 1.0 一样从第二节(Intermediate)开始对应
roots = [] if is1 else [s + "ThumbProximal" for s in ("left", "right")
if s + "ThumbIntermediate" in bs.human_b and s + "ThumbProximal" not in bs.human_b]
human = tree.humanoid(bs.human_b, bs.required, unit, _log, roots)
tree.lower_hips(human, _log)
# ---- PMX 物理 → SpringBone(1.0 写 VRMC_springBone;0.x 由同一份结果换算成 secondaryAnimation)
spring_ext = None
if spring and auto_spring and autophys.needed(model):
autophys.synthesize(model, bs.parents, bs.alias, bs.human_b, _log)
# 按比例跟随的付与骨拆权重:放在自动补物理之后,补出来的摆动骨也算带物理、不拆
vweights = skeleton.split_partial(bones, bs, vweights, model.get("rigid_bodies"), _log)
checks.report(bones, bs, raw_weights, vweights, bpos, vpos, scale, _log)
if spring:
spring_ext = _build_springs(
model, bs.parents, bs.alias, bs.human_b, glob, bpos, scale, xf,
tree.bone_node, tree.node_pos, tree.add_node,
include_lower=spring_skirt, stiffness_mul=spring_stiffness,
gravity=spring_gravity, gravity_lower=spring_gravity_skirt,
set_parent=tree.set_parent, cloth=(vnrm, vweights, xf_dir), log=_log,
**(spring_opts or {}))
if spring_ext and not is1:
vweights = springbone_v0.fold(tree, bones, vweights, spring_ext, human.values(), _log)
human = _prune_nodes(tree, bones, vweights, human, spring_ext, collapse_bones, _log)
nodes, top_nodes = tree.gltf_nodes()
if spring_ext and not is1:
springbone_v0.order_children(nodes, spring_ext)
# ---- 视线转角:按眼球几何算(lookAt 和补的视线表情都用它)
look, note = None, None
if "leftEye" in bs.human_b or "rightEye" in bs.human_b:
look, note = morphbake.eye_look_range(model, vweights, bs.parents,
[bs.human_b.get("leftEye"), bs.human_b.get("rightEye")])
if look:
_log("视线:左右 %.1f° · 下 %.1f° · 上 %.1f°(%s)"
% (look["lookLeft"], look["lookDown"], look["lookUp"], note))
elif note:
_log("视线:" + note, "warn")
# ---- 逐材质构建网格(材质表情会影响材质的 alphaMode,表情要先整理)
gb = vrmio.GLBBuilder()
gb.samplers.append(vrmio.default_sampler(tex_no_mip))
gaze_extra = _gaze(model, bs.human_b, is1, gaze, _log, look)
if extra_expr and max_morphs != 0:
expressions.add_extras(model, _log)
flat = expressions._flatten_morphs(model["morphs"], model, gaze_extra, weights=raw_weights)
gaze_split = morphbake.split_gaze(flat, {n for n, _ in gaze_extra})
# max_morphs: None = 全部;0 = 不导出;n = 只取前 n 个
if max_morphs is not None and max_morphs >= 0:
flat = flat[:int(max_morphs)]
# unity_outline:源 Unity 材质自己开了描边(FBX → PMX 时写进了 edge 字段)。
# 它和「按 PMX 轮廓线描边」是两回事,前者要无条件保留,后者由用户开关决定。
mats = MaterialBuilder(model, base_dir, gb, is1, flat, outline=(outline or unity_outline),
force_double_sided=force_double_sided,
tex_opt=textures.Optimizer(tex_max, tex_jpeg), known_alpha=tex_alpha)
mats.prefetch(threads)
prims, mat_gidx = mesh.build_primitives(model, xf, xf_dir, vpos, vnrm, vweights,
reverse_winding, mats.make)
# skin.joints 只放留下的骨;JOINTS_0 从 PMX 骨序号换成在 joints 里的位置
joint_bones = [i for i in range(len(bones)) if tree.bone_node(i) is not None]
mesh.remap_joints(prims, {b: k for k, b in enumerate(joint_bones)})
_log("网格:按材质分为 %d 个部分" % len(prims))
mats.log_summary(_log)
if not prims:
raise RuntimeError("此 PMX 没有可用的面数据")
mesh.write_accessors(gb, prims)
# ---- 表情 → morph target + VRM expression
expr = expressions.build_expressions(flat, prims, mats, mat_gidx, gb, xf, vmat,
is1, sparse_morphs, _log, combo=combo_expr,
hidden={d for _, d, _ in gaze_split.values()})
target_names = expr["target_names"]
_gaze_binds(expr, gaze_split, look, is1)
# ---- 按表情分网格(每个网格只带动得到它的 morph target)
groups = mesh.group_meshes(prims, len(target_names))
gltf_meshes, where = mesh.build_meshes(gb, prims, groups, target_names,
model["name"] or "body", sparse_morphs, prim_names=not is1)
if len(gltf_meshes) > 1:
_log("网格:按表情分为 %d 个(%s)" % (len(gltf_meshes), "、".join(
"%s:%d 个表情" % (m["name"], len(m.get("extras", {}).get("targetNames", ()))) for m in gltf_meshes)))
inv = []
for i in joint_bones:
p = tree.node_pos(tree.bone_node(i)) # 节点位置(hips 下移过)
inv.extend([1.0, 0.0, 0.0, 0.0,
0.0, 1.0, 0.0, 0.0,
0.0, 0.0, 1.0, 0.0,
-p[0], -p[1], -p[2], 1.0])
if not inv:
inv = [1.0, 0, 0, 0, 0, 1.0, 0, 0, 0, 0, 1.0, 0, 0, 0, 0, 1.0]
ibm = gb.add_accessor(inv, vrmio.FLOAT, "MAT4", minmax=False)
mesh_nodes = []
taken = {n.get("name") for n in nodes}
for k, m in enumerate(gltf_meshes):
mesh_nodes.append(len(nodes))
# 网格按材质起名,可能和骨骼重名(「髪」):Unity 里按名字找物体的会找错,加后缀
nm = expressions.uniq_name("mesh" if len(gltf_meshes) == 1 else m["name"], taken)
taken.add(nm)
nodes.append({"name": nm, "mesh": k, "skin": 0})
root_index = len(nodes)
nodes.append({"name": "root",
"children": list(top_nodes) + mesh_nodes})
joints = [tree.bone_node(i) for i in joint_bones]
if not joints:
joints = [0]
gltf = {
"asset": {"version": "2.0", "generator": "VRMify Enhanced"},
"scene": 0,
"scenes": [{"nodes": [root_index]}],
"nodes": nodes,
"meshes": gltf_meshes,
"skins": [{"joints": joints, "inverseBindMatrices": ibm,
"skeleton": root_index}],
"materials": mats.materials,
"accessors": gb.accessors,
"bufferViews": gb.bufferViews,
"buffers": [{"byteLength": len(gb.bin)}],
}
if gb.images:
gltf["images"] = gb.images
gltf["textures"] = gb.textures
gltf["samplers"] = gb.samplers
# 绑定的 morph target 序号 → 各网格里的;1.0 的 node 指向网格节点,0.x 的 mesh 指向网格号
mesh.remap_binds(expr, where, mesh_nodes, is1)
# ---- VRM 扩展
meta = meta or {}
title = meta.get("title") or model["name"] or "PMX Model"
if is1:
gltf["extensionsUsed"] = ["VRMC_vrm", "VRMC_materials_mtoon"]
gltf["extensions"] = {"VRMC_vrm": vrm_ext.build_vrm1(meta, title, human,
mesh_nodes, expr, look)}
if spring_ext:
if spring_center:
# center = 根节点:在模型自身的空间里模拟。应用里人物整体移动(走路的
# 根运动、平移)时,头发/裙摆不会因惯性被甩、往后拖压到腿上,只对身体本身
# 的动作有反应。实测走路时头发摆幅 0.73→0.15、胸部配饰 0.28→0.05、
# 裙摆穿进大腿的顶点 10→3。规范要求 center 是链首关节或其祖先,根节点满足
for sp in spring_ext["springs"]:
sp["center"] = root_index
gltf["extensionsUsed"].append("VRMC_springBone")
gltf["extensions"]["VRMC_springBone"] = spring_ext
else:
gltf["extensionsUsed"] = ["VRM"]
secondary = (springbone_v0.to_secondary(spring_ext, nodes, root_index if spring_center else None, _log)
if spring_ext else None)
gltf["extensions"] = {"VRM": vrm_ext.build_vrm0(meta, title, human, expr,
mats.props_0x, look, len(gltf_meshes),
secondary)}
size = vrmio.write_glb(gltf, gb.bin, vrm_path)
n_expr = (len(expr["preset"]) + len(expr["custom"])) if is1 else len(expr["blend_groups"])
_log("已写出 %s(%.2f MB)· 节点 %d · morph target %d · 表情 %d"
% (os.path.basename(vrm_path), size / 1048576.0, len(nodes),
len(target_names), n_expr), "ok")
return {"nodes": len(nodes), "primitives": len(prims), "meshes": len(gltf_meshes),
"morphs": len(target_names), "bytes": size, "scale": scale,
"vertices": sum(p["vcount"] for p in prims)}
def _prune_nodes(tree, bones, vweights, human, spring_ext, collapse, log):
"""去掉不起作用的节点,返回新的 humanoid 骨位 → 节点。
留下:humanoid 骨、有权重的骨、SpringBone 关节和碰撞体,以及连接它们的祖先(collapse 时祖先不留)。
MMD 模型里 IK、合并进主骨的付与骨(足D 等)、末端骨(先)、操作中心之类的骨不带动任何顶点,
在 VRM 里只是空节点,Blender / Unity 里看起来像一堆挂错位置的碎骨头。
"""
if not bones:
return human
core = set(human.values())
for wl in vweights:
for b, w in wl:
if w > 0:
core.add(tree.bone_node(b))
refs = []
if spring_ext:
refs = [j for sp in spring_ext["springs"] for j in sp["joints"]] + spring_ext.get("colliders", [])
core.update(o["node"] for o in refs)
before = len(tree.names)
new = tree.prune(core, collapse)
for o in refs:
o["node"] = new[o["node"]]
if before > len(tree.names):
log("骨骼:已去掉 %d 个不起作用的节点(%s),保留 %d 个"
% (before - len(tree.names),
"无权重且不属于 humanoid、物理的骨,包括中间的控制骨" if collapse
else "IK、末端骨、已合并的付与骨等无权重且不属于 humanoid、物理的骨", len(tree.names)))
return {k: new[v] for k, v in human.items()}
# -------------------------------------------------------------------- cli --
def _gaze(model, human_b, is1, enabled, log, look=None):
"""要补的视线表情 → [(名字, 骨骼表情 offsets)](交给 _flatten_morphs 烘焙)。"""
if not enabled or "leftEye" not in human_b or "rightEye" not in human_b:
return []
have = set()
for mo in model["morphs"]:
p = expressions._table_preset(mo["name"], True) or expressions._preset_en(mo["name"], True)
if p:
have.add(p)
# 左右(上下)都要补时按 GAZE_MAX 烘焙,之后拆成横向 + 深度两个场、权重给出实际角度(morphbake.split_gaze);
# 只补一边的按实际角度烘焙
deg = dict(look or morphbake.GAZE_DEG)
for a, b, axis in morphbake.GAZE_PAIRS:
if a not in have and b not in have:
deg[a] = deg[b] = morphbake.GAZE_MAX[axis]
out = [(n, offs) for n, offs in morphbake.gaze_offsets(human_b["leftEye"], human_b["rightEye"], deg)
if n not in have]
if out:
log("表情:补充视线表情 %s(由转动眼骨烘焙,lookAt 仍使用骨骼)" % " / ".join(n for n, _ in out))
return out
def _gaze_binds(expr, split, look, is1):
"""拆过的视线表情 → 横向场 + 深度场两个绑定,权重按实际视线角度(vrm_edit 改视线角度时同样重算)。"""
names = expr["target_names"]
for p, (tan, depth, axis) in split.items():
wt, wd = morphbake.gaze_weights((look or morphbake.GAZE_DEG)[p], axis)
slots = [(len(names) - 1 - names[::-1].index(n), w) for n, w in ((tan, wt), (depth, wd))]
if is1:
obj = expr["preset"].get(p)
if obj and (obj.get("extras") or {}).get("source") == p:
obj["morphTargetBinds"] = [{"node": 0, "index": i, "weight": w} for i, w in slots]
else:
for gr in expr["blend_groups"]:
if gr["name"] == p and gr["presetName"] == p.lower():
gr["binds"] = [{"mesh": 0, "index": i, "weight": round(w * 100, 4)} for i, w in slots]
def main(argv=None):
ap = argparse.ArgumentParser(description="PMX → VRM(纯 Python)")
ap.add_argument("pmx")
ap.add_argument("-o", "--out", default=None)
ap.add_argument("--spec", default="1.0", choices=["1.0", "0x"])
ap.add_argument("--scale", default="auto",
help="auto(归一到 1.6 m)或具体倍率")
ap.add_argument("--rotate", default="auto", choices=["auto", "none", "y180"])
ap.add_argument("--flip-winding", action="store_true",
help="强制反转三角形缠绕顺序(默认自动判定)")
ap.add_argument("--force-double-sided", action="store_true",
help="所有材质强制双面(模型仍有镂空时的兜底手段)")
ap.add_argument("--tpose", action="store_true",
help="把 A-pose 手臂抬成 VRM 规范的 T-pose(默认保留原始姿势,不重摆骨架)")
ap.add_argument("--keep-pose", action="store_true", help=argparse.SUPPRESS) # 旧版兼容:默认已是保留原姿势
ap.add_argument("--no-spring", action="store_true",
help="不把 PMX 物理转成 SpringBone(默认转换,仅 VRM 1.0)")
ap.add_argument("--no-spring-skirt", action="store_true",
help="跳过下半身(hips / 腿)下的物理链,通常是裙摆")
ap.add_argument("--spring-stiffness", type=float, default=1.0,
help="SpringBone 硬度整体倍率(默认 1.0,越大越硬)")
ap.add_argument("--spring-gravity", type=float, default=0.0,
help="SpringBone 重力(头发等,默认 0:保持 PMX 原造型;"
"斜着散开的长发加重力会被拉垂)")
ap.add_argument("--spring-gravity-skirt", type=float, default=0.1,
help="下半身(裙摆)SpringBone 重力(默认 0.1,抬腿时裙片落回腿上)")
ap.add_argument("--no-auto-spring", action="store_true",
help="模型没有物理刚体时不自动补(默认按骨骼名给头发、裙摆、袖子等加 SpringBone)")
ap.add_argument("--no-combo-expr", action="store_true",
help="情绪预设不组合眉 / 眼 / 嘴(默认组合,像 VRoid;关掉时每个预设只对应一个 PMX 表情)")
ap.add_argument("--keep-control-bones", action="store_true",
help="保留没有权重的中间骨(全ての親 / センター / グルーブ / 腰 等;默认去掉,层级像 VRoid)")
ap.add_argument("--no-extra-expr", action="store_true",
help="不补充 hideHighlight(关掉眼睛高光)、tongue(吐舌)表情")
ap.add_argument("--no-gaze", action="store_true",
help="不补视线表情(默认有左右眼骨时补 lookUp / lookDown / lookLeft / lookRight)")
ap.add_argument("--no-spring-center", action="store_true",
help="SpringBone 不设 center(默认以模型根节点为 center,人物整体移动时"
"头发/裙摆不会被甩)")
ap.add_argument("--outline", action="store_true",
help="按 PMX 的轮廓线设置写出 MToon 描边(默认不描边)")
ap.add_argument("--dense-morphs", action="store_true",
help="表情用密集存储(默认稀疏存储,文件小很多)")
ap.add_argument("--max-morphs", type=int, default=None,
help="只导出前 N 个表情(0 = 不导出,默认全部)")
ap.add_argument("--tex-max", type=int, default=0,
help="贴图最大边长(如 2048 / 1024,默认 0 = 原样;需要 Pillow)")
ap.add_argument("--tex-jpeg", action="store_true",
help="不透明贴图改存 JPEG(文件小很多;需要 Pillow)")
ap.add_argument("--tex-no-mip", action="store_true",
help="贴图不生成 mipmap,缓解 UV 岛无边距时沿接缝渗出的白边(远景会有轻微锯齿)")
ap.add_argument("--title", default=None)
ap.add_argument("--author", default=None)
a = ap.parse_args(argv)
out = a.out or (os.path.splitext(a.pmx)[0] + ".vrm")
meta = {}
if a.title:
meta["title"] = a.title
if a.author:
meta["author"] = a.author
st = convert(a.pmx, out, spec=("1.0" if a.spec == "1.0" else "0.x"),
scale_mode=a.scale, rotate=a.rotate,
reverse_winding=(True if a.flip_winding else "auto"),
meta=meta, max_morphs=a.max_morphs,
force_double_sided=a.force_double_sided,
tpose=a.tpose, outline=a.outline,
spring=not a.no_spring, spring_skirt=not a.no_spring_skirt,
spring_stiffness=a.spring_stiffness,
spring_gravity=a.spring_gravity,
spring_gravity_skirt=a.spring_gravity_skirt,
spring_center=not a.no_spring_center, auto_spring=not a.no_auto_spring,
sparse_morphs=not a.dense_morphs,
tex_max=a.tex_max, tex_jpeg=a.tex_jpeg, tex_no_mip=a.tex_no_mip, gaze=not a.no_gaze, combo_expr=not a.no_combo_expr, extra_expr=not a.no_extra_expr,
collapse_bones=not a.keep_control_bones,
log=lambda msg, tag=None: print(msg))
print("完成:%s(%.2f MB)" % (out, st["bytes"] / 1048576.0))
return 0
if __name__ == "__main__":
sys.exit(main())