什麼是 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頁面上的問題跟蹤器中引起一個新問題。該網站及其子頁面也能夠提供幫助：