使用 Property Is Equal Filter¶

Property Is Equal Filter 收集包含或不包含某个属性值达到特定值的 3D 节点。

要使用 Property Is Equal Filter:

在 Library 按 Alt 并右键单击 Rendering > Object Sources 中选择 Property Is Equal Filter。
在 Properties 集中：
- Source 到您要从中收集节点以进行过滤的源。例如，要将您的过滤器应用于项目中的所有节点，请选择 Root Object Source。您可以选择另一个过滤器的输出作为您收集节点以进行过滤的源。
- 将 Property Type 到您想要筛选节点的属性。
- Operation 到以下任一选项：
  - Include 用于收集在 Property Type 属性中设置的属性的节点。
  - Exclude 以排除包含您在 Property Type 属性中设置的属性的节点。
- 根据您在 Property Type 中选择的属性，设置您希望 Property Is Equal Filter 收集的属性值。
要使用 Property Is Equal Filter，可以：
- 在您用于渲染要应用过滤器的 3D 节点的 Draw Objects Render Pass 或 Draw Objects With Material Render Pass 中，将 Object Source 属性设置为过滤器或收集过滤器的对象源。
- 在您用于保存要使用其他渲染通道渲染的节点的 Node List Render Pass 中，将 Filter 属性设置为过滤器或收集过滤器的对象源。
  
  当您想要过滤除要渲染的3D节点之外的任何内容时，使用 Node List Render Pass，例如 Light 节点。Draw Objects Render Pass、Draw Objects With Material Render Pass 和 Gather Lights Render Pass 渲染通道可以使用相同 Node List Render Pass 的结果节点列表。
例如：
1. 在 Library > Rendering > Render Pass Prefabs 中创建一个 Group Render Pass，并在其中创建：
  - Clear Render Pass
  - Gather Lights Render Pass 和其中的 Draw Objects Render Pass
2. 在 Library 中，选择您创建的 Draw Objects Render Pass，并在 Properties 中将 Object Source 属性设置为您创建的过滤器或收集过滤器的对象源。
  
  请参阅使用对象源。
3. 在 Node Tree 中，选择要应用过滤器的 Viewport 2D 节点，并在 Properties 中将 Render Pass Prefab 属性设置为其后代 Draw Objects Render Pass 使用您创建的过滤器作为其对象源的 Group Render Pass。
  
  Kanzi Studio 渲染由过滤器收集的节点。

在 API 中使用 Property Is Equal Filter 过滤器。¶

有关详细信息，请参阅 PropertyIsEqualFilter 类。

另请参阅¶

使用 Contains Property Filter

使用 Object Type Filter