OpenSCAD 用户手册/OpenSCAD 用户界面
OpenSCAD 的用户界面分为三个部分
- 查看区域
- 控制台窗口
- 文本编辑器
预览和渲染输出将显示在查看区域中。使用显示坐标轴菜单项可以启用坐标轴指示器。
状态信息、警告和错误将显示在控制台窗口中。
在渲染过程中，控制台底部会显示一个进度条。它包含一个“取消”按钮，用于停止渲染。
内置的文本编辑器提供了基本的编辑功能，例如文本搜索和替换，并且还支持语法高亮显示。在“首选项”对话框中可以选择预定义的配色方案。
可以在源代码中更改数值，并实时观察结果。
将光标放在数字后面，然后按 Alt+向上箭头或 Alt+向下箭头，可以增加或减少所选数字。每次更改源代码中的选定数字后，对象都会重新渲染并在预览模式中显示。使用 Alt+右箭头将光标移到下一个数字，在需要时通过将光标移到最右侧的数字来添加更多小数位。使用 Alt+左箭头将光标移到数字最左边的数字后面。
注意：在 MacOS 上，请使用 Option + Shift 代替 Alt。
| 键 | 描述 |
|---|---|
| Alt + 向上箭头 | 增加光标左侧的数值，并预览对象。 |
| Alt + 向下箭头 | 减少光标左侧的数值，并预览对象。 |
| Alt + 左箭头 | 将光标移到更重要的数字。 |
| Alt + 右箭头 | 将光标移到更不重要的数字，最终添加一个小数位。 |
主要使用鼠标来导航查看区域
| 操作 | 图标 | 描述 |
|---|---|---|
| 旋转视图 | 
|
使用鼠标左键拖动可以沿查看区域的轴旋转视图。它保留垂直轴的方向。 双击左键可以设置旋转点。 |
| ⇧ Shift + |
按住 Shift 键并使用鼠标左键拖动可以沿垂直轴和指向用户的轴旋转视图。 | |
| 移动视区 | 
|
使用鼠标右键拖动可以移动视区。 |
| 缩放 |  
|
使用滚轮 |
|
使用鼠标中键拖动 | |
| ⇧ Shift + |
按住 Shift 键并使用鼠标右键或中键拖动 | |
| ⇧ Shift + | ||
| + 和 - | + 和 - | |
| 显示/隐藏旋转中心 | Ctrl+3 | 打开或关闭显示旋转中心的图形。（它始终位于视区的中心）。 |
| 重置旋转 | Ctrl+0 | 可以使用快捷键 Ctrl+0 重置旋转。 |
| 重置平移 | Ctrl + ⇧ Shift+0 |
可以使用快捷键 Ctrl+⇧ Shift+0 重置平移。 |
视图设置
[edit | edit source]可以使用“视图”菜单配置视区以使用不同的渲染方法和其他选项。此处描述的大多数选项也可以使用快捷键使用。
渲染模式
[edit | edit source]OpenCSG (F9)
[edit | edit source]此方法可以立即生成结果，但在处理高度非凸面物体时帧速率较低。
使用 F9 选择 OpenCSG 模式会切换到最后生成的 OpenCSG 视图，但不会重新评估源代码。您可能需要使用“编译”函数（F5，位于“设计”菜单中）重新评估源代码，构建 OpenCSG 对象，然后切换到 OpenCSG 视图。
实现细节
[edit | edit source]在 OpenCSG 模式下，OpenCSG 库 用于生成可见模型。该库使用高级 OpenGL 特性（2.0），例如 Z 缓冲区，并且不需要显式描述生成的网格 - 相反，它跟踪如何组合对象。例如，当渲染立方体中的球形凹痕时，它首先在显卡上渲染立方体，然后渲染球体，但不是使用 Z 缓冲区来隐藏被立方体覆盖的球体部分，而是只渲染球体的那些部分，在视觉上形成一个带有球形凹痕的立方体。
这种方法在第一次使用新程序时可能需要一些时间，但随后具有更高的帧率。
与 OpenCSG 之前一样，F10 和 F11 只启用 CGAL 显示模式，不更新底层对象；为此，请使用“编译并渲染”功能（F6，位于“设计”菜单中）。
为了结合这两种显示方法的优势，您可以选择性地将程序的一部分包装在 render 函数中，并强制它们即使在启用 OpenCSG 模式的情况下也烘焙成网格。
CGAL 的缩写是指开源计算几何算法库。
在 CGAL 模式下，CGAL 库用于计算根对象的网格，然后使用简单的 OpenGL 显示该网格。
如果启用显示边，OpenCSG 和 CGAL 模式都会渲染边和面；CGAL 甚至显示顶点。在 CGAL 网格模式下，此选项无效。
启用此选项可以清楚地显示 OpenCSG 和 CGAL 之间的区别：在 CGAL 模式下，您会看到在“属于”它的地方绘制的边，而 OpenCSG 不会显示布尔运算产生的边 - 这是因为它们从未被显式计算，而是只是某个对象的 Z 剪切开始或结束的地方。
如果启用显示轴，全局坐标系的原点将由一个正交轴指示器表示。此外，在查看区域的左下角还会显示一个带有轴名称的较小轴指示器。较小的轴指示器标记为 x、y、z，并分别以红色、绿色、蓝色显示。
如果启用显示十字准线，视窗的中心将由四条指向全局坐标系房间对角方向的线表示。当将查看区域对准模型中的特定点以在旋转期间将其保持在屏幕中央时，这很有用。
动画选项会在屏幕的下边缘添加一个动画栏。一旦设置了FPS 和步骤（合理的起始值分别是 10 和 100），当前时间就会每秒FPS 次增加 1/步骤，直到它达到 1，然后它会回环到 0。
每次更改时间时，程序都会重新评估，变量$t设置为当前时间。了解更多关于如何在第 其他语言特性 节中使用$t的信息。
菜单项顶部、底部、…、对角线和中心（Ctrl+4、Ctrl+5、…、Ctrl+0、Ctrl+Shift+0）将视图对齐到全局坐标系。
顶部、底部、左侧、右侧、正面和背面将视图与轴平行对齐，对角线选项将视图对角线对齐，就像 OpenSCAD 启动时对齐的一样。
中心选项将坐标中心放在屏幕中央（但不会旋转视图）。
默认情况下，视图处于透视模式，这意味着远离观察者的距离看起来更短，就像在现实世界中眼睛或相机看到的那样。当视图模式更改为正交时，可见距离不依赖于相机距离（视图模拟无限距离处的相机，具有无限焦距）。这与上面描述的顶部等选项结合使用特别有用，因为这些正交视图会产生类似于工程图中看到的 2D 图像。