フィルタ¶

Filters は、Kanzi プロジェクト内の3Dノードを収集して再編成します。異なるレンダーパスでレンダリングする3Dノードを決定するためにフィルタを使用できます。

1つ以上のフィルタまたはオブジェクトソースを設定すると、フィルタはそのフィルタで定義した要件に一致する3Dノードのセットを収集して出力します。

フィルタを使用して、Kanzi アプリケーション全体または一部のレンダリングを調整します。フィルタを使用するには、次のいずれかを行います。

Draw Objects Render Pass または Draw Objects With Material Render Pass で、Object Source プロパティを設定し、フィルタがレンダーパスに渡すノードのみをレンダーパスがレンダリングするようにします。
Node List Render Pass で Filter プロパティを設定し、フィルタがその Node List Render Pass に渡すノードのみを Node List Render Pass が保持するようにします。

Node List Render Pass を使用して、レンダリングしたい3Dノード以外のものをフィルタリングする場合、例えば Light ノードなどに使用します。Draw Objects Render Pass、Draw Objects With Material Render Pass、および Gather Lights Render Pass のレンダーパスは、同じ Node List Render Pass の結果ノードリストを使用できます。

レンダリングを参照してください。

たとえば、フィルタを使用して以下を行うことができます:

これらのフィルタは、Library > Rendering > Object Sources の Kanzi Studio で利用可能です。

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

Contains Property Filter を使用するを参照してください。
Object Type Filter は、ノードのタイプに基づいて3Dノードを収集します。Object Type Filter を使用するを参照してください。
Property Is Equal Filter は、特定の値に一致する特定のプロパティを持つ、または持たない3Dノードを収集します。

Property Is Equal Filter を使用するを参照してください。
Sorting Filter は、3D ノードを z 軸の位置に応じて並べるか、マテリアルタイプでグループ化します。

Sorting Filter を使用するを参照してください。
Tag Filter は、特定のタグが割り当てられている3Dノードを収集します。

Tag Filter の使用を参照してください。

APIでフィルタを使用する¶

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