OpenSCAD 使用者手冊/OpenSCAD 使用者介面
OpenSCAD 的使用者介面分為三個部分
- 檢視區域
- 控制檯視窗
- 文字編輯器
預覽和渲染輸出將顯示在檢視區域中。使用顯示座標軸選單項可以啟用座標軸指示器。
狀態資訊、警告和錯誤將顯示在控制檯視窗中。
在渲染過程中，控制檯底部會顯示一個進度條。它包含一個“取消”按鈕，用於停止渲染。
內建的文字編輯器提供了基本的編輯功能，例如文字搜尋和替換，並且還支援語法高亮顯示。在“首選項”對話方塊中可以選擇預定義的配色方案。
可以在原始碼中更改數值，並即時觀察結果。
將游標放在數字後面，然後按 Alt+向上箭頭或 Alt+向下箭頭，可以增加或減少所選數字。每次更改原始碼中的選定數字後，物件都會重新渲染並在預覽模式中顯示。使用 Alt+右箭頭將游標移到下一個數字，在需要時透過將游標移到最右側的數字來新增更多小數位。使用 Alt+左箭頭將游標移到數字最左邊的數字後面。
注意：在 MacOS 上，請使用 Option + Shift 代替 Alt。
| 鍵 | 描述 |
|---|---|
| Alt + 向上箭頭 | 增加游標左側的數值，並預覽物件。 |
| Alt + 向下箭頭 | 減少游標左側的數值，並預覽物件。 |
| Alt + 左箭頭 | 將游標移到更重要的數字。 |
| Alt + 右箭頭 | 將游標移到更不重要的數字，最終新增一個小數位。 |
主要使用滑鼠來導航檢視區域
| 操作 | 圖示 | 描述 |
|---|---|---|
| 旋轉檢視 | 
|
使用滑鼠左鍵拖動可以沿檢視區域的軸旋轉檢視。它保留垂直軸的方向。 雙擊左鍵可以設定旋轉點。 |
| ⇧ Shift + |
按住 Shift 鍵並使用滑鼠左鍵拖動可以沿垂直軸和指向使用者的軸旋轉檢視。 | |
| 移動視區 | 
|
使用滑鼠右鍵拖動可以移動視區。 |
| 縮放 |  
|
使用滾輪 |
|
使用滑鼠中鍵拖動 | |
| ⇧ Shift + |
按住 Shift 鍵並使用滑鼠右鍵或中鍵拖動 | |
| ⇧ Shift + | ||
| + 和 - | + 和 - | |
| 顯示/隱藏旋轉中心 | Ctrl+3 | 開啟或關閉顯示旋轉中心的圖形。（它始終位於視區的中心）。 |
| 重置旋轉 | Ctrl+0 | 可以使用快捷鍵 Ctrl+0 重置旋轉。 |
| 重置平移 | Ctrl + ⇧ Shift+0 |
可以使用快捷鍵 Ctrl+⇧ Shift+0 重置平移。 |
檢視設定
[edit | edit source]可以使用“檢視”選單配置視區以使用不同的渲染方法和其他選項。此處描述的大多數選項也可以使用快捷鍵使用。
渲染模式
[edit | edit source]OpenCSG (F9)
[edit | edit source]此方法可以立即生成結果，但在處理高度非凸面物體時幀速率較低。
使用 F9 選擇 OpenCSG 模式會切換到最後生成的 OpenCSG 檢視，但不會重新評估原始碼。您可能需要使用“編譯”函式（F5，位於“設計”選單中）重新評估原始碼，構建 OpenCSG 物件，然後切換到 OpenCSG 檢視。
實現細節
[edit | edit source]在 OpenCSG 模式下，OpenCSG 庫 用於生成可見模型。該庫使用高階 OpenGL 特性（2.0），例如 Z 緩衝區，並且不需要顯式描述生成的網格 - 相反，它跟蹤如何組合物件。例如，當渲染立方體中的球形凹痕時，它首先在顯示卡上渲染立方體，然後渲染球體，但不是使用 Z 緩衝區來隱藏被立方體覆蓋的球體部分，而是只渲染球體的那些部分，在視覺上形成一個帶有球形凹痕的立方體。
這種方法在第一次使用新程式時可能需要一些時間，但隨後具有更高的幀率。
與 OpenCSG 之前一樣，F10 和 F11 只啟用 CGAL 顯示模式，不更新底層物件；為此，請使用“編譯並渲染”功能（F6，位於“設計”選單中）。
為了結合這兩種顯示方法的優勢，您可以選擇性地將程式的一部分包裝在 render 函式中，並強制它們即使在啟用 OpenCSG 模式的情況下也烘焙成網格。
CGAL 的縮寫是指開源計算幾何演算法庫。
在 CGAL 模式下，CGAL 庫用於計算根物件的網格，然後使用簡單的 OpenGL 顯示該網格。
如果啟用顯示邊，OpenCSG 和 CGAL 模式都會渲染邊和麵；CGAL 甚至顯示頂點。在 CGAL 網格模式下，此選項無效。
啟用此選項可以清楚地顯示 OpenCSG 和 CGAL 之間的區別：在 CGAL 模式下，您會看到在“屬於”它的地方繪製的邊，而 OpenCSG 不會顯示布林運算產生的邊 - 這是因為它們從未被顯式計算，而是隻是某個物件的 Z 剪下開始或結束的地方。
如果啟用顯示軸，全域性座標系的原點將由一個正交軸指示器表示。此外，在檢視區域的左下角還會顯示一個帶有軸名稱的較小軸指示器。較小的軸指示器標記為 x、y、z，並分別以紅色、綠色、藍色顯示。
如果啟用顯示十字準線，視窗的中心將由四條指向全域性座標系房間對角方向的線表示。當將檢視區域對準模型中的特定點以在旋轉期間將其保持在螢幕中央時，這很有用。
動畫選項會在螢幕的下邊緣新增一個動畫欄。一旦設定了FPS 和步驟（合理的起始值分別是 10 和 100），當前時間就會每秒FPS 次增加 1/步驟，直到它達到 1，然後它會迴環到 0。
每次更改時間時，程式都會重新評估，變數$t設定為當前時間。瞭解更多關於如何在第 其他語言特性 節中使用$t的資訊。
選單項頂部、底部、…、對角線和中心（Ctrl+4、Ctrl+5、…、Ctrl+0、Ctrl+Shift+0）將檢視對齊到全域性座標系。
頂部、底部、左側、右側、正面和背面將檢視與軸平行對齊，對角線選項將檢視對角線對齊，就像 OpenSCAD 啟動時對齊的一樣。
中心選項將座標中心放在螢幕中央（但不會旋轉檢視）。
預設情況下，檢視處於透視模式，這意味著遠離觀察者的距離看起來更短，就像在現實世界中眼睛或相機看到的那樣。當檢視模式更改為正交時，可見距離不依賴於相機距離（檢視模擬無限距離處的相機，具有無限焦距）。這與上面描述的頂部等選項結合使用特別有用，因為這些正交檢視會產生類似於工程圖中看到的 2D 影像。