OpenSCAD 用户手册

OpenSCAD 徽标

简介

OpenSCAD 是一款用于创建实体 3D CAD 对象的软件。
它是 自由软件，可用于 GNU/Linux、Microsoft Windows 和 Mac OS X。

与大多数用于创建 3D 模型的自由软件（例如众所周知的应用程序 Blender）不同，OpenSCAD 不关注 3D 建模的艺术方面，而是专注于 CAD 方面。因此，当您计划创建机器零件的 3D 模型时，它可能是您正在寻找的应用程序，但如果您更感兴趣的是创建电脑动画电影或有机逼真模型，则可能不是您想要的。

与许多 CAD 产品不同，OpenSCAD 不是交互式建模器。相反，它类似于一个 2D/3D 编译器，它读取描述对象的程序文件并根据该文件渲染模型。这使您（设计者）能够完全控制建模过程。这使您能够轻松地更改建模过程中的任何步骤，并创建由可配置参数定义的设计。

OpenSCAD 具有两种主要操作模式，即“预览”和“渲染”。预览使用 3D 图形 和 计算机的 GPU 相对快速，但它是模型的近似值，可能会产生 伪像；预览使用 OpenCSG 和 OpenGL。渲染生成精确的几何图形和完全 细分 的 网格。它不是近似值，因此通常是一个漫长的过程，对于较大的设计可能需要几分钟或几小时。渲染使用 CGAL 作为其几何引擎。

OpenSCAD 提供两种类型的 3D 建模

• 构造实体几何 (CSG)
• 将 2D 图元挤出到 3D 空间中。

SVG 用于 2D，而 Autocad DXF 文件也可用于 2D 轮廓的数据交换格式。除了用于挤出的 2D 路径之外，还可以从 DXF 文件中读取设计参数。除了 DXF 文件外，OpenSCAD 还可以读取和创建开放的 3mf、STL、OFF 和许多其他文件格式的 3D 模型。

可以从 https://www.openscad.org/ 下载 OpenSCAD。更多信息可在 邮件列表 中找到。

其他资源

在 OpenSCAD 教程 中提供了关于使用 OpenSCAD 和 OpenSCAD 语言的清晰指导性介绍。

对于教师：2014 年的一个基本的 25 页幻灯片演示文稿可在 GNUFDL 下获得，以引导您的学生完成使用 OpenSCAD 的过程 此处。

Fablab Lannion（法国）编辑了一个很棒的法语 交互式教程，您可能会喜欢。

“备忘单”是 OpenSCAD 语言的有用快速参考，每个项目都链接回此 Wikibook。

可以在 此处 找到书籍列表。

历史

以下两个手册会定期进行清理或进行重大更改。在开始重大更新之前，请考虑存档这些手册。

这可以针对以下两个“可打印版本”链接完成到 互联网档案

• 2018-04-25 OpenSCAD 用户手册 - 可打印版本 & OpenSCAD 语言 - 可打印版本
• 2019-07-22 OpenSCAD 用户手册，其中包含上述两个打印版本的存档链接（截至此日期）。

Wayback Machine 不再提供免费的用户请求站点存档，因此下面仅列出了两个“可打印版本”手册

• 2020-12-11 OpenSCAD 用户手册 - 可打印版本 & OpenSCAD 语言 - 可打印版本

OpenSCAD 用户手册

1. 简介
2. 第一步
3. OpenSCAD 用户界面
4. 输入设备
5. 自定义器
6. 导入 - STL、3MF、OFF、AMF、DXF、SVG、CSG
   1. SVG 导入
7. 导出 - STL、3MF、OFF、AMF、DXF、SVG、CSG、PNG
   1. STL 导出
   2. CSG 导出
   3. DXF 挤出
   4. 其他 2D 格式
8. 示例项目
   1. 链式动物
9. 路径
10. 使用外部编辑器与 OpenSCAD
11. 与其他应用程序的集成
12. 在命令行环境中使用 OpenSCAD
13. 从源代码构建 OpenSCAD
    1. 在 Linux/UNIX 上构建
    2. 在 Linux 或 Mac OS X 上交叉编译 Windows
    3. 在 Windows 上构建（已过时）
    4. 在 Windows 上构建（新的）
    5. 在 Mac OS X 上构建
    6. 提交补丁
14. 常见问题解答
15. 库
16. 提示和技巧
17. 命令词汇表 - 非常简短的名称和语法参考

OpenSCAD 语言参考

1. OpenSCAD 语言
   1. 常规 - **首先阅读此内容** - 注释、值和数据类型、变量、向量、获取输入
2. 3D 对象 -
   1. 3D 基本实体 - 立方体、球体、圆柱体、多面体
   2. 3D 到 2D 投影
3. 2D 对象
   1. 2D 基本图元 - 正方形、圆形、多边形
   2. 文本 - 使用已安装或用户提供的字体文件生成文本。
   3. 2D 到 3D - 线性挤出、旋转挤出
4. 变换
   1. 颜色
   2. 旋转、平移、镜像、乘矩阵
   3. 缩放、调整大小
   4. 偏移、Minkowski 和、凸包
   5. 组合变换
5. 布尔运算
   1. 并集、差集、交集、渲染
6. 其他函数和运算符
   1. 条件和迭代函数 - for，intersection_for，if，条件 ? :，assign，let
   2. 数学运算符 - 常规，向量，矩阵乘法
   3. 数学函数
      1. 三角函数 (cos sin tan acos asin atan atan2)
      2. 其他 (abs ceil concat cross exp floor ln len let log lookup max min norm pow rands round sign sqrt)
   4. 字符串函数 - str，chr，ord
   5. 类型测试函数 - is_undef，is_bool，is_num，is_string，is_list
   6. 列表推导式
   7. 其他语言特性 - 特殊 '$' 变量，echo，render，surface，search，version()，version_num()，parent_module(n) 和 $parent_modules，assert
7. 用户自定义函数和模块 - 函数，模块，子模块
8. 调试辅助 - % # ! * echo
9. 外部库和代码文件
   1. include - SCAD，CSG
   2. use - SCAD
   3. import - STL，OFF，DXF
      1. import_dxf - 已弃用
      2. import_stl - 已弃用
   4. export - STL，OFF，AMF，3MF，DXF，SVG，PNG，CSG
   5. surface - PNG

开发中

本节包含有关正在进行的工作的文档，这些工作作为 OpenSCAD 快照版本中的实验功能提供，或者尚未完全集成，并且在 分支 或 拉取请求 中挂起在 OpenSCAD github 存储库 中。

• 开发中