主工作空间

Dynamo 工作空间由四个主要元素组成。

1. 所有活动选项卡。

2. 预览模式

3. 缩放/平移控件

4. 工作空间中的节点

所有活动选项卡

打开新文件时，将默认打开新的主工作空间。

可以创建一个自定义节点，然后在自定义节点工作空间中将其打开。

预览模式

有 3 种方法可在不同预览之间切换：

a.使用右上角图标

b.在工作空间中单击鼠标右键

• 从三维预览切换到图形预览

• 从图形预览切换到三维预览

c.使用键盘快捷键 (Ctrl+B)

缩放/平移控件

可以使用图标或鼠标在任一工作空间中导航。

a.在 “图形预览” 模式下

• 使用图标：
• 使用鼠标：

  • 单击鼠标左键 - 选择

  • 单击鼠标左键并拖动 - 选择框用于选择多个节点

  • 鼠标中键向上/向下滚动 - 放大/缩小

  • 单击鼠标中键并拖动 - 平移

  • 在画布上的任意位置单击鼠标右键 - 打开画布内搜索

b.在 “三维预览” 模式下

• 使用图标：
• 使用鼠标：

  • 鼠标中键向上/向下滚动 - 放大/缩小

  • 单击鼠标中键并拖动 - 平移

  • 单击鼠标右键并拖动 - 动态观察

工作空间中的节点

单击鼠标左键以选择任意节点。

要选择多个节点，请单击并拖动以创建选择框。

该库中包含所有已加载的节点，包括安装时附带的 10 个默认类别节点以及任何额外加载的自定义节点或软件包。该库中的节点在库、类别和子类别（如果适用）中按层次进行组织。

• 基本节点：默认安装时随附。

• 自定义节点：将常用例程或特殊图形存储为自定义节点。还可以与社区共享自定义节点

• 软件包管理器中的节点：已发布自定义节点的集合。

我们将浏览节点层次结构类别、介绍如何从库中快速搜索，以及了解其中一些常用节点。

类别的库层次结构

浏览这些类别是了解我们可以向“工作空间”添加的内容层次的最快方法，也是查找之前尚未使用的新节点的最佳方式。

通过单击菜单展开每个类别及其子类别来浏览库

1. 库

2. 种类

3. 子类别

4. 节点

这些选项会根据节点是 “创建” 数据、执行 “操作” 还是 “查询” 数据，来对同一子类别中的节点进一步分类。

将鼠标光标悬停在节点上，即可显示除其名称和图标以外的更多详细信息。这使我们可以快速了解节点的作用、所需输入内容以及输出内容。

1. 描述 - 节点的纯语言描述

2. 图标 - 库菜单中图标的较大版本

3. 输入 - 名称、数据类型和数据结构

4. 输出 - 数据类型和结构

在库中快速搜索

如果您相对具体地了解要添加到工作空间的节点，请在 “搜索” 字段中键入内容以查找所有匹配的节点。

通过单击要添加的节点进行选择，或按 Enter 键将亮显的节点添加到工作空间的中心。

按层次结构搜索

除了使用关键字尝试查找节点之外，我们还可以在“搜索”字段或代码块中键入以句点分隔的层次结构（这使用 Dynamo 文本语言）。

每个库的层次结构都会反映在添加到工作空间的节点名称中。

以 library.category.nodeName 格式键入“库”层次结构中节点位置的不同部分会返回不同结果

• library.category.nodeName

• category.nodeName

• nodeName 或 keyword

通常，工作空间中的节点名称将以 category.nodeName 格式进行呈现，但存在一些明显例外，尤其是在“输入”和“视图”类别中。

小心类似的命名节点，并注意类别差异：

• 大多数库中的节点将包括类别格式

• Point.ByCoordinates 和 UV.ByCoordinates 有相同名称，但来自不同类别

• 值得注意的例外情况包括内置函数、Core.Input、Core.View 和运算符

常用节点

Dynamo 的基本安装中包含数百个节点，哪些节点对于开发可视化程序至关重要？我们将重点介绍以下节点：定义程序的参数（“Input”）、查看节点操作的结果（“Watch”）以及通过快捷方式定义输入或功能（“Code Block”）。

“Input”节点

“Input”节点是可视化程序的用户（无论是自己还是他人）与关键参数交互的主要手段。以下是核心库中提供的一些节点：

Watch 和 Watch3D

“Watch”节点对于管理流经可视化程序的数据至关重要。将鼠标光标悬停在节点上，可通过节点数据预览查看节点的结果。

它有助于在 “Watch” 节点中保持其显示

或者，通过 “Watch3D” 节点查看几何图形结果。

这两个节点均位于核心库的“视图”类别中。

Code Block

Code Block 节点可用于定义代码块，其中各行用分号隔开。这可以像 X/Y 一样简单。

我们还可以将“代码块”用作定义“数字输入”或调用另一个节点功能的快捷方式。执行此类操作的语法遵循 Dynamo 文本语言（即 DesignScript）的命名约定。

下面是有关在脚本中使用“代码块”的简单演示（带有说明）。

1. 双击以创建“Code Block”节点

2. Circle.ByCenterPointRadius(x,y);Type

3. 在工作空间上单击以清除选择内容，应会自动添加 x 和 y 输入。

4. 创建“Point.ByCoordinates”节点和“数字滑块”，然后将它们连接到“代码块”的输入。

5. 执行可视化程序的结果在三维预览中会显示为圆

用户界面概述

Dynamo 的用户界面 (UI) 分为五个主要区域。我们将在此简要介绍概述，然后在以下各部分中进一步介绍工作空间和库。

1. 菜单

2. 工具栏

3. 库

4. 工作空间

5. 执行栏

菜单

以下是 Dynamo 应用程序基本功能的菜单。与大多数 Windows 软件一样，前两个菜单涉及文件管理、选择操作和内容编辑。其余菜单则更加特定于 Dynamo。

Dynamo 菜单

常规信息和设置位于 “Dynamo” 下拉菜单中。

1. 关于 - 了解计算机上安装的 Dynamo 版本。

2. 同意收集可用性数据 - 这允许您选择加入或退出共享您的用户数据以改进 Dynamo。

3. 首选项 - 包括定义应用程序的小数点精度和几何图形渲染质量等设置。

4. 退出 Dynamo

帮助

如果遇到问题，请查看 “帮助” 菜单。可以通过 Internet 浏览器访问其中一个 Dynamo 参考网站。

1. 快速入门 - 简要介绍如何使用 Dynamo。

2. 互动指南 -

3. 样例 - 参考示例文件。

4. Dynamo 词典 - 包含所有节点文档的资源。

5. Dynamo 网站 - 在 GitHub 上查看 Dynamo 项目。

6. Dynamo Project Wiki - 访问 Wiki 以了解如何使用 Dynamo API、支持库和工具进行开发。

7. 显示开始页面 - 在文档内时返回 Dynamo 开始页面。

8. 报告错误 - 在 GitHub 上打开问题。

工具栏

Dynamo 工具栏包含一系列按钮，可快速处理文件以及访问“Undo [Ctrl + Z]”和“Redo [Ctrl + Y]”命令。最右侧是另一个按钮，它将输出工作空间快照，这对于文档编制和共享非常重要。

库

Dynamo 库是功能库的集合，每个库都包含按类别分组的节点。它包含在默认安装 Dynamo 期间添加的基本库，随着我们继续介绍其用法，我们将演示如何通过自定义节点和其他软件包扩展基本功能。库部分将介绍有关如何使用它的更详细指导。

工作空间

在工作空间中，我们可以编写可视化程序，您还可以更改其“预览”设置以从此处查看三维几何图形。有关更多详细信息，请参见 工作空间。

执行栏

从此处运行 Dynamo 脚本。单击“执行”按钮上的下拉图标，可在不同模式之间切换。

• 自动：自动运行脚本。更改会实时更新。

• 手动：仅当单击“运行”按钮时，脚本才会运行。对更改复杂且“繁重”的脚本很有用。

• 周期：默认情况下，此选项灰显。仅当使用 DateTime.Now 节点时可用。可以将图形设置为按指定的间隔自动运行。