OpenSCAD 使用者手冊/庫

庫位置

OpenSCAD 使用三個庫 位置，即安裝庫、內建庫和使用者定義庫。

1. 安裝 庫位置是 OpenSCAD 安裝目錄下的 libraries 目錄。
2. 內建 庫位置取決於作業系統。從 2014.03 版本開始，可以使用“檔案->顯示庫資料夾...”選單項在系統特定檔案管理器中開啟它。
   
   • Windows: My Documents\OpenSCAD\libraries
   • Linux: $HOME/.local/share/OpenSCAD/libraries
   • Mac OS X: $HOME/Documents/OpenSCAD/libraries
3. 可以使用 使用者定義 庫路徑OPENSCADPATH環境變數指向庫。OPENSCADPATH如果庫集合位於多個位置，則可以包含多個目錄，使用分號 (;) 分隔 Windows 中的目錄，使用冒號 (:) 分隔 Linux/Mac OS 中的目錄。例如

Windows: C:\Users\A_user\Documents\OpenSCAD\MyLib;C:\Thingiverse Stuff\OpenSCAD Things;D:\test_stuff

(注意：對於 Windows，在 2014.02.22 之前的版本中，存在一個錯誤，阻止了上面所述的 OPENSCADPATH 中使用多個目錄，它使用冒號 (:) 分隔目錄。一個解決方法是，如果您的庫位於 C: 盤，則可以省略驅動器號和冒號，例如 \Thingiverse Stuff\OpenSCAD Things:\stuff。有關設定 Windows 環境變數的更多資訊，請參閱 使用者環境變數。

Linux/Mac OS: /usr/lib:/home/mylib:.

OpenSCAD 必須重新啟動才能識別對OPENSCADPATH環境變數的任何更改。

在 use <...> 或 include <...> 語句中指定 非完全限定 路徑和檔名時，OpenSCAD 會按以下順序查詢以下目錄中的檔案

• 呼叫 .scad 檔案的目錄
• 使用者定義 庫路徑 (OPENSCADPATH)
• 內建 庫（即上面提到的作業系統相關位置）
• 安裝 庫

如果庫檔案本身包含 use <...> 或 include <...>，則庫 .scad 檔案的目錄就是“呼叫”檔案，即在庫中查詢庫時，它不會檢查頂級 .scad 檔案的目錄。

例如，定義以下位置和檔案：（使用OPENSCADPATH=/usr/lib:/home/lib_os:.)

1. <installation library>/lib1.scad
2. <built-in library>/lib2.scad
3. <built-in library>/sublib/lib2.scad
4. <built-in library>/sublib/lib3.scad
5. /usr/lib/lib2.scad
6. /home/lib_os/sublib/lib3.scad

以下 include <...> 語句與指定的庫檔案匹配

include <lib1.scad>  // #1.
include <lib2.scad>  // #5.
include <sublib/lib2.scad>  // #3.
include <sublib/lib3.scad>  // #6.

從 2014.03 版本開始，可以在“幫助->庫資訊”對話方塊中驗證當前活動的位置列表。

詳細資訊將顯示OPENSCADPATH變數的內容和所有庫位置的列表。按列表中顯示的順序搜尋位置。例如；

OPENSCADPATH: /data/lib1:/data/lib2
OpenSCAD library path:
  /data/lib1
  /data/lib2
  /home/user/.local/share/OpenSCAD/libraries
  /opt/OpenSCAD/libraries

設定OPENSCADPATH

在 Windows 中，透過 控制面板 設定環境變數，選擇 系統，然後選擇 高階系統設定，單擊 環境變數。建立一個新的 使用者變數，或者編輯OPENSCADPATH如果它存在。

在 Linux 上，要簡單地將環境變數新增到所有使用者，可以在終端中輸入
sudo sh -c 'echo "OPENSCADPATH=$HOME/openscad/libraries" >>/etc/profile'
以設定OPENSCADPATH為openscad/libraries位於每個使用者的 home 目錄下。為了更精細地控制環境變數，您需要編輯配置檔案；例如，請參閱 此頁面。

在 macOS 上，可以使用 launchctl 為當前登入使用者設定環境變數
launchctl setenv OPENSCADPATH "/Users/myuser/my/own/path"
下次啟動 OpenSCAD 時，該變數將可用。

MCAD

OpenSCAD 包含 MCAD 庫。

有許多不同的分支在流傳（例如 [1]，[2]，[3]），其中許多分支沒有維護。

MCAD 包含許多不同質量的東西，包括

• 許多常見的形狀，例如圓角盒、二維和三維規則多邊形和多面體
• 用於漸開線齒輪和斜齒輪的齒輪生成器。
• 步進電機安裝輔助工具、步進電機和伺服電機輪廓
• 螺母、螺栓和軸承
• 螺釘和鑽頭
• 常見材料的材料定義
• 數學常數、曲線
• 水滴孔和多邊形孔

git 儲存庫還包含用於抓取 OpenSCAD 程式碼的 python 程式碼、測試框架和 SolidPython，這是一個用於實體 CAD 的外部 python 庫。

有關使用 MCAD 的更多詳細資訊，請參閱後面的章節，OpenSCAD 使用者手冊/MCAD。

其他庫

• Belfry OpenScad 庫 包含許多形狀、蒙版、操縱器，以及對螺紋、齒輪、折線和貝塞爾曲線的支援。
• 用於 OpenScad 的斜面庫
• BOLTS 試圖構建一個標準零件和維生素庫，可用於 OpenSCAD 和其他 CAD 工具。
• 凱爾特結庫 用於生成凱爾特結。
• 顏色空間轉換器 用於在 HSV 和 RGB 中使用顏色。
• 帶尺寸的圖紙 提供工具來建立三維物件的適當二維技術圖紙。
• DotSCAD 包含 2D 和 3D 操作和變換的綜合庫，包括沿任意路徑擠出、形狀彎曲等。
• 圓角，由 Stephanie Shaltes 提供的全面圓角庫。
• Local.scad 提供了一種靈活的方法來定位設計的部分。還用於 BOLTS。
• 密歇根理工大學的 Open Sustainability Technology Lab (MOST) 庫
• Obiscad 包含各種有用的工具，特別是用於以簡單而模組化的方式將模組附加到其他模組的框架。
• OpenSCAD 螺紋 庫：提供符合 ISO 標準的公制和英制螺紋，並支援內螺紋和外螺紋以及多線螺紋。
• 彈球庫：提供許多用於彈球設計工作的元件，包括用於部件三維列印的模型、用於 CNC 鑽孔的三維部件描述以及用於部件佔位面積的二維描述。
• 規則形狀庫 由 Giles Bathgates 提供：提供規則多邊形和多面體，幷包含在 MCAD 中。
• 滾珠鏈鏈輪 OpenSCAD 模組 允許您建立用於 ANSI 鏈和摩托車鏈的鏈輪。包含硬編碼的調整係數，可能需要調整。
• SCADBoard 是一個用於在 OpenSCAD 中設計 3D 列印 PCB 的庫。
• 形狀庫 包含許多形狀，例如圓角盒、規則多邊形。它也包含在 MCAD 中。
• 二維連線庫 可幫助連線二維片材，這對雷射切割設計很有用。
• 標尺 幫助確定 OpenSCAD 中物體的尺寸。
• 滾花表面庫 由 aubenc 建立
• 文字模組 基於技術字型的風格。
• OpenSCAD 圓角， 亦可訪問 https://www.thingiverse.com/thing:8812
• 單元測試框架
• 實用函式 集合。
• 工作流程庫: 全面的工作流程，由 Ulrich Bär 建立

這裡還列出了更多庫：https://github.com/openscad/openscad/wiki/Libraries

其他 OpenSCAD 教程和文件

• "OpenSCAD 使用者手冊" http://www.openscad.org/documentation.html
• "在 OpenSCAD 中掌握 10 個關鍵技能" https://cubehero.com/2013/11/19/know-only-10-things-to-be-dangerous-in-openscad/
• "OpenScad 入門教程" http://edutechwiki.unige.ch/en/OpenScad_beginners_tutorial
• "如何使用 OpenSCAD，設計引數化 3D 物件的技巧和竅門" http://www.tridimake.com/2014/09/how-to-use-openscad-tricks-and-tips-to.html
• OpenSCAD 討論論壇 http://forum.openscad.org