节点组

节点组示例。

对节点进行分组可以隐藏复杂性并重复使用常用功能，从而简化节点树。绿色标题栏可直观地识别节点组。

从概念上讲，节点组允许您将一 组 节点视为一个独立单元。它们类似于编程中的函数：可重用、可组合、可参数化。

例如，假设您创建了一个 “木纹” 材质，并希望将其用于多种颜色。您可以为每种颜色复制整个节点设置，但如果日后决定更改木纹细节，维护这些副本将非常繁琐。相反，您可以将生成木纹图案的节点移动到一个节点组中。然后，每种材质都可以重复使用该组，并提供自定义颜色作为输入。对木纹细节的任何更新都只需在节点组内进行一次。

节点组可以嵌套，也就是说，一个组可以包含其他组。

Note

禁止递归节点组，以避免无限递归。节点组不能直接或间接包含自身。

Tip

与其他数据块一样，名称以 . 开头的节点组会从菜单和列表中隐藏，只能通过搜索访问。这对节点资产作者来说非常有用，因为他们希望向最终用户隐藏内部实用程序组。

组输入 和 组输出 节点用于表示流入和流出组的数据。

通过 组输入 节点，可从节点组内部访问组的输入接口。这些接口作为参数，从外部控制组的行为。您可以将它们连接到内部节点，以驱动系数、颜色或几何输入等值。

Note

不影响输出的输入值将显示为灰色。

组输出 节点定义从节点组传出的数据。只有连接到该节点的接口才能作为组本身的输出。

Important

请避免在节点组内部使用材质输出等输出节点。此类节点应置于节点树的顶层，以提高节点组的复用性。

应使用 组输出 将数据传出节点组。

用法

管理输入/输出

您可以在侧栏的 组 面板上添加、移除和重新排列输入和输出接口。也可以直接创建新接口，方法是将 组输入 或 组输出 节点上的空心接口连接拖到节点编辑器中的另一个接口上。

重复使用节点组

参考

菜单:

添加 ‣ 组

快捷键:

Shift-A

现有的节点组可以在最初定义后再次放置，无论是在同一个节点树还是不同的节点树。也可以使用 文件 ‣ 关联/追加 从不同的 blend 文件中导入节点组。

Tip

当从另一个 blend 文件中追加节点组时，Blender 不会区分材质组或合成组等类型。为避免混淆，建议使用前缀（Mat_、Comp_、Geo_ 等）等命名约定来表示组的上下文。

属性

群组

参考

面板:

侧栏 ‣ 群组 ‣ 群组

群组 面板。

该面板包含与组节点相关的属性，例如其名称和外观。

名称

在标题中显示的节点名称。

描述

光标悬停在标题上或添加菜单中时显示的信息。

颜色标签

影响标题栏颜色的节点组的颜色标签。

节点宽度

新创建的组节点的宽度。

（设置默认节点宽度）

根据当前上下文中的父组节点设置宽度

显示管理面板 几何节点

在从节点组资产创建修改器时，启用几何节点修改器中的管理面板显示功能。

用法 几何节点

该面板仅在几何节点编辑器中可见。

修饰键

节点组将被用作几何节点修改器。

工具

节点组将被用作工具。

几何节点编辑器标题栏的数据块菜单只会列出用法与当前节点树子类型匹配的节点组。

Tip

如果不小心禁用了两种用法，节点组将无法再通过数据块菜单访问。要使其再次可访问，可以将其作为一个节点添加到另一个节点组中（添加 ‣ 群组），选择该节点，然后按 Tab 键进入。从那里，你可以再次启用其中一个用法。

群组接口

参考

面板:

侧栏 ‣ 群组 ‣ 群组接口

群组接口 面板。

该面板用于添加、删除、重新排序和编辑节点组的用户界面元素。它定义了接口在组节点上的显示方式，并对接口进行组织，使其更加清晰易用。

可用的条目类型包括：

• 输入：定义节点组的输入接口。

• 输出：定义节点组的输出接口。

• 面板：

  将相关接口分组并组织在一起。对于结构复杂的节点设置非常有用。面板总是显示在节点界面的底部。可以通过在界面条目列表中将一个面板拖到另一个的顶部来嵌套面板。

• 面板开关：

  为面板标题添加一个布尔复选框，以便控制其内容。只有当面板在界面条目列表中被选中时，该选项才可用。

  面板开关在 面板开关 子面板下有自己的选项。请注意，开关接口不会直接列在界面列表中——带开关的面板会在名称旁边显示一个布尔接口图标。要使开关接口重新可见，必须从面板上卸除。

  Note

  面板开关不会自动禁用或使接口变灰。如需直观且功能上禁用接口，请使用切换节点或类似逻辑，手动断开接口连接。

界面条目列表

一个 UI 列表视图，显示所有输入/输出接口和面板。每个项目都可以单独重命名和配置。名称会显示在节点的用户界面中。

Tip

在节点上选择接口标签时，该接口也会在 界面条目列表 中被选中。

其他菜单

复制条目

复制选中的接口或面板。

生成面板开关

将选定的布尔输入转换为其父面板的切换按钮。仅当面板被选中且活动项为布尔接口时可用。

卸除面板开关

移除布尔接口与面板之间的切换关系，使其再次成为普通的独立输入。

接口

接口的属性取决于多种因素，包括它是输入还是输出接口、数据类型以及节点树的类型。

类型

由此界面项生成的接口的类型。

描述

将鼠标悬停在接口上时显示的工具提示文本。

属性域 几何节点 -- 输出 -- 整数 颜色 矢量 布尔 浮点

属性对应的几何体元素类型。请参阅属性域获取属性域的完整列表。

默认属性 几何节点 -- 整数 颜色 矢量 布尔 浮点

将节点组用作几何节点修改器时默认使用的属性名。

子类型 整数 浮点 矢量 字符串

指定数据在用户界面中的解释、显示方式，有时还包括约束规则。视觉呈现、单位后缀和输入行为通常取决于场景单位设置。

更改子类型不会改变底层数据类型，仅影响值的显示和编辑方式。

整数

无:

标准整数值，无特殊含义。

像素:

表示以像素为单位的数值，后缀为 “px”。通常用于表示尺寸、分辨率、图像大小或其他屏幕空间的测量值。

百分比:

以百分比形式显示。通常与设置为 0 和 100 的 最小值 和 最大值 配合使用。

系数:

表示介于下限和上限之间的规格化系数，通常用于 0.0-1.0 的范围。

浮点

无:

标准浮点数值，无特定单位。

像素:

表示以像素为单位的数值，后缀为 “px”。通常用于表示尺寸、分辨率、图像大小或其他屏幕空间的测量值。

百分比:

以百分比形式显示。通常与设置为 0 和 100 的 最小值 和 最大值 配合使用。

系数:

介于下限和上限之间的规格化值，通常在 0.0-1.0 范围内。

质量:

基于场景单位系统的质量值。

角度:

旋转测量值，以角度或弧度显示，具体取决于场景单位设置。

时间（相对于场景）:

以帧为单位的时间，根据场景帧率自动转换为秒。

时间（绝对）:

直接以秒为单位测量的时间。

距离:

使用场景长度单位进行的空间距离测量。

波长:

波周期的间距。以毫米（mm）、微米（µm）、纳米（nm）或皮米（pm）为单位显示。

色温:

与光源的感知颜色相对应的温度值（开尔文）。

频率:

每秒重复的速率（赫兹）。

矢量

无:

标准的矢量值。

像素:

表示以像素为单位的数值，后缀为 “px”。通常用于表示尺寸、分辨率、图像大小或其他屏幕空间的测量值。

百分比:

每个分量均以百分比形式显示。

系数:

每个分量都被视为一个规格化系数。

移动:

使用场景长度单位的位移矢量。

方向:

几何方向矢量，通常经过规格化处理。

速度:

表示运动速度和方向的矢量。

加速度:

表示速度变化率的矢量。

欧拉角:

欧拉旋转角度。

XYZ:

笛卡尔坐标。根据具体情况，也可能支持第四个分量（W）。

字符串

无:

标准的文本字符串。

文件路径:

字符串被解释为文件路径，从而能在用户界面中启用文件选择对话框。

维度 矢量

设置矢量接口的分量数目：2、3 或 4．改变维度会影响接口的绘制方式以及数据通过时的传递方式。

• 2D：X 与 Y 分量。

• 3D：X、Y 与 Z 分量。

• 4D：X、Y、Z 与 W 分量。

默认

接口没有任何连接时使用的值。

最小值、最大值

节点界面中 UI 控件的最小值和最大值。

Important

这不会限制流经接口的实际数据。如果向接口传递的值更大，它仍然会被不加改变地处理。

扩展 菜单

以扩展布局显示菜单，同时显示所有选项。

• 在节点编辑器中，只会显示扩展菜单，而不显示标签。

• 在修改器和操作面板中，将同时显示标签和展开的菜单。

默认输入 几何节点 -- 输入 -- 整数 矢量 矩阵

接口未连接时使用的值。需要启用 隐藏值。

可选标签 输入

表明此接口的标签对于理解其含义并非必需。这可能导致在某些情况下跳过显示该标签。

隐藏值

隐藏接口的默认值控件，即使接口未连接。

层选择 几何节点 -- 输入 -- 布尔

将蜡笔层或层组作为选择区域。

在修改器中隐藏 几何节点 -- 输入

在几何节点修改器界面中隐藏输入值。这允许在节点组内部使用该接口，但不将其暴露给修改器。

仅适用于几何节点输入接口。

形状 几何节点 -- 输入

指定接口接受的高阶数据类型。有关详细信息，请参阅接口形状。

自动:

根据接口的使用方式自动检测最合适的形状。这是默认选项，适用于大多数情况。

动态:

接口可适应多种形状，使其在与不同连接使用时更加灵活。适用于处理各种数据类型的通用节点组。

单一:

仅允许单个值（常量），而不允许结构化数据。场或栅格不可连接。

力场:

接口期望为场，这意味着其值可能因几何元素或上下文的不同而不同。

栅格:

接口期望使用栅格数据结构，该结构存储在体积或二维空间中采样的值。

面板

描述

将鼠标悬停在面板标题上时显示的工具提示文本。

默认关闭

启用后，该面板在新建节点时默认处于折叠状态。

动画

控制节点组属性的动画数据，包括活动的动作及其分配的槽。

请参阅手动指定动作和槽获取更多信息。

建立组

参考

菜单:

节点 ‣ 创建组

快捷键:

Ctrl-G

创建一个包含所有选定节点的新组。

将创建 组输入 和 组输出 节点，以表示与组外未选定节点的连接。输入将转接到 组输入，输出将转接到 组输出。

在对 单个节点 分组时，产生的节点组将：

• 保留原始节点的界面，包括面板和默认值。

• 继承原始节点的名称

在对 多个节点 分组时，节点组是通过由连线生成的输入和输出接口创建的。在这种情况下，会使用 "NodeGroup"、"NodeGroup.001" 等通用名称。

插入到组

参考

菜单:

节点 ‣ 插入到组

将选中的节点移动到活动组节点中。使用时，请先选中一组节点，以目标组节点结尾，然后执行该操作，即可将这些节点移动到该组中。被移动的节点会被聚合到一个独立的组中，以保留其连接上下文，并拥有独立的组输入和输出节点。该组现有的输入和输出节点将根据新节点（如果有）更新为新的接口。必须编辑该节点组，使其包含一个 组输入 节点和一个 组输出 节点。

编辑组

参考

菜单:

节点 ‣ 编辑组

标题栏:

进入父级节点树

快捷键:

Tab, Ctrl-Tab

选定一个节点组后，按 Tab 进入该组并查看其内容。再按 Tab（或 Ctrl-Tab）离开该组，回到其父级，这可能是顶级节点树或其他节点组。你可以参考节点编辑器左上角的面包屑导航，看看你在层次结构中的位置。

展开后的节点组示例。

解散组

参考

菜单:

节点 ‣ 解散组

快捷键:

Ctrl-Alt-G

移除组并将单个节点放入你的编辑器工作区。没有内部连接丢失，现在你可以将内部节点连接到工作区的其他节点。

分离

参考

快捷键:

P

分离 操作可将选定节点从节点组中移出，并将其放置到父节点树中。当需要在组外编辑节点以提高清晰度或重复使用时，此操作非常有用。

复制

将选定节点复制到父节点树中，同时保留原始节点在组内的位置。当您希望在组外重复使用节点但仍然保留组内定义时，此操作非常有用。

移动

将选定节点移动到父节点树，并从原始组中将其移除。在需要简化组或直接显示其内容时，此操作非常有用。

合并组输入

参考

菜单:

节点 ‣ 合并组输入

快捷键:

Ctrl-J

在可能的情况下，将多个选定的 组输入 节点合并为一个统一的 组输入 节点。保留现有链接，并统一重复的输入以减少混乱并简化节点树。

此操作可用于清理已变得无序或包含冗余输入节点的节点组。