フィルタ¶

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

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

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

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

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

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

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

これらのフィルタは、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 クラスを参照してください。