# 函数 函数可以在代码块中创建，并在 Dynamo 定义中的其他位置进行调用。这将在参数化文件中创建另一层控制，并且可以作为基于文本版本的自定义节点进行查看。在这种情况下，“父”代码块可以随时访问，并且可以位于图形上的任意位置。不需要引线！ ### 父对象 第一行包含关键字“def”，接着是函数名称，然后是括号中的输入名称。大括号定义函数的主体。使用“return =”返回值。定义函数的代码块没有输入或输出端口，因为它们是从其他代码块调用的。 ! ``` /*This is a multi-line comment, which continues for multiple lines*/ def FunctionName(in1,in2) { //This is a comment sum = in1+in2; return sum; }; ``` ### 子项 通过提供名称和相同数量的参数，调用同一文件中具有另一代码块的函数。其工作原理与库中现成的节点一样。 ! ``` FunctionName(in1,in2); ``` ## 练习：球体（按 Z） > 单击下面的链接下载示例文件。 > > 可以在附录中找到示例文件的完整列表。 {% file src="" %} 在本练习中，我们将创建一个通用定义，该定义将通过输入的点列表创建球体。这些球体的半径由每个点的 Z 特性驱动。 首先从 0 到 100 的十个值范围开始。将这些值插入到 **“Point.ByCoordinates”** 节点，以创建对角线。 ! 创建 **“代码块”**，然后引入我们的定义。 ! > 1. 使用以下代码行： > > ``` > def sphereByZ(inputPt) > { > > }; > ``` > > *“inputPt”* 是我们提供的名称，用于表示将驱动函数的点。目前，该函数不会执行任何操作，但我们会在后续步骤中构建此函数。 ! > 1. 通过添加到 **“代码块”** 函数，我们放置注释和 *“sphereRadius”* 变量（该变量会查询每个点的 *“Z”* 位置）。请记住，*“inputPt.Z”不需要圆括号用作方法。这是对现有图元特性的“查询”*，因此不需要输入： > > ``` > def sphereByZ(inputPt,radiusRatio) > { > //get Z Value, ise ot to drive radius of sphere > sphereRadius=inputPt.Z; > }; > ``` ! > 1. 现在，我们再次调用在另一个 **“代码块”** 中创建的函数。如果双击画布以创建新的 *“代码块”*，然后键入 *“sphereB”*，我们会注意到 Dynamo 建议使用已定义的 *“sphereByZ”* 函数。您的函数已添加到智能库！非常棒。 ! > 1. 现在，我们调用相应函数并创建一个名为 *“Pt”* 的变量，以连接在之前步骤中创建的点： > > ``` > sphereByZ(Pt) > ``` > 2. 在输出中，我们注意到所有值都为空值。这是为什么呢？在定义函数后，我们会计算 *“sphereRadius”* 变量，但是我们未定义函数应 *“返回”* 为 *“输出”* 的内容。可以在下一个步骤中修复该问题。 ! > 1. 一个重要步骤是，我们需要定义函数的输出，方法是将一行代码 `return = sphereRadius;` 添加到 *“sphereByZ”* 函数。 > 2. 现在，我们看到“代码块”的输出为我们提供了每个点的 Z 坐标。 现在，让我们通过编辑 *“父”* 函数，来创建实际球体。 ! > 1. 首先，我们使用代码行定义一个球体：`sphere=Sphere.ByCenterPointRadius(inputPt,sphereRadius);` > 2. 接下来，我们将返回值更改为 *“sphere”*，而不是 *“sphereRadius”*：`return = sphere;`。这会在 Dynamo 预览中为我们提供一些巨大的球体！ ! > 1.要调整这些球体的大小，我们通过添加分隔器来更新“sphereRadius”值：`sphereRadius = inputPt.Z/20;`。现在，我们可以看到单独的球体，然后开始了解半径和 Z 值之间的关系。 ! > 1. 在 **“Point.ByCoordinates”** 节点上，通过将连缀从“最短列表”更改为“叉积”，我们将创建点栅格。*“sphereByZ”* 函数仍然完全有效，因此所有点都会使用基于 Z 值的半径创建球体。 ! > 1. 仅是为了测试水域，我们将原始数字列表连接到 **“Point.ByCoordinates”** 的 X 输入。现在，我们得到了一个球体的立方体。 > 2. 注意：如果在计算机上的计算需要较长时间，请尝试将 *“#10”* 更改为 *“#5”* 之类的值。 请记住，我们创建的 *“sphereByZ”* 函数是一个通用函数，因此我们可以调用前一课中的螺旋，然后对其应用该函数。 ! 最后一步：使用用户定义的参数来控制半径比。为此，我们需要为该函数创建新输入，并将 *“20”* 除数替换为参数。 ! > 1. 将 *“sphereByZ”* 定义更新为以下内容： > > ``` > def sphereByZ(inputPt,radiusRatio) > { > //get Z Value, use it to drive radius of sphere > sphereRadius=inputPt.Z/radiusRatio; > //Define Sphere Geometry > sphere=Sphere.ByCenterPointRadius(inputPt,sphereRadius); > //Define output for function > return sphere; > }; > ``` > 2. 通过向输入中添加“ratio”变量来更新子 **“代码块”**：`sphereByZ(Pt,ratio);`。将滑块插入到新创建的 **“代码块”** 输入中，并根据半径比改变半径大小。