CadQuery中构建多面体并进行面切割的技术解析

问题背景

在使用CadQuery进行3D建模时，用户经常需要从顶点和面定义构建复杂的多面体。本文将通过一个制作骰子的实际案例，深入探讨如何正确构建多面体并在其表面进行切割操作。

多面体构建的关键技术

1. 顶点和面的定义

构建多面体首先需要明确定义顶点坐标和面索引。在骰子案例中，我们使用了8个顶点和6个面：

t = 1 / (3 ** 0.5)
vertexes = (
    (t, t, t), (-t, t, t), (-t, -t, t), (t, -t, t),
    (t, t, -t), (-t, t, -t), (-t, -t, -t), (t, -t, -t)
)

faces = (
    (0, 1, 2, 3), (0, 1, 5, 4), (0, 3, 7, 4),
    (6, 7, 4, 5), (6, 7, 3, 2), (6, 5, 1, 2),
)

2. 从边构建面的正确方法

初学者常犯的错误是在构建边时索引处理不当。正确的做法是：

for points in face_points:
    faces.append(
        Face.makeFromWires(Wire.assembleEdges(
            Edge.makeLine(
                points[i],
                points[i + 1 if i < len(points) - 1 else 0]
            ) for i in range(len(points))))
    )

关键点在于循环终止条件和索引处理，确保每条边正确连接顶点。

3. 构建有效实体

构建实体时需要确保形状有效：

w = Workplane(Solid.makeSolid(Shell.makeShell(faces)))

可以通过isValid()方法检查形状是否有效，这对调试很有帮助。

表面切割技术

1. 确定切割平面

在特定面上切割需要正确定位切割平面：

world_up = Vector(0, 0, 1).normalized()
origin = face.Center()
normal = face.normalAt()
x_dir = world_up.cross(normal)
if x_dir.Length == 0:
    x_dir = (1,0,0)  # 处理特殊情况

2. 创建切割文本

使用CadQuery的text功能创建切割形状：

symbol = (
    Workplane(Plane(origin, x_dir, normal), origin=origin)
    .text(
        str(i+1),
        font='Arial',
        fontsize=1,
        distance=-.025
    )
)

3. 执行切割操作

最后对实体进行切割：

w = w.cut(symbol)

常见问题与解决方案

1. 边构建不完整：确保每个面的所有边都被正确创建，特别是闭合边。

2. 形状无效：构建实体后使用isValid()检查，确保几何体有效。

3. 切割方向错误：仔细计算切割平面的法向量和X方向向量。

4. 文本深度不当：调整distance参数控制切割深度。

完整示例代码

以下是构建六面骰子的完整代码：

from cadquery import Workplane, Plane, Vector, Face, Solid, Shell, Wire, Edge
from cadquery.vis import show_object

t = 1 / (3 ** 0.5)
vertexes = (
    (t, t, t), (-t, t, t), (-t, -t, t), (t, -t, t),
    (t, t, -t), (-t, t, -t), (-t, -t, -t), (t, -t, -t)
)

faces = (
    (0, 1, 2, 3), (0, 1, 5, 4), (0, 3, 7, 4),
    (6, 7, 4, 5), (6, 7, 3, 2), (6, 5, 1, 2),
)

face_points = [[vertexes[i] for i in face] for face in faces]
faces = []
for points in face_points:
    faces.append(
        Face.makeFromWires(Wire.assembleEdges(
            Edge.makeLine(
                points[i],
                points[i + 1 if i < len(points) - 1 else 0]
            ) for i in range(len(points))))
    )

w = Workplane(Solid.makeSolid(Shell.makeShell(faces)))

for i, face in enumerate(w.faces().vals()):
    world_up = Vector(0, 0, 1).normalized()
    origin = face.Center()
    normal = face.normalAt()
    x_dir = world_up.cross(normal)
    if x_dir.Length == 0:
        x_dir = (1,0,0)

    symbol = (
        Workplane(Plane(origin, x_dir, normal), origin=origin)
        .text(
            str(i+1),
            font='Arial',
            fontsize=1,
            distance=-.025
        )
    )

    w = w.cut(symbol)

show_object(w)

通过掌握这些技术，用户可以灵活地在CadQuery中构建各种复杂多面体并进行表面处理，为3D建模提供更多可能性。