程式碼區塊是 Dynamo 中的獨有功能，用於動態連接視覺程式設計環境與文字型環境。程式碼區塊可存取所有 Dynamo 節點，並可以在一個節點定義整個圖形。請仔細閱讀本章，因為程式碼區塊是 Dynamo 中的基礎建置材料。

在本節中，您將會學習一系列如何使用 DesignScript 建立幾何圖形的課程。請將範例 DesignScript 複製到 Dynamo 程式碼區塊逐步進行。

// copy this code into a Code Block
// to start writing DesignScript

x = "Let's create some geometry!";

Dynamo 是 AEC 領域開始撰寫程式碼的絕佳之門。您可以從以下各節開始撰寫程式碼：

• 程式碼區塊和 DesignScript

• 使用 DesignScript 的幾何圖形

• Python

​Python 是使用廣泛的程式設計語言，其備受青睞與其語法樣式有很大關係。Python 的可讀性很高，因此較許多其他語言更容易瞭解。Python 支援模組與套件，可嵌入至既有應用程式中。如需如何正常使用 Python 的資訊， 上的 頁面是良好的資源。

Intersect、Trim 和 SelectTrim 主要是用在較低維度的幾何圖形 (例如點、曲線和曲面)。而立體幾何圖形則有額外的一組方法，可以透過類似 Trim 的方法減去材料，然後將元素合併在一起形成較大的元素，在建構幾何圖形後修改形狀。

Union (聯集)

Union 方法使用兩個實體物件，從兩個物件都涵蓋到的空間建立單一實體物件。物件之間重疊的空間會合併成最終的形狀。此範例將一個圓球和一個立方體合併成一個單一的立體圓球-立方塊造型：

s1 = Sphere.ByCenterPointRadius(
    CoordinateSystem.Identity().Origin, 6);

s2 = Sphere.ByCenterPointRadius(
    CoordinateSystem.Identity().Origin.Translate(4, 0,
    0), 6);

combined = s1.Union(s2);

Difference (差集)

Difference 方法與 Trim 類似，從基準實體減去輸入工具實體的內容。在此範例中，我們從一個圓球切掉一個小凹口：

Intersect (交集)

Intersect 方法傳回兩個實體輸入之間重疊的實體。在以下範例中，Difference 已變成 Intersect，產生的實體是一開始切掉不見的空洞：

程式碼區塊是 DesignScript 中的深層視窗，是 Dynamo 程式設計語言的核心。DesignScript 可用於從頭開始進行建置以支援探索式設計工作流程，它是一個可讀且簡要的語言，可為較小的位元碼提供即時意見以也可以用於大型且複雜的互動。DesignScript 還形成在後台驅動 Dynamo 大多數方面之引擎的基礎。因為幾乎 Dynamo 節點的所有功能和互動都與指令碼撰寫語言有一對一的關係，所以有獨特的機會以流暢方式在節點式互動與指令碼撰寫之間轉換。

對於初學者，節點可以自動轉換為文字語法，以協助學習 DesignScript，或單純只是為了縮小較大的圖表部分。使用稱為「要編碼的節點」的流程即可達成。在 會說明更多詳細資訊。經驗更豐富的使用者可以使用程式碼區塊，建立既有功能以及使用許多標準編碼範例的使用者編寫關係的自訂組合。對於初學者和進階使用者之間的使用者，提供了大量的捷徑和程式碼片段可加快您的設計。雖然術語「程式碼區塊」可能會讓非程式設計師覺得有點難以理解，但它其實很容易使用，而且功能強大。初學者可以在進行最少編碼的情況下使用程式碼區塊，進階使用者可定義在 Dynamo 定義的其他位置可進行呼叫的指令碼型定義。

程式碼區塊：簡要概述

簡而言之，程式碼區塊是視覺指令碼撰寫環境中的文字指令碼撰寫介面。它們可以用作數字、字串、公式和其他資料類型。程式碼區塊是專為 Dynamo 設計的，因此可以在程式碼區塊中定義任意變數，且這些變數會自動新增至節點的輸入：

點 (Point)

Dynamo 標準幾何圖形資源庫中最簡單的幾何圖形物件是一個點。所有幾何圖形都是使用稱作建構函式的特殊函數建立的，每個建構函式都會傳回一個該特定幾何圖形類型的新實體。在 Dynamo 中，建構函式以物件類型的名稱 (在此案例中為 Point) 為開頭，後接建構的方法。若要建立一個以 x、y、z 直角座標指定的三維點，請使用 ByCoordinates 建構函式：

Dynamo 中的建構函式通常以「By」字首指定，呼叫這些函數會傳回該類型新建立的物件。這個新建立的物件以等號左邊命名的變數儲存。

大多數物件都有許多不同的建構函式，我們可以使用 BySphericalCoordinates 建構函式，指定圓球的半徑、第一個旋轉角度和第二個旋轉角度 (以度為單位指定) 建立一個圓球上的點：

從點到線

點可以用來建構更高維度的幾何圖形，例如直線。我們可以使用 ByStartPointEndPoint 建構函式在兩個點之間建立一個 Line 物件：

從直線到曲面

同樣的，直線也可以用來建立更高維度的曲面幾何圖形，例如使用 Loft 建構函式，用一系列直線或曲線，在這之間內插一個曲面。

從曲面到實體

曲面也可以用來建立更高維度的實體幾何圖形，例如把曲面加厚指定的距離。許多物件都會附加稱為方法的函數，程式設計師可以對該特定物件執行指令。所有幾何圖形都通用的方法包括 Translate 和 Rotate，分別將幾何圖形平移 (移動) 和旋轉指定的量。曲面有一個 Thicken 方法，它採用一個單一的數字輸入，指定曲面的新厚度。

相交

Intersection 指令可以從較高維度的物件萃取出較低維度的幾何圖形。在建立、萃取和重新建立幾何圖形的循環過程中，萃取出的較低維度幾何圖形可以形成較高維度幾何圖形的基礎。在此範例中，我們使用產生的實體 (Solid) 來建立一個曲面 (Surface)，並使用曲面 (Surface) 來建立一條曲線 (Curve)。

計算設計中經常會使用曲線和曲面做為後續建構幾何圖形的基礎。為了讓這個早期的幾何圖形能夠做為後期幾何圖形的基礎，腳本必須要能夠萃取品質，例如物件整個區域的位置和方位。曲線與曲面兩種都支援這類萃取，這就是所謂的參數化。

一條曲線上所有的點都可以視為在 0 到 1 的範圍內具有唯一的參數。如果我們根據幾個控制點或內插點建立 NurbsCurve，第一個點的參數會是 0，最後一個點的參數會是 1。我們無法事先知道所有中間點的確切參數是多少，這聽起來像是很嚴重的限制，不過透過一系列的公用程式函數，這個狀況會減輕許多。曲面的參數化與曲線類似，但是有兩個分別稱為 u 和 v 的參數，而不是一個。如果我們要建立一個包含以下幾點的曲面：

pts = [ [p1, p2, p3],
        [p4, p5, p6],
        [p7, p8, p9] ];

p1 會有 u = 0 v = 0 的參數，p9 會有 u = 1 v = 1 的參數。

決定用來產生曲線的點時，參數化並不是特別好用，它的主要用途是決定由 NurbsCurve 和 NurbsSurface 建構函式所產生的中間點的位置。

曲線 (Curve) 有一個 PointAtParameter 方法，採用 0 到 1 之間的一個雙精確度引數，並傳回位於該參數的 Point 物件。例如，此腳本會找出參數 0、.1、.2、.3、.4、.5、.6、.7、.8、.9 和 1 的點 (Point)：

pts = {};
pts[0] = Point.ByCoordinates(4, 0, 0);
pts[1] = Point.ByCoordinates(6, 0, 1);
pts[2] = Point.ByCoordinates(4, 0, 2);
pts[3] = Point.ByCoordinates(4, 0, 3);
pts[4] = Point.ByCoordinates(4, 0, 4);
pts[5] = Point.ByCoordinates(3, 0, 5);
pts[6] = Point.ByCoordinates(4, 0, 6);

crv = NurbsCurve.ByPoints(pts);

pts_at_param = crv.PointAtParameter(0..1..#11);

// draw Lines to help visualize the points
lines = Line.ByStartPointEndPoint(pts_at_param,
    Point.ByCoordinates(4, 6, 0));

同樣的，曲面 (Surface) 有一個 PointAtParameter 方法，採用兩個引數：產生的點的 u 和 v 參數。

在萃取曲線和曲面上的各個點時雖然很好用，但是腳本通常需要知道位於某個參數的特定幾何特性，例如曲線或曲面是朝向哪個方向。CoordinateSystemAtParameter 方法不只會找出位置，也會找出位於曲線或曲面的參數處有方向的 CoordinateSystem。例如，以下腳本會沿著一個迴轉的曲面 (Surface) 萃取出有方向的 CoordinateSystem，並使用 CoordinateSystem 的方位產生插在曲面法線方向上的線條：

如先前所述，參數化在整個曲線或曲面的長度不一定都是均勻的，這表示參數 0.5 不一定會永遠對應到曲線或曲面的中點，0.25 不一定會永遠對應到曲線或曲面四分之一的點。若要避開這種限制，曲線還有另外一組參數化指令，可讓您沿著曲線找出位於特定長度的點。

NurbsCurve 的二維類比是 NurbsSurface，就像自由形式的 NurbsCurve，您可以使用兩種基本方法建構 NurbsSurface：一個是輸入一組基準點，讓 Dynamo 在這些點之間內插，另一個是明確指定曲面的控制點。就像自由形式的曲線，如果設計師很清楚知道要產生的曲面形狀，或如果設計需要曲面通過約束點，內插的曲面會很好用。相反地，如果是要探索各種平滑程度的設計，透過控制點建立的曲面就比較有用。

內插曲面

若要建立內插的曲面，只要產生一些近似曲面形狀的二維點即可。這些點必須是矩形，亦即不是鋸齒狀。NurbsSurface.ByPoints 方法會從這些點建構一個曲面。

// python_points_1 is a set of Points generated with
// a Python script found in Chapter 12, Section 10

surf = NurbsSurface.ByPoints(python_points_1);

控制點曲面

指定曲面的基本控制點，也可以建立自由形式的 NurbsSurface。就像 NurbsCurve 一樣，控制點可以視為是代表一個有直線段的四邊形網格，這會根據曲面的次數，平滑化成最終的曲面形狀。若要使用控制點來建立 NurbsSurface，請在 NurbsSurface.ByPoints 中包含另外兩個參數，指出基本曲線在曲面兩個方向的次數。

我們可以增加 NurbsSurface 的次數，來變更產生的曲面幾何圖形：

斷面混成曲面

就像我們可以在一組輸入點之間內插來建立 Surface，也可以在一組基準曲線之間內插來建立 Surface。這稱為斷面混成。使用 Surface.ByLoft 建構函式可以建立斷面混成的曲線，一組輸入曲線是唯一的參數。

迴轉曲面

迴轉的曲面是另外一種曲面類型，環繞一個中心軸掃掠一條基準曲線可以建立這種曲面。如果內插曲面是內插曲線的二維類比，則迴轉的曲面就是圓和弧的二維類比。

迴轉的曲面是由基準曲線 (代表曲面的「邊緣」)、軸原點 (曲面的基準點)、軸方向 (中央「核心」方向)、掃掠起始角度和掃掠結束角度指定。這些是用來做為 Surface.Revolve 建構函式的輸入。

透過在三維空間中明確指出 x、y、z 座標，可以建立某些幾何圖形物件。但是，我們更常對物件本身或對其基本的 CoordinateSystem 使用幾何轉換，將幾何圖形移動到最終位置。

翻譯

最簡單的幾何轉換是平移，亦即將一個物件沿著 x、y、z 方向移動指定的單位數。

在 Dynamo 中有兩種基本方法可以建立自由形式的曲線：指定一些點，讓 Dynamo 在這些點之間插出一條平滑的曲線，另一個比較低階的方法是指定某個次數的曲線的基本控制點。如果設計師很清楚知道要產生的線條形狀，或如果設計有一些特定的約束讓曲線可以或無法通過，內插的曲線會很好用。透過控制點指定的曲線實際上是一系列的直線段，演算法會將這些線段平滑產生一條最終的曲線形狀。如果是要探索各種不同平滑程度的曲線形狀，或者當曲線段之間的平滑連續性很重要時，透過控制點指定曲線就很好用。

內插曲線

若要建立內插的曲線，只要將一些點傳入 NurbsCurve.ByPoints 方法即可。

產生的曲線會分別與每個輸入點相交，從第一個點開始，在最後一個點結束。這裡可以使用一個選擇性的週期性參數，用來建立一條週期性的封閉曲線。Dynamo 會自動填入缺少的線段，因此不需要複製終點 (與起點相同)。

計算設計中的物件很少會以其最終的位置和形狀明確建立，幾乎都是以既有的幾何圖形為基礎，將它們經過平移、旋轉，或以其他任何方式放在適當位置。向量數學是一種以幾何搭建鷹架的方式，對幾何圖形提供方向和方位，並且將整個 3D 空間的移動概念化而不提供視覺表現法。

從最基礎來說，一個向量代表 3D 空間中的一個位置，而且通常視為從位置 (0,0,0) 到該位置的一個箭頭終點。向量可以使用 ByCoordinates 建構函式建立，採用新建立的向量物件的 x、y、z 位置。請注意，向量物件不是幾何物件，不會出現在 Dynamo 視窗中。但是在主控台視窗中可以列印出新建立或修改過的向量的相關資訊：

向量物件定義了一組數學運算，讓您可以在 3D 空間中相加、相減、相乘，或以其他任何方式移動物件，就像您在 1D 空間中的數線上移動實數一樣。

向量相加

向量相加是定義為兩個向量的分量總和，可以視為是兩個分量的向量箭頭以尖端接著尾端的方式放置而得到的向量。向量相加是使用

以下 Python 指令碼會為多個範例產生點陣列。請將這些指令碼貼至 Python Script 節點，如下所示：

python_points_1

python_points_2

python_points_3

python_points_4

python_points_5

在 Dynamo 2.0 中，我們可以在第一次開啟 Python 視窗時，指定要使用的預設樣板 (.py extension)。這是一個大家期待已久的功能，因為可以加快在 Dynamo 中使用 Python 的速度。使用樣板，可以讓我們在想要開發自訂 Python 指令碼時，有預設的匯入值可以隨時開始。

此樣板的位置位於 Dynamo 安裝的 APPDATA 位置。

這通常如下所示 ( %appdata%\Dynamo\Dynamo Core\{version}\ )。

座標系統 (CoordinateSystem)

雖然 Dynamo 能夠建立各種複雜幾何形狀，但是簡單的幾何基本型是構成任何計算設計的骨架：無論是以最終設計的形式直接表示，或是用來做為產生更複雜幾何圖形的鷹架。

雖然 CoordinateSystem 嚴格來說不算是一個幾何圖形，但卻是建構幾何圖形的一個重要工具。一個 CoordinateSystem 物件可以同時追蹤位置和幾何的轉換，例如旋轉、切變和調整比例。

建立一個中心點位於 x=0，y=0，z=0 的 CoordinateSystem (沒有旋轉、調整比例或切變轉換)，只需要呼叫 Identity 建構函式：

具有幾何轉換的 CoordinateSystem 超出本章節的範圍，不過有另一個建構函式 CoordinateSystem.ByOriginVectors 可以讓您在特定的點建立座標系統：

點 (Point)

最簡單的幾何基本型是一個點 (Point)，代表三維空間中的一個零維位置。如先前所述，在特定座標系統中建立一個點有幾種不同的方式：Point.ByCoordinates 以指定的 x、y、z 座標建立一個點；Point.ByCartesianCoordinates 在特定座標系統中以指定的 x、y、z 座標建立一個點；Point.ByCylindricalCoordinates 在有半徑、旋轉角度和高度的圓柱上建立一個點；Point.BySphericalCoordinates 在有半徑和兩個旋轉角度的圓球上建立一個點。

本範例會顯示在各種座標系統建立的點：

直線 (Line)

下一個較高維度的 Dynamo 基本型是線段，代表兩個端點之間有無限個點。使用 Line.ByStartPointEndPoint 建構函式明確指出兩個邊界點，或使用 Line.ByStartPointDirectionLength 建構函式指定起點、方向和沿著該方向的長度，可以建立直線。

3D 基本型 - 立方體、圓錐、圓柱、圓球等

Dynamo 有幾個物件，代表三維的幾何基本型的最基本類型：使用 Cuboid.ByLengths 建立的立方體 (Cuboid)；使用 Cone.ByPointsRadius 和 Cone.ByPointsRadii 建立的圓錐 (Cone)；使用 Cylinder.ByRadiusHeight 建立的圓柱 (Cylinder)；以及使用 Sphere.ByCenterPointRadius 建立的圓球 (Sphere)。

可以在程式碼塊中建立函數，然後在 Dynamo 定義中的其他位置重新呼叫函數。此作業會在參數式檔案中建立另一個控制層，可視為自訂節點的文字版本。在此案例中，「父系」Code Block 可隨時存取，可在圖表中的任何位置找到。無需使用線路！

父系

第一行包含關鍵字「def」，然後依次是函數名稱與輸入的名稱 (在括號中)。大括號定義函數的本體。使用「return =」傳回值。定義函數的 Code Block 沒有輸入或輸出埠，因為會從其他 Code Block 呼叫。

子系

使用同一檔案中的其他 Code Block，只需提供名稱與相同數量的引數即可呼叫函數。其工作方式類似於資源庫中的現成節點。

練習：透過 Z 建立圓球

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

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

在本練習中，我們將進行根據輸入點清單建立圓球的一般定義。這些圓球的半徑由每個點的 Z 性質驅動。

接下來先建立介於 0 到 100 之間的一系列十個值。將這些值插入 Point.ByCoordinates 節點，以建立對角線。

建立 Code Block 並介紹我們的定義。

1. 使用以下程式碼行：

inputPt 是我們為了表示驅動函數的點而提供的名稱。到現在為止，函數不會執行任何作業，但我們將在後續步驟中建置此函數。

1. 加入 Code Block 函數後，我們加上註解和 sphereRadius 變數，它會查詢每個點的 Z 位置。請記住，inputPt.Z 是一個方法，不需要括號。這是 查詢 既有元素的性質，因此不需要任何輸入：

1. 現在，我們呼叫在另一個 Code Block 中建立的函數。如果在圖元區上按兩下以建立新的 Code Block，然後鍵入 sphereB，我們發現 Dynamo 建議使用我們定義的 sphereByZ 函數。您的函數已加入 intellisense 資源庫！太酷了。

1. 現在，我們呼叫函數，並建立一個稱為 Pt 的變數以插入先前步驟中建立的點：

2. 我們看到輸出全部都是空值。為何會發生這種情況？定義函數時，我們會計算 sphereRadius 變數，但沒有定義函數應 傳回 哪些項目做為 輸出。我們可以在下一步修正此問題。

1. 我們需要在 sphereByZ 函數中加入 return = sphereRadius; 行定義函數的輸出，這是重要的步驟。

2. 現在，我們可以看到 Code Block 的輸出提供每個點的 Z 座標。

現在，我們要編輯 父系 函數以建立實際的圓球。

1. 我們首先使用以下程式碼行定義圓球：sphere=Sphere.ByCenterPointRadius(inputPt,sphereRadius);

2. 接下來，我們將傳回值變更為 sphere，而不是 sphereRadius：return = sphere; 這會在 Dynamo 預覽中產生一些巨大的圓球！

1.若要調整這些圓球的大小，我們加入圓規來更新圓球半徑值：sphereRadius = inputPt.Z/20; 現在，我們可以看到分開的圓球，並開始了解半徑與 Z 值之間的關係。

1. 在 Point.ByCoordinates 節點上，透過將交織從「最短清單」變更為「笛卡兒積」，我們建立點的格線。sphereByZ 函數仍完全有效，因此所有點會建立半徑以 Z 值為基礎的圓球。

1. 為了進行測試，我們將原始數字清單插入 Point.ByCoordinates 的 X 輸入。我們現在有一個立方塊的圓球。

2. 注意：如果在您的電腦上需要花很長時間執行此計算，請嘗試將 #10 變更為諸如 #5 等數字。

請記住，我們建立的 sphereByZ 函數是一般函數，因此可以回顧先前課程中的螺旋線，並對其套用函數。

最後一步：運用使用者定義的參數驅動半徑比。若要執行，我們需要為函數建立新輸入，並使用參數取代除數 20。

1. 將 sphereByZ 定義更新為：

2. 在輸入 sphereByZ(Pt,ratio); 中加入 ratio 變數以更新子系 Code Block。將滑棒插入新建立的 Code Block 輸入，並根據半徑比變更半徑的大小。

到目前為止，許多範例都將重點放在從較低維度的物件建構較高維度的幾何圖形。交集的方法允許這種較高維度的幾何圖形產生較低維度的物件，而修剪和選取修剪的指令則允許腳本在建立幾何圖形後大幅修改幾何形狀。

Dynamo 針對所有幾何圖形都定義了 Intersect 方法，表示理論上，任何幾何圖形部分都可以與其他任何幾何圖形部分相交。某些交集本來就沒有意義，例如牽涉到點 (Point) 的交集，因為產生的物件永遠都是輸入點本身。下表概述物件之間其他可能的交集組合。下表概述各種交集運算的結果：

Intersect (交集)

下面這個非常簡單的範例示範一個平面與一個 NurbsSurface 的交集。交集產生一個 NurbsCurve 陣列，可以像任何其他 NurbsCurve 一樣使用這個陣列。

Trim 方法與 Intersect 方法非常類似之處在於幾乎是針對每個幾何圖形定義。不過，Trim 的限制遠比 Intersect 還多。

Trim (修剪)

請注意，Trim 方法一定要有「選取」點，這個點決定要捨棄哪個幾何圖形，要保留哪些部份。Dynamo 會找出並捨棄最接近選取點且經過修剪的幾何圖形。

Python 和 Revit

現在我們已經示範了如何在 Dynamo 中使用 Python 指令碼，接下來瞭解將 Revit 資源庫連接至指令碼撰寫環境。請記住，我們使用以下 Code Block 的前四行匯入了 Python 標準和 Dynamo 核心節點。若要匯入 Revit 節點、Revit 元素及 Revit 文件管理員，我們只需再加入幾行程式碼：

這會提供 Revit API 的存取權，以及適用於 Revit 工作的自訂指令碼。透過合併視覺程式設計程序與 Revit API 指令碼，將大幅改進協同合作與工具開發。例如，BIM 管理員與線路圖設計者可以針對同一圖表進行合作。透過這種協同合作，他們可以改善模型的設計與執行。

速寫

程式碼區塊有一些基本的速寫方法，簡言之，這些方法可以 顯著 降低資料管理的難度。以下我們將分類講解基本知識，並討論如何使用此速寫來建立與查詢資料。

其他語法

範圍和序列

定義範圍與序列的方法可以精簡為基本速寫。使用以下影像作為「..」語法的指南，以使用 Code Block 定義一系列數值資料。瞭解此標記法後，建立數值資料就會非常有效率：

1. 在此範例中，數字範圍由定義 beginning..end..step-size; 的基本 Code Block 語法所取代。以數字方式表示，我們得到：0..10..1;

2. 請注意，語法 0..10..1; 相當於 0..10; 步長大小 1 是速寫標記法的預設值。因此 0..10; 將產生從 0 到 10 且步長大小為 1 的序列。

進階範圍

藉由建立進階範圍，我們能以簡單方式使用清單的清單。在以下範例中，我們將隔離變數與主要範圍標記，並建立該清單的另一個範圍。

1.建立巢狀範圍，對含與不含「#」的標記進行比較。套用基本範圍內的相同邏輯，只是變得稍複雜一些。

2.可以在主要範圍內的任何位置定義子範圍，請注意我們可以有兩個子範圍。

3.透過控制範圍內的「end」值，我們可以建立長度不同的多個範圍。

比較以上兩個速寫，並嘗試剖析 子範圍 與 # 標記如何產生結果輸出，來作為邏輯練習。

建立清單與取得清單中的項目

除了使用速寫建立清單外，我們也可以快速建立清單。這些清單可以包含多種元素類型，也可以進行查詢 (請記住，清單本身就是物件)。總而言之，使用 Code Block，您將使用括號 (方括號) 建立清單和查詢清單中的項目：

1.使用字串快速建立清單，並使用項目索引查詢清單。

2.使用變數建立清單，並使用範圍速寫標記查詢清單。

使用巢狀清單進行管理是類似的程序。請注意清單順序，並使用多組方括號呼叫：

1.定義清單的清單。

2.使用單邊括號查詢清單。

3.使用雙邊括號查詢項目。

練習：正弦曲面

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

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

在本練習中，我們將靈活運用新的速寫技能，以建立由範圍與公式定義的炫酷蛋殼曲面。在本練習中，請注意我們如何搭配使用 Code Block 與既有 Dynamo 節點：我們對處理大量資料的工作使用 Code Block，而以視覺方式配置 Dynamo 節點以實現定義的易讀性。

首先，透過連接以上節點以建立曲面。不是使用數字節點來定義寬度與長度，而是按兩下圖元區，然後在 Code Block 中輸入 100;。

1. 在 Code Block 中輸入 0..1..#50，定義介於 0 至 1 之間且分為 50 份的範圍。

2. 將該範圍連接至 Surface.PointAtParameter，這會在曲面內為 u 與 v 指定介於 0 與 1 之間的值。請記得在 Surface.PointAtParameter 節點上按一下右鍵，將「交織」變更為「笛卡兒積」。

在此步驟中，我們使用第一個函數在 Z 方向將點的格線上移。此格線將根據基本函數驅動產生的曲面。如以下影像所示新增節點

1. 我們使用包含 (0..Math.Sin(x*360)..#50)*5; 這一行的 Code Block。為了快速詳細說明這一點，我們將定義內含公式的範圍。此公式是正弦函數。正弦函數會接收 Dynamo 中輸入的角度，因此為了取得完整的正弦波形，我們將 x 值 (這是 0 到 1 的範圍輸入) 乘以 360。接下來，我們希望份數與每列的控制格線點數量相同，所以使用 #50 定義五十份。最後，乘數 5 只是為了增加平移的振幅，方便我們在 Dynamo 預覽中查看效果。

1. 雖然上一個 Code Block 運作地很好，但它並非完全是參數式方法。我們要動態驅動其參數，因此我們將上一步的程式碼行取代為 (0..Math.Sin(x*360*cycles)..#List.Count(x))*amp;。藉此我們能根據輸入定義這些值。

透過變更滑棒 (範圍從 0 到 10)，我們得到一些有趣的結果。

1. 透過對數字範圍執行轉置，我們反轉窗簾波浪的方向：transposeList = List.Transpose(sineList);

1. 加入 sineList 與 transposeList 後會得到一個扭曲的蛋殼曲面：eggShellList = sineList+transposeList;

變更下面指定的滑棒值，將此演算法「變平靜」。

最後，我們使用 Code Block 查詢資料的隔離部分。若要重新產生具有特定範圍點的曲面，請在 Geometry.Translate 與 NurbsSurface.ByPoints 節點之間加入以上 Code Block。這包括文字行：sineStrips[0..15..1];。這將選取前 16 列的點 (從 50 個點中)。重新建立曲面，我們可以看到已產生點格線的隔離部分。

1. 在最後一個步驟中，為了讓此 Code Block 的參數式程度更高，我們使用範圍從 0 至 1 的滑棒來驅動該查詢。我們使用這一行程式碼執行此作業：sineStrips[0..((List.Count(sineStrips)-1)*u)];。這可能有些混亂，但使用該行程式碼可以快速運用介於 0 和 1 之間的乘數來擴充清單長度。

若使用滑棒值 0.53，會建立一個剛好通過格線中點的曲面。

與預期一致，使用滑棒值 1 時，會從完整的點格線建立一個曲面。

查看視覺圖表，我們可以亮顯 Code Block，並查看其中的每項函數。

1.第一個 Code Block 取代 Number 節點。

2.第二個 Code Block 取代 Number Range 節點。

3.第三個 Code Block 取代 List.Transpose、List.Count 和 Number Range 節點。

4.第四個 Code Block 查詢清單的清單，取代 List.GetItemAtIndex 節點。

您可能發現 Dynamo 中節點名稱有一個常見現象：每個節點都使用 . 語法而不含空格。這是因為每個節點頂部的文字都表示指令碼撰寫的實際語法，而 . (或 點標記法 ) 將元素與我們可能呼叫的方法分開。這樣可以從視覺指令碼輕鬆轉換為文字型指令碼。

如果將點標記法做一般的類比，在 Dynamo 中如何處理一個參數式蘋果呢？以下是我們在決定吃蘋果之前先對蘋果執行的一些方法。(注意：這些方法不是實際的 Dynamo 方法)。

為什麼要在 Dynamo 的視覺程式設計環境中使用文字程式設計？有許多優點。您可藉此在直覺的視覺介面中建立程式，不必學習特殊語法。但是，視覺程式可能會變得雜亂，有時會缺少功能。例如，Python 為編寫條件陳述式 (if/then) 及迴圈提供更容易達到目標的方法。Python 是功能強大的工具，可以延伸 Dynamo 的功能，您可藉此使用幾行簡潔的程式碼來取代許多節點。

視覺程式：

文字程式：

Python 節點

與程式碼區塊類似，Python 節點是視覺程式設計環境中的指令碼撰寫介面。Python 節點位於資源庫中的「Script」>「Editor」>「Python Script」下。

語言變更部分概述對 Dynamo 每個版本中的語言所做的更新和修改。這些變更可能會影響功能、效能和使用方式，本指南將協助使用者瞭解何時以及為何要適應這些更新。

Dynamo 2.0 語言變更

1. 將 list@level 語法從「@-1」變更為「@L1」

• list@level 的新語法是使用 list@L1 而不是 list@-1

• 動機：讓程式碼語法與預覽/使用者介面一致，使用者測試表明此新語法更容易理解

1. 在 TS 中實施 Int 和 Double 類型，以便與 Dynamo 類型保持一致

2. 不允許其引數僅基數不同的多載函數

• 使用已移除多載的舊圖表，應預設為等級較高的多載。

• 動機：消除要執行哪個特定函數的不明確性

1. 使用複製指南時停用陣列提升

2. 讓指令式區塊中的變數對指令式區塊範圍是局部變數

• 指令式 Code Block 內部定義的變數值，不會因參考它們的指令式區塊內部的變更而改變。

1. 讓變數成為不變，以停用 Code Block 節點中的關聯式更新

2. 將所有使用者介面節點編譯為靜態方法

3. 支援沒有指定的傳回陳述式

• 函數定義或指令式程式碼中都不需要「=」。

1. 移轉 CBN 中的舊方法名稱

• 許多節點已更名，提高在資源庫瀏覽器使用者介面中的可讀性和放置

1. 在字典清理時使用清單

已知問題：

• 指令式區塊中的名稱空間衝突會導致出現意外的輸入埠。請參閱 以取得更多資訊。若要解決此問題，請如下所示定義指令式區塊外部的函數：

Dynamo 2.0 語言變更說明

我們大量改進 Dynamo 2.0 版的語言。這樣做的主要動機是簡化語言。重點一直是讓 DesignScript 更容易理解和使用，使其更強大和靈活，目的是提高終端使用者的理解。

以下是 2.0 中的變更清單說明：

• 簡化 List@Level 語法

• 其參數只有等級不同的多載方法是不合法的

• 將所有使用者介面節點編譯為靜態方法

• 與複製指南/交織一起使用時停用清單提升

1.簡化 list@level 語法

list@level 的新語法是使用 list@L1 而不是 list@-1

2.其參數只有等級不同的多載函數是不合法的

多載函數有問題的原因很多：

• 圖表中的使用者介面節點指出的多載函數，可能與執行階段所執行的多載不同

• 方法解析成本高昂，也不適用於多載函數

• 很難理解多載函數的複製行為

以 BoundingBox.ByGeometry 為例 (舊版 Dynamo 中有兩個多載函數)，一個採用單值引數，另一個採用幾何清單作為引數：

如果使用者將第一個節點放在圖元區上並連接一個幾何圖形清單，他希望複製能夠啟動，但這永遠不會發生，因為在執行階段將改為呼叫第二個多載，如下所示：

在 2.0 中，我們不允許由於這個原因僅在參數基數上不同的多載函數。這表示，對於有相同數量和類型的參數但有一個或多個參數只是等級不同的多載函數，先定義的多載永遠優先，編譯器會捨棄其餘多載。進行這種簡化的主要優點是透過一個快速方式選擇候選函數，可以簡化方法解析邏輯。

在 2.0 的幾何圖形資源庫中，棄用了 BoundingBox.ByGeometry 範例中的第一個多載，保留了第二個多載，因此，如果節點是要複製 (亦即用於第一個的環境中)，則必須搭配最短 (或最長) 交織選項使用，或在有複製指南的 Code Block 中使用：

在這個例子中，我們可以看到，等級較高的節點既可以在複製呼叫中使用，也可以在非複製呼叫中使用，因此永遠優先於等級較低的多載。因此，根據經驗法則，一律建議節點作者放棄等級較低的多載，而使用等級較高的方法，以便 DesignScript 編譯器永遠會呼叫等級較高的方法，作為它找到的第一個方法 (也是唯一一個方法)。

範例：

下面的範例中定義了函數 foo 的兩個多載。在 1.x 中，哪個多載會在執行階段執行並不明確。使用者可能期望執行第二個多載 foo(a:int, b:int)，在這種情況下，應該是方法要複製三次並傳回三次 10 的值。實際上傳回的是 10 的單一值，因為呼叫的是帶有 list 參數的第一個多載。

在 2.0 中省略第二個多載：

在 2.0 中，永遠是定義的第一種方法而不是其餘方法。先到先贏。

對於以下每種情況，將採用定義的第一個多載。請注意，它純粹基於定義函數的順序，而不是參數等級，但建議針對使用者定義和 ZeroTouch 節點優先使用參數等級較高的方法。

3.將所有使用者介面節點編譯為靜態方法

在 Dynamo 1.x 中，分別將 1.x 的使用者介面節點 (非 Code Block) 編譯為實體方法和性質。例如，Point.X 節點編譯為 pt.X，Curve.PointAtParameter 編譯為 curve.PointAtParameter(param)。此行為有兩個問題：

A.使用者介面節點表示的函數並不一定與執行階段所執行的函數相同

一個典型的範例是 Translate 節點。有多個 Translate 節點採用相同數量和類型的引數，例如：Geometry.Translate、Mesh.Translate 和 FamilyInstance.Translate。由於這些節點都是編譯為實體方法，因此將 FamilyInstance 傳入 Geometry.Translate 節點在執行階段意外地仍然有作用，因為它會將呼叫分派到 FamilyInstance 上的 Translate 實體方法。這顯然會誤導使用者，因為該節點並沒有按照它說的進行。

B.第二個問題是實體方法不適用於異質陣列

在執行階段時，執行引擎需要找出應該分派到哪個函數。如果輸入是清單 (例如 list.Translate())，由於完整瀏覽清單中的每個元素並對其類型查詢方法非常耗費資源，因此方法解析邏輯只需假設目標類型與第一個元素的類型相同，然後嘗試查詢針對該類型定義的 Translate() 方法。因此，如果第一個元素類型與方法的目標類型不符 (或者如果它甚至是 null 或空清單)，則即使清單中有其他相符的類型，整個清單也會失敗。

例如，如果將具有類型 [Arc, Line] 的清單輸入傳入 Arc.CenterPoint，則如果是弧，結果如預期會包含一個中心點，如果是線，結果則是 null 值。但是如果順序顛倒，則整個結果是空值，因為第一個元素無法通過方法解析檢查：

Dynamo 1.x：只測試輸入清單的第一個元素進行方法解析檢查

在 2.0 中，透過將使用者介面節點編譯為靜態性質和靜態方法，可以解決這兩個問題。

使用靜態方法，執行階段方法解析更直接，會反覆運算輸入清單中的所有元素。例如：

foo.Bar() (實體方法) 語義需要檢查 foo 的類型，也會檢查它是否是清單，然後將其與候選函數比對。這很耗費資源。相反地，Foo.Bar(foo) (靜態方法) 語義只需要檢查一個其參數類型為 foo 的函數！

以下是在 2.0 中發生的情況：

• 使用者介面性質節點編譯為靜態 getter：引擎為每個性質產生 getter 的靜態版本。例如，Point.X 節點編譯為靜態 getter Point.get_X(pt)。請注意，靜態 getter 也可以在 Code Block 節點中使用其別名 Point.X(pt) 來呼叫。

• 使用者介面方法節點編譯為靜態版本：引擎為節點產生對應的靜態方法。例如，Curve.PointAtParameter 節點編譯為 Curve.PointAtParameter(curve: Curve, parameter:double) 而非 curve.PointAtParameter(parameter)。

注意: 我們尚未移除此變更的實體方法支援，因此 CBN 中使用的現有實體方法 (如上述範例中的 pt.X 和curve.PointAtParameter(parameter)) 仍然有作用。

此範例先前在 1.x 中有作用，因為圖表將編譯為 point.X;，它會尋找點物件的 X 性質。它現在在 2.0 中失敗，因為編譯的程式碼 - Vector.X(point) 只需要一個 Vector 類型：

優點：

前後一致/可理解： 靜態方法消除了哪個方法將在執行階段執行的任何不確定性。方法永遠與圖表中使用者預期會被呼叫的使用者介面節點一致。

相容： 程式碼和視覺程式之間有更好的相關性。

提供指導： 將異質清單輸入傳入節點現在會導致節點接受的類型為非空值，而未實作節點的類型為空值。結果更可預測，且更清楚指出哪些是節點允許的類型。

警告：多載方法有無法解析的不明確性

由於 Dynamo 通常支援函數多載，因此如果另一個多載函數有相同數量的參數，可能還是會讓人感到困惑。例如，在以下圖表中，如果我們將一個數值連接到 Curve.Extrude 的 direction 輸入，將一個向量連接到 Curve.Extrude 的 distance 輸入，兩個節點都會繼續運作，這不是預期的狀況。在這種情況下，即使節點編譯為靜態方法，引擎仍然無法在執行階段分辨出差異，並根據輸入類型選擇其中一種。

解決的問題：

轉換成靜態方法語義會產生以下副作用，由於相關的 2.0 語言變更，因此在這裡說明這些副作用。

1.喪失多型行為：

我們考慮 ProtoGeometry 中 TSpline 節點的範例 (請注意，TSplineTopology 繼承自基底 Topology 類型)：先前編譯為實體方法 object.Edges 的 Topology.Edges 節點現在編譯為靜態方法 Topology.Edges(object)。某個方法在執行階段分派物件類型後，先前的呼叫會以多型方式解析為衍生的類別方法 TsplineTopology.Edges。

而新的靜態行為則被迫呼叫基底類別方法 Topology.Edges。結果，此節點傳回的是基底類別 Edge 物件，而不是類型為 TSplineEdge 的衍生類別物件。

這是一種倒退的結果，因為預期是 TSplineEdges 的下游 TSpline 節點開始失敗。

此問題已透過在方法分派邏輯中增加一個執行階段檢查，針對方法第一個參數的類型或子類型檢查實體類型而解決。對於輸入清單，我們簡化了方法分派，只檢查第一個元素的類型。因此，最終的解決方法是折衷使用部分靜態和部分動態的方法查詢。

2.0 中新的多型行為：

在此案例中，由於第一個元素 a 是 TSpline ，因此在執行階段呼叫的是 TSplineTopology.Edges 衍生方法。結果它針對基底 Topology 類型 b 傳回 null。

在第二個案例中，由於一般的 Topology 類型 b 是第一個元素，因此呼叫基底 Topology.Edges 方法。由於 Topology.Edges 也恰好接受衍生的 TSplineTopology 類型 a 當作輸入，因此它針對 a 和 b 兩個輸入都傳回 Edges。

2.因為外層產生多餘的清單而導致倒退

在複製指南行為方面，實體方法和靜態方法之間有一個主要差異。使用實體方法，帶有複製指南的單值輸入不會提升為清單，而靜態方法會提升。

我們來看看 Surface.PointAtParameter 節點的範例，該節點使用笛卡兒積交織、單一曲面輸入以及 u 和 v 參數值的陣列。實體方法編譯為：

產生一個 2D 點陣列。

靜態方法編譯為：

產生一個 3D 點清單 (最外層多出一個清單)。

將使用者介面節點編譯為靜態方法的這種副作用，可能會導致這類現有使用案例的倒退。此問題已透過在與複製指南/交織一起使用時，停用將單值輸入提升為清單來解決 (請參閱下一項)。

4.使用複製指南/交織時停用清單提升

在 1.x 中，有兩種情況會將單值提升為清單：

• 將等級較低的輸入傳入需要等級較高輸入的函數時

• 將等級較低的輸入傳入需要相同等級的函數，但輸入引數使用複製指南裝飾或使用交織時

在 2.0 中，我們阻止且不再支援在後者這類情況下進行清單提升。

在下面的 1.x 圖表中，每個 y 和 z 各有一層複製指南，強制對它們都進行 1 級的陣列提升，這就是為什麼結果有 3 級 (x、y、z 各 1 級)。但是使用者期望結果是 1 級，因為即使單值輸入有複製指南，也不容易看出會讓結果增加層數。

Dynamo 1.x：3D 點清單

在 2.0 中，每個單值引數 y 和 z 即使有複製指南也不會導致提升，因此清單維度與 x 的 1D 輸入清單相同。

Dynamo 2.0：1D 點清單

上述因靜態方法編譯而產生外層多餘清單的倒退，也透過這種語言變更而獲得解決。

繼續使用上面同一個範例，我們看到像下面的靜態方法呼叫：

在 Dynamo 1.x 中產生一個 3D 點清單。發生這種情況的原因是，當與複製指南一起使用時，第一個單值引數曲面提升為清單。

Dynamo 1.x：使用複製指南時，引數提升為清單

在 2.0 中，我們停用與複製指南或交織搭配使用時，將單值引數提升為清單的功能。所以現在呼叫：

只會傳回 2D 清單，因為沒有將曲面提升。

Dynamo 2.0：使用複製指南時，停用將單值引數提升為清單

這項變更現在移除額外多出的清單階層，也解決因為轉換為靜態方法編譯所導致的倒退問題。

優點：

清楚： 結果符合使用者預期，也更容易理解

相容： 使用者介面節點 (使用交織選項) 和使用複製指南的 CBN 會提供相容的結果

一致：

• 實體方法和靜態方法一致 (修正靜態方法語義的問題)

• 使用輸入和使用預設引數的節點行為一致 (請參閱下文)

5.變數在 Code Block 節點中是不可變的，以防止關聯式更新

DesignScript 歷來支援兩種程式設計典範 - 關聯式程式設計和指令式程式設計。關聯式程式碼從變數彼此有相依性的程式陳述句建立相依性圖表。更新某個變數可能會觸發相依於此變數的其他所有變數的更新。這表示關聯式區塊中陳述句的執行順序，不是根據其順序，而是根據變數之間的相依性關係。

在下面的範例中，程式碼的執行順序是行 1 -> 2 -> 3 -> 2。由於 b 相依於 a，因此當第 3 行的 a 更新時，執行會再跳到第 2 行，以使用新的 a 值更新 b。

相反地，如果在指令式環境中執行相同的程式碼，則陳述句會以線性方式、從上到下的流程執行。因此，指令式的 Code Block 適合依序執行 (如迴圈和 if-else 條件) 的程式碼結構。

關聯式更新的不明確性：

1.具有循環相依性的變數：

在某些情況下，變數之間的循環相依性可能不像以下案例如此明顯。在編譯器無法靜態偵測循環的這類案例中，可能會導致無限的執行階段循環。

2.相依於自己的變數：

如果變數相依於自己，其值應該要累積？還是應該在每次更新時重設為其原始值？

在此幾何圖形範例中，由於立方體 b 既相依於自己，也相依於圓柱 a，則移動滑棒應該要讓孔沿圖塊移動？還是應該針對每個滑棒位置更新，沿其路徑打出多個孔而產生一個累積性的效果？

3.更新變數的性質：

4.更新函數：

根據經驗，我們發現關聯式更新對節點型的資料流程圖表環境中的 Code Block 節點沒有用處。在任何視覺程式設計環境出現之前，探索選項唯一的方法是明確地更改程式中某些變數的值。文字型程式有變數更新的完整記錄，而在視覺程式設計環境中只顯示變數的最新值。

如果某些使用者真的使用變數，很可能他們是在不知不覺的情況下使用，而導致弊大於利。因此，我們決定在 2.0 的 Code Block 節點讓變數不變來隱藏關聯性，同時繼續讓關聯式更新只作為 DS 引擎的原生功能。這是為簡化使用者的腳本編寫體驗而進行的另一項變更。

透過阻止 CBN 中的變數重新定義，停用關聯式更新：

在 Code Block 中仍允許使用清單編製索引

清單編製索引是一個例外，在 2.0 中仍允許指定索引運算子。

在下一個範例中，我們會看到清單 a 已初始化，但之後可以指定索引運算子來覆寫，且任何相依於 a 的變數都會關聯地更新，如 c 的值所示。而且，在重新定義一個或多個元素之後，節點預覽會顯示 a 的更新值。

6.指令式區塊中的變數對指令式區塊範圍是局部變數

我們變更了 2.0 的指令式範圍規則，停用複雜的跨語言更新情境。

在 Dynamo 1.x 中，以下腳本的執行順序會是行 1 -> 2 -> 4 -> 6 -> 4，當中會從外部向內部的語言範圍傳遞變更。由於 y 是在外部的關聯式區塊中更新，而指令式區塊中的 x 相依於 y，因此控制將從外部的關聯式程式轉移到第 4 行的指令式語言。

在下一個範例中，執行順序會是行：1 -> 2 -> 4 -> 2，其中會從內部向外部的語言範圍傳遞變更。

上述情境是指跨語言更新，就像關聯式更新在 Code Block 節點中不是很有用一樣。為了停用複雜的跨語言更新情境，我們已讓指令式範圍中的變數成為局部變數。

在 Dynamo 2.0 的以下範例中：

• 指令式區塊中定義的 x 現在對於指令式範圍是局部變數

• 外部範圍中的 x 值和 y 值分別仍是 1 和 2

如果要在外部範圍中存取指令式區塊內的任何局部變數值，則需要傳回該變數。

請參考以下範例：

• 在指令式範圍內局部複製 y

• 指令式範圍內 x 的局部值為 4

• 由於跨語言更新，更新外部範圍中 y 的值，會繼續導致 x 更新，但在 2.0 的 Code Block 中由於變數不變性而停用

7.清單與字典

在 Dynamo 1.x 中，清單和字典由單一統一的容器表示，透過整數索引和非整數鍵可以對該容器編製索引。下表總結 2.0 中清單和字典之間的區別，以及新字典資料類型的規則：

新的 [] 清單語法

在 2.0 中，清單初始化語法從大括號 {} 變更為方括號 []。所有 1.x 腳本在 2.0 中打開時，都會自動移轉成新語法。

關於 Zero Touch 節點上預設引數屬性的注意事項：

但是請注意，自動移轉不適用於預設引數屬性中使用的舊語法。節點作者需要手動更新其 zero-touch 方法定義，才能使用預設引數屬性 DefaultArgumentAttribute 中的新語法 (如有必要)。

關於編製索引的注意事項：

新的編製索引行為在某些情況下變得不同。使用 [] 運算子將索引編製成包含任意索引/鍵清單的清單/字典，現在會保留索引/鍵輸入清單的清單結構。以前永遠會傳回值的 1D 清單：

字典初始化語法：

字典初始化的 {} (大括號語法) 只能用在

的鍵值對格式，其中的 <key> 只能使用一個字串，而且以逗號分隔多個鍵值對。

Dictionary.ByKeysValues zero-touch 方法可透過分別傳入鍵和值的清單，並使用 zero-touch 方法 (如複製指南等) 的所有花俏功能，當作初始化字典一個更多樣的方式。

為什麼沒有以任意表示式呈現字典初始化語法？

我們嘗試過在字典鍵值初始化語法中對鍵使用任意表示式的想法，但是發現它可能會導致讓人混淆的結果，尤其是像 {keys : vals} (keys，vals 都表示清單) 這樣的語法會干擾 DesignScript 的其他語言功能 (如複製) 並產生與 zero touch 初始設定式節點不同的結果。

例如，可能會有其他類似此陳述句很難定義預期行為的情況：

進一步增加複製指南語法等而不只是識別項，有違語言簡單性的想法。

我們將來也許_可以_擴充字典鍵以支援任意表示式，但我們也必須確保與其他語言功能的互動是一致且可理解，但代價是提高複雜度，而不是讓系統功能變弱但容易理解。因為總是能使用 Dictionary.ByKeysValues(keyList, valueList) 方法作為替代方法來解決問題，這並不會很困難。

與 Zero Touch 節點的互動：

1.傳回 .NET 字典的 Zero Touch 節點會傳回為 Dynamo 字典

請考慮以下傳回 IDictionary 的 zero-touch C# 方法：

對應的 ZT 節點傳回值會編組成 Dynamo 字典：

2.多重傳回節點的預覽形式為字典

以多重傳回屬性傳回 IDictionary 的 Zero Touch 節點會傳回 Dynamo 字典：

3.Dynamo 字典可作為輸入傳入接受 .NET 字典的 Zero-touch 節點

具有 IDictionary 參數的 ZT 方法：

ZT 節點接受 Dynamo 字典作為輸入：

多重傳回節點中的字典預覽

字典是未排序的鍵值對。因此同樣地，傳回字典之節點的鍵值對預覽，也無法保證會按照節點傳回值的順序進行排序。

但是，我們為已定義 MultiReturnAttribute 的多重傳回節點做出例外。在以下範例中，DateTime.Components 節點是一個「多重傳回」節點，節點預覽反映出其鍵值對與節點輸出埠的順序相同，這也是根據節點定義上的 MultiReturnAttribute 指定輸出的順序。

另請注意，與使用者介面節點不同，Code Block 的預覽並未排序，因為 Code Block 節點沒有輸出埠資訊 (以多重傳回屬性的形式)：