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 儲存庫 中。

• 開發中