建立一些自訂節點後，下一步是以套件方式開始組織和發佈它們 - 這是一個很便利的方式來儲存您的節點並與 Dynamo 社群分享。

我們剛剛建立了自訂節點並將其套用至 Dynamo 圖形中的特定程序。我們非常喜歡此節點，因此，我們要將其保留在我們的 Dynamo 資源庫以在其他圖形中進行參考。若要執行此作業，我們將在本端發佈此節點。此程序與發佈套件的程序類似，我們將在下一個章節中進行詳細討論。

透過在本端發佈節點，當您開啟一個新的階段作業時該節點將可在 Dynamo 資源庫中存取。如果不發佈節點，參照自訂節點的 Dynamo 圖表也必須在其資料夾中具有該自訂節點 (或必須使用 「檔案」>「匯入資源庫」 將自訂節點匯入 Dynamo 中)。

練習：在本端發佈自訂節點

按一下下方的連結下載範例檔案。

附錄中提供範例檔案的完整清單。

讓我們繼續瞭解在前一個部份中建立的自訂節點。開啟 PointsToSurface 自訂節點後，我們會在 Dynamo 自訂節點編輯器中看到圖表。您也可以在「Dynamo 圖表編輯器」中按兩下自訂節點來開啟。

若要在本端發佈自訂節點，只需在圖元區上按一下右鍵，然後選取 「發佈此自訂節點...」

參照上圖填寫相關資訊，並選取 「本端發佈」。請注意，「群組」欄位定義可從 Dynamo 功能表存取的主要元素。

選擇資料夾，以容納所有您打算在本端發佈的自訂節點。Dynamo 每次載入時都會檢查此資料夾，因此請確認該資料夾位於固定位置。導覽至此資料夾，然後選擇 「選擇資料夾」。Dynamo 節點現已在本端發佈，每次您載入程式時，該節點都會在您的 Dynamo 資源庫中！

若要查看自訂節點的資料夾位置，請前往 「Dynamo」>「偏好」>「套件設定」>「節點和套件路徑」。

在此視窗中，我們看到路徑清單。

1. Documents\DynamoCustomNodes... 是本端發佈之自訂節點的位置。

2. AppData\Roaming\Dynamo... 是線上安裝的 Dynamo 套件的預設位置。

3. 您可能想要在清單中將本端資料夾路徑的順序下移，只要按一下路徑名稱左側的向下箭頭即可。頂層資料夾是套件安裝的預設路徑。因此，透過將預設 Dynamo 套件安裝路徑保留為預設資料夾，線上套件將與本端發佈的節點分離。

我們已切換路徑名稱的順序，以將 Dynamo 的預設路徑作為套件的安裝位置。

導覽至此本端資料夾，我們可以在 「.dyf」 資料夾中找到原始自訂節點，.dyf 是 Dynamo 自訂節點檔案的副檔名。我們可以編輯此資料夾中的檔案，節點將在使用者介面中更新。我們還可以新增更多節點至主要的 DynamoCustomNode 資料夾，Dynamo 會在重新啟動時將其新增到您的資源庫！

Dynamo 現在每次都會將「PointsToSurface」載入到 Dynamo 資源庫的「DynamoPrimer」群組中。

Dynamo 為廣泛的視覺程式設計任務提供許多核心節點。有時，一個更快、更有序或更輕鬆的共享解決方法是建置您自己的節點。這些節點可以在不同專案中重複使用，讓您的圖表更清楚整潔，這些節點也可以推送至 Package Manager 並與全球的 Dynamo 社群分享。

Dynamo Mesh Toolkit 可提供工具，以匯入外部檔案格式的網格、根據 Dynamo 幾何圖形物件建立網格，並根據網格的頂點與索引手動建置網格。資源庫還提供工具來修改網格、修復網格，或萃取水平切片，以用於加工。

Dynamo Mesh Toolkit 是 Autodesk 持續進行網格研究的一部分，因此在未來的幾年將繼續成長。該工具箱將頻繁推出新方法，請隨時與 Dynamo 團隊聯繫以提供註解、錯誤以及新功能的建議。

網格與實體

下面的練習演示了使用 Mesh Toolkit 可執行的一些基本網格作業。在此練習中，我們將網格與一系列的平面相交，如果使用實體執行此作業，則運算成本很高。與實體不同，網格具有一組「解析度」，不以數學方式定義，而是以拓樸方式定義，我們可根據要執行的作業來定義此解析度。有關網格與實體關係的詳細資訊，您可以參考此手冊的用於計算設計的幾何圖形一章。有關 Mesh Toolkit 的更詳細資訊，您可以參考 Dynamo Wiki 頁面。我們利用下面的練習來瞭解此套件。

安裝 Mesh Toolkit

在 Dynamo 中，前往頂部功能表列中的「套件」>「Package Manager...」。在搜尋欄位中，鍵入 MeshToolkit (全部一個字，無空格)。按一下「安裝」，系統請您確認時，請接受，即可開始下載。非常簡單！

練習：網格相交

按一下下方的連結下載範例檔案。

附錄中提供完整的範例檔案清單。

在此範例中，我們將瞭解 Mesh Toolkit 的 Intersect 節點。我們將匯入網格並將其與一系列輸入平面相交以建立切片。這是準備模型以使用鐳射切割、水刀切割或數控機床進行加工的起點。

首先，在 Dynamo 中開啟 Mesh-Toolkit_Intersect-Mesh.dyn。

1. 檔案路徑： 找到要匯入的網格檔案 (stanford_bunny_tri.obj)。支援的檔案類型為 .mix 和 .obj

2. Mesh.ImportFile： 連接檔案路徑以匯入網格

1. Point.ByCoordinates： 建構一個點 - 這將是弧的中心。

2. Arc.ByCenterPointRadiusAngle： 在該點週圍建構一個弧。這條曲線將用來定位一系列平面。 __設定如下： __ radius: 40, startAngle: -90, endAngle:0

建立一系列沿著弧轉向的平面。

1. Code Block：建立 25 個介於 0 和 1 之間的數字。

2. Curve.PointAtParameter： 將弧連接到 curve 輸入並將 Code Block 輸出連接至 param 輸入以擷取出一系列沿著曲線的點。

3. Curve.TangentAtParameter： 連接與前一個節點相同的輸入。

4. Plane.ByOriginNormal： 將點連接至 origin 輸入並將 vector 連接至 normal 輸入，在每個點建立一系列平面。

接下來，我們將使用這些平面與網格相交。

1. Mesh.Intersect： 將這些平面與匯入的網格相交，建立一系列 PolyCurve 輪廓線。在節點上按一下右鍵，並將交織設定為最長

2. PolyCurve.Curves： 將 PolyCurve 切斷為曲線段。

3. Curve.EndPoint： 擷取每條曲線的端點。

4. NurbsCurve.ByPoints： 使用點來建構 NURBS 曲線。使用設定為 True 的 Boolean 節點，以封閉曲線。

在繼續之前，請關閉某些節點 (例如：Mesh.ImportFile、Curve.EndPoint、Plane.ByOriginNormal 以及 Arc.ByCenterPointRadiusAngle) 的預覽，以更清楚地查看結果。

1. Surface.ByPatch： 為每條輪廓線建構曲面修補，以便建立網格的「切片」。

新增第二組切片，產生格子/蛋盒的效果。

您可能會發現與一個差不多的實體相比，網格相交作業的計算速度更快。例如本練習中示範的工作流程非常適合用於網格。

Dynamo 在其節點庫中儲存了許多開箱即用的功能。對於這些經常使用的常式或要與社群共用的特殊圖表，自訂節點和套件是進一步延伸 Dynamo 很好的方式。

自訂節點的構成方式是在「Dynamo 自訂節點」中嵌套其他節點和自訂節點， 我們可以將「Dynamo 自訂節點」從概念上理解為容器。當在圖中執行此容器節點時，將執行其所有內部節點以允許您重複使用和共用一個有用的節點。

適應變更

當您在圖中有多個自訂節點副本時，您可以透過編輯基礎自訂節點來更新所有副本。這容許您透過採用工作流程或設計中可能發生的任何變更來順暢地更新您的圖形。

工作共用

雖然有爭議，但是一般認為自訂節點的最佳功能是其工作共用功能。如果「經驗豐富的使用者」建立了複雜的 Dynamo 圖形，並將其傳遞給不太熟悉 Dynamo 的新使用者，則他/她可壓縮圖形為最基本的內容以進行設計互動。可開啟自訂節點以編輯內部圖形，但「容器」可以保持簡單。使用此程序，自訂節點允許 Dynamo 使用者設計簡潔、直觀的圖表。

有許多方式可建置節點

自訂節點環境和建立第一個自訂節點

讓我們跳至自訂節點環境，並建立一個簡單的節點來計算百分比。自訂節點環境不同於 Dynamo 圖形環境，但其互動根本相同。在此基礎上，讓我們建立第一個自訂節點！

若要從頭開始建立自訂節點，請啟動 Dynamo，然後選取「自訂節點」，或在圖元區鍵入 Ctrl + Shift + N。

在「自訂節點性質」對話方塊中指定名稱、描述和品類。

1. 名稱： Percentage

2. 描述：計算一個值相對於另一個值的百分比。

3. 品類： Math.Functions

這將開啟一個具有黃色背景的圖元區，表示您正在自訂節點內工作。在此畫布上，您可以存取所有核心 Dynamo 節點，以及 Input 和 Output 節點，其標示資料流進和流出自訂節點。您可以在「Input」>「Basic」中找到它們。

1. Input： Input 節點在自訂節點上建立輸入埠。Input 節點的語法為 input_name : datatype = default_value(選擇性)。

您可以將此自訂節點儲存為 .dyf (而非標準 .dyn) 檔案，它將會自動新增至您的階段作業和將來的階段作業中。您將在資源庫的「Add-ons」區段中找到自訂節點。

繼續向前

現在，我們建立了第一個自訂節點，下一部分將深入瞭解自訂節點功能以及如何發佈一般工作流程。在以下部分中，我們將瞭解如何開發可將幾何圖形從一個平面轉移至另一個平面的自訂節點。

在先前各節中，我們詳細瞭解了如何使用自訂節點與範例檔案設置 MapToSurface 套件。但是，如何發佈已在本端開發的套件呢？此案例研究將示範如何從本端資料夾的一組檔案發佈套件。

有許多方式可以發佈套件。以下是建議的程序：本端發佈、本端開發，然後線上發佈。我們從包含套件中所有檔案的資料夾開始。

解除安裝套件

在對發佈 MapToSurface 套件進行瞭解之前，若您已在上一課程中安裝該套件，請將其解除安裝，以便不會使用相同的套件。

首先，請前往「套件」>「套件管理員」>「已安裝的套件」頁籤，然後按一下「MapToSurface」旁的垂直圓點功能表 >「刪除」。

然後重新啟動 Dynamo。重新開啟後，若查看 「管理套件」 視窗，會發現其中應該不再包含 MapToSurface。現在我們準備好重新開始！

本端發佈套件

在下方的連結按一下，下載範例檔案。

附錄中提供完整的範例檔案清單。

這是為套件首次提交的檔案，我們已將所有範例檔案與自訂節點置於一個資料夾中。準備好此資料夾後，我們就準備好上傳到 Dynamo Package Manager。

1. 此資料夾包含五個自訂節點 (.dyf)。

2. 此資料夾還包含五個範例檔案 (.dyn) 與一個匯入的向量檔案 (.svg)。這些檔案將作為介紹練習，用以向使用者示範如何使用自訂節點。

在 Dynamo 中，首先按一下 「套件」>「Package Manager」>「發佈新套件」 頁籤。

在 「發佈套件」 頁籤中，填寫視窗左側的相關欄位。

接下來，我們將加入套件檔案。您可以選取「加入目錄」(1)，逐個加入檔案，或加入整個資料夾。若要加入非 .dyf 的檔案，請務必在瀏覽器視窗中將檔案類型變更為 「所有檔案 (.)」。請注意，我們會加入所有檔案，不會區分該檔案是自訂節點檔案 (.dyf) 或範例檔案 (.dyn)。發佈套件時，Dynamo 會將這些項目分類。

選取 MapToSurface 資料夾後，Package Manager 會顯示資料夾內容。如果您上傳您自己的套件，且套件的資料夾結構複雜，而您不希望 Dynamo 變更資料夾結構，則可以啟用「保留資料夾結構」切換開關。此選項適用於進階使用者，如果您的套件並非以特定方式刻意設定，最好不要開啟此切換開關，讓 Dynamo 視需要組織檔案。按一下「下一步」以繼續。

發佈前，您可以在這裡預覽 Dynamo 組織套件檔案的方式。按一下「完成」以繼續。

按一下「本端發佈」(1)來進行發佈。若您跟著這裡的說明操作，請確定您按的是 「本端發佈」，而不是 「線上發佈」，避免 Package Manager 中有多個重複的套件。

發佈後，在「DynamoPrimer」群組或 Dynamo 資源庫下應該會顯示自訂節點。

現在，我們看一下根目錄，以瞭解 Dynamo 如何格式化我們剛剛建立的套件。前往「已安裝的套件」頁籤 > 按一下「MapToSurface」旁的垂直圓點功能表 > 選取「展示根目錄」，即可查看根目錄。

請注意，根目錄位於套件的本端位置 (請記住，我們在「本端」發佈套件)。Dynamo 目前參考此資料夾以讀取自訂節點。因此，請務必使用本端發佈功能，將資料夾發佈到永久的資料夾位置 (即不是您的桌面)。以下將分解講述 Dynamo 套件資料夾。

1. bin 資料夾包含使用 C# 或 Zero-Touch 資源庫建立的 .dll 檔案。我們沒有為此套件建立任何內容，所以此範例的此資料夾為空白。

2. dyf 資料夾包含自訂節點。開啟此資料夾將顯示此套件的所有自訂節點 (.dyf 檔案)。

3. extra 資料夾包含所有其他檔案。這些檔案可能是 Dynamo 檔案 (.dyn)，也可能是所需的任何其他檔案 (.svg、.xls、.jpeg、.sat 等)。

4. pkg 檔案是定義套件設定的基本文字檔案。它是 Dynamo 中自動建立的檔案，但是如果您希望取得詳細資料，可以編輯該檔案。

線上發佈套件

1. 準備好發佈後，在「套件」>「Package Manager」>「已安裝的套件」視窗中，選取要發佈之套件右側的按鈕，然後選擇「發佈」。

2. 如果您要更新已發佈的套件，請選擇「發佈版本」，Dynamo 將根據該套件根目錄中的新檔案，線上更新您的套件。非常簡單！

發佈版本...

若要更新已發佈套件根資料夾中的檔案，您也可以在 「我的套件」 頁籤中選取 「發佈版本...」，以發佈新版本的套件。這是一個很順暢的方式，可以對內容進行必要更新以及與社群分享。只有當您是套件的維護者時，才能使用 「發佈版本」。

Dynamo 提供自訂節點的多種不同建立方法。您可以從頭開始建置自訂節點、從既有圖表建置自訂節點，或使用 C# 明確建置自訂節點。在本節中，我們將討論在 Dynamo 使用者介面內透過既有圖表建置自訂節點。此方法非常適用於清理工作區，以及封裝一系列節點以供在其他位置重複使用。

練習：UV 對映的自訂節點

第 I 部分：以圖表開始

在以下影像中，我們將使用 UV 座標在曲面之間對映點。我們將使用此概念建立對 XY 平面中的曲線進行參考的面板化曲面。在此，我們將建立四邊形面板以進行面板化，但運用相同邏輯，我們可以使用 UV 對映建立多種面板。這是開發自訂節點的好機會，因為我們在此圖表或在其他 Dynamo 工作流程中，可以更輕鬆地重複使用類似程序。

按一下下方的連結下載範例檔案。

附錄中提供範例檔案的完整清單。

1. Code Block： 使用此行建立範圍介於 -45 到 45 之間的 10 個數字 45..45..#10;

2. Point.ByCoordinates： 將 Code Block 的輸出連接至「x」與「y」輸入，並將交織設定為交互參考。現在應該已建立點的格線。

3. Plane.ByOriginNormal： 將 Point 輸出連接至 origin 輸入，以便在每個點處建立平面。將使用預設的法線向量 (0,0,1)。

4. Rectangle.ByWidthLength： 將上一步中的平面連接至 plane 輸入，並使用 Code Block 以值 10 指定寬度與長度。

現在應該能看到矩形的格線。接下來使用 UV 座標將這些矩形對映到目標曲面。

1. Polygon.Points： 將上一步中的 Rectangle.ByWidthLength 輸出連接至 polygon 輸入，以擷取每個矩形的角點。這些是將要對映到目標曲面的點。

2. Rectangle.ByWidthLength： 使用 Code Block 以值 100 指定矩形的長度與寬度。這將是基準曲面的邊界。

3. Surface.ByPatch： 將上一步中的 Rectangle.ByWidthLength 連接至 closedCurve 輸入，以建立基準曲面。

4. Surface.UVParameterAtPoint： 連接 Polygon.Points 節點的 Point 輸出與 Surface.ByPatch 節點的 Surface 輸出，以傳回每個點處的 UV 參數。

現在，我們已建立基準曲面與一組 UV 座標，可以匯入目標曲面並在曲面之間對映點。

1. File Path： 選取要匯入的曲面的檔案路徑。檔案類型應是 .SAT。按一下 「瀏覽...」 按鈕，導覽至上面所下載 .zip 檔案中的 UVmapping_srf.sat 檔案。

2. Geometry.ImportFromSAT： 連接檔案路徑以匯入曲面。您在幾何圖形預覽中應該能看到匯入的曲面。

3. UV： 將 UV 參數輸出連接至 UV.U 與 UV.V 節點。

4. Surface.PointAtParameter： 連接匯入的曲面以及 u 與 v 座標。現在，您應該能看到目標曲面上 3D 點的格線。

最後一步是使用 3D 點來建構矩形曲面修補。

1. PolyCurve.ByPoints： 連接曲面上的點以建構通過這些點的 PolyCurve。

2. Boolean： 在工作區中加入 Boolean，將其連接至 connectLastToFirst 輸入，並切換至「True」以封閉 polycurve。現在，您應該能看到對映到曲面的矩形。

3. Surface.ByPatch： 將 polycurve 連接至 closedCurve 輸入，以建構曲面修補。

第 II 部分：從圖表到自訂節點

現在選取要巢狀插入至自訂節點的節點，同時考慮希望採用的節點輸入與輸出。我們希望自訂節點盡可能靈活，因此該自訂節點應該能對映任何多邊形，而不僅僅是矩形。

選取以下節點 (從 Polygon.Points 開始)，在工作區上按一下右鍵，然後選取「建立自訂節點」。

在「自訂節點性質」對話方塊中，指定自訂節點的名稱、描述及品類。

1. 名稱：MapPolygonsToSurface

2. 描述：將多邊形從基礎曲面對映至目標曲面

3. 附加元件品類：Geometry.Curve

自訂節點已顯著清理工作區。請注意，已根據原始節點命名輸入與輸出。接下來編輯自訂節點，以便讓名稱更具描述性。

按兩下「自訂節點」以對其進行編輯。這將開啟工作區，並以黃色背景表示節點內部。

1. Input： 將輸入名稱變更為 baseSurface 與 targetSurface。

2. Output： 為對映的多邊形加入其他輸出。

儲存自訂節點，然後返回首頁工作區。請注意 MapPolygonsToSurface 節點反映我們剛剛所做的變更。

我們也可以在自訂註解中加入內容，以提高自訂節點的堅實性。註解有助於提示輸入與輸出類型，或說明節點的功能。使用者將游標懸停在自訂節點的輸入或輸出上方時，將顯示註釋。

按兩下「自訂節點」以對其進行編輯。這會重新開啟黃色背景工作區。

1. 開始編輯 Input Code Block。若要開始註解，請在註解文字之前鍵入「//」。鍵入有助於說明節點的任何內容 - 在此我們將描述 targetSurface。

2. 接下來還要設定輸入類型等於某個值，以設定 inputSurface 的預設值。在此，我們將預設值設定為原始 Surface.ByPatch 設定。

也可以將註解套用到 Output。

編輯 Output Code Block 中的文字。在註解文字前鍵入「//」。在此，我們將加入更深入的描述，以說明 Polygons 與 surfacePatches 輸出。

1. 將游標懸停在自訂節點輸入上方可查看註解。

2. 設定 inputSurface 的預設值後，我們也可以執行定義，而不提供曲面輸入。

Dynamo 提供大量即裝即用的功能，並維護了豐富的套件資源庫，可顯著擴充 Dynamo 的功能。套件是自訂節點或其他功能的集合。Dynamo Package Manager 是一個入口網站，可讓社群下載已在線上發佈的套件。這些工具集由協力廠商開發，可擴充 Dynamo 的核心功能，任何人都能存取，按一下按鈕即可下載。

開放原始碼專案 (例如 Dynamo) 在此類型的社群參與下蓬勃發展。使用專屬的協力廠商開發人員，Dynamo 可以將其適用範圍延伸到一系列產業的工作流程中。因此，Dynamo 團隊齊心協力簡化套件的開發與發佈 (在後續各節中將更詳細地討論這一點)。

安裝套件

最簡易的套件安裝方式是使用 Dynamo 介面中的「套件」功能表選項。現在，讓我們直接開始安裝套件。在此簡單範例中，我們將安裝某個常見套件，在格線上建立四邊形板。

在 Dynamo 中，前往 「套件」>「Package Manager...」

在搜尋列中，我們搜尋「quads from rectangular grid」。片刻之後，您應該會看到符合此搜尋查詢的所有套件。我們要選取具有相符名稱的第一個套件。

按一下「安裝」，將此套件加入至您的資源庫，系統請您確認時，請接受。完成！

請注意，Dynamo 資源庫中現在有另一個群組稱為「buildz」。此名稱是指套件的開發人員，此群組中已放置自訂節點。我們可以立即開始使用。

使用 Code Block 可快速定義矩形格線，將結果輸出至 Polygon.ByPoints 節點，然後輸出至 Surface.ByPatch 節點，以檢視您剛剛建立的矩形板清單。

安裝套件資料夾 - DynamoUnfold

上述範例著重針對具有一個自訂節點的套件，不過您可以使用相同程序下載具有多個自訂節點的套件並支援資料檔案。現在使用更全面的套件 DynamoUnfold 示範。

如同上述範例，首先請選取 「套件」>「Package Manager...」。

這次我們要搜尋 「DynamoUnfold」，這是一個字，沒有空格。當我們看到套件時，按一下「安裝」下載，將 DynamoUnfold 加入您的 Dynamo 資源庫。

在 Dynamo 資源庫中，我們有一個 DynamoUnfold 群組，當中有多個品類和自訂節點。

現在，我們看一下套件的檔案結構。

1. 請先前往「套件」>「Package Manager」>「已安裝的套件」。

3. 然後按一下「展示根目錄」，以開啟此套件的根資料夾。

這會將我們帶到套件的根目錄。請注意，我們有 3 個資料夾和 1 個檔案。

1. bin 資料夾包含 .dll 檔案。此 Dynamo 套件使用 Zero-Touch 進行開發，因此自訂節點保留在此資料夾中。

2. dyf 資料夾包含自訂節點。此套件不是使用 Dynamo 自訂節點進行開發，所以此套件的此資料夾是空的。

3. extra 資料夾包含所有其他檔案 (包括範例檔案)。

4. pkg 檔案是定義套件設定的基本文字檔案。現在我們可以忽略該檔案。

開啟「extra」資料夾，我們可以看到隨安裝而下載的一系列範例檔案。並非所有套件都有範例檔案，但此若套件有範例檔案，您可以在此處找到這些檔案。

接下來開啟「SphereUnfold」。

開啟檔案並按一下求解器上的「執行」後，就會看到一個展開的圓球！諸如此類的範例檔案有助於學習如何使用新的 Dynamo 套件。

!

瀏覽和檢視套件資訊

在「Package Manager」中，您可以使用「搜尋套件」頁籤中的排序和篩選選項來瀏覽套件。該頁籤提供數種篩選，包含主程式、狀態 (新的、已棄用或取消棄用)，以及套件是否具有相依性。

透過排序套件，您可以找出高評等或下載次數最多的套件，或尋找最近更新的套件。

您也可以按一下「檢視詳細資料」，針對每個套件取得更多詳細資料。這會開啟 Package Manager 中的側面板，您可以在其中尋找資訊，例如版本管理和相依性、網站或儲存庫 URL、授權資訊等。

Dynamo Package Manager 網站

探索 Dynamo 套件的另一種方式是探索 Dynamo Package Manager 網站。您可以在這裡找到套件和作者排行榜的統計資料。您也可以從 Dynamo Package Manager 下載套件檔案，但是從 Dynamo 直接執行會更順暢。

套件儲存在本端的什麼位置？

如果您想要查看套件檔案的儲存位置，請在頂端導覽中按一下「Dynamo」>「偏好」>「套件設定」>「節點和套件檔案位置」。您可以在這裡找到您目前的根資料夾目錄。

套件預設安裝在與以下資料夾路徑類似的位置：C:/Users/[使用者名稱]/AppData/Roaming/Dynamo/[Dynamo 版本]。

進一步使用套件

Dynamo 社群在不斷成長與發展。透過不時地探索 Dynamo Package Manager，您會發現一些激動人心的新開發功能。在以下各節，我們將從終端使用者的視角到建立您自己的 Dynamo 套件，更深入地查看套件。

什麼是 Zero-Touch？

「Zero-Touch 匯入」是指匯入 C# 資源庫所使用的一個簡易點選方法。Dynamo 將讀取 .dll 檔案的公開方法，並將其轉換為 Dynamo 節點。您可以使用 Zero-Touch 開發自己的自訂節點與套件，並將外部資源庫匯入 Dynamo 環境。

1. .dll 檔

2. Dynamo 節點

使用 Zero-Touch，您可以實際匯入不一定是為 Dynamo 開發的資源庫，並建立一組新節點。目前的 Zero-Touch 功能展示出 Dynamo 專案的跨平台能力。

本節將示範如何使用 Zero-Touch 匯入協力廠商的資源庫。如需有關開發自己 Zero-Touch 資源庫的資訊，請參考 Dynamo Wiki 頁面。

Zero-Touch 套件

Zero-touch 套件是使用者定義之自訂節點的良好補充。下表列出使用 C# 資源庫的一些套件。如需有關套件的更多詳細資訊，請造訪附錄中的「套件」一節。

案例研究 - 匯入 AForge

在本案例研究中，我們將展示如何匯入 AForge 外部 .dll 資源庫。AForge 是功能強大的資源庫，提供從影像處理到人工智慧的一系列功能。我們將參考 AForge 的影像類別執行以下的一些影像處理練習。

我們從下載 AForge 開始。在 AForge 下載頁面上，選取 [Download Installer (下載安裝程式)]，並在下載完成後進行安裝。

在 Dynamo 中，建立新檔案，然後選取 「檔案」>「匯入資源庫...」

接下來，找到 dll 檔。

1. 在快顯視窗中，導覽至 AForge 安裝的「Release」資料夾。該資料夾可能位於類似如下的資料夾中：C:\Program Files (x86)\AForge.NET\Framework\Release。

2. AForge.Imaging.dll： 在此案例研究中，我們只希望使用 AForge 資源庫中的這個檔案。選取此 .dll，然後按一下 「開啟」。

回到 Dynamo，您應該會看到資源庫中已加入 AForge 節點群組。現在，可以從我們的視覺程式存取 AForge 影像資源庫！

練習 1：邊緣偵測

在下方的連結按一下，下載範例檔案。

附錄中提供完整的範例檔案清單。

現在已匯入資源庫，我們將從這第一個簡易練習 (01-EdgeDetection.dyn) 開始。我們將對範例影像執行某些基本影像處理，以展示 AForge 影像如何進行篩選。我們將使用 Watch Image 節點展示結果，並在 Dynamo 中套用與 Photoshop 中類似的篩選。

若要匯入影像，請在圖元區加入 File Path 節點，並從練習資料夾 (相片來源：flickr) 中選取「soapbubbles.jpg」。

File Path 節點僅提供我們所選影像的路徑字串。接下來，我們需要在 Dynamo 中將其轉換為可用的影像檔。

1. 使用 File From Path，在 Dynamo 環境中將檔案路徑項目轉換為影像。

2. 將 File Path 節點連接至 File.FromPath 節點。

3. 為了將此檔案轉換為影像，我們將使用 Image.ReadFromFile 節點。

4. 最後，我們來查看結果！將 Watch Image 節點放在圖元區上，並連接至 Image.ReadFromFile。我們尚未使用 AForge，但已成功將影像匯入 Dynamo。

在 AForge.Imaging.AForge.Filters (「導覽」功能表中) 下，您會發現有許多可用的篩選。我們現在將使用這些篩選的其中之一，以根據閾值對影像執行去飽和度。

1. 將三個滑棒放至圖元區，然後將其範圍變更為 0 到 1，將其步長值變更為 0.01。

2. 在圖元區加入 Grayscale.Grayscale 節點。這是 AForge 篩選，會將灰階篩選套用至影像。從步驟 1 將這三個滑棒連接至 cr、cg 和 cb。將頂部與底部滑棒的值變更為 1，將中間滑棒的值變更為 0。

3. 若要套用灰階篩選，我們需要對影像採取某項動作。為此，我們使用 BaseFilter.Apply。將影像連接至影像輸入，並將 Grayscale.Grayscale 連接至 baseFilter 輸入。

4. 插入 Watch Image 節點，我們得到一個去飽和度的影像。

我們可以控制如何根據紅、綠、藍的閾值對此影像執行去飽和度。這些閾值由 Grayscale.Grayscale 節點的輸入定義。請注意，影像看起來非常暗，這是因為我們的滑棒中將綠色的值設定為 0。

1. 將頂部與底部滑棒的值變更為 0，將中間滑棒的值變更為 1。這樣即可取得更清晰的去飽和度影像。

接下來我們使用去飽和度影像，並對其套用其他篩選。去飽和度影像具有一定的對比度，因此我們要測試某些邊緣偵測。

1. 在圖元區加入 SobelEdgeDetector.SobelEdgeDetector 節點。

2. 將此節點連接至 BaseUsingCopyPartialFilter.Apply，並將去飽和度影像連接至此節點的影像輸入。

3. Sobel 邊偵測器已在新影像中亮顯邊。

拉近後，邊偵測器已顯示標示圈的外框 (以像素為單位)。AForge 資源庫的工具可利用與此類似的結果並建立 Dynamo 幾何圖形。我們將在下一個練習中探索該功能。

練習 2：建立矩形

現在我們已介紹了一些基本影像處理，接下來使用影像來驅動 Dynamo 幾何圖形！在本練習中，基本上我們的目的是使用 AForge 與 Dynamo 執行影像的 「即時追蹤」。我們將使用簡易的作業從參考影像中擷取矩形，不過 AForge 中提供了執行更複雜作業的工具。我們將使用下載練習檔案中的 02-RectangleCreation.dyn。

1. 使用 File Path 節點，導覽至練習資料夾中的 grid.jpg。

2. 連接上述其餘的一系列節點，以顯示路線參數式格線。

在下一步，我們將參考影像中的白色正方形，並將其轉換為實際的 Dynamo 幾何圖形。AForge 具有許多功能強大的電腦視覺工具，這裡我們要使用其中一種很重要的資源庫工具，名為 BlobCounter。

1. 在圖元區加入 BlobCounter，接著我們需要採取某種方式來處理影像 (類似於上一個練習的 BaseFilter.Apply 工具)。

很遺憾，「處理影像」節點不會立刻顯示在 Dynamo 資源庫中。這是因為函數可能沒有顯示在 AForge 原始程式碼中。若要修正此問題，我們需要尋找因應措施。

1. 在圖元區加入 Python 節點，然後在 Python 節點中加入下列程式碼。此程式碼將匯入 AForge 資源庫，然後處理匯入的影像。

import sys
import clr
clr.AddReference('AForge.Imaging')
from AForge.Imaging import *

bc= BlobCounter()
bc.ProcessImage(IN[0])
OUT=bc

將影像輸出連接至 Python 節點輸入，Python 節點將產生 AForge.Imaging.BlobCounter 結果。

後續步驟會展現一些熟練使用 AForge Imaging API 的技巧。不必學會這些，也能處理 Dynamo 工作。這比較算是用來示範 Dynamo 環境的靈活度，可搭配多種外部資源庫使用。

1. 將 Python 指令碼的輸出連接至 BlobCounterBase.GetObjectRectangles。這會讀取影像中的物件，並根據閾值從像素空間萃取量化的矩形。

1. 在圖元區加入另一個 Python 節點，連接至 GetObjectRectangles，然後輸入以下程式碼。這將建立經過組織的 Dynamo 物件清單。

OUT = []
for rec in IN[0]:
	subOUT=[]
	subOUT.append(rec.X)
	subOUT.append(rec.Y)
	subOUT.append(rec.Width)
	subOUT.append(rec.Height)
	OUT.append(subOUT)

1. 轉置上一步 Python 節點的輸出。這會建立 4 個清單，分別代表每個矩形的 X、Y、寬度及高度。

2. 使用 Code Block 將資料排列為適合 Rectangle.ByCornerPoints 節點的結構 (程式碼如下)。

recData;
x0=List.GetItemAtIndex(recData,0);
y0=List.GetItemAtIndex(recData,1);
width=List.GetItemAtIndex(recData,2);
height=List.GetItemAtIndex(recData,3);
x1=x0+width;y1=y0+height;
p0=Autodesk.Point.ByCoordinates(x0,y0);
p1=Autodesk.Point.ByCoordinates(x0,y1);
p2=Autodesk.Point.ByCoordinates(x1,y1);
p3=Autodesk.Point.ByCoordinates(x1,y0);

我們現在有一系列形，代表影像中的白色正方形。透過程式設計，我們已實現與 Illustrator 中的即時追蹤 (大致) 類似的功能！

不過還需要清理一下。拉近後，可以看到有一些不需要的小矩形。

接下來要編寫程式碼，除去不需要的矩形。

1. 在 GetObjectRectangles 節點與另一個 Python 節點之間插入一個 Python 節點。節點的程式碼位於下方，會移除小於指定大小的所有矩形。

rectangles=IN[0]
OUT=[]
for rec in rectangles:
 if rec.Width>8 and rec.Height>8:
  OUT.append(rec)

消除多餘的矩形後，只是為了好玩，我們將從矩形建立曲面，並根據矩形的面積依距離擠出矩形。

最後，將 both_sides 輸入變更為 false，會產生一個方向的擠出。將產生的此結果浸入樹脂，將產生造型極為奇特的桌子。

以上是基本範例，但這裡描述的概念可以轉變成令人興奮的真實應用。電腦視覺可用於許多程序。這裡列示一些範例：條碼讀取器、透視配合、投影對映及增強實景。如需此練習相關的更多 AForge 進階主題，請完整閱讀本文。

Dynamo 提供了多種套件建立方式，供個人使用或與 Dynamo 社群分享。在以下案例研究中，我們將瞭解如何透過解構既有的套件以設置套件。此案例研究以上一章的課程為基礎，會提供一組自訂節點，以便在 Dynamo 曲面之間依 UV 座標對映幾何圖形。

MapToSurface 套件

我們將使用的範例套件會演示曲面之間點的 UV 對映。我們已在此手冊的建立自訂節點一節中建置了工具的基礎內容。以下檔案將示範我們如何利用 UV 對映的概念，以及如何為可發佈資源庫開發一組工具。

在此影像中，我們將使用 UV 座標在曲面之間對映點。套件以此概念為基礎，但具有更複雜的幾何圖形。

安裝套件

在上一章中，我們探索了根據 XY 平面中定義的曲線在 Dynamo 中將曲面面板化的方式。此案例研究將針對幾何圖形的更多標註延伸這些概念。我們會將此套件安裝為已建置的套件，以演示其開發方式。在下一節，我們將示範此套件的發佈方式。

在 Dynamo 中，按一下「套件」>「Package Manager」，然後搜尋套件「MapToSurface」(全部一個字，無空格)。按一下「安裝」以開始下載，並將套件加入您的資源庫。

安裝後，「Add-ons」>「DynamoPrimer」區段下應該會顯示自訂節點。

現在已安裝套件，接下來瞭解其設置方式。

自訂節點

我們將建立的套件會使用已建置供參考的五個自訂節點。接下來瞭解每個節點的行為。某些自訂節點會建置其他自訂節點，圖表的配置可供其他使用者以簡單的方式進行瞭解。

這是具有五個自訂節點的簡單套件。在以下步驟中，我們將簡要討論每個自訂節點的設置。

PointsToSurface

這是一個基本自訂節點，是其他所有對映節點的基礎。簡言之，節點會將來源曲面 UV 座標的點對映至目標曲面 UV 座標的位置。由於點是最基本的幾何圖形，以此為基礎會建置更複雜的幾何圖形，因此我們可以使用此邏輯在曲面之間對映 2D 甚至 3D 幾何圖形。

PolygonsToSurface

只需使用這裡的多邊形，即可示範將對映點從 1D 幾何圖形延伸至 2D 幾何圖形的邏輯。請注意，我們已將 PointsToSurface 節點巢狀插入此自訂節點中。使用此方式，我們可以將每個多邊形的點對映到曲面，然後從這些對映的點重新產生多邊形。透過保持正確的資料結構 (點清單的清單)，我們可以在多邊形精簡為一組點後保持多邊形的獨立性。

NurbsCrvtoSurface

這裡套用的邏輯與 PolygonsToSurface 節點中相同。但不是對映多邊形點，而是對映 NURBS 曲線的控制點。

OffsetPointsToSurface

此節點稍微複雜一些，但概念很簡單：此節點與 PointsToSurface 節點類似，可在曲面之間對映點。但是，它也會考慮到不在原始來源曲面上的點，會取得這些點距最近 UV 參數的距離，並將此距離對映到對應 UV 座標處的目標曲面法線。如果查看範例檔案，會比較有感覺。

SampleSrf

這個簡單節點會建立一個參數式曲面，從來源格線對映到範例檔案中的波浪曲面。

範例檔案

範例檔案可在套件的根資料夾中找到。按一下「Package Manager」>「安裝的套件」頁籤。

按一下「MapToSurface」旁的垂直圓點功能表 >「展示根目錄」。

接著開啟 「extra」 資料夾，此資料夾包含套件中不是自訂節點的所有檔案。這是 Dynamo 套件的範例檔案 (若存在) 的儲存位置。以下螢幕擷取畫面討論每個範例檔案中示範的概念。

01-PanelingWithPolygons

此範例檔案示範如何根據矩形的格線使用 PointsToSurface 將曲面平板化。這看起來應該很熟悉，因為我們在上一章示範了類似的工作流程。

02-PanelingWithPolygons-II

此練習檔案使用類似的工作流程，展示在從一個曲面將圓 (或表示圓的多邊形) 對映到另一個曲面的設置。此練習檔案使用 PolygonsToSurface 節點。

03-NurbsCrvsAndSurface

此範例檔案使用「NurbsCrvToSurface」節點，因此複雜性更高。會將目標曲面偏移指定的距離，並將 NURBS 曲線對映至原始目標曲面與偏移曲面。由此對對映的兩條曲線執行斷面混成以建立曲面，然後增厚該曲面。產生的這個實體具有代表目標曲面法線的波浪線。

04-PleatedPolysurface-OffsetPoints

此範例檔案示範如何將褶狀的 PolySurface 從來源曲面對映到目標曲面。來源曲面與目標曲面分別是跨越格線的矩形曲面與旋轉曲面。

來源 PolySurface 從來源曲面對映到目標曲面。

05-SVG-Import

由於自訂節點可以對映不同類型的曲線，因此這最後一個檔案參考從 Illustrator 匯出的 SVG 檔案，並將匯入的曲線對映到目標曲面。

剖析整個 .svg 檔案的語法，將曲線從 .xml 格式轉換為 Dynamo polycurve。

將匯入的曲線對映到目標曲面。我們可藉此以明確方式 (點選) 在 Illustrator 中設計一個平板化物件，匯入至 Dynamo，然後套用到目標曲面。