> For the complete documentation index, see [llms.txt](https://primer2.dynamobim.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://primer2.dynamobim.org/zh-tw/5_essential_nodes_and_concepts/index-of-nodes.md).
# 節點的索引
本索引提供此手冊中所用所有節點的附加資訊，以及您可能認為有用的其他元件。這只是 Dynamo 所提供 500 個節點中部分節點的簡介。
## 顯示
### 顏色
| | | |
| -------------------------------- | ------------------------------------------------------------------------ | -------------------------------- |
| | 建立 | |
|  | Color.ByARGB
依 Alpha、紅色、綠色與藍色等組成來建構顏色。
|  |
|  | Color Range
從開始顏色與結束顏色之間的顏色漸層取得顏色。
|  |
| | 動作 | |
|  | Color.Brightness
取得此顏色的亮度值。
|  |
|  | Color.Components
依照以下順序列示顏色組成：Alpha、紅色、綠色、藍色。
|  |
|  | Color.Saturation
取得此顏色的飽和度值
|  |
|  | Color.Hue
取得此顏色的色相值。
|  |
| | 查詢 | |
|  | Color.Alpha
找出顏色的 Alpha 組成 (0 到 255)。
|  |
|  | Color.Blue
找出顏色的藍色組成 (0 到 255)。
|  |
|  | Color.Green
找出顏色的綠色組成 (0 到 255)。
|  |
|  | Color.Red
找出顏色的紅色組成 (0 到 255)。
|  |
| | | |
| -------------------------------- | -------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | GeometryColor.ByGeometryColor
使用顏色顯示幾何圖形。
|  |
### Watch
| | | |
| -------------------------------- | ------------------------------------------------------ | -------------------------------- |
| | 動作 | |
|  | View\.Watch
視覺化節點的輸出。
|  |
|  | View\.Watch 3D
展示幾何圖形的動態預覽。
|  |
## 輸入
| | | |
| -------------------------------- | -------------------------------------------------------------- | -------------------------------- |
| | 動作 | |
|  | Boolean
在 true 與 false 之間進行選取。
|  |
|  | Code Block
允許直接編寫 DesignScript 程式碼。
|  |
|  | Directory Path
可讓您選取系統上的目錄，以取得其路徑
|  |
|  | File Path
可讓您選取系統中的檔案，以取得其檔名
|  |
|  | Integer Slider
產生整數值的滑棒。
|  |
|  | Number
建立數字。
|  |
|  | Number Slider
產生數值的滑棒。
|  |
|  | String
建立字串。
|  |
|  | Object.IsNull
判定給定物件是否為空值。
|  |
## 清單
| | | |
| -------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | List.Create
從給定的輸入製作新清單。
|  |
|  | List.Combine
將結合器套用至兩個序列中的每個元素
|  |
|  | Number Range
建立指定範圍內的一系列數字
|  |
|  | Number Sequence
建立一系列數字。
|  |
| | 動作 | |
|  | List.Chop
將一個清單細分為一組清單 (其中每個清單包含指定數量的項目)。
|  |
|  | List.Count
傳回給定清單中儲存的項目數目。
|  |
|  | List.Flatten
依特定數量展開清單的巢狀清單。
|  |
|  | List.FilterByBoolMask
查看個別布林清單中的對應索引來篩選順序。
|  |
|  | List.GetItemAtIndex
取得給定清單中位於指定索引處的項目。
|  |
| | List.Map
將函數套用至清單的所有元素，從結果產生新清單
|  |
| | List.Reverse
建立新的清單，其中包含給定清單的項目，但以逆向順序排列
|  |
|  | List.ReplaceItemAtIndex
取代給定清單中位於指定索引處的項目。
|  |
|  | List.ShiftIndices
將清單中的索引向右移動給定數量
|  |
|  | List.TakeEveryNthItem
在給定的偏移之後，擷取給定清單中索引是給定值倍數的項目。
|  |
|  | List.Transpose
在清單的清單中交換列與欄。如果某些列短於其他列，會在結果陣列中插入空值作為預留位置，以便其永遠為矩形
|  |
## 邏輯
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------- |
| | 動作 | |
|  | If
條件陳述式。檢查測試輸入的布林值。如果測試輸入為 true，結果會輸出真實的輸入，否則結果會輸出虛假的輸入。
|  |
## 數學
| | | |
| -------------------------------- | --------------------------------------------------------------------- | -------------------------------- |
| | 動作 | |
|  | Math.Cos
計算角度的餘弦值。
|  |
|  | Math.DegreesToRadians
將以度表示的角度轉換為以弳度表示的角度。
|  |
|  | Math.Pow
計算數值的指定次方。
|  |
|  | Math.RadiansToDegrees
將以弳度表示的角度轉換為以度表示的角度。
|  |
|  | Math.RemapRange
調整數字清單的範圍，同時保留分配比率。
|  |
|  | Math.Sin
計算角度的正弦值。
|  |
|  | Map
將值對映到輸入範圍
|  |
## 字串
| | | |
| -------------------------------- | -------------------------------------------------------------------------- | -------------------------------- |
| | 動作 | |
|  | String.Concat
將多個字串連接成單一字串。
|  |
|  | String.Contains
判定給定的字串是否包含給定的子字串。
|  |
|  | String.Join
將多個字串連接成單一字串，同時在接合的每個字串之間插入給定的分隔符號。
|  |
|  | String.Split
將單一字串分割為字串清單，分割位置由給定的分隔符號字串決定。
|  |
|  | String.ToNumber
將字串轉換為整數或倍精數。
|  |
## 幾何圖形
### 圓
| | | |
| -------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Circle.ByCenterPointRadius
使用輸入中心點和世界 XY 平面中的半徑，並以世界 Z 為法線，來建立一個圓。
|  |
|  | Circle.ByPlaneRadius
在輸入平面建立一個中心點在輸入平面原點 (根)、具有給定半徑的圓。
|  |
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | CoordinateSystem.ByOrigin
建立一個原點在輸入點、X 與 Y 軸分別設定為 WCS X 軸與 Y 軸的座標系統
|  |
|  | CoordinateSystem.ByCylindricalCoordinates
以相對於指定座標系統的指定圓柱座標參數，建立一個座標系統
|  |
### 立方體
| | | |
| -------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Cuboid.ByLengths
建立一個中心點在 WCS 原點，且具有長度、寬度、高度的立方體。
|  |
|  | Cuboid.ByLengths (origin)
建立一個中心點在輸入點，具有指定寬度、長度及高度的立方體。
|  |
|  | Cuboid.ByLengths (coordinateSystem)
建立一個中心點在 WCS 原點，且具有長度、寬度、高度的立方體。
|  |
|  | Cuboid.ByCorners
建立一個從低點跨距到高點的立方體。
|  |
|  | Cuboid.Length
傳回立方體的輸入尺寸，而不是實際世界的空間尺寸。
|  |
|  | Cuboid.Width
傳回立方體的輸入尺寸，而不是實際世界的空間尺寸。
|  |
|  | Cuboid.Height
傳回立方體的輸入尺寸，而不是實際世界的空間尺寸。
|  |
|  | BoundingBox.ToCuboid
取得邊界框做為實體立方體
|  |
{% hint style="warning" %}
\*\*換句話說，如果您建立一個立方體寬度 (X 軸) 長度為 10，然後將其轉換為 X 軸 2 倍比例的座標系統，則寬度仍為 10。ASM 不允許您以任何可預測的順序擷取本體的頂點，因此在轉換後無法決定尺寸。
{% endhint %}
### 曲線
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------------- |
| | 動作 | |
|  | Curve.Extrude (distance)
在法線向量的方向擠出曲線。
|  |
|  | Curve.PointAtParameter
取得曲線上位於 StartParameter() 與 EndParameter() 之間指定參數處的點。
|  |
### 幾何圖形修改子
| | | |
| -------------------------------- | ------------------------------------------------------------------------- | -------------------------------- |
| | 動作 | |
|  | Geometry.DistanceTo
取得此幾何圖形距其他幾何圖形的距離。
|  |
|  | Geometry.Explode
將複合元素或非單獨元素分開為組成部分
|  |
|  | Geometry.ImportFromSAT
匯入的幾何圖形的清單
|  |
|  | Geometry.Rotate (basePlane)
繞平面原點及法線將物件旋轉指定度數。
|  |
|  | Geometry.Translate
將任何幾何圖形類型在給定方向平移給定距離。
|  |
### 直線
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Line.ByBestFitThroughPoints
建立一條與點的散射圖最近似的線。
|  |
|  | Line.ByStartPointDirectionLength
建立一條從某點開始，沿向量方向延伸指定長度的直線。
|  |
|  | Line.ByStartPointEndPoint
在兩個輸入點之間建立一條直線。
|  |
|  | Line.ByTangency
建立一條在輸入曲線的參數點位置與輸入曲線相切的線。
|  |
| | 查詢 | |
|  | Line.Direction
曲線的方向。
|  |
### NurbsCurve
| | | |
| -------------------------------- | ----------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | NurbsCurve.ByControlPoints
使用明確控制點建立 BSplineCurve。
|  |
|  | NurbsCurve.ByPoints
透過在點之間進行內插來建立 BSplineCurve
|  |
### NurbsSurface
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | NurbsSurface.ByControlPoints
使用明確控制點建立一個具有指定 U 與 V 次數的 NurbsSurface。
|  |
|  | NurbsSurface.ByPoints
建立一個具有指定內插點及 U 與 V 次數的 NurbsSurface。產生的曲面將通過所有點。
|  |
### Plane
| | | |
| -------------------------------- | ----------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Plane.ByOriginNormal
建立一個中心點在根點，具有輸入法線向量的平面。
|  |
|  | Plane.XY
在世界 XY 建立一個平面
|  |
### 點
| | | |
| -------------------------------- | ----------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Point.ByCartesianCoordinates
在有 3 個直角座標的給定座標系統中產生一點
|  |
|  | Point.ByCoordinates (2d)
在 XY 平面中給定 2 個直角座標產生一點。Z 分量是 0。
|  |
|  | Point.ByCoordinates (3d)
給定 3 個直角座標產生一點。
|  |
|  | Point.Origin
取得原點 (0,0,0)
|  |
| | 動作 | |
|  | Point.Add
對點加入向量。與 Translate (Vector) 相同。
|  |
| | 查詢 | |
|  | Point.X
取得點的 X 分量
|  |
|  | Point.Y
取得點的 Y 分量
|  |
|  | Point.Z
取得點的 Z 分量
|  |
### Polycurve
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Polycurve.ByPoints
根據連接點的一系列線建立 PolyCurve。若要取得封閉的曲線，最後一個點應該與起點位於相同的位置。
|  |
### 矩形
| | | |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Rectangle.ByWidthLength (Plane)
建立一個中心點在輸入平面根，具有輸入寬度 (平面 X 軸長度) 與長度 (平面 Y 軸長度) 的矩形。
|  |
### 圓球
| | | |
| -------------------------------- | ------------------------------------------------------------------------------ | -------------------------------- |
| | 建立 | |
|  | Sphere.ByCenterPointRadius
建立一個中心點在輸入點，具有給定半徑的實體圓球。
|  |
### 曲面
| | | |
| -------------------------------- | ---------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Surface.ByLoft
透過在輸入斷面曲線之間進行斷面混成來建立曲面
|  |
|  | Surface.ByPatch
透過填滿輸入曲線所定義之封閉邊界的內部來建立曲面。
|  |
| | 動作 | |
|  | Surface.Offset
沿曲面法線方向，將曲面偏移指定的距離
|  |
|  | Surface.PointAtParameter
傳回指定的 U 與 V 參數處的點。
|  |
|  | Surface.Thicken
將曲面增厚為實體，沿曲面法線的方向朝曲面兩側擠出。
|  |
### UV
| | | |
| -------------------------------- | -------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | UV.ByCoordinates
從兩個倍精數建立 UV。
|  |
### 向量
| | | |
| -------------------------------- | ----------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | Vector.ByCoordinates
由 3 個歐幾里得座標形成一個向量
|  |
|  | Vector.XAxis
取得標準 X 軸向量 (1,0,0)
|  |
|  | Vector.YAxis
取得標準 Y 軸向量 (0,1,0)
|  |
|  | Vector.ZAxis
取得標準 Z 軸向量 (0,0,1)
|  |
| | 動作 | |
|  | Vector.Normalized
取得向量的正規化版本
|  |
## 座標系統
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 建立 | |
|  | CoordinateSystem.ByOrigin
建立一個原點在輸入點、X 與 Y 軸分別設定為 WCS X 軸與 Y 軸的座標系統
|  |
|  | CoordinateSystem.ByCylindricalCoordinates
以相對於指定座標系統的指定圓柱座標參數，建立一個座標系統
|  |
## 運算子
| | | |
| -------------------------------- | -------------------------------------------------- | -------------------------------- |
|  | +
加
|  |
|  | -
減
|  |
|  | \*
乘
|  |
|  | /
分區
|  |
|  | %
模除會計算第一個輸入除以第二個輸入後的餘數
| |
|  | <
小於
|  |
|  | >
大於
|  |
|  | ==
相等性會測試兩個值是否相等。
|  |