Dynamo
Primer for v2.0
简体中文
简体中文
  • 关于
  • 简介
    • 什么是 Dynamo 以及它是如何工作的?
    • Primer 用户手册、Dynamo 社区和平台
  • Dynamo 设置
  • 用户界面
    • 工作空间
    • 库
  • 节点和导线
  • 基本节点和概念
    • 节点索引
    • 计算设计的几何图形
      • 几何图形概述
      • 向量、平面和坐标系
      • 点
      • 曲线
      • 曲面
      • 实体
      • 网格
    • 程序的构建块
      • 数据
      • 数学
      • 逻辑
      • 字符串
      • 颜色
    • 使用列表进行设计
      • 什么是列表
      • 使用列表
      • 列表的列表
      • n 维列表
    • Dynamo 中的词典
      • 什么是词典
      • 词典节点
      • 代码块中的词典
      • Revit 使用案例
  • 自定义节点和软件包
    • 自定义节点
      • 自定义节点简介
      • 创建自定义节点
      • 发布到库
    • 软件包
      • 软件包简介
      • 软件包案例研究 - Mesh Toolkit
      • 开发软件包
      • 发布软件包
      • Zero-Touch 输入
  • 适用于 Revit 的 Dynamo
    • Revit 连接
    • 选择
    • 编辑
    • 创建
    • 自定义
    • 记录
  • Dynamo for Civil 3D
    • Civil 3D 连接
    • 快速入门
    • 节点库
    • 样例工作流
      • 道路
        • 灯杆放置
      • 浇口面
        • 服务设施放置
      • 公共设施
        • 重命名结构
      • 轨道
        • 间隙包络
      • 勘测
        • 点编组管理
    • 高级主题
      • 对象绑定
      • Python 和 Civil 3D
    • Dynamo Player
    • 有用的软件包
    • 资源
  • Forma Beta 版中的 Dynamo
    • 在 Forma 中设置 Dynamo Player
    • 在 Dynamo Player 中添加和共享图形
    • 在 Dynamo Player 中运行图形
    • Dynamo 计算服务与 Desktop Dynamo 的差异
  • 在 Dynamo 中编码
    • 代码块和 DesignScript
      • 什么是代码块
      • DesignScript 语法
      • 简写
      • 函数
    • 使用 DesignScript 的几何图形
      • DesignScript 几何图形基础知识
      • 几何基本体
      • 向量数学
      • 曲线:内插和控制点
      • 平移、旋转和其他变换
      • 曲面:内插、控制点、放样、旋转
      • 几何参数化
      • 相交和修剪
      • 几何布尔
      • Python 点生成器
    • Python
      • Python 节点
      • Python 和 Revit
      • 设置自己的 Python 模板
    • 语言更改
  • 最佳做法
    • 图形策略
    • 脚本编写策略
    • 脚本参考
    • 管理您的程序
    • 在 Dynamo 中高效处理大型数据集
  • 样例工作流
    • 快速入门工作流
      • 参数化花瓶
      • 吸引器点
    • 概念索引
  • 开发人员入门
    • 从源代码构建 Dynamo
      • 从源代码构建 DynamoRevit
      • 在 Dynamo 中管理和更新依赖项
    • 为 Dynamo 开发
      • 快速入门
      • Zero-Touch 案例研究 - 网格节点
      • 在 Zero-Touch 节点中执行 Python 脚本 (C#)
      • 进一步了解 Zero-Touch
      • 高级 Dynamo 节点自定义
      • 在 Dynamo 软件包中使用 COM(互操作)类型
      • NodeModel 案例研究 - 自定义 UI
      • 更新 Dynamo 2.x 的软件包和 Dynamo 库
      • 更新 Dynamo 3.x 的软件包和 Dynamo 库
      • 扩展程序
      • 为 Dynamo 2.0+ 定义自定义软件包组织
      • Dynamo 命令行界面
      • Dynamo 集成
      • 为 Dynamo For Revit 开发
      • 发布软件包
      • 从 Visual Studio 构建软件包
      • 软件包形式的扩展
    • 拉取请求
    • 测试期望
    • 示例
  • 附录
    • 常见问题解答
    • 可视化编程和 Dynamo
    • 资源
    • 发行说明
    • 有用的软件包
    • 示例文件
    • 主体集成图
    • 下载 PDF
    • Dynamo 键盘快捷键
Powered by GitBook
On this page
  • 我有哪些选项?
  • For(面向)Dynamo
  • In(使用)Dynamo
  • 每种方法有哪些优点/缺点?
  • 了解 Dynamo 版本控制和 API 更改 (1.x → 2.x)
  • 在软件包中分发二进制文件的权限
  • Dynamo UI 性能注意事项
Edit on GitHub
Export as PDF
  1. 开发人员入门

为 Dynamo 开发

Previous在 Dynamo 中管理和更新依赖项Next快速入门

Last updated 2 months ago

无论用户的经验水平如何,Dynamo 平台是专为所有用户设计的,旨在使他们都能够成为参与者。有多个针对不同能力和技能水平的开发选项,每个选项都有其优势和劣势,具体取决于目标。下面,我们将概述不同的选项以及如何选择其中一个。

三种开发环境:Visual Studio、Python 编辑器和代码块 DesignScript

我有哪些选项?

Dynamo 的开发选项主要分为两类:for(面向)Dynamo 与 in(使用)Dynamo。可以将这两个类别视为如下所述:“in”Dynamo 表示使用 Dynamo IDE 创建要在 Dynamo 中使用的内容,而“for”Dynamo 表示使用外部工具创建要输入到 Dynamo 中以供使用的内容。尽管本手册重点介绍 for Dynamo 开发,但下面介绍了适用于所有过程的资源。

For(面向)Dynamo

这些节点允许最高程度的自定义。许多软件包都是使用此方法构建的,它对于参与 Dynamo 的源代码而言必不可少。本手册将介绍构建这些软件包的过程。

  • Zero-Touch 节点

  • NodeModel 派生节点

  • 扩展

在下面的讨论中,Visual Studio 将用作 Zero-Touch 和 NodeModel 节点的开发环境。

我们将要开发的项目的 Visual Studio 界面

In(使用)Dynamo

  • 代码块会在可视化编程环境中显示 DesignScript,从而支持灵活的文本脚本和节点工作流。代码块中的函数可由工作空间中的任何对象调用。

  • 自定义节点是节点集合甚至整个图形的容器。它们是收集常用例程并与社区共享这些例程的有效方式。

  • Python 节点是可视化编程工作空间中的脚本接口,类似于代码块。Autodesk.DesignScript 库使用与 DesignScript 类似的点表示法。

在 Dynamo 工作空间中开发是获得即时反馈的强大工具。

在 Dynamo 工作空间中使用 Python 节点开发

每种方法有哪些优点/缺点?

Dynamo 的开发选项旨在解决自定义需求的复杂性。无论目标是在 Python 中编写递归脚本还是构建完全自定义的节点 UI,都有一些选项可用于实现仅涉及启动和运行所需内容的代码。

Dynamo 中的代码块、Python 节点和自定义节点

这些都是用于在 Dynamo 可视化编程环境中编写代码的简单选项。通过 Dynamo 可视化编程工作空间,可访问 Python、DesignScript,还可以在自定义节点内包含多个节点。

使用这些方法,我们可以:

  • 开始编写 Python 或 DesignScript,而几乎无需设置。

  • 将 Python 库输入到 Dynamo 中。

  • 将代码块、Python 节点和自定义节点作为软件包的一部分与 Dynamo 社区共享。

Zero-Touch 节点

“Zero-Touch”是指一种用于输入 C# 库的简单点击方法。Dynamo 将读取 .dll 的公有方法,并将这些方法转换为 Dynamo 节点。可以使用 Zero-Touch 来开发您自己的自定义节点和软件包。

使用此方法,我们可以:

  • 编写 C# 方法,并在 Dynamo 中轻松将这些方法用作节点

  • 通过软件包将 C# 库作为节点与 Dynamo 社区共享

NodeModel 派生节点

通过这些节点,可以更深入地了解 Dynamo 的结构。它们基于 NodeModel 类,并使用 C# 编写。尽管此方法提供了最大的灵活性和强大功能,但节点的大多数方面都必须明确定义,并且函数需要位于单独的程序集中。

使用此方法,我们可以:

  • 使用滑块、图像、颜色等创建完全可自定义的节点 UI(例如 ColorRange 节点)

  • 访问并影响 Dynamo 画布中发生的情况

  • 自定义连缀

  • 作为软件包载入到 Dynamo 中

了解 Dynamo 版本控制和 API 更改 (1.x → 2.x)

由于 Dynamo 会定期更新,因此可能会对软件包使用的 API 的一部分进行更改。跟踪这些更改对于确保现有软件包继续正常工作而言非常重要。

在软件包中分发二进制文件的权限

请注意,.dll 包含在要上传到软件包管理器的软件包中。如果软件包作者未创建 .dll,则他们必须有权共享它。

如果软件包包含二进制文件,则在下载时必须提示用户该软件包包含二进制文件。

Dynamo UI 性能注意事项

在撰写本文时,Dynamo 主要使用 WPF(Windows 演示基础)来呈现其 UI。WPF 是一个复杂而强大的基于 xaml/绑定的系统。由于 Dynamo 具有复杂的 UI,因此很容易造成 UI 挂起、内存泄漏,或者以降低性能的方式将图形执行和 UI 更新包装在一起。

本 Primer 提供了有关的指南。

尽管这些过程存在于可视化编程工作空间中并且相对简单,但它们都是用于自定义 Dynamo 的可行选项。本 Primer 涵盖了这些内容,并在一章中提供了脚本编写技巧和最佳实践。

下载代码块示例(单击鼠标右键,然后单击“另存为”),或在 中查看详细漫游。

下载自定义节点示例(单击鼠标右键,然后单击“另存为”),或在 中查看详细漫游。

下载 Python 节点示例(单击鼠标右键,然后单击“另存为”),或在 中查看详细漫游。

输入一个不一定是为 Dynamo 开发的库,并自动创建一组新节点(如本 Primer 中的 )

API 更改是在 上进行跟踪的。这包括对 DynamoCore、库和工作空间的更改。

举例来说,2.0 版中即将发生的重大更改是从 XML 文件格式转换为 JSON 文件格式。NodeModel 派生节点现在需要 ,否则它们将无法在 Dynamo 2.0 中打开。

Dynamo 的 API 文档目前涵盖了核心功能:

请参考 ,该页面将帮助您避免在更改 Dynamo 代码时遇到的一些常见陷阱。

输入 Zero-Touch 库
脚本编写策略
Primer
Primer
Primer
Dynamo Github Wiki
JSON 构造函数
http://dynamods.github.io/DynamoAPI
Dynamo 性能注意事项 Wiki 页面
A-Forge 示例
三种开发环境
Visual Studio 界面
在 Dynamo 工作空间中使用 Python 节点开发
代码块、Python 脚本和自定义节点
Zero-Touch 节点
NodeModel 派生节点
Dynamo API 更改文档
API 文档