主要工作區

Dynamo 工作區由四個主要元素組成。

1. 所有作用中的頁籤。

2. 預覽模式

3. 縮放/平移控制

4. 工作區中的節點

所有作用中的頁籤

當您開啟新檔案時，預設會開啟新的「首頁」工作區。

您可以在自訂節點工作區中建立自訂節點並開啟它。

預覽模式

有 3 種方法可在不同預覽之間切換：

a.使用右上角的圖示

b.在工作區中按一下右鍵

• 從 3D 預覽切換至圖表預覽

• 從圖表預覽切換至 3D 預覽

c.使用鍵盤快速鍵 (Ctrl+B)

縮放/平移控制

您在任何一個工作區都可以使用圖示或滑鼠導覽。

a.在圖表預覽模式中

• 使用圖示：
• 使用滑鼠：

  • 按一下左鍵 - 選取

  • 按一下左鍵並拖曳 - 選取方塊以選取多個節點

  • 中鍵向上/向下捲動 - 拉近/拉遠

  • 按一下中鍵並拖曳 - 平移

  • 在圖元區上任意位置按一下右鍵 - 開啟圖元區搜尋

b.在 3D 預覽模式中

• 使用圖示：
• 使用滑鼠：

  • 中鍵向上/向下捲動 - 拉近/拉遠

  • 按一下中鍵並拖曳 - 平移

  • 按一下右鍵並拖曳 - 環轉

工作區中的節點

按一下左鍵以選取任何節點。

若要選取多個節點，請按一下並拖曳以建立選取方塊。

使用者介面概述

Dynamo 的使用者介面 (UI) 分為五個主要區域。我們在此將簡要概述，並在以下幾節進一步說明工作區和資源庫。

1. 功能表

2. 工具列

3. 資源庫

4. 工作區

5. 執行列

功能表

以下是 Dynamo 應用程式的基本功能功能表。與大多數 Windows 軟體一樣，前兩個功能表與管理檔案、選取作業和編輯內容相關。其餘的功能表包含 Dynamo 更具體的功能。

Dynamo 功能表

在 Dynamo 下拉式功能表上可以找到一般資訊和設定。

1. 關於 - 瞭解您電腦上安裝的 Dynamo 版本。

2. 收集使用狀況資料的合約 - 這可讓您選擇是否分享您的使用者資料來改善 Dynamo。

3. 偏好 - 包括各項設定，例如定義應用程式的小數點精確度和幾何圖形彩現品質。

4. 結束 Dynamo

說明

如果您遇到問題，請查閱 「說明」 功能表。您可以透過網際網路瀏覽器存取其中一個 Dynamo 參考網站。

1. 開始使用 - 使用 Dynamo 的簡要介紹。

2. 互動式指南 -

3. 範例 - 參考範例檔案。

4. Dynamo 字典 - 所有節點上具備文件的資源。

5. Dynamo 網站 - 在 GitHub 上檢視 Dynamo 專案。

6. Dynamo 專案 Wiki - 造訪 Wiki，以學習使用 Dynamo API 進行開發，支援資源庫與工具。

7. 顯示開始頁面 - 返回至文件中的 Dynamo 開始頁面。

8. 報告錯誤 - 在 Github 開啟問題。

工具列

Dynamo 的工具列包含一系列按鈕，可快速存取以使用檔案及退回 [Ctrl + Z] 與重做 [Ctrl + Y] 指令。最右側是另一個按鈕，可以匯出工作區的快照，這對於製作文件及分享非常有用。

資源庫

Dynamo 資源庫是一個功能資源庫的集合，每個資源庫都包含依品類分組的節點。它包含在 Dynamo 預設安裝期間加入的基本資源庫，隨著我們繼續介紹用法，我們將示範如何使用自訂節點和其他套件來延伸基本功能。資源庫一節將涵蓋使用資源庫更詳細的指導。

工作區

「工作區」是我們建構視覺程式的位置，您也可以變更其「預覽」設定，以從此處檢視 3D 幾何圖形。請參閱工作區，以取得更多詳細資料。

執行列

從此處執行 Dynamo 腳本。按一下「執行」按鈕上的下拉式圖示，可在不同模式之間進行變更。

• 自動：自動執行腳本。變更會即時更新。

• 手動：只在按一下「執行」按鈕時才執行腳本。在變更複雜繁重的腳本時，此功能非常有用。

• 周期性：此選項預設會灰顯。只有在使用 DateTime.Now 節點時才能使用。您可以將圖表設定為以指定間隔自動執行。

資源庫包含所有載入的節點，其中包括 10 個安裝隨附的預設品類節點，以及已載入的其他所有自訂節點或套件。資源庫中的節點在資源庫、品類和子品類 (如果有) 內以階層方式組織。

• 基本節點：預設安裝隨附。

• 自訂節點：將常用常式或特殊圖表儲存為自訂節點。您也可以與社群共用您的自訂節點

• Package Manager 中的節點：收集已發佈的自訂節點。

品類的資源庫階層

透過在這些品類中進行瀏覽，能以最快方式瞭解可以加入到工作區的項目所在的階層，並以最佳方式探索尚未使用的新節點。

透過四處按一下功能表瀏覽資源庫，展開每個品類及其子品類

1. 資源庫

2. 品類

3. 子品類

4. 節點

這些項目會根據節點是建立資料、執行動作或查詢資料，進一步分類成有相同子品類的節點。

將滑鼠懸停在節點上，可顯示名稱和圖示之外更詳細的資訊。我們由此可以快速了解節點的功能、所需的輸入及其提供的輸出。

1. 描述 - 節點的普通語言描述

2. 圖示 -「資源庫」功能表中更大版本的圖示

3. 輸入 - 名稱、資料類型與資料結構

4. 輸出 - 資料類型與結構

在資源庫中快速搜尋

如果您知道希望加入至工作區的節點相關特性，在 「搜尋」 欄位中鍵入可查詢所有相符的節點。

選擇按一下要加入的節點，或按 Enter 將亮顯的節點加入工作區的中心。

依階層搜尋

除了使用關鍵字嘗試尋找節點，我們還可以在「搜尋欄位」中鍵入以句點分隔的階層，或使用程式碼區塊 (使用 Dynamo 文字語言)。

每個資源庫的階層都會反映在加入工作區的節點名稱中。

在資源庫階層中以 library.category.nodeName 格式鍵入節點位置的不同部分，會傳回不同的結果

• library.category.nodeName

• category.nodeName

• nodeName 或 keyword

通常，工作區中節點的名稱將以 category.nodeName 格式呈現，但在「Input」與「View」品類中有一些明顯的例外。

請注意名稱相似的節點，並注意品類差異：

• 大多數資源庫中的節點將包括品類格式

• Point.ByCoordinates 和 UV.ByCoordinates 的名稱相同，但來自不同品類

• 明顯的例外包括內建函數、Core.Input、Core.View 及運算子

常用的節點

Dynamo 的基本安裝中包括數百個節點，哪些節點對於開發視覺程式非常重要？接下來我們著重了解定義程式參數 (Input)、查看節點動作結果 (Watch) 以及透過捷徑 (Code Block) 定義輸入或功能所使用的節點。

輸入節點

輸入節點是視覺程式的使用者 (不論是您自己還是他人) 與關鍵參數結合的主要方式。以下是核心資源庫中一些可用的項目：

Watch 與 Watch3D

Watch 節點對於管理流經視覺程式的資料非常重要。您可以透過節點資料預覽，將滑鼠懸停在節點上，來檢視節點的結果。

在 Watch 節點中保持顯示會很有用

或透過 Watch3D 節點查看幾何圖形結果。

這兩個節點都位於核心資源庫內的 View 品類中。

Code Block

Code Block 節點可以用於定義一塊程式碼 (以分號分隔各行)。這可以像 X/Y 一樣簡單。

以下是在腳本中使用 Code Block 的簡單示範 (含指示)。

1. 按兩下以建立 Code Block 節點

2. 鍵入 Circle.ByCenterPointRadius(x,y);

3. 按一下工作區以清除選取，這會自動加入 x 和 y 輸入。

4. 建立 Point.ByCoordinates 節點與 Number Slider，然後將其連接至 Code Block 的輸入。

5. 執行視覺程式的結果如 3D 預覽中顯示為圓