通过专注于三个核心需求:表示设计的数据结构、在 2D 屏幕上显示该设计的方法,以及用户交互系统,可以用不到 500 行 Python 代码构建一个功能齐全的 3D 建模器。这种方法展示了复杂的计算机辅助设计(CAD)工具如何被抽象为可管理的组件,从而允许创建无需庞大代码库即可模拟现实的工具。
CAD 工具的核心需求
从核心上讲,所有 CAD 工具都必须满足三个基本功能:通过数据结构表示 3D 对象、在 2D 屏幕上显示该对象,并提供用户与设计进行交互和修改的方法。虽然特定领域的工具可能会增加物理模拟或 3D 打印检查等功能,但这三大支柱仍然是任何 3D 建模软件的基石。
构建此类工具的挑战在于如何在保持代码规模较小的同时管理渲染过程的复杂性。通过专注于特定的设计数据结构,渲染逻辑的复杂性可以降到最低,从而实现更精简的实现。
“然而,所有 CAD 工具都必须包含上述至少三个功能:表示设计的数据结构、将其显示到屏幕上的能力,以及与设计进行交互的方法。”
— 500 Lines or LessA 3D Modeller
利用 Legacy OpenGL 实现简化
该项目利用 Legacy OpenGL(一种已弃用但很有用的图形 API)来保持较小的代码占用。与要求程序员编写在 GPU 上运行的“着色器”的 Modern OpenGL 不同,Legacy OpenGL 提供“固定函数管线”。这允许开发者通过简单地设置全局变量来启用或禁用自动功能,如光照、着色和面剔除。
通过使用这一较旧的标准,该项目减少了所需的线性代数知识量,并简化了整体代码结构。这种权衡是刻意的:它牺牲了现代图形的高性能可编程管线,以换取在严格的 500 行限制内构建功能性建模器的能力。
Viewer 与转换管线
“Viewer”类作为应用程序的核心引擎,负责通过 OpenGL Utility Toolkit (GLUT) 管理窗口创建并驱动主渲染循环。它处理转换管线,该管线将点从“模型空间”(对象的局部坐标)转换为“世界空间”,最后转换为“视口空间”(2D 屏幕坐标)。

此图说明了由 Viewer 类管理的转换管线,用于将模型空间转换为视口空间。
Viewer 在调用 Scene 的渲染函数之前,会初始化 OpenGL 状态,包括投影矩阵和光源。它还管理“ModelView”矩阵,该矩阵将物体在世界中的位置与查看者的视角相结合,以确定用户实际看到的内容。
Scene 抽象与局限性
“Scene”类为 3D 设计提供主要接口,抽象掉了底层的数据结构。它维护一个“节点”列表——即 3D 模型中的各个组件——并跟踪用户当前选中的项目。这种分离允许渲染逻辑保持一致,无论单个对象变得多么复杂。

Scene 类维护一个节点列表,这些节点被组织成特定的子类层级。
虽然这种 500 行的方法成功建立了一个功能齐全的 3D 建模器,但它具有固有的局限性。由于它依赖于 Legacy OpenGL,它无法轻松实现现代 3D 引擎中发现的先进可编程效果。此外,提供的源代码材料并未详细说明“Interaction”类的具体实现或“Node”子类的完整层级结构。

此图像提供了由 3D 建模器渲染的样本场景的视觉示例。