Dynamo
Primer for v2.0
繁體中文
繁體中文
  • 關於
  • 簡介
    • 什麼是 Dynamo?它如何運作?
    • 手冊使用者指南、Dynamo 社群與平台
  • 安裝 Dynamo
  • 使用者介面
    • 工作區
    • 資源庫
  • 節點和線路
  • 基本節點和概念
    • 節點的索引
    • 用於計算設計的幾何圖形
      • 幾何圖形概述
      • 向量、平面和座標系統
      • 點
      • 曲線
      • 曲面
      • 實體
      • 網格
    • 程式的建置區塊
      • 資料
      • 數學
      • 邏輯
      • 字串
      • 顏色
    • 使用清單設計
      • 什麼是清單
      • 使用清單
      • 清單的清單
      • n 維清單
    • Dynamo 中的字典
      • 什麼是字典
      • 字典節點
      • 程式碼區塊中的字典
      • Revit 使用情況
  • 自訂節點和套件
    • 自訂節點
      • 自訂節點簡介
      • 建立自訂節點
      • 發佈至資源庫
    • 套件
      • 套件簡介
      • 套件案例研究 - Mesh Toolkit
      • 開發套件
      • 發佈套件
      • Zero-Touch 匯入
  • 適用於 Revit 的 Dynamo
    • Revit 連接
    • 選取
    • 編輯
    • 建立
    • 自訂
    • 記錄
  • Dynamo for Civil 3D
    • Civil 3D 連接
    • 入門
    • 節點資源庫
    • 範例工作流程
      • 道路
        • 燈柱放置
      • 面
        • 服務放置
      • 公用程式
        • 更名結構
      • 鐵路
        • 間隙包絡線
      • 測量
        • 點群組管理
    • 進階主題
      • 物件併入
      • Python 和 Civil 3D
    • Dynamo 播放器
    • 有用的套件
    • 資源
  • Dynamo in Forma Beta 版
    • 設定 Forma 中的 Dynamo Player
    • 在 Dynamo Player 中加入和分享圖表
    • 在 Dynamo Player 中執行圖表
    • Dynamo 計算服務與桌面版 Dynamo 的差異
  • 在 Dynamo 中撰寫程式碼
    • 程式碼區塊和 DesignScript
      • 什麼是程式碼區塊
      • DesignScript 語法
      • 速寫
      • 函數
    • 使用 DesignScript 的幾何圖形
      • DesignScript 幾何圖形基礎知識
      • 幾何基本型
      • 向量數學
      • 曲線:內插和控制點
      • 平移、旋轉和其他轉換
      • 曲面:內插、控制點、斷面混成、迴轉
      • 幾何參數化
      • 交集和修剪
      • 幾何布林運算
      • Python 點產生器
    • Python
      • Python 節點
      • Python 和 Revit
      • 設定您自己的 Python 樣板
    • 語言變更
  • 最佳實踐
    • 圖表策略
    • 指令碼撰寫策略
    • 指令碼撰寫參考
    • 管理您的程式
    • 在 Dynamo 中有效率地處理大型資料集
  • 範例工作流程
    • 入門工作流程
      • 參數式花瓶
      • 牽引點
    • 概念索引
  • 開發人員手冊
    • 從原始碼建置 Dynamo
      • 從原始碼建置 DynamoRevit
      • 管理和更新 Dynamo 中的相依性
    • 為 Dynamo 開發
      • 入門
      • Zero-Touch 案例研究 - 網格節點
      • 在 Zero-Touch 節點中執行 Python 指令碼 (C#)
      • 深入瞭解 Zero-Touch
      • 進階 Dynamo 節點自訂
      • 在 Dynamo 套件中使用 COM (互通性) 類型
      • NodeModel 案例研究 - 自訂使用者介面
      • 針對 Dynamo 2.x 更新您的套件和 Dynamo 資源庫
      • 針對 Dynamo 3.x 更新套件與 Dynamo 資料庫
      • 延伸
      • 定義 Dynamo 2.0+ 的自訂套件組織
      • Dynamo 指令行介面
      • Dynamo 整合
      • 為 Dynamo for Revit 開發
      • 發佈套件
      • 從 Visual Studio 建置套件
      • 將延伸當作套件
    • 提取請求
    • 測試預期結果
    • 範例
  • 附錄
    • 常見問題
    • 視覺程式設計和 Dynamo
    • 資源
    • 發行說明
    • 有用的套件
    • 範例檔案
    • 主體程式整合對應表
    • 下載 PDF
    • Dynamo 鍵盤快速鍵
Powered by GitBook
On this page
  • 顯示
  • 顏色
  • Watch
  • 輸入
  • 清單
  • 邏輯
  • 數學
  • 字串
  • 幾何圖形
  • 圓
  • 立方體
  • 曲線
  • 幾何圖形修改子
  • 直線
  • NurbsCurve
  • NurbsSurface
  • 平面
  • 點
  • Polycurve
  • 矩形
  • 圓球
  • 曲面
  • UV
  • 向量
  • 座標系統
  • 運算子
Edit on GitHub
Export as PDF
  1. 基本節點和概念

節點的索引

本索引提供此手冊中所用所有節點的附加資訊,以及您可能認為有用的其他元件。這只是 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

取得邊界框做為實體立方體

**換句話說,如果您建立一個立方體寬度 (X 軸) 長度為 10,然後將其轉換為 X 軸 2 倍比例的座標系統,則寬度仍為 10。ASM 不允許您以任何可預測的順序擷取本體的頂點,因此在轉換後無法決定尺寸。

曲線

動作

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 以相對於指定座標系統的指定圓柱座標參數,建立一個座標系統

運算子

+ 加

- 減

* 乘

/ 除

% 模除會計算第一個輸入除以第二個輸入後的餘數

< 小於

> 大於

== 相等性會測試兩個值是否相等。

Previous基本節點和概念Next用於計算設計的幾何圖形

Last updated 1 month ago