导读:约 12 分钟读完;需要会在命令行跑 Python;没拆过 glb 文件也能跟,第 4 节会先补两个前提。
这篇写给正在把「文生 3D 服务给出的模型」往游戏或场景里塞的人:模型能显示,但一拉远拉近就跳、一摆位置就陷地、一转身车头朝侧面。读完之后,你手里会有一套能照着跑的六步顺序,和五条能直接写进脚本的验收断言。先看这张表,找到自己该从哪一节开始:
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 刚拿到一批 AI 生成模型、还没进引擎的人 | 一个十几行的探测脚本 | 先量出每档的面数、贴图尺寸、节点数,判断资产是不是「看着有档位、其实没差别」 | 4 |
| 模型已经进引擎、切档时位置乱跳的人 | 锚点(挂在模型上的固定点,比如炮口位置)对齐与贴地两条规则 | 把切档跳动和陷地一次性修掉,不用逐模型补补偿值 | 6、8 |
| 负责资产验收的人 | 五条断言 + 一张坑表 | 抄成自己项目里的检查脚本,新增载具时照着跑 | 8、9 |
不适合谁:只想了解「AI 建模靠不靠谱」的读者,这篇不讲生成质量,只讲生成之后怎么把资产整理到能用。
一句话:文生 3D 服务给你的是一堆各自独立的文件,而游戏要的是一套能互相替换的同构资产。这篇讲中间那段整理工作。下面这张表是全文导航,每行说清这一节解决什么问题:
| 小节 | 讲什么 | 解决什么问题 |
|---|---|---|
| 3 | 三个典型现象 | 让你判断自己遇到的是不是同一类问题 |
| 4 | 补两个前提 | 先知道 LOD 和这类服务的交付方式 |
| 5 | 探测脚本 | 看清手头的资产到底长什么样 |
| 6 | 六步全貌 | 知道一共有几步、每步为什么存在 |
| 7 | 七条坑 | 会反复踩的地方,含触发场景 |
| 8 | 五条判据 | 抄成自己的验收断言 |
先说我当时看到的三个现象:
它们看着是三个问题,根子上是同一件事:每台车、每个精度档都是各算各的。档位来源、朝向、落地高度没有一处统一基准。
LOD(多细节层次):同一个物体按不同精细程度做几份模型,离镜头近用细的、离得远用粗的,运行时按距离切换。它解决的是「一个模型不可能既近看精细、又远看不卡」的矛盾。本文的场景里,三台车、每台四个档,一共十二个文件。
文生 3D 服务的交付方式:Tripo 这类服务是按档出独立文件的——同一台车导出四个 glb,几何不一样、面数逐档下降、贴图分辨率也逐档下降,最细的一档最贵。这一点必须先说清,因为它决定了下面的做法:每个档位都要拿服务给的对应文件,而不是拿最细那份自己减面三次。
为什么不自己减?三次减面是链式的:第二档从第一档减、第三档从第二档减,误差会叠加,而且你很难复现服务端那一版的比例。
如果你用的服务只给一份模型,那这套流程仍然成立,只是第 1 步变成「用减面工具生成各档」,并且要自己保证每档的面数梯度——区别在于减面质量由你负责。
后面几步都要读写 glb,所以先装工具。glb 是「把模型、材质、贴图打进一个二进制文件」的格式,用 Python 的 pygltflib 就能读:
pip install pygltflib
python -c "import pygltflib; print(pygltflib.__version__)"
# 能看到版本号就说明装好了
下面这段脚本用来回答一个问题:你的四个档,是真的四个档,还是四个长得一样的文件。它打印每个文件的节点数、三角面数和贴图字节数:
from pygltflib import GLTF2
g = GLTF2().load("tank-lod1.glb")
print("节点数", len(g.nodes), "网格数", len(g.meshes))
tris = 0
for mesh in g.meshes:
for prim in mesh.primitives:
tris += g.accessors[prim.indices].count // 3
print("三角面数", tris)
for img in g.images:
bv = g.bufferViews[img.bufferView]
print("贴图", img.mimeType, bv.byteLength, "字节")
跑完你会看到「三角面数 N」「贴图 image/jpeg N 字节」两种行。判读方式:
img.bufferView 报 None,说明贴图是外部文件而不是嵌在 glb 里,这套脚本要改成先读外部文件。整理一台车的资产要做六步,顺序不能乱(前一步的输出是后一步的输入):
下面按这个顺序逐步展开。
为什么需要这一步:前面说过,链式减面会叠误差。更现实的原因是:一旦某一档出问题,你没法判断是「服务生成得不好」还是「你自己减面减坏了」。每档对到自己的来源,问题就能二分。
做法很简单,维护一张来源表。下面这张表每一行回答两件事:这一档的文件从哪来、贴图要做多大:
| 档位 | 来源 | 目标贴图 |
|---|---|---|
| lod1(最精细) | 服务输出的 lod1 文件 | 1024 × 1024 |
| lod2 | 服务输出的 lod2 文件 | 512 × 512 |
| lod3 | 服务输出的 lod3 文件 | 128 × 128 |
| lod4(最粗) | 服务输出的 lod4 文件 | 128 × 128 |
这张表就是后面所有步骤的输入。它的价值在于:任何一次「这档怎么这样」的疑问,都能先回到「它是不是对错了来源」。
为什么需要这一步:我们会把「车头朝向」定义成 +Z 轴——引擎里所有载具的前进方向、炮塔的偏航角都按这个轴算。只要有一个资产的车头朝侧面,它就得在业务代码里被特殊对待,而特殊对待会一路传染到瞄准、开火、停靠判定。
怎么做:在 Blender 里选中模型的所有对象,绕竖直轴旋转(Blender 的竖直轴是 Z,导出成 glTF 后对应 Y),让车头在导出结果里指向 +Z(在 Blender 里就是朝 -Y),然后应用变换。不要只改根节点的旋转——旋转留在节点上,几何本身还是侧着的,后面算包围盒和锚点时会再次出错。
怎么验收:取车身包围盒的最长水平轴,算它与 +Z 的偏航夹角,断言不超过 0.5 度。0.5 度这个阈值不是随手取的:它比「肉眼能看出的歪」小一个量级,又比浮点误差和顶点抽稀带来的抖动大,能过就不会在游戏里看出斜。
为什么需要这一步:模型的原点(pivot)如果在车身中心,你摆位置时 y 就得填「地面高度 + 半个车高」;换一台车高不同,这个补偿值就得换。补偿值一多,总有一处忘记改,于是出现陷地或浮空。
下面这张表对比三种做法各自改了什么、代价是什么:
| 做法 | 改了什么 | 代价 |
|---|---|---|
| 挪顶点 | 直接改几何坐标 | 顶点数据全变,没法再按字节比对 |
| 改根节点位移 | 只动节点变换,几何不动 | 档位之间可以比字节,推荐 |
| 加一层父节点 | 多一个节点承载偏移 | 层级变深,模型树下钻时要多处理一层 |
我们选第二种:只把根节点沿竖直方向平移,让包围盒最低点落在 y = 0。这样「摆在哪就是落在哪」,业务侧 y 直接填地面高度。它还有个副作用好处:各档的几何字节没动,重跑管线时可以直接比对文件指纹,确认「这一档没被意外改动」。
怎么验收:每档包围盒的最低点绝对值不超过 1 厘米。1 厘米是按这台车的体量取的——约等于车长的千分之二,肉眼看不出来,但能抓住真正的偏移。
为什么需要这一步:炮口、发射点这类挂点,如果每档都按自己的几何重新算(比如取某个部件的中心),抽稀之后部件形状变了,算出来的点就会漂。表现是:切档的瞬间,炮口火光或弹道起点跳一下。
原来的做法:每档算一次,各自取几何中心。 现在的做法:只在最精细档算一次,把结果写进锚点,其余档直接复制同一组坐标。 差别:锚点从「每档一个值」变成「四个档一个值」,切档不会再跳;代价是粗档的锚点不一定严格贴在它自己的几何表面上,远看不可见。
验收断言:同一锚点在四个档里的世界坐标两两相差不超过 1 厘米。
为什么需要这一步:贴图是体积大头。最精细档一张 1024 的图就占了文件一多半;如果三档都用 1024,体积会翻几倍,而远处根本看不出差别。
下面这段代码把三档规格集中成一处,后面每一步都从这里取数:
SPEC = {
"textureSizes": {"lod1": 1024, "lod2": 512, "lod3": 128},
"jpegQuality": 80,
}
def target_texture_size(lod: str, spec=SPEC) -> int:
return spec["textureSizes"][lod]
这段代码就是「配置怎么被消费」的全部:管线读一个档位名,查表拿到目标边长,交给缩放那一步。下面是硬编码的写法,同样三档在函数体里逐个判断:
# 原来的写法:每加一档就要改一处 if,漏一处就静默用错尺寸
if lod == "lod1":
size = 1024
elif lod == "lod2":
size = 512
else:
size = 128
差别不在于行数,而在于新增档位时改一处还是改多处:查表法只改 SPEC 一行,if 链要逐个文件找。
关键细节:已经是目标尺寸的贴图,原样搬运字节,不要重新编码。二次 JPEG 编码只会掉质量,体积也不一定更小。我们的实测结果是:最精细档的贴图本来就是这个尺寸,管线直接复用原字节,所以那一档的文件大小一个字节都没变。
质量参数取 80 的依据:同一张贴图在无头 Blender 4.5 里按三种质量编码,实测体积见下表(512 见方 / 128 见方,单位字节):
| 质量 | 512 × 512 | 128 × 128 |
|---|---|---|
| 75 | 44554 | 4967 |
| 80 | 51027 | 5596 |
| 85 | 60056 | 6437 |
取 80 的理由是:相对 75 只多 12%15% 的体积,但能避开低质量档的块状色斑;相对 85 又省下 13%15%。你的场景可以按同一方法实测自己的图——判据是「肉眼看不到块效应」的最小质量,再留一档余量。
为什么需要这一步:前面每一步都有「看起来对了」的可能,而切档、贴地这些问题恰恰是肉眼最迟钝的。断言是把「看起来对」换成「算出来对」。
五条断言:
改完把第 5 节那段探测脚本对新产物再跑一遍:四个档的面数这时应该已经拉开,贴图尺寸也应逐档变小。
再加一道「重跑比对」:整条管线对着原始导出再跑一遍,逐字节比对产物。这条能抓住「某一步是手工改的、下次重跑就丢」的问题。
下面这张表按「你会看到什么 → 为什么 → 怎么解决 → 为什么这样能解决」组织。每条都写了触发场景,方便对号入座:
| 坑 | 为什么是坑 | 怎么解决 | 为什么能解决 |
|---|---|---|---|
| 四个档面数几乎一样(场景:把最细模型连减三次面) | 链式减面的误差叠加,且下游档位复用了上游结果 | 每档吃服务给的对应原始导出 | 每档独立生成,减面只做一次 |
| 轮子陷地或整车浮空(场景:模型原点在车身中心,代码里手填补偿) | 补偿值随车高变化,漏改一处就错 | 把根节点平移到包围盒最低点为 0 | 位置即落点,业务侧不用记补偿 |
| 车头朝侧面(场景:某台车用不同提示词生成,朝向和别的不一致) | 生成服务不保证朝向 | 全资产统一转 +Z 并断言偏航角 | 朝向计算只有一套轴,业务侧没有特判 |
| 切档时炮口特效跳位(场景:每档按自己几何重算挂点) | 抽稀改变了部件形状,挂点跟着漂 | 锚点以最精细档为准,其余照抄 | 锚点只有一个来源,切档不变 |
| 贴图越压越糊、体积还不降(场景:对已是目标尺寸的图又走一遍缩放) | 有损编码叠加,且小图重编码后不一定更小 | 尺寸已达标就原样搬运字节 | 少一次有损编码 |
| 贴图颜色发灰(场景:无头 Blender 用默认色彩变换导出) | 默认的色彩变换会改写像素值 | 强制成标准(Standard)变换、关掉 Look 与曝光 | 输出像素与源图保持一致 |
| 索引改成 16 位后模型破面(场景:顶点数超过 65535 仍强转) | 16 位索引的上限是 65536,溢出回绕 | 先统计顶点数,超了就用 32 位 | 在数据类型允许的范围内才降位 |
指数降位那条补充一句:我们把它用在顶点数没超上限的档上,省下约 24.8KB(索引部分约 4.8%)。这个收益只在「顶点数够少」时成立,不是所有档都能这样省。
把上面收成五条,可以直接抄进你的检查脚本:
这些阈值都是按体量和肉眼阈值取的(1 厘米约等于车长的千分之二,0.5 度比肉眼可辨的歪小一个量级),换到别的尺度要按同样思路重算,不要照抄数字。
当前做法的边界很清楚:
推广性说明:来源核对、朝向统一、贴地、锚点对齐这四步对任何「多份文件要互相替换」的资产都成立(载具、角色、道具、建筑);四档、1024/512/128、1 厘米这些是本场景的参数,按你的体量重取。
这些内容来自一个真实项目里连续两周的模型资产整理:三台载具、每台四个精度档,一共十二个文件,前后返工了四五轮。文中所有体积数字都是同一批文件在本机实测得到的——导出后量一次、整条管线重跑后再量一次比对;朝向、贴地、锚点这三类问题则是把模型放进游戏里逐档切换,用肉眼看现象、再用断言确认修好了。这套顺序后来每次新增载具都照跑一遍。