# 开发软件包

Dynamo 提供了多种方法来创建软件包，以供个人使用或与 Dynamo 社区共享。在下面的案例研究中，我们将通过解构现有软件包来逐步介绍如何创建一个软件包。本案例研究基于上一章的课程构建，提供一组自定义节点用于按 UV 坐标映射几何图形（从一个 Dynamo 曲面到另一个 Dynamo 曲面）。

## MapToSurface 软件包

我们将使用一个示例包，演示点从一个曲面到另一个曲面的 UV 映射。我们已在本 Primer 的[创建自定义节点](https://primer2.dynamobim.org/zh-cn/6_custom_nodes_and_packages/6-1_custom-nodes/2-creating)部分中构建了该工具的基础知识。下面的文件演示了如何理解 UV 映射的概念，并为可发布库开发一组工具。

在此图像中，我们使用 UV 坐标将点从一个曲面映射到另一个曲面。软件包基于此概念，但有更加复杂的几何图形。

### 安装软件包

在前一章中，我们探讨了在 Dynamo 中基于在 XY 平面中定义的曲线为曲面镶板的方法。本案例研究扩展了这些概念，以获得更多几何图形尺寸。我们将以内置方式安装此软件包，以演示其开发方式。在下一节中，我们将演示如何发布此软件包。

在 Dynamo 中，依次单击“软件包”>“软件包管理器”，然后搜索软件包“MapToSurface”（全部写为一个单词）。单击“安装”以开始下载，并将软件包添加到库。

<figure><img src="https://338946474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZkPl5tDHbu5X9VJTozDs%2Fuploads%2Fgit-blob-568489b83d824b9ed7c5ad523ded5728055e7c58%2Fmap-to-surface-install.png?alt=media" alt=""><figcaption></figcaption></figure>

完成安装后，自定义节点应位于“附加模块”>“DynamoPrimer”部分下。

!

现在，软件包已完成安装，我们来介绍其设置方式。

### 自定义节点

我们正在创建的软件包使用我们为参照而构建的五个自定义节点。下面，我们来介绍每个节点的作用。某些自定义节点基于其他自定义节点构建，图表具有布局，供其他用户直接理解。

这是一个包含五个自定义节点的简单软件包。在下面的步骤中，我们将简要介绍每个自定义节点的设置。

!

#### **PointsToSurface**

这是一个基本自定义节点，所有其他映射节点均基于该节点。只需放置，该节点会将某个点从源曲面 UV 坐标映射到目标曲面 UV 坐标的位置。由于点是最基本的几何图形，基于它可构建更复杂的几何图形，因此我们可以使用此逻辑将二维几何图形（甚至三维几何图形）从一个曲面映射到另一个曲面。

!

#### **PolygonsToSurface**

仅使用此处的多边形，可演示将映射点从一维几何图形扩展到二维几何图形的逻辑。请注意，我们已将 *“PointsToSurface”* 节点嵌套到此自定义节点中。这样，我们就可以将每个多边形的点映射到曲面，然后基于这些映射点重新生成多边形。通过保持正确的数据结构（一列点列表），我们可以在多边形简化为一组点后，使多边形保持分离。

!

#### **NurbsCrvtoSurface**

此处应用的逻辑与 *“PolygonsToSurface”* 节点中的逻辑相同。但是，我们不是映射多边形点，而是映射 NURBS 曲线的控制点。

!

**OffsetPointsToSurface**

此节点变得更加复杂，但概念非常简单：与 *“PointsToSurface”* 节点类似，此节点会将点从一个曲面映射到另一个曲面。但是，它还会考虑不在原始源曲面上的点，获取其与最近 UV 参数的距离，并将此距离映射到相应 UV 坐标处的目标曲面法线。在查看示例文件时，这会更有意义。

!

#### **SampleSrf**

这是一个简单节点，用于创建参数化曲面以从源栅格映射到示例文件中的波状曲面。

!

### 示例文件

示例文件位于软件包的根文件夹中。依次单击“软件包管理器”>“已安装的软件包”选项卡。

在“MapToSurface”的旁边，依次单击垂直点菜单 >“显示根目录”。

<figure><img src="https://338946474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZkPl5tDHbu5X9VJTozDs%2Fuploads%2Fgit-blob-5afcebbbace12477f62efffe8b98f0661aed879f%2Fshow-root-directory.png?alt=media" alt=""><figcaption></figcaption></figure>

接着，打开 *“extra”* 文件夹，该文件夹存储软件包中所有非自定义节点的文件。这是存储 Dynamo 软件包示例文件（如果存在）的位置。下面的屏幕截图介绍每个示例文件中演示的概念。

#### **01-PanelingWithPolygons**

此示例文件演示了如何使用 *“PointsToSurface”* 来根据矩形栅格为曲面镶板。这应该看起来很熟悉，如我们在[上一章](https://primer2.dynamobim.org/zh-cn/6_custom_nodes_and_packages/6-1_custom-nodes/2-creating)中演示的类似工作流。

!

#### **02-PanelingWithPolygons-II**

使用类似的工作流，本练习文件显示用于将圆（或表示圆的多边形）从一个曲面映射到另一个曲面的设置。这将使用 *“PolygonsToSurface”* 节点。

!

#### **03-NurbsCrvsAndSurface**

此示例文件通过使用“NurbsCrvToSurface”节点增加了一些复杂性。目标曲面偏移给定距离，且 NURBS 曲线映射到原始目标曲面和偏移曲面。从这里，将放样两条映射曲线以创建曲面，然后加厚该曲面。此结果实体有表示目标曲面法线的波动。

!

#### **04-PleatedPolysurface-OffsetPoints**

此示例文件演示如何将褶皱多重曲面从源曲面映射到目标曲面。源曲面和目标曲面是分别跨栅格和旋转曲面的矩形曲面。

!

源多重曲面从源曲面映射到目标曲面。

!

#### **05-SVG-Import**

由于自定义节点能够映射不同类型的曲线，因此最后这个文件会引用从 Illustrator 输出的 SVG 文件，并将输入的曲线映射到目标曲面。

!

通过解析 .svg 文件的语法，曲线将从 .xml 格式转换为 Dynamo 复合线。

!

输入的曲线将映射到目标曲面。这样，我们可以在 Illustrator 中显式（点击）设计镶板、输入 Dynamo，然后应用于目标曲面。

!