Files
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

758 lines
31 KiB
Python
Raw Permalink 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 -*-
"""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())