CadQuery中glTF文件导出的正确方法

在3D建模领域，glTF格式因其轻量级和高效性而广受欢迎。本文将详细介绍如何在CadQuery这一强大的参数化建模工具中正确导出glTF格式文件。

常见误区与正确方法

许多用户初次尝试在CadQuery中导出glTF文件时，会参考官方文档中关于exporters.export()函数的说明。然而，这种方法实际上并不适用于glTF格式的导出。正确的做法是使用Assembly对象的save方法。

错误示范

import cadquery as cq
from cadquery import exporters

result = cq.Workplane().box(10, 10, 10)
exporters.export(result, "object.gltf")  # 这行代码不会正常工作

正确方法

import cadquery as cq

result = cq.Workplane().box(10, 10, 10)
assembly = cq.Assembly(result)
assembly.save("object.gltf")

技术细节解析

为什么需要Assembly

CadQuery中的Assembly类专门用于处理复杂的装配体结构，而glTF格式天生适合表示这种层级关系。当我们将一个简单的立方体转换为Assembly时，实际上是创建了一个包含单个部件的装配体。

导出流程详解

1. 创建基本几何体：首先使用Workplane创建基础形状
2. 构建装配体：将几何体包装在Assembly对象中
3. 导出操作：调用Assembly的save方法指定glTF格式

实际应用建议

对于更复杂的模型，可以创建包含多个部件的Assembly：

box1 = cq.Workplane().box(10, 10, 10)
box2 = cq.Workplane().box(5, 5, 5).translate((15, 0, 0))

assembly = cq.Assembly()
assembly.add(box1, name="大盒子")
assembly.add(box2, name="小盒子")
assembly.save("两个盒子.gltf")

这种方法不仅适用于简单的几何体，也适用于复杂的机械装配体导出。

总结

CadQuery中导出glTF文件的关键在于正确使用Assembly类。虽然文档中提到的exporters.export()方法适用于其他格式，但对于glTF这种特殊的3D格式，必须通过Assembly的save方法来实现。理解这一区别对于高效使用CadQuery进行3D建模和导出至关重要。