如何为3D模型程序化生成Box UVW映射？求命令行工具方案

以下是几个原生简便的实现方式，能生成和3ds Max UVW Map -> Box 效果一致的UV映射，且不受模型原有UV、网格合并状态影响：

方案1：Blender命令行脚本（效果最匹配） #

Blender的Box UV投影逻辑与3ds Max高度对齐，可通过命令行完全自动化处理：

1. 编写Python脚本 generate_box_uv.py：

import bpy
import sys

# 清除默认场景内容
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()

# 解析命令行参数
argv = sys.argv[sys.argv.index('--') + 1:]
input_path = argv[argv.index('--input') + 1]
output_path = argv[argv.index('--output') + 1]
box_size = float(argv[argv.index('--size') + 1])

# 导入目标模型
bpy.ops.import_scene.gltf(filepath=input_path)

# 为每个网格对象添加Box UV映射
for obj in bpy.context.scene.objects:
    if obj.type == 'MESH':
        bpy.context.view_layer.objects.active = obj
        obj.select_set(True)
        # 添加Box投影UV修改器
        uv_mod = obj.modifiers.new(name="Box_UV", type='UV_PROJECT')
        uv_mod.projector_type = 'BOX'
        uv_mod.box_size = (box_size, box_size, box_size)
        # 应用修改器生成UV
        bpy.ops.object.modifier_apply(modifier=uv_mod.name)
        # 确保UV通道存在（兼容无原生UV的模型）
        if not obj.data.uv_layers:
            obj.data.uv_layers.new(name="UVMap")

# 导出处理后的模型
bpy.ops.export_scene.gltf(filepath=output_path, use_selection=True)

2. 命令行执行：

blender --background --python generate_box_uv.py -- --input model.gltf --output model_box_uv.gltf --size 50

方案2：PyMeshLab脚本工具 #

PyMeshLab提供了直接生成Box UV的API，可封装为命令行工具：

1. 编写脚本 box_uv_generator.py：

import pymeshlab as ml
import argparse

def generate_box_uv(input_path, output_path, box_size):
    ms = ml.MeshSet()
    ms.load_new_mesh(input_path)
    # 应用Box UV映射，尺寸与3ds Max参数对应
    ms.compute_texcoord_box(mesh=0, boxsize=[box_size, box_size, box_size])
    ms.save_current_mesh(output_path)

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='Generate Box UV mapping matching 3ds Max')
    parser.add_argument('-i', '--input', required=True, help='Input GLTF/GLB model path')
    parser.add_argument('-o', '--output', required=True, help='Output model path')
    parser.add_argument('-size', type=float, default=50, help='Box size for UV projection')
    args = parser.parse_args()
    generate_box_uv(args.input, args.output, args.size)

2. 命令行执行：

python box_uv_generator.py -i model.gltf -o model_box_uv.gltf -size 50

方案3：轻量自定义工具（基于Assimp） #

如果需要更轻量化的实现，可基于Assimp库编写自定义逻辑，核心是对每个顶点计算Box UV：

• 先计算模型的轴对齐包围盒（AABB）
• 对每个顶点，根据其在包围盒中的相对位置，分别映射到Box的六个面的UV坐标系
  这种方式需要手动实现映射逻辑，但可打包为独立命令行工具，适合不需要依赖Blender/PyMeshLab的场景。

内容的提问来源于stack exchange，提问作者baltzar