让炮塔能转、炮管能抬:AI 生成的军车模型怎么重做成层级结构 | 杨元超的世界

约 8 分钟读完;需要你会命令行、知道 glb 是什么;不懂 Three.js 也能跟。

读者是谁

这篇写给拿 AI 生成模型做游戏资产、却被扁平结构卡住的开发者,以及做细节层级(LOD)的同学;下面这张表按角色列出你能带走什么、从哪节开始读。

读者 带走什么 拿它做什么 从哪节开始读
拿 AI 生成模型做资产的人 六步处理管线的判断标准 逐档跑一遍自己的模型 6
处理扁平 glb 的人 20 行节点树检查脚本 先判断自己的模型是不是真的扁平 4
做 LOD 的人 每档喂原始导出的原则 别再二次减面 6

不做 3D 资产、只写页面逻辑的读者不必读。

0 本文讲什么

这篇讲:AI 生成的军车模型是一堆平铺零件,怎么把它重做成引擎能驱动的层级结构。读完你会得到一张路线图:从「长什么样、为什么用不了」到环境、脚本、六步管线、坑与验收,最后是裁减与下一步。

先看这张表,决定要不要继续读:

小节 讲什么 读它能得到什么
1–2 扁平模型长什么样、为什么引擎用不了 判断自己的模型是否此类
3–4 装环境、打印节点树 一次跑通、确认问题
5 手工改 vs 写管线怎么选 决定值不值得投入
6 六步处理管线 可以照着做的判据与顺序
7–8 常见坑、三道自动检查 排查与验收标准
9–10 非车辆怎么套用、下一步动作 复用到别的模型

1 你会遇到什么

AI 生成服务(如 Tripo3D,文生/图生 3D)给的模型能看不能动:炮塔不会转、炮管不会抬、子弹没地方出。读完能带走一套六步管线、一个检查脚本、一份验收清单。

这类文件通常是 glb:glTF 的二进制封装格式,节点树、网格、材质、贴图都在一个文件里。打开后最反直觉的是节点层级(hierarchy,父子关系)——AI 导出基本没有层级:190 个零件平铺在同一层,单材质、贴图内嵌,648356 字节。

先把两种形态画出来(左边未处理,右边是处理完的目标):

Tripo 原始(扁平)                    处理后(层级)
model.glb                            model.glb
├─ tripo_part_0  (mesh)              └─ ParentNode
├─ tripo_part_1  (mesh)                 └─ Body    (mesh,84 件合并)
├─ … 共 190 个平级节点                    └─ Turret  (mesh,95 件合并)
└─ tripo_part_189 (mesh)                   ├─ WeaponPart_1  (mesh)
                                           ├─ … 共 11 根炮管
                                           └─ WeaponPart_11 (mesh)

下面这张表对比同一台车在两种形态下 5 个能力能不能做到(表里的 LOD 是按距离切换的细节档位,第 6 节细讲),你可以对着自己模型的症状对号入座:

能力 扁平模型 层级模型
炮塔 yaw(绕竖轴转) 没有炮塔节点,只能整台车转 Turret 绕自己原点转
炮管 pitch(俯仰)/ 后坐 两根炮管焊在车体上 每根炮管独立节点,各自动
发射点 只能按包围盒猜位置 炮管节点原点就是炮口基准
LOD 切档 整包替换,节点数对不上 同构层级,逐档替换

2 为什么用不了

游戏引擎读取并使用层级:顺着父子链找部件,不靠名字猜。典型取法如下(属性名按你的引擎改;示例不带行号便于复制,伪代码带行号便于讨论):

const body = root.children[0];
const turret = body.children[0];
turret.rotateOnAxis(new Vector3(0, 1, 0), yaw);            // 炮塔 yaw
const barrels = turret.children.filter((c) => c.geometry); // 每根炮管一个
barrels[0].rotation.x = pitch;                             // 炮管 pitch
const muzzle = barrels[0].localToWorld(new Vector3(0, 0, 0)); // 发射点

代码第 3 行 turret.rotateOnAxis 是炮塔 yaw,第 4 行拿到每根炮管,第 6 行 localToWorld 给出炮口位置。所以层级必须固定为三级:ParentNode → Body → Turret → WeaponPart;少一层就取不到。

3 准备环境

后面第 4、6 节要读 glb、算几何量、合并网格,先装一个能解析 glb 的 Python 库。Python 3 + pygltflib 够用:把第 4 节脚本存成 print_tree.py,执行后打印节点树:

python --version              # 需要 Python 3
python -m pip install pygltflib
python print_tree.py model.glb

示例假设文件叫 model.glb,放在当前目录。

4 最小可跑示例

动手改之前,先用 20 行代码确认模型是否真的扁平:它打印节点树,顶层节点数≈总节点数(这台 190 对 190)就需要后面这套处理。代码可直接复制:

from pygltflib import GLTF2

gltf = GLTF2().load("model.glb")          # 假设场景 0
roots = gltf.scenes[gltf.scene].nodes     # 顶层节点

def walk(index, depth):
    node = gltf.nodes[index]
    kind = "mesh" if node.mesh is not None else "none"
    print(f"{'  ' * depth}- {node.name or index}: geometry={kind}")
    for child in node.children or []:
        walk(child, depth + 1)

print(f"总节点数: {len(gltf.nodes)}")
print(f"顶层(平级)节点数: {len(roots)}")
print("节点树:")
for index in roots:
    walk(index, 1)

怎么读结果:顶层数接近总数就是扁平形态;已是三级链就跳过前面六步,直接去第 8 节验收。

5 为什么写一条管线,而不是在 Blender 里手工拖节点

把 190 个平铺零件改成三级层级、统一朝向尺寸和锚点(旋转中心),有两套干法:

两者代价不同:手工法上手快但改不了几次,管线法投入大但能反复跑。

真要写,管线约 8001200 行 Python(含检查脚本),熟练 23 天;服务到引擎之间没有标准转换器,但 pygltflib + trimesh + Blender bpy 够用。

6 六步管线

总目标:把平铺零件变成引擎能驱动的层级。六步顺序:分类(谁属于谁)→ 定向(统一 +Z)→ 定标贴地(真实尺寸、落地)→ 锚点(旋转中心)→ 合并(可驱动网格)→ LOD 与贴图(远处降细节)。第 13 步通用,第 46 步车辆特有(第 10 节裁减)。

这六步要写成脚本。脚本 = 一段读 glb、算几何量、重组层级、写回新 glb 的程序。本文给判据不给完整工具,因为完整工具会绑死目录结构和引擎约定。翻译成脚本的路子统一是「读节点 → 算体积/质心/包围盒 → 筛选分组 → 写回」;第 1~4 步用 pygltflib + numpy,第 5 步合并与重算法线、贴图坐标(UV)用 trimesh 或 bpy。

六步结构同构(读 → 算 → 筛 → 分组 → 写回),后面五步同法,只以第 1 步说明写法(伪代码带行号便于讨论,省略已标注):

 1 │ parts = read_parts("model.glb")        # 读:体积/质心/包围盒
 2 │ hull = max(parts, key=volume)          # 算:体积最大件 = 车体
 3 │ hull_top = hull.bbox_max[1]            # 车体顶面
 4 │ band = [p for p in parts if p.centroid[1] > hull_top]
 5 │ main = max(band, key=volume)           # 主炮塔块
 6 │ barrels = [p for p in band if is_thin(p) and near_center(p)]
 7 │ turret = [p for p in band if p not in barrels]
 8 │ body = [p for p in parts if p not in band]
 9 │ write_groups(body, turret, barrels)    # 写回
10 │ # 省略:越过炮塔/底面更高的判断、按跨度打分
  1. 分类:解决「190 个零件谁属于谁」。只按几何量:车体取体积最大件(tripo_part_1 是 Tripo 导出的零件默认名,顶面 0.1880);炮塔带是质心高于车体顶面的件;主炮塔是带内体积最大件(底面 0.1904);炮管候选要同时满足细截面、近中线、沿长轴越过炮塔、底面高于炮塔底,按跨度与截面比取高侧 → 11 件;Turret = 带内去掉炮管 95 件,Body = 其余 84 件。漏掉「底面更高」,4 个车体件会被算成炮管(候选 11→15)。
  2. 定向:解决「所有车朝哪算前」。炮管首尾 5% 截面质心连成方向向量,绕 Y 轴转到水平,θ = atan2(z, x);这台 -89.6991°(同一公式可算你的模型)。必须通过:偏航 ≤0.5°(实测 0.121°);俯仰只记录(实测 -1.510°,输入自带 -2.075°),超 30° 视为异常。
  3. 定标 + 贴地:解决「大小和地面」。车身旋转后的长水平轴缩放到目标车长 6.2463 m(业务给定,你的模型填你的尺寸),比例 = 目标 ÷ 实测(这台 7.437196);最低点压到 y = 0。
  4. 锚点:解决「绕哪个点转」。pivot(锚点)是节点局部坐标原点,旋转围绕它发生。锚点取「要旋转的块」的包围盒中心——Body 取车身组中心,Turret 取主炮塔块中心(这台 y = 1.7867),WeaponPart 取炮尾端截面中心。拿整个 Turret 组中心当锚点,天线把中心拉高 0.9641 m(2.7508 − 1.7867),炮塔绕架空位置画圈。
  5. 合并:解决「零件太多、驱动不了」。车体、炮塔各合成一个 mesh,重算法线(顶点朝向,决定光照)和 UV(贴图坐标),POSITION 的 min/max(顶点坐标的最小/最大值)用 f32 量化(32 位浮点,有微小误差),材质贴图原样搬运,索引统一 32 位(防顶点数超 65535 溢出),每根炮管保持独立 mesh。产物 4142 个三角形 = 1603 + 2135 + 404(Blender 导入按面数核对;你的模型按 ±5% 验收)。
  6. LOD 与贴图:解决「远处的模型别太重」。

LOD 怎么做

先交代一个领域约定。LOD(level of detail,细节层级)是为远景省显存和带宽——远处模型不需要那么细。Tripo 这类服务按 LOD 各导出一个独立文件:同一台车导出 2~3 个 glb,几何是同一台车,只是面数和贴图分辨率不同:

档位 面数 贴图分辨率 用在哪
lod1 最高(4142 三角形) 1024 近景
lod2 中等 512 中景
lod3 最低 128 远景

所以处理方式是「逐档各跑一遍六步管线」,产物每档一份。

再讲为什么每档直接吃对应档位的原始导出、不要二次减面:拿 lod1 自己减面生成 lod2,减面会破坏零件边界,分类漂移,同一根炮管在 lod1 能识别、到 lod2 就识别不出;三档都吃同一份导出则面数完全一样,「有 LOD」但没省。服务自己出的每档本就按面数递减设计,直接用最省事。注意导出不一定严格递减:这台 lod1 和 lod2 就是同一份文件(同样 4142 个三角形、md5 一样;md5 是文件指纹),每档都要显式绑定自己的源文件。

贴图分辨率与质量怎么定

贴图也要跟着档位定分辨率:lod1 1024 / lod2 512 / lod3 128(你的模型按屏幕占比定)。远处看不清细节,贴图太浪费显存。源图已是目标尺寸就逐字节保留;要缩的走 Blender,视图变换固定 Standard(默认 AgX 会改颜色)。下面这张表是 JPEG 质量实测(源 1024²):

目标尺寸 q75 q80 q85
512² 44554 B 51027 B 60056 B
128² 4967 B 5596 B 6437 B

取 q80:体积与画质的折中。

7 读者会踩的坑

下面按「是什么 → 为什么是坑 → 怎么解决 → 为什么能解决」排:

坑是什么 为什么是坑 如何解决 为什么能解决
车体按「触地零件里三角形最多」选 履带段三角形最密,被选成车体(顶面 0.0698),炮塔带吞了 173 件 改按「体积最大」选(顶面 0.1880) 体积是车体最稳定的几何特征,履带段体积远小于车体
拿整个 Turret 组包围盒中心当炮塔锚点 天线把中心拉高 0.9641 m,炮塔绕架空位置画圈 锚点改取「主炮塔块」的包围盒中心 旋转中心只应取决于要旋转的那块,与整组装饰无关
按 X 轴找炮管首尾 炮管沿 Z 轴长,角度只算到 -13.5° 把长轴作为参数传入,规定离炮塔中心较远的一端是炮口 方向由几何决定,不靠对模型朝向的假设
三档 LOD 都喂同一份 glb 导出 面数完全一样,有 LOD 但一个面都没省 每档显式绑定对应档位的导出文件 服务按档位各导出一份,档位不同面数本就不同
用 Blender 默认视图变换缩图 AgX 会改颜色,缩完图发灰/发暗 固定 Standard、曝光 0、gamma 1 色彩变换固定后,像素才可与原图逐字节比较

脚注:写脚本还有两个坑:合并索引把浮点个数当顶点数,Blender 报 IndexError: 1669(改用 len(positions) // 3);临时诊断脚本与管线坐标顺序不同,会差 0.3%。

8 怎么验收

怎么判断改对了?跑下面三道自动检查,全绿才算处理完:

检查 内容 通过判据
verify_norm.py 16 项:层级、材质/贴图各 1、长度 ±5%、贴地、锚点对照参照、偏航 ≤0.5°、三角形 ±5%、法线非零、索引范围、包围盒匹配 16/16
jest 场景 解析产出的 .glb,检查层级、命名、包围盒、材质 6/6
regen-check.sh 重跑整条管线,产物逐字节比对 REGEN_IDENTICAL

脚本名是我们项目里的,你不必同名。这份清单可当验收脚本骨架(断言 = 写死的自动判断,不满足就报错):

进引擎前用 Blender headless(无界面模式,命令行直接跑)导入一次:父子链正确、输出 IMPORT_OK,面数 1603 / 2135 / 404。第三道最容易被忽略:只读产物的测试改坏了照样绿——它测的是快照,不是管线回归。

9 非车辆模型怎么裁减步骤(通用三步仍要做,只跳过车辆特有的三步)

不管什么模型,分类、定向、贴地都要做;能跳过的是车辆特有的炮塔 yaw、炮管 pitch、发射口。

建筑、道具只做前三步;角色还要对齐骨骼名与层级——「层级即契约」思路另篇再写。

10 你下一步能做什么

  1. 用第 4 节的脚本跑你自己的模型,确认它是不是扁平形态;
  2. 按第 6 节前 3 步做分类、+Z 定向、贴地,再用第 8 节的断言清单跑一遍;
  3. 把「重跑 + 逐字节比对」接进持续集成(CI),改坏管线时立刻失败。

这些内容来自哪里

这些内容来自一个真实资产处理流程的反复打磨:同一批模型连续跑了多轮规范化与逐字节比对,才把层级、朝向、尺度与挂点固定成一条可重跑的管线。文中的零件数、体积变化与通过项数都是当时实测的结果。

相关文章