使用 Property Is Equal Filter

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

要使用 Property Is Equal Filter:

  1. 在 Library 按 Alt 并右键单击 Rendering > Object Sources 中选择 Property Is Equal Filter。

    ../../_images/create-property-is-equal-filter.png
  2. 在 Properties 集中:

    • Source 到您要从中收集节点以进行过滤的源。 例如,要将您的过滤器应用于项目中的所有节点,请选择 Root Object Source。 您可以选择另一个过滤器的输出作为您收集节点以进行过滤的源。

    • 将 Property Type 到您想要筛选节点的属性。

    • Operation 到以下任一选项:

      • Include 用于收集在 Property Type 属性中设置的属性的节点。

      • Exclude 以排除包含您在 Property Type 属性中设置的属性的节点。

    • 根据您在 Property Type 中选择的属性,设置您希望 Property Is Equal Filter 收集的属性值。

    ../../_images/property-is-equal-filter-properties.png
  3. 要使用 Property Is Equal Filter,可以:

    • 在用于渲染要应用过滤器的 3D 节点的 Draw Objects 渲染通道或 Draw Objects With Material 渲染通道中,将 Object Source 属性设置为该过滤器或采集该过滤器的对象源。

    • 在用于保存要使用其他渲染通道渲染的节点的 Node List 渲染通道中,将 Filter 属性设置为该过滤器或采集该过滤器的对象源。

      当您要过滤的不是要渲染的 3D 节点(例如 Light 节点)时,请使用 Node List 渲染通道。Draw Objects 渲染通道、Draw Objects With Material 渲染通道和 Gather Lights 渲染通道可以使用同一 Node List 渲染通道的结果节点列表。

    例如:

    1. 在 Library > Rendering > Render Pass Prefabs 中创建一个 Group 渲染通道,并在其中创建:

      • Clear 渲染通道

      • Gather Lights 渲染通道,并在其中创建一个 Draw Objects 渲染通道

      ../../_images/render-passes-for-filters.png
    2. 在 Library 中选择您创建的 Draw Objects 渲染通道,并在 Properties 中将 Object Source 属性设置为您创建的过滤器或收集该过滤器的对象源。

      请参阅 使用对象源。

    3. 在 Node Tree 中选择要应用过滤器的 Viewport 2D 节点,并在 Properties 中将 Render Pass Prefab 属性设置为 Group 渲染通道,该渲染通道的后代 Draw Objects 渲染通道使用您创建的过滤器作为其对象源。

      ../../_images/render-pass-prefab-set-to-group-render-pass.png

      Kanzi Studio 渲染由过滤器收集的节点。

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

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

另请参阅

使用 Contains Property Filter

使用 Object Type Filter

使用 Sorting Filter

使用 Tag Filter

过滤器 (Filters)

渲染 (Rendering)

使用对象源