什么是 OpenSCAD ？

万俟超

2023-12-01

   OpenSCAD 是一个用于创建实体三维 CAD 对象的软件。它是普适的一个软件，适用于 Linux/UNIX、MS Windows 和 Mac OS X各类主流系统。
  不像大多数自由软件创建3D 模型 (如著名的 Application Blender)，OpenSCAD 专注于 CAD 方面，而不是艺术方面的3D 造型。因此这可能是您正计划创建3D 模型的机器零件，而不是制作电脑动画电影的工具。
   OpenSCAD 不是一个交互式建模器。相反它更像一个 3D 编译器，读取描述对象并呈现的脚本文件 这个脚本文件中的3D 模型（参见下面的示例）。这软件是对建模过程进行完全的控制，使您能够轻松地完成改变建模过程中的任何步骤或设计。
   OpenSCAD提供了两种主要的建模技术：首先是建设性的实体几何（又名CSG），其次是2D轮廓的制作。作为这些2D轮廓的数据交换格式，使用Autocad DXF文件。除了用于制作的2D路径之外，还可以从DXF文件中读取设计参数。除DXF文件外，OpenSCAD还可以读取和创建STL和OFF文件格式的3D模型。

内容目录

1.开始
2.文件
3.建筑物开敞式
4.先决条件
5.获取源代码
6.为 Mac OS X 构建
7.Linux/BSD 构建
8.在具有较旧或缺少依赖性的系统上构建Linux / BSD
9.窗户建筑
10.汇编

1.开始

您可以下载最新的OpenSCAD二进制文件org/下载.安装二进制文件，您可以将任何其它软件打开。
打开OpenSCAD时，您将在窗口中看到三个框架。左侧框架是您编写3D对象模型的代码。您可以在右侧框架中看到模型的3D渲染。
让我们做一棵树吧！在左框架中键入下列代码：
cylinder(h = 30, r = 8);
然后点击 F5 渲染3D 模型。现在你可以看到一个圆柱体在我们的树上。现在让我们添加浓密（叶状部分）的树-由球体代表的。为了做到这一点我们将把圆柱体和柱体结合起来球体

union() {
  cylinder(h = 30, r = 8);
  sphere(20);
}

但是，这并不完全正确！浓密的/多叶的是树周围的底部。我们需要把球体沿着 z 轴向上移动。

union() {
  cylinder(h = 30, r = 8);
  translate([0, 0, 40]) sphere(20);
}

就这样！你做了你的第一个3D模型！还有其他原始的可以与其他集合操作组合的形状（Union，交叉、差分和变换、旋转、缩放、要制作复杂的模型！)检查所有的其他语言特点在开放式手册.

2.文件

浏览 OpenSCAD 主页 (org/document.html(文件)

3.建筑物开敞式

要从源代码构建 OpenSCAD，请遵循适用于您的平台的相关条件。

4.先决条件

要构建 OpenSCAD，您需要一些库和工具。版本括号中的数字指定了已用于的版本，使用其他版本可能导致建模崩溃。
如果您正在使用Ubuntu的新版本，您可以安装下列软件。如果您正在使用 mac，或者较老的 linux/bsd，那么是从源代码下载和编译库的构建脚本。按照下面编译的平台的说明。
•A C++ compiler supporting C++11
•Qt (4.4 -> 5.x)
•QScintilla2 (2.7 ->)
•CGAL (3.6 ->)
•GMP (5.x)
•MPFR (3.x)
•cmake (2.8 ->, required by CGAL and the test framework)
•boost (1.35 ->)
•OpenCSG (1.3.2 ->)
•GLEW (1.5.4 ->)
•Eigen (3.x)
•glib2 (2.x)
•fontconfig (2.10 -> )
•freetype2 (2.4 -> )
•harfbuzz (0.9.19 -> )
•libzip (0.10.1 -> )
•Bison (2.4 -> )
•Flex (2.5.35 -> )
•pkg-config (0.26 -> )
•double-conversion (2.0.1 -> )

5.获取源代码

安装 Git (git-sCM.com/)进入你的系统。然后进行克隆：

git clone git://github.com/openscad/openscad.git

将下载最新的来源到一个目录命名openscad.
进入这个网址 (https：//github.com/OpenSCAD/MCAD()做下列工作：

   cd openscad
        git submodule update --init

6.为 Mac OS X 构建

先决条件：
• XCODE
• cmake
• pkg-Config
安装依赖项：
在使用以下三个选项中的一个构建依赖之后，请遵循汇编一节的内容

从源头上
运行设置环境变量的脚本：

source setenv_mac.sh

然后运行脚本编译所有的依赖关系：

 ./scripts/macosx-build-dependencies.sh

Homebrew（假设已经安装了Homebrew）
1. ./scripts/macosx-build-homebrew.sh
MacPorts（假设已经安装了MacPorts）
对于有冒险精神的人来说，可能可以使用 OpenSCAD 构建麦波特.主要的挑战是，MacPort 部分地破坏了库，但这往往会不时地发生改变。
但是！macport 目前对 qt5 的支持不是很好，所以使用 qt4 是目前唯一可行的选择。然而，MacPorts 的 QT4 会损坏moc命令，导致 OpenSCAD 编译到断路，当固定在 macports 时，你读到这一点。

sudo port install opencsg qscintilla boost cgal pkgconfig eigen3
harfbuzz fontconfig

7.Linux/BSD 构建

首先，确保安装了 Git（通常打包为 “Git-Core”）或者 “scmgit”）。一旦您克隆了这个 Git 存储库，下载并安装上面列出的依赖程序包（使用了系统的程序包）。提供了一个方便的脚本可以帮助解决这个问题对某些系统的处理：

sudo ./scripts/uni-get-dependencies.sh

安装依赖项之后，检查它们的版本。你可以运行这个帮助您的脚本：

./scripts/check-dependencies.sh
Take care that you don't have old local copies anywhere (/usr/local/)

如果所有依赖项都存在并且具有足够高的版本，则向前跳到编译说明。

8.为 Linux/BSD 构建具有较老依赖项或缺失依赖项的系统

如果您的一些系统依赖库丢失或陈旧，那么您可以下载并构建新的版本$HOME/openscad_deps通过遵循这个过程。首先，运行设置的脚本环境变量。

source ./scripts/setenv-unibuild.sh

然后运行脚本编译以上所有的先决条件库：

./scripts/uni-build-dependencies.sh

请注意，不包括像 GCC、QT 或 GLIB2 这样的庞大依赖项。这里只有较小的 (BOOST、CGAL、OpenCSG 等)。之后构建时，再次检查依赖项。

./scripts/check-dependencies.sh

在那之后，按照下面的编译指令。

9.窗户建筑

Windows的OpenSCAD通常是由Linux交叉编译的。如果你愿意尝试在 Windows 上构建 MSVC，请参见本网站：https///en.wikibooks.org/wiki/openscad _ user _ 手册/building _ on 窗口
要交叉构建，首先要确保您拥有所有必需的的MXE项目 (列于https//mxe.cc/# 需求)不安装 MXE 本身，下面的脚本将为您在下面$HOME/openscad_deps/mxe
然后安装开发工具以获取 GCC。然后在你做完之后克隆这个 Git 存储库，启动一个新的清洁 bash shell 并运行设置环境变量的脚本。

source ./scripts/setenv-mingw-xbuild.sh 64

然后运行脚本下载和编译以上所有的先决条件库：

./scripts/mingw-x-build-dependencies.sh 64

注意这个过程可能需要几个小时和几十GB的磁盘空间，因为它使用https//mxe.cc系统交叉构建。完成后，构建 OpenSCAD 并将其打包到一个安装程序：

./scripts/release-common.sh mingw64

如果你希望你只能建立openscad.exe二进制

cd mingw64
qmake ../openscad.pro CONFIG+=mingw-cross-env
make

对于一个32位的 Windows 交叉构建，在上面的指令中将64替换为32。

10.汇编

首先，从Qt运行qmake openscad.pro以生成Makefile。在某些系统上，根据您安装的Qt版本，您可能需要指定要使用的版本，例如：通过运行qmake4，qmake-qt4，qmake -qt = qt5，或类似的东西。然后运行make。最后，您可以以root用户身份运行make install，或者只是将’openscad’二进制文件（Mac OS X上的OpenSCAD.app）复制到您选择的bin目录中。如果您在从源代码编译时遇到问题，请在github页面上的问题跟踪器中引发一个新问题。该网站及其子页面也可以提供帮助：