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 Render Pass または Draw Objects With Material Render Pass で、Object Source プロパティをフィルタまたはフィルタを収集するオブジェクトソースに設定します。

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

      Node List Render Pass を使用して、レンダリングしたい3Dノード以外のものをフィルタリングする場合、例えば 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

      ../../_images/render-passes-for-filters.png
    2. Library で作成した Draw Objects Render Pass を選択し、Properties で Object Source プロパティを作成したフィルタ、またはフィルタを収集するオブジェクトソースに設定します。

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

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

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

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

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

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

関連項目

Contains Property Filter を使用する

Object Type Filter を使用する

Sorting Filter を使用する

Tag Filter の使用

フィルタ

レンダリング

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