初始化 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
+757
View File
@@ -0,0 +1,757 @@
# -*- coding: utf-8 -*-
"""PSK / PSKX(Unreal ActorX)→ MMD PMX,纯 Python 标准库。
和项目里其它转换器保持同一套口径:
· 换轴 (x, y, z)_psk → (x, z, y)_pmx(Y/Z 对调,详见 convert() 里的长注释)
· 缩放 按包围盒高度归一到 MMD 常规的 20 单位
· 居中 x/z 取包围盒中心、y 脚底归零
· 骨骼 Bip001 这套 3dsMax Biped 命名默认转成 MMD 标准日文骨名,
英文原名写进骨骼的英文名(name_en)字段,两边都不丢
· 表情 PSK 的 MRPHINFO/MRPHDATA(顶点位移增量)→ PMX 顶点表情
· 材质 按材质名在源目录找同名贴图;toon 一律不使用
骨骼世界矩阵的坑见 formats/pskio.py 头部注释(四元数要取共轭)。
"""
import os
import re
import shutil
import sys
BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
for _sub in ("formats", "convert"):
_p = os.path.join(BASE, _sub)
if os.path.isdir(_p) and _p not in sys.path:
sys.path.insert(0, _p)
import pskio
import pmxio
# --------------------------------------------------------- toon(不使用) ------
# PMX 材质的 toon 字段由「共有Toonフラグ」决定宽度,两个方向都别搞反
# (PMX 规范 + mmd_tools 的 `is_shared_toon_texture` 一致):
#
# flag = 1 → 共享/内建 toon。字段是 **1 字节编号**,引用 MMD 安装目录
# `Data/` 下的 toon01.bmp … toon10.bmp。
# ⚠ **编号 0 就是 toon01.bmp,不是「不使用」**。mmd_tools 源码里
# 写死了这个 +1:
# toon_path = "toon%02d.bmp" % (shared_toon_texture + 1)
# MMD 的 Data 目录里**根本没有 toon00.bmp**(只有 toon01..toon10),
# 所以「编号 0 = toon00.bmp = 不使用 toon」这个说法是错的。
#
# flag = 0 → 本模型**纹理表**里的贴图。字段是**纹理索引宽度**(ti),
# **-1 = なし(不使用)**。
#
# 所以「不使用 toon」唯一正确的写法是 `toon_flag = 0, toon = -1`。
#
# 2026-09-24 修正:以前四个转换器都写 `flag=1, toon=0`(注释误以为 0 是
# toon00.bmp = 不使用),实际等于给每个材质硬套了一层 **toon01.bmp**,用户反馈
# 「PMX 文件还是自动上了 Toon 路径」。
# 对照实测:用户本机那份公认正常的 `Anastasya.pmx`,全部 13 个材质都是
# `toon_flag=0 / toon=-1`;而本工具产出的 `R2T1FeiBiMd10011.pmx` 是 `flag=1/0`。
_TOON_NONE_FLAG = 0
_TOON_NONE_INDEX = -1
def _log_default(msg, tag=None):
print(msg)
# ------------------------------------------------------------- 骨名映射 ------
# Bip001(3dsMax Biped)→ MMD 标准骨名。映射不到的保留原名。
_BONE_JP = {
"Root": "全ての親",
"Bip001": "グルーブ",
"Bip001Pelvis": "センター",
"Bip001Spine": "上半身",
"Bip001Spine1": "上半身1",
"Bip001Spine2": "上半身2",
"Bip001Neck": "首",
"Bip001Head": "頭",
"Bip001LClavicle": "左肩",
"Bip001RClavicle": "右肩",
"Bip001LUpperArm": "左腕",
"Bip001RUpperArm": "右腕",
"Bip001LForearm": "左ひじ",
"Bip001RForearm": "右ひじ",
"Bip001LHand": "左手首",
"Bip001RHand": "右手首",
"Bip001LThigh": "左足",
"Bip001RThigh": "右足",
"Bip001LCalf": "左ひざ",
"Bip001RCalf": "右ひざ",
"Bip001LFoot": "左足首",
"Bip001RFoot": "右足首",
"Bip001LToe0": "左つま先",
"Bip001RToe0": "右つま先",
}
# 手指:Bip001LFinger0 / LFinger01 / LFinger1 / LFinger11 ...
# 拇指从 0 起,其余手指从 1 起(MMD 标准骨名的惯例)。
_FINGER_JP = ("親指", "人指", "中指", "薬指", "小指")
_FW = ("0", "1", "2", "3", "4", "5")
_SIDE_JP = {"L": "左", "R": "右"}
_FINGER_RE = re.compile(r"^Bip001([LR])Finger(\d)(\d?)$")
def bone_jp(name):
"""单根骨骼名 → MMD 日文名;没有对应条目就返回 None(保留原名)。"""
if name in _BONE_JP:
return _BONE_JP[name]
m = _FINGER_RE.match(name or "")
if m:
side, finger, seg = m.group(1), int(m.group(2)), m.group(3)
if 0 <= finger < len(_FINGER_JP):
base = 0 if finger == 0 else 1 # 拇指从 0、其余从 1
idx = base + (int(seg) if seg else 0)
if idx < len(_FW):
return "%s%s%s" % (_SIDE_JP[side], _FINGER_JP[finger], _FW[idx])
return None
# ----------------------------------------------------------------- 小工具 ----
def _uniq(name, used):
base = (name or "").strip() or "bone"
if base not in used:
used.add(base)
return base
i = 1
while "%s_%d" % (base, i) in used:
i += 1
nm = "%s_%d" % (base, i)
used.add(nm)
return nm
def _morph_panel(name):
"""PMX 表情面板:1=眉 2=目 3=口 4=その他(只影响 MMD 里的分组)。"""
n = (name or "").lower()
if n.startswith("b_") or "brow" in n or n.startswith("mayu"):
return 1
if n.startswith("e_") or "pupil" in n or "eye" in n or n.startswith("hitomi"):
return 2
if (n.startswith("l_") or n.startswith("r_") or n.startswith("aa")
or n.startswith("mouth") or "lip" in n or "tooth" in n
or "tongue" in n or n.startswith("kuch")):
return 3
return 4
_TEX_EXT = (".png", ".bmp", ".tga", ".jpg", ".jpeg", ".dds")
def _copy_tex(src, dst, remove_alpha):
"""拷贴图;remove_alpha 时复用 uemodel2pmx 那套去 alpha 逻辑。"""
if remove_alpha:
try:
import uemodel2pmx
r = uemodel2pmx._copy_texture(src, dst, True)
if r:
return r
except Exception:
pass
shutil.copyfile(src, dst)
return "copied"
def _find_texture(folder, mat_name):
"""按材质名在同目录(含 Textures 子目录)找贴图文件,返回绝对路径或 None。"""
cands = []
nm = mat_name or ""
cands.append(nm)
if nm.startswith("MI_"):
cands.append(nm[3:])
if nm.startswith("M_"):
cands.append(nm[2:])
for base in list(cands):
for suf in ("_D", "_Diffuse", "_BaseColor", "_Albedo", "_d", "_C"):
cands.append(base + suf)
dirs = [folder]
for sub in ("Textures", "textures", "Texture"):
d = os.path.join(folder, sub)
if os.path.isdir(d):
dirs.append(d)
parent = os.path.dirname(folder)
for sub in ("Textures", "textures"):
d = os.path.join(parent, sub)
if os.path.isdir(d):
dirs.append(d)
lower = {}
for d in dirs:
try:
for f in os.listdir(d):
st, ext = os.path.splitext(f)
if ext.lower() in _TEX_EXT:
lower.setdefault((d, st.lower()), f)
except OSError:
pass
for base in cands:
if not base:
continue
for (d, st), f in lower.items():
if st == base.lower():
return os.path.join(d, f)
return None
# ------------------------------------------------------------------- 主体 ----
def _warn_anchor_collision(out_path, log):
"""提示 `.psk` 同名冲突(PmxEditor 的「アンカーデータ」误读)。
PmxEditor 打开 `xxx.pmx` 时会自动去找**同名**的 `xxx.psk`,当成它的
「アンカー(锚点/权重编辑)数据」加载 —— 见菜单
`[ファイル] → [アンカーデータの自動読み込み/保存]` 与它的 readme:
「モデルファイル名と同名のアンカーデータファイル(*.psk)がある場合自動読み込み」
而 `*.psk` 恰好又是 Unreal ActorX 网格的扩展名,也就是本工具的**输入**格式。
于是「源 psk 和输出 pmx 同名同目录」这种最自然的用法,一定会让 PmxEditor 弹:
アンカーデータの読み込みに失敗しました。
这个报错**不影响模型**(点确定后模型照常显示),但很吓人,所以主动说一声。
"""
d = os.path.dirname(os.path.abspath(out_path)) or "."
stem = os.path.splitext(os.path.basename(out_path))[0]
clash = [f for f in (stem + ".psk", stem + ".pskx")
if os.path.isfile(os.path.join(d, f))]
if not clash:
return
log("提示:同一目录下有同名的 %s。PmxEditor 打开此 PMX 时会尝试将其作为"
"「アンカーデータ」(锚点 / 权重数据)加载,并提示"
"「アンカーデータの読み込みに失敗しました。」,点击确定即可,不影响模型。"
"如需避免,可移动或重命名 PMX,或在 PmxEditor 中关闭"
"[ファイル]→[アンカーデータの自動読み込み/保存]。"
% " / ".join(clash), "warn")
def convert(path, out_path, scale_mode="mmd", log=None, name=None,
enable_edge=False, force_double_sided=False, textures=True,
keep_add_uv=True, remove_alpha=True, flip_winding="auto",
center=True, jp_bones=True, make_ik=True, export_morphs=True,
fbx_path=None):
"""PSK/PSKX → PMX。返回统计 dict。"""
_l = log or _log_default
m = pskio.read_psk(path)
kind = "PSKX" if m.face32 else "PSK"
_l("读取 %s:顶点 %d · 楔 %d · 三角面 %d · 材质 %d · 骨骼 %d · 权重 %d"
% (kind, len(m.points), len(m.wedges), len(m.faces),
len(m.materials), len(m.bones), len(m.weights)))
if not m.points or not m.wedges:
raise ValueError("此文件中没有网格数据(PNTS / VTXW 为空)")
if not m.faces:
raise ValueError("此文件中没有面数据(FACE 块为空)")
_l("表情 %d 个 · 附加 UV %d 套 · %s"
% (len(m.morphs), len(m.extra_uvs),
"含法线" if m.normals else "不含法线(将自动计算)"))
# ---- 坐标变换
#
# 实测(R2T1FeiBiMd10011.psk / R2T1AimisiMd10011.pskx 两个文件一致):
# Bip001LHand 在 +X、Bip001RHand 在 -X → PSK 的 +X = 模型**左手**
# 脚踝 → 脚尖的方向 ≈ (0, -0.47, -0.88) → PSK 的 -Y = 模型**正面**
# (另有一条独立佐证:整体包围盒在 +Y 侧明显更长,那是头发/披风/背包)
# 整体 +Z = 上
# 而 MMD/PMX 的约定是:**正面 -Z、左手 +X、上 +Y**
# (见 pmx2vrm.py 里对实测模型「小食Taberu」的记录:両目 Z=-0.75、
# 左腕 X=+1.34;本机 F:\测试\...\Anastasya.pmx 复核同样成立)。
#
# 所以只要把 PSK 的 Y 和 Z 对调就同时满足三条:
# 左手 +X → +X ✓ 上 +Z → +Y ✓ 正面 -Y → -Z ✓
#
# 注意这里**不是** uemodel2pmx 那种 (x, z, -y):
# (x, z, -y) 行列式 +1(纯旋转,不改手性),会把正面 -Y 送到 **+Z**,
# 于是人物在 MMD 里背对镜头 —— 这正是 2026-09-24 修掉的那个 bug。
# (x, z, y) 行列式 -1,正好把 PSK 的右手系翻成 MMD 的左手系,手性才对上。
# 因为绕序会跟着反射一起翻,flip_winding="auto" 的投票(以及没有法线时的
# 兜底)都要相应反转,见下面「绕序」那一段。
def xf(p):
return (p[0], p[2], p[1])
# ---- 顶点:一个 wedge 对应一个 PMX 顶点(UV/材质分流都在 wedge 上)
n_wedge = len(m.wedges)
n_point = len(m.points)
raw_pos = []
bad_wedge = 0
for pi, u, v, _mi in m.wedges:
if not (0 <= pi < n_point):
pi = 0
bad_wedge += 1
raw_pos.append(m.points[pi])
if bad_wedge:
_l("网格:%d 个楔的点索引越界,已改用第 0 个点" % bad_wedge, "warn")
pts = [xf(p) for p in raw_pos]
ys = [p[1] for p in pts]
lo_y, hi_y = (min(ys), max(ys)) if ys else (0.0, 1.0)
if scale_mode in ("mmd", "auto", None):
scale = 20.0 / max(hi_y, 1e-6)
if hi_y <= 0:
scale = 20.0 / max(abs(lo_y), 1e-6)
_l("缩放:源高 %.2f 单位 × %.6f → %.2f(MMD 标准身高 20)"
% (hi_y, scale, hi_y * scale))
elif scale_mode in ("raw", "none", 1, 1.0):
# 与 fbx2pmx 的 --scale raw 对齐:保持源尺寸不动。
# (以前这里只认 "mmd" 和数字,写 --scale raw 会直接
# ValueError: could not convert string to float: 'raw'。)
scale = 1.0
_l("缩放:保持源尺寸(scale=1.0),源高 %.2f 单位" % hi_y)
else:
scale = float(scale_mode)
_l("缩放:源高 %.2f 单位 × %.6f → %.2f"
% (hi_y, scale, hi_y * scale))
if center and pts:
xs = [p[0] for p in pts]
zs = [p[2] for p in pts]
off = (-(min(xs) + max(xs)) * 0.5 * scale,
-lo_y * scale,
-(min(zs) + max(zs)) * 0.5 * scale)
_l("居中:偏移 (%.3f, %.3f, %.3f)" % off, "info")
else:
off = (0.0, 0.0, 0.0)
def sp(p):
t = xf(p)
return (t[0] * scale + off[0], t[1] * scale + off[1],
t[2] * scale + off[2])
def sdir(d):
"""源位移 → PMX 位移(只换轴 + 缩放,不带平移)。"""
t = xf(d)
return (t[0] * scale, t[1] * scale, t[2] * scale)
# ---- 骨骼世界坐标
_wrot, wpos = pskio.bone_world(m)
bone_pos = [sp(p) for p in wpos]
n_src = len(m.bones)
# ---- 骨骼顺序:DFS,保证父在子前面
kids = [[] for _ in range(n_src)]
roots = []
for i, b in enumerate(m.bones):
p = b.parent_index
if 0 <= p < n_src and p != i:
kids[p].append(i)
else:
roots.append(i)
order = []
seen = [False] * n_src
stack = list(reversed(roots))
while stack:
i = stack.pop()
if seen[i]:
continue
seen[i] = True
order.append(i)
stack.extend(reversed(kids[i]))
for i in range(n_src):
if not seen[i]:
seen[i] = True
order.append(i)
slot = {bi: k for k, bi in enumerate(order)}
used = set()
pmx_bones = []
n_renamed = 0
for src in order:
b = m.bones[src]
jp = bone_jp(b.name) if jp_bones else None
main_name = jp if jp else b.name
if jp:
n_renamed += 1
p = b.parent_index if 0 <= b.parent_index < n_src else -1
pmx_bones.append({
"name": _uniq(main_name, used),
"name_en": b.name or "bone",
"pos": bone_pos[src],
"parent": slot.get(p, -1),
"layer": 0, "flag": 0, "tail_kind": 0, "tail": (0.0, 0.0, 0.0),
"inherit_rot": None, "inherit_mov": None, "fixed_axis": None,
"local_axis": None, "external": None, "ik": None,
"_kids": [],
})
for src in order:
b = m.bones[src]
p = b.parent_index if 0 <= b.parent_index < n_src else -1
if p in slot and slot[p] != slot[src]:
pmx_bones[slot[p]]["_kids"].append(slot[src])
for bk in pmx_bones:
flag = 0x0002 | 0x0004 | 0x0008 | 0x0010 # 可旋转/可移动/可显示/可操作
k = bk.pop("_kids")
if k:
flag |= 0x0001 # 尾 = 骨骼(取第一个子骨骼)
bk["tail_kind"] = 1
bk["tail"] = k[0]
else:
p = bk["parent"]
if 0 <= p < len(pmx_bones):
d = (bk["pos"][0] - pmx_bones[p]["pos"][0],
bk["pos"][1] - pmx_bones[p]["pos"][1],
bk["pos"][2] - pmx_bones[p]["pos"][2])
ln = (d[0] ** 2 + d[1] ** 2 + d[2] ** 2) ** 0.5
bk["tail"] = ((d[0] / ln, d[1] / ln, d[2] / ln) if ln > 1e-9
else (0.0, 1.0, 0.0))
else:
bk["tail"] = (0.0, 1.0, 0.0)
bk["flag"] = flag
_l("骨骼:%d 根%s"
% (len(pmx_bones),
"" if not jp_bones else "(其中 %d 根改为 MMD 标准日文名,"
"原英文名保留在英文名中)" % n_renamed))
# ---- 足 IK(MMD 摆姿势几乎必用;源骨架没有,这里补标准的一套)
def find_bone(jp_name):
for i, b in enumerate(pmx_bones):
if b["name"] == jp_name:
return i
return -1
ik_made = 0
if make_ik:
ground_y = min(p[1] for p in (sp(x) for x in raw_pos)) if raw_pos else 0.0
center_i = find_bone("センター")
for side, s in (("左", "L"), ("右", "R")):
i_ankle = find_bone(side + "足首")
i_knee = find_bone(side + "ひざ")
i_leg = find_bone(side + "足")
i_toe = find_bone(side + "つま先")
if min(i_ankle, i_knee, i_leg) < 0:
continue
ankle = pmx_bones[i_ankle]["pos"]
i_legik = len(pmx_bones)
pmx_bones.append({
"name": _uniq(side + "足IK", used),
"name_en": "LegIK_" + s,
"pos": (ankle[0], ground_y, ankle[2]),
"parent": center_i if center_i >= 0 else 0,
"layer": 0,
"flag": 0x0002 | 0x0004 | 0x0008 | 0x0010 | 0x0020,
"tail_kind": 0, "tail": (0.0, 1.0, 0.0),
"inherit_rot": None, "inherit_mov": None,
"fixed_axis": None, "local_axis": None, "external": None,
"ik": {"target": i_ankle, "iterations": 40,
"limit_angle": 1.0,
"links": [{"bone": i_knee, "min": None, "max": None},
{"bone": i_leg, "min": None, "max": None}]},
})
ik_made += 1
if i_toe >= 0:
toe = pmx_bones[i_toe]["pos"]
pmx_bones.append({
"name": _uniq(side + "つま先IK", used),
"name_en": "ToeIK_" + s,
"pos": (toe[0], ground_y, toe[2]),
"parent": i_legik,
"layer": 0,
"flag": 0x0002 | 0x0004 | 0x0008 | 0x0010 | 0x0020,
"tail_kind": 0, "tail": (0.0, 1.0, 0.0),
"inherit_rot": None, "inherit_mov": None,
"fixed_axis": None, "local_axis": None,
"external": None,
"ik": {"target": i_toe, "iterations": 3,
"limit_angle": 1.0,
"links": [{"bone": i_ankle,
"min": None, "max": None}]},
})
ik_made += 1
if ik_made:
_l("足 IK:已补充 %d 根(足IK / つま先IK,父骨骼 センター)" % ik_made,
"info")
else:
_l("足 IK:源骨架中没有完整的腿部骨链,未补充 IK 骨", "info")
# ---- 面:按材质排序,保证 PMX 材质吃连续的面段
nmats = max(1, len(m.materials))
tri = []
for (i0, i1, i2), mi in m.faces:
if i0 >= n_wedge or i1 >= n_wedge or i2 >= n_wedge:
continue
if not (0 <= mi < nmats):
mi = 0
tri.append((mi, i0, i1, i2))
tri.sort(key=lambda t: t[0])
# ---- 绕序自动判定(用变换后的数据投票;缩放/平移不影响手性)
# xf 是一次反射(行列式 -1),几何绕序会跟着翻,所以下面「没有法线」的兜底
# 也从「保持不变」改成「反转」——不然没带 VTXNORMS 的 psk 会整片背面朝外。
pos_t = [sp(p) for p in raw_pos]
if m.normals and len(m.normals) == n_point:
nrm_t = []
for pi, _u, _v, _mi in m.wedges:
n = m.normals[pi] if 0 <= pi < len(m.normals) else (0.0, 0.0, 1.0)
t = xf(n)
ln = (t[0] ** 2 + t[1] ** 2 + t[2] ** 2) ** 0.5 or 1.0
nrm_t.append((t[0] / ln, t[1] / ln, t[2] / ln))
else:
nrm_t = []
face_idx = []
for _mi, a, b, c in tri:
face_idx.extend((a, b, c))
if flip_winding in ("auto", None, ""):
if nrm_t:
need_flip, ag, dis = pmxio.detect_winding(pos_t, nrm_t, face_idx)
_l("绕序自动判定:与法线同向 %d 面 / 反向 %d 面 → %s"
% (ag, dis, "需要反转" if need_flip else "保持不变"))
else:
need_flip = True
_l("绕序:缺少法线数据,按坐标轴反射统一反转(保持正面朝外)", "info")
else:
need_flip = bool(flip_winding)
pmx_faces = []
for _mi, a, b, c in tri:
pmx_faces.extend((c, b, a) if need_flip else (a, b, c))
# ---- 权重:RAWWEIGHTS 是按「点」索引的,楔要按 point_index 去查
per_point = {}
for w, pi, bi in m.weights:
if 0 <= pi < n_point:
per_point.setdefault(pi, []).append((w, bi))
n_dropped = 0
no_weight = 0
pmx_verts = []
n_add = min(4, len(m.extra_uvs)) if keep_add_uv else 0
for wi, (pi, u, v, _mi) in enumerate(m.wedges):
P = sp(m.points[pi] if 0 <= pi < n_point else (0.0, 0.0, 0.0))
if nrm_t:
N = nrm_t[wi]
else:
N = (0.0, 0.0, 1.0)
wl = [(b, w) for w, b in per_point.get(pi, []) if w > 1e-6]
if len(wl) > 4:
n_dropped += len(wl) - 4
wl.sort(key=lambda t: -t[1])
wl = wl[:4]
wl = [(b, w) for b, w in wl if 0 <= b < n_src]
if not wl:
no_weight += 1
wl = [(0, 1.0)]
tot = sum(w for _, w in wl) or 1.0
wl = [(slot.get(b, 0), w / tot) for b, w in wl]
if len(wl) == 1:
wtype, wbones, wweights = 0, [wl[0][0]], []
elif len(wl) == 2:
wtype, wbones, wweights = 1, [wl[0][0], wl[1][0]], [wl[0][1]]
else:
wtype = 2
wbones = [wl[k][0] if k < len(wl) else wl[0][0] for k in range(4)]
wweights = [wl[k][1] if k < len(wl) else 0.0 for k in range(4)]
add = []
for k in range(n_add):
st = m.extra_uvs[k]
uv = st[wi] if wi < len(st) else (0.0, 0.0)
add.append((uv[0], uv[1], 0.0, 0.0))
pmx_verts.append({"pos": P, "normal": N, "uv": (u, v),
"add_uv": add, "wtype": wtype, "wbones": wbones,
"wweights": wweights, "sdef": None, "edge": 1.0})
if no_weight:
_l("权重:%d 个顶点没有权重,已绑定到第 0 根骨骼" % no_weight, "warn")
if n_dropped:
_l("权重:已丢弃 %d 条第 5 根及以后的骨骼权重(PMX 每个顶点最多 4 根)"
% n_dropped, "info")
# ---- 材质 + 贴图
folder = os.path.dirname(os.path.abspath(path))
out_dir = os.path.dirname(os.path.abspath(out_path))
tex_dir = os.path.join(out_dir, "textures")
pmx_textures = []
tex_slot = {}
n_linked = 0
def use_texture(mat_name):
if mat_name in tex_slot:
return tex_slot[mat_name]
real = _find_texture(folder, mat_name)
if real is None:
real = _find_texture(out_dir, mat_name)
if real is None:
tex_slot[mat_name] = -1
return -1
ext = os.path.splitext(real)[1].lower()
if ext not in _TEX_EXT:
tex_slot[mat_name] = -1
return -1
dst = os.path.join(tex_dir, os.path.basename(real))
try:
os.makedirs(tex_dir, exist_ok=True)
_copy_tex(real, dst, remove_alpha)
except OSError:
tex_slot[mat_name] = -1
return -1
pmx_textures.append("textures/" + os.path.basename(real))
tex_slot[mat_name] = len(pmx_textures) - 1
return tex_slot[mat_name]
counts = [0] * nmats
for _mi, _a, _b, _c in tri:
counts[_mi] += 1
pmx_materials = []
for k in range(nmats):
mt = m.materials[k] if k < len(m.materials) else None
mname = (mt.name if mt and mt.name else "mat%d" % k)
ti = use_texture(mname) if textures else -1
if ti >= 0:
n_linked += 1
flag = 0x0E | (0x10 if enable_edge else 0)
if force_double_sided:
flag |= 0x01
pmx_materials.append({
"name": mname, "name_en": mname,
"diffuse": (1.0, 1.0, 1.0, 1.0),
"specular": (0.0, 0.0, 0.0),
"shininess": 0.0,
"ambient": (0.5, 0.5, 0.5),
"flag": flag,
"edge_color": (0.0, 0.0, 0.0, 1.0),
"edge_size": 1.0 if enable_edge else 0.0,
"tex": ti, "sph": -1, "sph_mode": 0,
# toon:**不使用**。见文件顶部 _TOON_NONE_FLAG 的说明。
"toon_flag": _TOON_NONE_FLAG, "toon": _TOON_NONE_INDEX, "memo": "",
"faces": counts[k],
})
# 空材质(源里声明了但一个面都没用上)会让 PMX 出现 0 面材质段,去掉更干净
pmx_materials = [x for x in pmx_materials if x["faces"] > 0]
if not pmx_materials:
pmx_materials.append({
"name": "material_0", "name_en": "material_0",
"diffuse": (1.0, 1.0, 1.0, 1.0), "specular": (0.0, 0.0, 0.0),
"shininess": 0.0, "ambient": (0.5, 0.5, 0.5),
"flag": 0x0E | (0x10 if enable_edge else 0),
"edge_color": (0.0, 0.0, 0.0, 1.0),
"edge_size": 1.0 if enable_edge else 0.0, "tex": -1, "sph": -1,
"sph_mode": 0, "toon_flag": _TOON_NONE_FLAG,
"toon": _TOON_NONE_INDEX, "memo": "",
"faces": len(pmx_faces) // 3,
})
# PMX 材质的「面数」字段其实是**索引数**(每个三角面占 3 个)
for x in pmx_materials:
x["faces"] = int(x["faces"]) * 3
_l("材质:%d 个 · 关联到贴图 %d 个%s"
% (len(pmx_materials), n_linked,
"" if n_linked else "(源目录中没有同名贴图,导出为无贴图模型)"))
# ---- 表情:MRPH 的位移是按「点」索引的,要摊到该点对应的所有楔上
point_to_wedges = {}
for wi, (pi, _u, _v, _mi) in enumerate(m.wedges):
if 0 <= pi < n_point:
point_to_wedges.setdefault(pi, []).append(wi)
used_mo = set()
pmx_morphs = []
if export_morphs:
for mo in m.morphs:
offs = []
for pi, d in mo.offsets:
dp = sdir(d)
if abs(dp[0]) + abs(dp[1]) + abs(dp[2]) < 1e-9:
continue
for wi in point_to_wedges.get(pi, ()):
if wi < len(pmx_verts):
offs.append((wi, dp))
if not offs:
continue
nm = _uniq(mo.name, used_mo)
pmx_morphs.append({"name": nm, "name_en": mo.name or nm,
"panel": _morph_panel(mo.name), "kind": 1,
"offsets": offs})
_l("表情:%d 个(顶点表情)" % len(pmx_morphs))
# ---- 表示枠 / 模型信息
frames = []
if pmx_bones:
frames.append({"name": "Root", "name_en": "Root", "special": 0,
"items": [(0, i) for i in range(len(pmx_bones))]})
if pmx_morphs:
frames.append({"name": "表情", "name_en": "Exp", "special": 1,
"items": [(1, i) for i in range(len(pmx_morphs))]})
stem = os.path.splitext(os.path.basename(path))[0]
title = name or stem
comment = ["由 %s 转换:%s" % (kind, os.path.basename(path)),
"骨骼 %d 根 · 材质 %d 个 · 表情 %d 个" % (len(pmx_bones),
len(pmx_materials),
len(pmx_morphs)),
"converted by psk2pmx.py"]
model = pmxio.new_model(title)
model["name"] = title
model["name_en"] = stem
model["comment"] = "\r\n".join(comment)
model["comment_en"] = "\r\n".join(comment)
model["vertices"] = pmx_verts
model["faces"] = pmx_faces
model["textures"] = pmx_textures
model["materials"] = pmx_materials
model["bones"] = pmx_bones
model["morphs"] = pmx_morphs
model["frames"] = frames
model["add_uv"] = n_add
if not enable_edge:
pmxio.strip_edges(model, force_double_sided=False)
size = pmxio.write_pmx(model, out_path)
_l("已写出 %s(%.2f MB)· 顶点 %d · 三角面 %d · 骨骼 %d · 材质 %d · 表情 %d"
% (os.path.basename(out_path), size / 1048576.0, len(pmx_verts),
len(pmx_faces) // 3, len(pmx_bones), len(pmx_materials),
len(pmx_morphs)), "ok")
_warn_anchor_collision(out_path, _l)
st = {"bytes": size, "vertices": len(pmx_verts),
"tris": len(pmx_faces) // 3, "bones": len(pmx_bones),
"materials": len(pmx_materials), "morphs": len(pmx_morphs),
"textures": len(pmx_textures), "scale": scale}
if fbx_path:
try:
import fbxout
st["fbx"] = fbxout.export_model(
fbx_path, pmx_verts, pmx_faces, pmx_materials,
pmx_bones, pmx_morphs,
mirror_z=True, reverse_winding=True, tex_dir=tex_dir,
log=_l, name=title)
_l("已写出 %s(ASCII FBX 7.4 · %.2f MB)"
% (os.path.basename(fbx_path),
st["fbx"]["bytes"] / 1048576.0), "ok")
except Exception as e:
st["fbx_error"] = str(e)
_l("FBX 导出失败:%s" % e, "err")
return st
def main(argv=None):
import argparse
ap = argparse.ArgumentParser(description="PSK / PSKX → MMD PMX(纯 Python)")
ap.add_argument("src")
ap.add_argument("-o", "--out", default=None)
ap.add_argument("--scale", default="mmd",
help="mmd(归一到 20 单位,默认)/ raw(保持源尺寸)/ 具体倍率")
ap.add_argument("--edge", action="store_true", help="给材质开启 MMD 轮廓线")
ap.add_argument("--force-double-sided", action="store_true")
ap.add_argument("--no-textures", action="store_true")
ap.add_argument("--keep-alpha", action="store_true", help="保留贴图 alpha")
ap.add_argument("--no-add-uv", action="store_true")
ap.add_argument("--raw-bone-names", action="store_true",
help="骨骼保留原始英文名,不转 MMD 日文标准名")
ap.add_argument("--no-ik", action="store_true", help="不补 MMD 足 IK 骨")
ap.add_argument("--no-morphs", action="store_true")
ap.add_argument("--fbx", action="store_true", help="同时导出 FBX")
ap.add_argument("--name", default=None)
a = ap.parse_args(argv)
out = a.out or (os.path.splitext(a.src)[0] + ".pmx")
fbx = (os.path.splitext(out)[0] + ".fbx") if a.fbx else None
st = convert(a.src, out, scale_mode=a.scale,
log=lambda m_, t=None: print(m_), name=a.name,
enable_edge=a.edge, force_double_sided=a.force_double_sided,
textures=not a.no_textures, keep_add_uv=not a.no_add_uv,
remove_alpha=not a.keep_alpha, jp_bones=not a.raw_bone_names,
make_ik=not a.no_ik, export_morphs=not a.no_morphs,
fbx_path=fbx)
print("完成:%s(%.2f MB)" % (out, st["bytes"] / 1048576.0))
return 0
if __name__ == "__main__":
sys.exit(main())