# 函数

函数可以在代码块中创建，并在 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="/files/9FxWO9piFcrXGA3urseU" %}

在本练习中，我们将创建一个通用定义，该定义将通过输入的点列表创建球体。这些球体的半径由每个点的 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);`。将滑块插入到新创建的 **“代码块”** 输入中，并根据半径比改变半径大小。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://primer2.dynamobim.org/zh-cn/8_coding_in_dynamo/8-1_code-blocks-and-design-script/4-functions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.