# 節點的索引
本索引提供此手冊中所用所有節點的附加資訊，以及您可能認為有用的其他元件。這只是 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.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
以相對於指定座標系統的指定圓柱座標參數，建立一個座標系統
| ! |
## 運算子
| | | |
| - | -------------------------------------------------- | - |
| ! | +
加
| ! |
| ! | -
減
| ! |
| ! | \*
乘
| ! |
| ! | /
分區
| ! |
| | %
模除會計算第一個輸入除以第二個輸入後的餘數
| ! |
| | <
小於
| ! |
| ! | >
大於
| ! |
| ! | ==
相等性會測試兩個值是否相等。
| ! |