什么是 OpenSCAD ？

     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

安装依赖项：

在使用如下三个选项中的一个构建依赖以后，请遵循汇编一节的内容

1. 从源头上

运行设置环境变量的脚本：

 source setenv_mac.sh

而后运行脚本编译全部的依赖关系：

 ./scripts/macosx-build-dependencies.sh

2. Homebrew（假设已经安装了Homebrew）

3.  ./scripts/macosx-build-homebrew.sh

4. 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页面上的问题跟踪器中引起一个新问题。该网站及其子页面也能够提供帮助：