初始化 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
+688
View File
@@ -0,0 +1,688 @@
# -*- coding: utf-8 -*-
"""fbxout.py - 把网格 + 骨骼 + 蒙皮写成 **ASCII FBX 7.4**(纯标准库)。
为什么要 ASCII:二进制 FBX 要做 deflate + 节点表 + 32/64 位偏移宽度,
坑多且难调试(本工程读 FBX 时就踩过 7400=32 位偏移的坑)。ASCII FBX 是
纯文本,任何 DCC(Blender / Maya / 3ds Max / Unity / UE)都认,出问题能直接
肉眼看字节。
坐标系(与工程的 FBX 读取路径**互为逆操作**,可自校验)
fbx = (x, y, -z)_pmx —— 即读取侧的「Z 取反」
PMX 左手系、fbx 右手系 ⇒ 手性和绕序一起翻,所以三角形要**反转绕序**。
GlobalSettings 里如实声明 UpAxis=Y / FrontAxis=Z(sign +1) / CoordAxis=X,
这样 Blender、Maya 之流会按声明把模型摆正(角色在 Blender 里仍朝 -Y)。
用本工程的 FBX→PMX 路径(Z 轴翻转=开)再读回来,应当与源 PMX 一致。
蒙皮约定(FBX SDK 的老规矩)
对每个 Cluster:TransformLink = 绑定姿势下骨骼的世界矩阵 W,
Transform = W⁻¹
于是 TransformLink · Transform = I ⇒ 顶点本来就在绑定姿势里,静止时不变形;
摆姿势时按 A_bone · (Transform · v) 的公式走。绑定姿势的骨骼只有平移
(PMX 的骨骼本来就不带旋转),所以两个矩阵都是纯平移。
矩阵按**行主序**写 16 个数,平移落在最后一行(第 13/14/15 个)。
用法(也可直接当命令行工具,接 .pmx):
python fbxout.py model.pmx -o model.fbx
"""
import argparse
import os
import sys
import time
_HERE = os.path.dirname(os.path.abspath(__file__))
def _log_default(msg, tag=None):
try:
print(msg)
except UnicodeEncodeError:
print(msg.encode("utf-8", "replace").decode("ascii", "replace"))
def _f(v):
"""FBX 里的浮点写法:够短又不丢精度。"""
x = float(v)
if x == int(x) and abs(x) < 1e15:
return str(int(x))
return "%.6g" % x
def _arr(w, indent, values):
"""把整个数组写成一条 `a: ...` 行。
Autodesk 自己的 ASCII FBX 就是这么写的 —— 顶点表几 MB 全塞在一行里很正常。
早期版本按固定条数换行、每行重复写一次 `a:` 标签,虽然也有工具这么干,
但那样会让不少第三方解析器(以及本工程自己)在续行处多吃/漏吃数值,
所以统一改成一条行最保险。
"""
w("%sa: %s" % (indent, ",".join(values)))
def _esc(s):
return (s or "").replace("\\", "\\\\").replace('"', '\\"')
def _san(s):
"""名字里的非 ASCII 会被某些工具当成编码问题,统一换成下划线。"""
out = []
for ch in (s or ""):
out.append(ch if 32 < ord(ch) < 127 else "_")
nm = "".join(out).strip() or "unnamed"
return nm[:120]
def _name(prefix, s):
"""带 `Class::` 命名空间的名字(FBX 里的传统写法)。"""
return "%s::%s" % (prefix, _san(s))
def _clip(s, n=120):
"""名字清洗:去掉控制字符(换行会破坏 FBX 的行结构)并截断。
与 `_san` 不同,这里**保留非 ASCII** —— 表情名用日文/中文很常见,
而 FBX 文本本身就是 UTF-8,SDK 与 Blender 都能正确解码。
"""
s = (s or "").strip()
s = "".join(ch for ch in s if ord(ch) >= 32)
return s[:n]
class _Ids(object):
def __init__(self, start=1000000, step=100000):
self.n = start
self.step = step
def block(self):
base = self.n
self.n += self.step
return base
def _weights_of(vertex):
"""PMX 顶点 → [(骨骼下标, 权重)]。
PMX 的约定:wt=1(BDEF2) 只存 w1,w2 = 1-w1;wt=3(SDEF) 同 BDEF2;
wt=4(QDEF) 同 BDEF4。把补位权重丢掉,只留真正参与的点。
"""
wt = vertex.get("wtype", 0)
bs = list(vertex.get("wbones") or [])
ws = list(vertex.get("wweights") or [])
out = []
if wt in (0,) or not bs:
return [(bs[0] if bs else 0, 1.0)]
if wt in (1, 3):
w1 = ws[0] if ws else 1.0
out = [(bs[0], w1), (bs[1] if len(bs) > 1 else bs[0], 1.0 - w1)]
else: # 2=BDEF4 / 4=QDEF
for k in range(min(len(bs), 4)):
w = ws[k] if k < len(ws) else 0.0
if w > 1e-6:
out.append((bs[k], w))
out = [(b, w) for b, w in out if w > 1e-6]
return out or [(0, 1.0)]
def export_model(path, verts, faces, materials, bones, morphs=None,
mirror_z=True, reverse_winding=True, tex_dir=None, log=None,
creator="ueformat2pmx", name=None, model_name="model",
flip_v=True):
"""写出 ASCII FBX。
verts : PMX 顶点 dict 列表(pos/normal/uv/wtype/wbones/wweights)
faces : 展平的三角索引
materials : PMX 材质 dict 列表(用 name/diffuse/tex)
bones : PMX 骨骼 dict 列表(用 name/pos/parent)
morphs : PMX 表情 dict 列表;kind=1(顶点表情)会写成
BlendShape/BlendShapeChannel/Shape —— 只写真正动过的控制点,
数值是**增量**(FBX 文件里 Shape 的 Vertices 就是这个语义)。
骨骼/UV/材质表情 FBX 装不下,跳过。
model_name : 网格节点名(默认 "model",传模型名更友好)
flip_v : 是否把 UV 的 V 轴翻过来(**默认必须翻**,见下面注释)
返回统计 dict。
"""
_l = log or _log_default
sx = 1.0
sz = -1.0 if mirror_z else 1.0
if name:
model_name = name
model_name = _san(model_name)
def xf(p):
return (p[0] * sx, p[1], p[2] * sz)
nv = len(verts)
ntris = len(faces) // 3
out = []
w = out.append
# ------------------------------------------------- 表情预处理(→ Shape)--
# **FBX 文件里 Shape 的 Vertices 是「相对基础控制点的增量」,不是绝对坐标**
# (实测确认:写全 0 → 读回等于原网格;写基础坐标 → 读回是两倍)。
# FBX SDK / Blender 读取时会给未列在 Indexes 里的控制点补 0 增量,
# 并把结果展开成与网格控制点等长的绝对坐标数组 —— 读取端因此**不需要**
# 知道我们只写了变化点,插件侧的 FbxShape.GetControlPointAt 拿到的就是
# 与网格一一对应的绝对坐标。
# 于是这里只写「真正动过的控制点」:本工程样本 161 个表情、每个约 600 点,
# 合计约 3 MB;若按全量写,光这一个模型就要 300 MB 以上。
morph_shapes = []
for mo in (morphs or []):
if int(mo.get("kind", 1)) != 1:
continue # 只搬顶点表情;骨骼/UV/材质表情 FBX 装不下
pairs = {}
for vi, d in (mo.get("offsets") or []):
vi = int(vi)
if 0 <= vi < nv:
pairs[vi] = d
if pairs:
morph_shapes.append((mo, pairs))
n_shape = len(morph_shapes)
n_attr = len(bones) + 1 # 每根骨骼一个 + 网格一个
# 每根骨骼影响哪些顶点(Cluster 用;顺带决定 Definitions 里 Deformer 的数量)
per_bone = {}
for vi, v in enumerate(verts):
for b, wt in _weights_of(v):
if 0 <= b < len(bones):
per_bone.setdefault(b, []).append((vi, wt))
n_cluster = len(per_bone)
n_def = 1 + n_cluster + (1 + n_shape if n_shape else 0)
hdr_axis = "Z" if mirror_z else "-Z"
_l("FBX:%d 顶点 · %d 三角面 · %d 骨骼 · %d 材质(ASCII 7.4,%s-up,前方 %s)%s"
% (nv, ntris, len(bones), len(materials), "Y", hdr_axis,
("· %d 个顶点表情写入 BlendShape" % n_shape) if n_shape else ""))
ids = _Ids()
gid = ids.block() # Geometry
mid = ids.block() # Mesh Model
bone_id0 = ids.block() # 骨骼 Model 段
mat_id0 = ids.block() # Material 段
tex_id0 = ids.block() # Texture / Video 段
def_id0 = ids.block() # Deformer 段(Skin + Cluster)
na_id0 = ids.block() # NodeAttribute 段(骨骼 + 网格)
morph_id0 = ids.block() # BlendShape / BlendShapeChannel / Shape 段
bone_model = [bone_id0 + i for i in range(max(len(bones), 1))]
# ------------------------------------------------------------ 头 + 设置 --
w("; FBX 7.4.0 project file")
w("; 由 %s 生成(纯 Python,ASCII FBX)" % creator)
w("; ----------------------------------------------------")
w("")
t = time.localtime()
w("FBXHeaderExtension: {")
w("\tFBXHeaderVersion: 1003")
w("\tFBXVersion: 7400")
w("\tCreationTimeStamp: {")
w("\t\tVersion: 1000")
w("\t\tYear: %d" % t.tm_year)
w("\t\tMonth: %d" % t.tm_mon)
w("\t\tDay: %d" % t.tm_mday)
w("\t\tHour: %d" % t.tm_hour)
w("\t\tMinute: %d" % t.tm_min)
w("\t\tSecond: %d" % t.tm_sec)
w("\t\tMillisecond: 0")
w("\t}")
w('\tCreator: "%s"' % creator)
w("}")
w("")
w("GlobalSettings: {")
w("\tVersion: 1000")
w("\tProperties70: {")
w('\t\tP: "UpAxis", "int", "Integer", "",1')
w('\t\tP: "UpAxisSign", "int", "Integer", "",1')
w('\t\tP: "FrontAxis", "int", "Integer", "",2')
w('\t\tP: "FrontAxisSign", "int", "Integer", "",%d'
% (1 if mirror_z else -1))
w('\t\tP: "CoordAxis", "int", "Integer", "",0')
w('\t\tP: "CoordAxisSign", "int", "Integer", "",1')
w('\t\tP: "OriginalUpAxis", "int", "Integer", "",1')
w('\t\tP: "OriginalUpAxisSign", "int", "Integer", "",1')
w('\t\tP: "UnitScaleFactor", "double", "Number", "",1')
w('\t\tP: "OriginalUnitScaleFactor", "double", "Number", "",1')
w('\t}')
w("}")
w("")
# ------------------------------------------------------------ Definitions --
n_tex = sum(1 for m in materials
if isinstance(m.get("tex"), int) and m["tex"] >= 0)
w("Definitions: {")
w("\tVersion: 100")
# Count = 下面 ObjectType 块的**个数**:GlobalSettings / Model / Geometry /
# Material / Deformer / NodeAttribute,有贴图时再加 Texture 与 Video。
w("\tCount: %d" % (6 + (2 if n_tex else 0)))
w('\tObjectType: "GlobalSettings" {')
w("\t\tCount: 1")
w("\t}")
w('\tObjectType: "Model" {')
w("\t\tCount: %d" % (1 + len(bones)))
w("\t}")
w('\tObjectType: "Geometry" {')
w("\t\tCount: %d" % (1 + n_shape))
w("\t}")
# NodeAttribute 段不能省:**Model 的「类型」是由它挂着的 NodeAttribute
# 对象决定的**,Model 行里的 "LimbNode" 只是个字符串。
# 少了它,FBX SDK 侧 node.GetNodeAttribute() 返回 null(网格还能靠
# Geometry 连接被 SDK 兜回来,骨骼却没有任何线索),任何按 SDK API
# 判断骨骼的导入器都会一根骨头都收不到 —— PE 的 FBX 导入插件就是这样
# 在 PE 里「只有网格、没有骨骼」的。
w('\tObjectType: "NodeAttribute" {')
w("\t\tCount: %d" % n_attr)
w("\t}")
if n_tex:
w('\tObjectType: "Video" {')
w("\t\tCount: %d" % n_tex)
w("\t}")
w('\tObjectType: "Texture" {')
w("\t\tCount: %d" % n_tex)
w("\t}")
w('\tObjectType: "Material" {')
w("\t\tCount: %d" % max(len(materials), 1))
w("\t}")
w('\tObjectType: "Deformer" {')
w("\t\tCount: %d" % n_def)
w("\t}")
w("}")
w("")
# ---------------------------------------------------------------- Objects --
w("Objects: {")
# Geometry
w('\tGeometry: %d, "%s", "Mesh" {' % (gid, _name("Geometry", "mesh")))
w("\t\tVertices: *%d {" % (nv * 3))
_arr(w, "\t\t\t", [_f(c) for v in verts for c in xf(v["pos"])])
w("\t\t} ")
# 三角形的顶点顺序。**PVI / 法线 / UVIndex 三处必须用同一个顺序**:
# 法线与 UV 都是 ByPolygonVertex(每个多边形顶点一项,按多边形顶点顺序
# 一一对应)。镜像手性时绕序要反转,但如果只反 PVI、不反 UVIndex 与
# 法线,等于把每个三角形首末两个角的 UV/法线对调 —— 几何形状完全正确、
# 贴图却整片错乱(用户报的「FBX 材质显示不对、同时导出的 PMX 正常」
# 就是这个:实测 115563/115563 个三角形全部首末对调)。
tris = []
for t2 in range(ntris):
a, b, c = faces[t2 * 3], faces[t2 * 3 + 1], faces[t2 * 3 + 2]
if reverse_winding:
a, b, c = c, b, a
tris.append((a, b, c))
w("\t\tPolygonVertexIndex: *%d {" % (ntris * 3))
buf = []
for a, b, c in tris:
buf.append("%d,%d,%d" % (a, b, -(c + 1))) # 末位取反 = 多边形结束
_arr(w, "\t\t\t", buf)
w("\t\t} ")
w("\t\tGeometryVersion: 124")
# 法线:ByPolygonVertex(最兼容的写法)
w("\t\tLayerElementNormal: 0 {")
w("\t\t\tVersion: 101")
w('\t\t\tName: ""')
w('\t\t\tMappingInformationType: "ByPolygonVertex"')
w('\t\t\tReferenceInformationType: "Direct"')
w("\t\t\tNormals: *%d {" % (ntris * 9))
buf = []
for tri in tris:
for vi in tri:
n = verts[vi]["normal"] if vi < nv else (0.0, 1.0, 0.0)
buf.append("%s,%s,%s" % (_f(n[0] * sx), _f(n[1]), _f(n[2] * sz)))
_arr(w, "\t\t\t\t", buf)
w("\t\t\t} ")
w("\t\t}")
# UV:ByPolygonVertex + IndexToDirect
# **V 轴必须翻**:MMD / PMX / UE 的 UV 原点在**左上**(v 向下),而 FBX 的
# 通行约定(Autodesk / Blender / Maya)原点在**左下**(v 向上)。原样写出去,
# 下游按 v 向上解释就把贴图上下颠倒了 —— 表现为形状完全正确、图案整体错位
# (脸上出现嘴/脖子处的图、腿脚出现靴子、头发出现大片黑斑)。本工程的
# fbx2pmx 读 FBX 时同样做 `1.0 - v`,两边对称,导入导出往返才能对上。
w("\t\tLayerElementUV: 0 {")
w("\t\t\tVersion: 101")
w('\t\t\tName: "UVChannel_1"')
w('\t\t\tMappingInformationType: "ByPolygonVertex"')
w('\t\t\tReferenceInformationType: "IndexToDirect"')
w("\t\t\tUV: *%d {" % (nv * 2))
buf = []
for v in verts:
u = v.get("uv") or (0.0, 0.0)
vv = (1.0 - u[1]) if flip_v else u[1]
buf.append("%s,%s" % (_f(u[0]), _f(vv)))
_arr(w, "\t\t\t\t", buf)
w("\t\t\t} ")
w("\t\t\tUVIndex: *%d {" % (ntris * 3))
buf = []
for tri in tris:
buf.append("%d,%d,%d" % tri)
_arr(w, "\t\t\t\t", buf)
w("\t\t\t} ")
w("\t\t}")
# 逐面材质
if materials:
w("\t\tLayerElementMaterial: 0 {")
w("\t\t\tVersion: 101")
w('\t\t\tName: ""')
w('\t\t\tMappingInformationType: "ByPolygon"')
w('\t\t\tReferenceInformationType: "IndexToDirect"')
w("\t\t\tMaterials: *%d {" % ntris)
per_mat = []
for mi, mt in enumerate(materials):
per_mat.extend([mi] * (max(0, int(mt.get("faces", 0))) // 3))
if len(per_mat) < ntris:
per_mat.extend([0] * (ntris - len(per_mat)))
del per_mat[ntris:]
_arr(w, "\t\t\t\t", [str(x) for x in per_mat])
w("\t\t\t} ")
w("\t\t}")
w("\t\tLayer: 0 {")
w("\t\t\tVersion: 100")
w('\t\t\tLayerElement: {')
w('\t\t\t\tType: "LayerElementNormal"')
w("\t\t\t\tTypedIndex: 0")
w("\t\t\t}")
w('\t\t\tLayerElement: {')
w('\t\t\t\tType: "LayerElementUV"')
w("\t\t\t\tTypedIndex: 0")
w("\t\t\t}")
if materials:
w('\t\t\tLayerElement: {')
w('\t\t\t\tType: "LayerElementMaterial"')
w("\t\t\t\tTypedIndex: 0")
w("\t\t\t}")
w("\t\t}")
w("\t}")
# 骨骼:Model(LimbNode),Lcl Translation = 相对父骨骼的位置(绑定姿势只有平移)
bpos = [xf(b["pos"]) for b in bones]
for bi, b in enumerate(bones):
p = b.get("parent", -1)
if 0 <= p < len(bones):
d = (bpos[bi][0] - bpos[p][0], bpos[bi][1] - bpos[p][1],
bpos[bi][2] - bpos[p][2])
else:
d = bpos[bi]
# 骨名写**裸名**、不加 `Model::` 前缀。本工程自己的 FBX→PMX 读取路径
# 会把 Model 名字原样当骨名用,加前缀会让「导出再读回」的骨名变成
# `Model::Bip001Pelvis`,导进 Blender / UE 看着也脏。
w('\tModel: %d, "%s", "LimbNode" {' % (bone_model[bi], _san(b["name"])))
w("\t\tVersion: 232")
w("\t\tProperties70: {")
w('\t\t\tP: "InheritType", "enum", "", "",1')
# **DefaultAttributeIndex 不能省**(网格 Model 一直有它,骨骼以前漏了):
# FBX SDK 只在 Model 显式声明这个属性之后,才会把 "OO" 连接上来的
# NodeAttribute 挂到该节点上;缺了它 node.GetNodeAttribute() 永远是 null。
# 这正是「骨骼在 Blender 里看得见(Blender 自己解析文件,不看这个属性),
# 在 PE 的 FBX 导入插件里却一根都没有(插件走 FBX SDK 的 API)」的原因。
# 实测:同一份文件只补这一行,eSkeleton 节点数 0 → 489。
w('\t\t\tP: "DefaultAttributeIndex", "int", "Integer", "",0')
w('\t\t\tP: "Lcl Translation", "Lcl Translation", "", "A",%s,%s,%s'
% (_f(d[0]), _f(d[1]), _f(d[2])))
w('\t\t\tP: "Lcl Rotation", "Lcl Rotation", "", "A",0,0,0')
w('\t\t\tP: "Lcl Scaling", "Lcl Scaling", "", "A",1,1,1')
w('\t\t}')
w('\t\tShading: T')
w('\t\tCulling: "CullingOff"')
w("\t}")
# 网格节点
w('\tModel: %d, "%s", "Mesh" {' % (mid, _san(model_name)))
w("\t\tVersion: 232")
w("\t\tProperties70: {")
w('\t\t\tP: "InheritType", "enum", "", "",1')
w('\t\t\tP: "DefaultAttributeIndex", "int", "Integer", "",0')
w("\t\t}")
w("\t\tShading: T")
w('\t\tCulling: "CullingOff"')
w("\t}")
# 节点属性:骨骼 → Skeleton,网格 → Mesh。名字照 Autodesk 的习惯留空
# (`"NodeAttribute::"`),类型由第三个字符串决定。
for bi in range(len(bones)):
w('\tNodeAttribute: %d, "NodeAttribute::", "LimbNode" {' % (na_id0 + bi))
w('\t\tTypeFlags: "Skeleton"')
w("\t}")
w('\tNodeAttribute: %d, "NodeAttribute::", "Mesh" {' % (na_id0 + len(bones)))
w('\t\tTypeFlags: "Mesh"')
w("\t\tGeometryVersion: 124")
w("\t}")
# 材质(+ 贴图 Video/Texture)
mat_ids = []
tex_ids = []
for mi, mt in enumerate(materials or [{"name": "material_0",
"diffuse": (1.0, 1.0, 1.0, 1.0),
"tex": -1}]):
myid = mat_id0 + mi
mat_ids.append(myid)
diff = list(mt.get("diffuse") or (1.0, 1.0, 1.0, 1.0))
alpha = diff[3] if len(diff) > 3 else 1.0
w('\tMaterial: %d, "%s", "" {' % (myid, _name("Material", mt.get("name"))))
w("\t\tVersion: 102")
w('\t\tShadingModel: "phong"')
w("\t\tMultiLayer: 0")
w("\t\tProperties70: {")
w('\t\t\tP: "DiffuseColor", "Color", "", "A",%s,%s,%s'
% (_f(diff[0]), _f(diff[1]), _f(diff[2])))
w('\t\t\tP: "DiffuseFactor", "Number", "", "A",1')
w('\t\t\tP: "TransparencyFactor", "Number", "", "A",%s'
% _f(1.0 - max(0.0, min(1.0, alpha))))
w('\t\t\tP: "SpecularColor", "Color", "", "A",0,0,0')
w('\t\t\tP: "SpecularFactor", "Number", "", "A",0')
w('\t\t\tP: "ShininessExponent", "Number", "", "A",0')
w('\t\t\tP: "EmissiveColor", "Color", "", "A",0,0,0')
w('\t\t\tP: "AmbientColor", "Color", "", "A",0.5,0.5,0.5')
w("\t\t}")
w("\t}")
ti = mt.get("tex", -1)
if isinstance(ti, int) and ti >= 0:
tex_ids.append((mi, ti))
# 贴图(引用文本文件名,不内嵌二进制)
tex_files = {}
if tex_ids and tex_dir is not None:
folder_idx = {}
try:
for fn in os.listdir(tex_dir):
folder_idx.setdefault(fn.lower(), fn)
except OSError:
pass
for mi, ti in tex_ids:
vid = tex_id0 + mi * 2
tid = vid + 1
# 文件名由调用方通过 materials[i]["_tex_file"] 传入;没有就按序号找
fn = materials[mi].get("_tex_file")
if not fn:
hits = [v for k, v in folder_idx.items()
if k.endswith(".png") and ("tex%02d" % ti) in k]
fn = hits[0] if hits else None
if not fn:
continue
rel = "textures/" + fn
tex_files[mi] = rel
w('\tVideo: %d, "Video::tex%d", "Clip" {' % (vid, mi))
w("\t\tType: \"Clip\"")
w("\t\tProperties70: {")
w('\t\t\tP: "Path", "KString", "XRefUrl", "", "%s"' % _esc(rel))
w("\t\t}")
w("\t\tUseMipMap: 0")
w('\t\tFilename: "%s"' % _esc(rel))
w('\t\tRelativeFilename: "%s"' % _esc(rel))
w("\t}")
w('\tTexture: %d, "Texture::tex%d", "" {' % (tid, mi))
w('\t\tType: "TextureVideoClip"')
w("\t\tVersion: 202")
w('\t\tTextureName: "Texture::tex%d"' % mi)
w('\t\tMedia: "Video::tex%d"' % mi)
w('\t\tFileName: "%s"' % _esc(rel))
w('\t\tRelativeFilename: "%s"' % _esc(rel))
w("\t\tModelUVTranslation: 0,0")
w("\t\tModelUVScaling: 1,1")
w('\t\tTexture_Alpha_Source: "None"')
w("\t\tCropping: 0,0,0,0")
w("\t}")
# 蒙皮:Skin + 每个骨骼一个 Cluster
skin_id = def_id0
w('\tDeformer: %d, "Deformer::Skin", "Skin" {' % skin_id)
w("\t\tVersion: 101")
w("\t\tLink_DeformAcuracy: 50")
w("\t}")
# per_bone / n_cluster 已经在前面算好(Definitions 里要用到)
for bi in sorted(per_bone):
pairs = sorted(per_bone[bi])
cx = bpos[bi]
w('\tDeformer: %d, "SubDeformer::%s", "Cluster" {'
% (skin_id + 1 + bi, _san(bones[bi]["name"])))
w("\t\tVersion: 100")
w('\t\tUserData: "", ""')
w("\t\tIndexes: *%d {" % len(pairs))
_arr(w, "\t\t\t", [str(x[0]) for x in pairs])
w("\t\t} ")
w("\t\tWeights: *%d {" % len(pairs))
_arr(w, "\t\t\t", [_f(x[1]) for x in pairs])
w("\t\t} ")
# 行主序 4x4:TransformLink = W(骨骼世界),Transform = W⁻¹
w("\t\tTransform: *16 {")
w("\t\t\ta: " + ",".join(["1", "0", "0", "0", "0", "1", "0", "0",
"0", "0", "1", "0",
_f(-cx[0]), _f(-cx[1]), _f(-cx[2]), "1"]))
w("\t\t} ")
w("\t\tTransformLink: *16 {")
w("\t\t\ta: " + ",".join(["1", "0", "0", "0", "0", "1", "0", "0",
"0", "0", "1", "0",
_f(cx[0]), _f(cx[1]), _f(cx[2]), "1"]))
w("\t\t} ")
w("\t}")
# 表情:BlendShape → BlendShapeChannel(一个表情一个)→ Shape(增量)
# 名字一律写**裸名**(和骨名一样,不加 `SubDeformer::` / `Shape::` 前缀):
# · FBX SDK 侧 channel.GetName() 会把前缀剥掉,两种写法结果相同;
# · 本工程自己的 fbx2pmx 直接取字段原文,写裸名才不会把表情名变成
# "Shape::L_P";
# · Blender 的 shape key 名字也直接取这个字段。
# 名字里的非 ASCII(日文表情名很常见)**保留原样** —— FBX 文本是 UTF-8,
# SDK 与 Blender 都能正确解码,换成下划线反而让用户在 PE 里认不出表情。
shape_ids = {}
if n_shape:
w('\tDeformer: %d, "BlendShape", "BlendShape" {' % morph_id0)
w("\t\tVersion: 101")
w("\t}")
for k, (mo, pairs) in enumerate(morph_shapes):
cid = morph_id0 + 1 + k * 2
sid = cid + 1
shape_ids[k] = (cid, sid)
nm = _esc(_clip(mo.get("name"))) or ("morph_%d" % k)
w('\tDeformer: %d, "%s", "BlendShapeChannel" {' % (cid, nm))
w("\t\tVersion: 100")
# 字段名是 DeformPercent(不是 DeformerPercent)——后者会被 SDK 当成
# 未知字段默默丢掉,通道权重就一直是 0。
w("\t\tDeformPercent: 0")
# FullWeights = 每个 target shape 的默认权重(百分比)。SDK 导出时必写。
w("\t\tFullWeights: *1 {")
w("\t\t\ta: 100")
w("\t\t} ")
w("\t}")
keys = sorted(pairs)
w('\tGeometry: %d, "%s", "Shape" {' % (sid, nm))
w("\t\tVersion: 100")
w("\t\tIndexes: *%d {" % len(keys))
_arr(w, "\t\t\t", [str(x) for x in keys])
w("\t\t} ")
w("\t\tVertices: *%d {" % (len(keys) * 3))
buf = []
for vi in keys:
d = xf(pairs[vi])
buf.append("%s,%s,%s" % (_f(d[0]), _f(d[1]), _f(d[2])))
_arr(w, "\t\t\t", buf)
w("\t\t} ")
w("\t}")
w("}")
w("")
# ------------------------------------------------------------ Connections --
w("Connections: {")
w('\tC: "OO",%d,0' % mid)
w('\tC: "OO",%d,%d' % (gid, mid))
w('\tC: "OO",%d,%d' % (skin_id, gid))
# 每个 Model 挂自己的 NodeAttribute(没有它 SDK 认不出节点类型)
w('\tC: "OO",%d,%d' % (na_id0 + len(bones), mid))
for bi in range(len(bones)):
w('\tC: "OO",%d,%d' % (na_id0 + bi, bone_model[bi]))
# 表情链:Shape → Channel → BlendShape → Geometry
if n_shape:
w('\tC: "OO",%d,%d' % (morph_id0, gid))
for k in range(n_shape):
cid, sid = shape_ids[k]
w('\tC: "OO",%d,%d' % (cid, morph_id0))
w('\tC: "OO",%d,%d' % (sid, cid))
for bi in range(len(bones)):
p = bones[bi].get("parent", -1)
if 0 <= p < len(bones):
w('\tC: "OO",%d,%d' % (bone_model[bi], bone_model[p]))
else:
w('\tC: "OO",%d,0' % bone_model[bi])
if bi in per_bone:
w('\tC: "OO",%d,%d' % (skin_id + 1 + bi, skin_id))
w('\tC: "OO",%d,%d' % (bone_model[bi], skin_id + 1 + bi))
for mi, myid in enumerate(mat_ids):
w('\tC: "OO",%d,%d' % (myid, mid))
if mi in tex_files:
tid = tex_id0 + mi * 2 + 1
w('\tC: "OP",%d,%d, "DiffuseColor"' % (tid, myid))
w("}")
w("")
w("Takes: {")
w('\tCurrent: ""')
w("}")
w("")
data = "\n".join(out)
tmp = path + ".tmp"
with open(tmp, "w", encoding="utf-8", newline="\n") as f:
f.write(data)
os.replace(tmp, path)
st = {"bytes": len(data.encode("utf-8")), "vertices": nv, "tris": ntris,
"bones": len(bones), "materials": len(materials or []),
"clusters": n_cluster, "textures": len(tex_files),
"shapes": n_shape, "morphs": len(morphs or [])}
_l("FBX:%d 个 Cluster · %d 个表情 Shape · 引用贴图 %d 张 · %.2f MB"
% (n_cluster, n_shape, len(tex_files), st["bytes"] / 1048576.0))
return st
def export_pmx(pmx_path, fbx_path, log=None, mirror_z=True):
"""直接读 PMX 再写 FBX(命令行用)。"""
import pmxio
m = pmxio.read_pmx(pmx_path)
tex_dir = os.path.join(os.path.dirname(os.path.abspath(pmx_path)), "textures")
for mt in m["materials"]:
ti = mt.get("tex", -1)
if isinstance(ti, int) and 0 <= ti < len(m["textures"]):
mt["_tex_file"] = os.path.basename(m["textures"][ti])
model_name = (m.get("name") or "").strip() or \
os.path.splitext(os.path.basename(pmx_path))[0]
return export_model(fbx_path, m["vertices"], m["faces"], m["materials"],
m["bones"], m["morphs"], mirror_z=mirror_z,
reverse_winding=True, tex_dir=tex_dir, log=log,
creator="fbxout.py", model_name=model_name)
def main(argv=None):
ap = argparse.ArgumentParser(description="PMX → ASCII FBX 7.4(纯 Python)")
ap.add_argument("src")
ap.add_argument("-o", "--out", default=None)
ap.add_argument("--no-mirror", action="store_true",
help="不取反 Z(默认取反,与工程 FBX 读取路径互逆)")
a = ap.parse_args(argv)
out = a.out or (os.path.splitext(a.src)[0] + ".fbx")
st = export_pmx(a.src, out, log=lambda m_, t=None: print(m_),
mirror_z=not a.no_mirror)
print("完成:%s(%.2f MB)" % (out, st["bytes"] / 1048576.0))
return 0
if __name__ == "__main__":
sys.exit(main())