> 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-cn/5_essential_nodes_and_concepts/index-of-nodes.md).
# 节点索引
此索引提供有关此入门手册中使用的所有节点以及其他可能有用构件的信息。这只是对 Dynamo 中提供的 500 个节点中一部分节点的介绍。
## 显示
### 颜色
| | | |
| -------------------------------- | -------------------------------------------------------------------- | -------------------------------- |
| | 创建 | |
|  | Color.ByARGB
按 Alpha、红色、绿色和蓝色分量构造颜色。
|  |
|  | 颜色范围
基于起点颜色和终点颜色之间的颜色渐变获取颜色。
|  |
| | 操作 | |
|  | 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
显示几何图形的动态预览。
|  |
## 输入
| | | |
| -------------------------------- | ----------------------------------------------------------- | -------------------------------- |
| | 操作 | |
|  | 布尔
在“True”和“False”之间选择。
|  |
|  | 代码块
允许直接编写 DesignScript 代码。
|  |
|  | Directory Path
允许您选择系统上的目录以获取其路径
|  |
|  | 文件路径
允许您选择系统上的文件以获取其文件名
|  |
|  | Integer Slider
用于生成整数值的滑块。
|  |
| | 数字
创建数字。
| |
| | Number Slider
用于生成数字值的滑块。
|  |
| | 字符串
创建字符串。
|  |
| | Object.IsNull
确定给定对象是否为 Null。
|  |
## 列表
| | | |
| -------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------- |
| | 创建 | |
|  | List.Create
基于给定输入创建一个新列表。
|  |
|  | List.Combine
将组合器应用于两个序列中的每个元素
|  |
| | 数字范围
按指定范围创建一系列数字
| |
| | 数字序列
创建一系列数字。
|  |
| | 操作 | |
|  | List.Chop
将某个列表切成一组列表，其中每个列表包含给定数量的项目。
|  |
|  | List.Count
返回存储于给定列表中的项数。
|  |
|  | List.Flatten
按一定数量展平一列嵌套列表。
|  |
|  | List.FilterByBoolMask
通过在单独布尔列表中查找相应索引过滤序列。
|  |
|  | List.GetItemAtIndex
获取位于指定索引处给定列表中的项目。
|  |
| | List.Map
将函数应用于列表的所有元素，从而基于结果生成一个新列表。
|  |
| | List.Reverse
以相反顺序创建包含给定列表各项的新列表。
|  |
|  | List.ReplaceItemAtIndex
替换位于指定索引处给定列表中的项目。
|  |
|  | List.ShiftIndices
将列表中的索引右移给定数量
|  |
|  | List.TakeEveryNthItem
在给定偏移后是给定值倍数的索引处提取给定列表的项。
|  |
|  | List.Transpose
交换一列列表中的行和列。如果一些行长短不一，则 Null 值将作为占位符插入结果数组中，使其始终为矩形
|  |
## 逻辑
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------- |
| | 操作 | |
|  | If
条件语句。检查测试输入的布尔值。如果测试输入为 True，则结果将输出 True 输入，否则结果将输出 False 输入。
|  |
## 数学
| | | |
| -------------------------------- | ----------------------------------------------------------------------- | -------------------------------- |
| | 操作 | |
| | Math.Cos
查找角度的余弦。
|  |
| | Math.DegreesToRadians
将以度为单位的角度换算为以弧度为单位的角度。
|  |
| | Math.Pow
求数字的指定次幂。
|  |
| | Math.RadiansToDegrees
将以弧度为单位的角度换算为以度为单位的角度。
|  |
| | Math.RemapRange
调整数字列表的范围，同时保留分布率。
|  |
| | Math.Sin
查找角度的正弦。
|  |
|  | 映射
将值映射到输入范围
|  |
## 字符串
| | | |
| - | ------------------------------------------------------------------------- | -------------------------------- |
| | 操作 | |
| | String.Concat
将多个字符串合并为单个字符串。
|  |
| | String.Contains
确定给定字符串是否包含给定子字符串。
|  |
| | String.Join
将多个字符串合并为单个字符串，在每个连接的字符串之间插入给定分隔符。
|  |
| | String.Split
使用由给定分隔符字符串确定的分段，将单个字符串拆分为字符串列表。
|  |
| | String.ToNumber
将字符串转换为整数或双精度数。
|  |
## 几何图形
### 圆
| | | |
| -------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------- |
| | 创建 | |
|  | Circle.ByCenterPointRadius
以世界坐标系 Z 轴为法线，通过在世界坐标系 XY 平面输入圆心和半径创建圆。
|  |
|  | Circle.ByPlaneRadius
在输入平面内以输入平面原点（根）为圆心，按给定半径创建圆。
|  |
| | | |
| -------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------- |
| | 创建 | |
|  | CoordinateSystem.ByOrigin
创建坐标系，方法是使其原点位于输入点，X 和 Y 轴设置为 WCS 的 X 和 Y 轴
|  |
|  | CoordinateSystem.ByCylindricalCoordinates
在指定柱面坐标参数处相对于指定坐标系创建坐标系
|  |
### 立方体
| | | |
| -------------------------------- | -------------------------------------------------------------------------------- | -------------------------------- |
| | 创建 | |
|  | Cuboid.ByLengths
以 WCS 原点为中心，使用宽度、长度和高度创建立方体。
|  |
|  | Cuboid.ByLengths（原点）
以输入点为中心，使用特定宽度、长度和高度创建立方体。
|  |
|  | Cuboid.ByLengths（坐标系）
以 WCS 原点为中心，使用宽度、长度和高度创建立方体。
|  |
|  | Cuboid.ByCorners
通过从低点到高点延伸创建立方体。
|  |
|  | Cuboid.Length
返回立方体的输入尺寸标注，而不是实际的世界空间尺寸标注。\*\*
|  |
|  | Cuboid.Width
返回立方体的输入尺寸标注，而不是实际的世界空间尺寸标注。\*\*
|  |
|  | Cuboid.Height
返回立方体的输入尺寸标注，而不是实际的世界空间尺寸标注。\*\*
|  |
|  | BoundingBox.ToCuboid
获取边界框作为实心长方体
|  |
{% hint style="warning" %}
\*\*换句话说，如果创建一个立方体宽度（X 轴）长度为 10，并将其转换为在 X 方向缩放 2 倍的坐标系，则宽度仍将是 10。ASM 不允许以任何可预测的顺序提取实体的顶点，因此无法在转换后确定尺寸标注。
{% endhint %}
### 曲线
| | | |
| -------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 操作 | |
|  | Curve.Extrude（距离）
朝法向量方向拉伸曲线。
|  |
|  | Curve.PointAtParameter
获取 StartParameter() 和 EndParameter() 之间指定参数处曲线上的点。
|  |
### 几何图形修改器
| | | |
| -------------------------------- | -------------------------------------------------------------------- | -------------------------------- |
| | 操作 | |
|  | Geometry.DistanceTo
获取从该几何图形到另一几何图形的距离。
|  |
|  | Geometry.Explode
将复合或非单独图元拆分为其构件
|  |
|  | Geometry.ImportFromSAT
输入几何图形的列表
|  |
|  | Geometry.Rotate（基准面）
绕平面原点和法线将对象旋转指定度数。
|  |
|  | 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（二维）
在 XY 平面中通过 2 个笛卡尔坐标形成一个点。Z 分量为 0。
|  |
| | Point.ByCoordinates（三维）
通过给定的 3 个笛卡尔坐标形成一个点。
|  |
| | Point.Origin
获取原点 (0,0,0)
|  |
| | 操作 | |
| | Point.Add
将向量添加到点。相当于平移（向量）。
|  |
| | 查询 | |
| | Point.X
获取点的 X 分量
|  |
| | Point.Y
获取点的 Y 分量
|  |
| | Point.Z
获取点的 Z 分量
|  |
### 复合线
| | | |
| - | ------------------------------------------------------------------------------------------- | -------------------------------- |
| | 创建 | |
| | Polycurve.ByPoints
由连接点的直线序列生成 PolyCurve。对于闭合曲线，最后一个点应与起点位于同一位置。
|  |
### 矩形
| | | |
| - | --------------------------------------------------------------------------------------------------- | -------------------------------- |
| | 创建 | |
| | Rectangle.ByWidthLength（平面）
以输入平面原点为中心，按输入宽度（平面 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
在指定柱面坐标参数处相对于指定坐标系创建坐标系
|  |
## 运算符
| | | |
| -------------------------------- | -------------------------------------------------------- | -------------------------------- |
|  | +
加
|  |
|  | -
减
|  |
| | \*
乘
|  |
|  | /
部门
|  |
| | %
模块除法会查找在除以第二个输入后得到的第一个输入的余数
|  |
|  | <
小于
|  |
|  | >
大于
|  |
|  | ==
两个值之间的相等测试。
|  |