Filters

Filters collect and reorganize 3D nodes in your Kanzi project. You can use filters to determine which 3D nodes to render in different render passes. After you set one or more filters or object sources, a filter collects and outputs a set of 3D nodes that match the requirements you define in that filter.

Use filters to adjust the rendering for the whole or parts of your Kanzi application. To use a filter, either:

  • In a Draw Objects Render Pass or Draw Objects With Material Render Pass set the Object Source property so that the render pass renders only those nodes that the filter passes to the render pass.

  • In a Node List Render Pass set the Filter property so that the Node List Render Pass holds only those nodes that the filter passes to that Node List Render Pass.

    Use a Node List Render Pass when you want to filter anything but the 3D nodes that you want to render, such as Light nodes. Draw Objects Render Pass, Draw Objects With Material Render Pass, and Gather Lights Render Pass render passes can use the result node list of the same Node List Render Pass.

See Rendering.

For example, you can use filters to:

These filters are available in Kanzi Studio in the Library > Rendering > Object Sources:

../../_images/create-filters.png

Using filters in the API

For details, see the FilterObjectSource class in the Kanzi Engine API reference.