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