Contains Property Filter を使用する

Contains Property Filter は、特定のプロパティを持つ、または持たない3Dノードを収集します。

Contains Property Filter を使用するには:

  1. Library Alt を押しながら右クリック Rendering > Object Sources で Contains Property Filter を選択します。

    ../../_images/create-contains-property-filter.png
  2. Properties セット内で:

    • フィルタリングのためにノードを収集したいソースに Source します。たとえば、プロジェクト内のすべてのノードにフィルタを適用するには、Root Object Source を選択します。フィルタリングのためにノードを収集するソースとして、別のフィルタの出力を選択することもできます。

    • ノードをフィルタリングしたいプロパティに Property Type を設定します。

    • Operation を次のいずれかに:

      • Include は、Property Type プロパティに設定したプロパティを含むノードを収集します。

      • Exclude は、Property Type プロパティに設定したプロパティを含むノードを除外します。

    ../../_images/contains-property-filter-properties.png
  3. Contains Property Filter を使用するには、次のいずれかを行います。

    • フィルタを適用したい 3D ノードのレンダリングに使用する Draw Objects レンダーパスまたは Draw Objects With Material レンダーパスで、Object Source プロパティをそのフィルタ、またはそのフィルタを収集するオブジェクトソースに設定します。

    • 他のレンダーパスを使用してレンダリングしたいノードを保持するために使用する Node List レンダーパスで、Filter プロパティをそのフィルタ、またはそのフィルタを収集するオブジェクトソースに設定します。

      Light ノードなど、レンダリングしたい 3D ノード以外のものをフィルタリングする場合は、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 プロパティを、作成したフィルタまたはフィルタを収集するオブジェクトソースに設定します。

      オブジェクトソース (Object Sources) を使用する を参照してください。

    3. Node Tree で、フィルタを適用する Viewport 2D ノードを選択し、Properties で Render Pass Prefab プロパティを、作成したフィルタをオブジェクトソースとして使用する Draw Objects レンダーパスを子孫に持つ Group レンダーパスに設定します。

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

      Kanzi Studio は、フィルタによって収集されたノードをレンダリングします。

Contains Property Filter フィルタをAPIで使用する

詳細については、ContainsPropertyFilter クラスを参照してください。

関連項目

Object Type Filter を使用する

Property Is Equal Filter を使用する

Sorting Filter を使用する

Tag Filter の使用

フィルタ

レンダリング

オブジェクトソース (Object Sources) を使用する