Zero-Touch 案例研究 - 网格节点
在 Visual Studio 项目启动并运行后,我们将介绍如何构建一个自定义节点来创建一个单元的矩形网格。尽管我们可以使用多个标准节点创建该矩形网格,但它是一个非常有用的工具,可轻松包含在 Zero-Touch 节点中。与网格线不同,单元可以围绕其中心点进行单元、查询其角顶点,或将其构建到面中。
本例将介绍创建 Zero-Touch 节点时需要注意的一些功能和概念。在我们构建自定义节点并将其添加到 Dynamo 中后,请确保查看“进一步了解 Zero-Touch”页面,以更深入地了解默认输入值、返回多个值、文档、对象、使用 Dynamo 几何类型和移植。
自定义矩形网格节点
要开始构建网格节点,请创建一个新的 Visual Studio 类库项目。有关如何设置项目的深入介绍,请参见“快速入门”页面。
选择
Class Library
作为项目类型将项目命名为
CustomNodes
由于我们将要创建几何图形,因此我们需要参照相应的 NuGet 软件包。通过 Nuget 软件包管理器安装 ZeroTouchLibrary 软件包。对于 using Autodesk.DesignScript.Geometry;
语句而言,此软件包是必需的。
浏览 ZeroTouchLibrary 软件包
我们将要在 Dynamo Studio 的当前版本(即 1.3)中使用此节点。选择与此版本匹配的软件包版本。
请注意,我们还将类文件重命名为
Grids.cs
接下来,我们需要建立 RectangularGrid 方法将在其中运行的名称空间和类。在 Dynamo 中,该节点将根据方法和类名进行命名。我们尚不需要将该节点复制到 Visual Studio 中。
Autodesk.DesignScript.Geometry;
将参照创建列表时所需的 ZeroTouchLibrary 软件包System.Collections.Generic
中的 ProtoGeometry.dll
现在,我们可以添加用于绘制矩形的方法。类文件应如下所示,并可以复制到 Visual Studio 中。
如果项目看起来与此类似,请继续并尝试构建 .dll
。
选择“构建”>“构建解决方案”
检查项目的 bin
文件夹以查找 .dll
。在构建成功后,我们可以将 .dll
添加到 Dynamo 中。
Dynamo 库中的自定义 RectangularGrids 节点
画布上的自定义节点
用于将
.dll
添加到 Dynamo 中的“添加”按钮
自定义节点修改
在上例中,我们创建了一个非常简单的节点,该节点未定义 RectangularGrids
方法之外的太多其他内容。但是,我们可能要为输入端口创建工具提示,或者像标准 Dynamo 节点一样为该节点提供摘要。将这些功能添加到自定义节点会使其更易于使用,尤其是当用户要在库中搜索这些节点时。
默认输入值
xCount 输入的工具提示
RectangularGrid 节点需要其中的一些基本功能。在下面的代码中,我们添加了输入和输出端口描述、摘要和默认输入值。
通过为方法参数赋值,来为输入提供默认值:
RectangularGrid(int xCount = 10, int yCount = 10)
创建输入和输出工具提示、搜索关键字以及前面带有
///
的 XML 文档摘要。
要添加工具提示,我们需要在项目目录中有一个 xml 文件。通过启用该选项,.xml
可以由 Visual Studio 自动生成。
在此处启用 XML 文档文件,然后指定文件路径。这将生成一个 XML 文件。
大功告成!我们已创建了一个包含多个标准功能的新节点。以下“Zero-Touch 基础知识”章节将更详细地介绍 Zero-Touch 节点开发以及需要注意的问题。
Last updated