Instancing QML Type

インスタンステーブルの基本型。詳細...

• 継承されたメンバを含む全メンバのリスト

プロパティ

• depthSortingEnabled : bool
• hasTransparency : bool
• instanceCountOverride : int
• shadowBoundsMaximum : vector3d
• shadowBoundsMinimum : vector3d

方法

• color instanceColor(int index) (since 6.3)
• vector3d instanceCustomData(int index) (since 6.3)
• vector3d instancePosition(int index) (since 6.3)
• quaternion instanceRotation(int index) (since 6.3)
• vector3d instanceScale(int index) (since 6.3)

詳細説明

インスタンス化されたレンダリングは、バリエーションを持つモデルの複製を可能にします。

インスタンス化タイプは、各インスタンスがベースモデルに対してどのように変更されるかを指定するテーブルを定義します。このテーブルには、各インデックスのエントリがあり、トランスフォーム マトリックス、カラー、カスタム マテリアルで使用する汎用データが含まれています。インスタンス化を使うには、モデルのinstancing プロパティを設定して、インスタンス化オブジェクトを参照します。

アプリケーションは、QQuick3DInstancing をサブクラス化することで C++でインスタンスオブジェクトを定義することができます： InstanceList FileInstancing RandomInstancing また、ModelParticle3D.instanceTable プロパティを使うことで、particle system を使ってインスタンステーブルを定義することもできます。

プロパティの説明

depthSortingEnabled : bool

インスタンステーブルの深度ソート有効値を保持します。有効な場合、インスタンスはカメラから最も遠いインスタンスから最も近いインスタンスへ、つまり背面から前面へソートされレンダリングされます。無効（デフォルト）の場合、インスタンスはインスタンステーブルで指定された順序でレンダリングされます。

hasTransparency : bool

モデルをレンダリングするときに使用されるべきアルファ値がインスタンス化テーブルに含まれている場合、このプロパティをtrueに設定します。このプロパティはモデルが不透明な場合にのみ違いが生じます：モデルが透明な場合material 、またはopacity が1より小さい場合、テーブルからのアルファ値が関係なく使用されます。

instanceCountOverride : int

インスタンステーブルを再生成または再アップロードせずにインスタンス数を制限するには、このプロパティを設定します。これにより、レンダリングされるインスタンス数の非常に安価なアニメーションが可能になります。

shadowBoundsMaximum : vector3d

インスタンステーブル内のモデルのシャドウマップ境界を計算する際に使用される最大境界を設定します。

デフォルト値：(-1, -1, -1)

shadowBoundsMinimumも参照してください 。

shadowBoundsMinimum : vector3d

インスタンステーブル内のモデルのシャドウマップ境界を計算する際に使用される最小境界を設定します。

デフォルト値：(1, 1, 1)

shadowBoundsMaximumも参照してください 。

メソッドのドキュメント

[since 6.3] color instanceColor(int index)

のインスタンスの色を返します。index

このメソッドは Qt 6.3 で導入されました。

instancePosition,instanceScale,instanceRotation, instanceColor,instanceCustomDataも参照してください 。

[since 6.3] vector3d instanceCustomData(int index)

にあるインスタンスのカスタムデータを返します。index

このメソッドは Qt 6.3 で導入されました。

instancePosition,instanceScale,instanceRotation,instanceColor, instanceCustomDataも参照してください 。

[since 6.3] vector3d instancePosition(int index)

におけるインスタンスの位置を返します。index

このメソッドは Qt 6.3 で導入されました。

instanceScale,instanceRotation,instanceColor,instanceCustomDataも参照してください 。

[since 6.3] quaternion instanceRotation(int index)

でのインスタンスの回転を表す四元数を返します。index

このメソッドは Qt 6.3 で導入されました。

instancePosition,instanceScale, instanceRotation,instanceColor,instanceCustomDataも参照してください 。

[since 6.3] vector3d instanceScale(int index)

でのインスタンスのスケールを返します。index

このメソッドは Qt 6.3 で導入されました。

instancePosition, instanceScale,instanceRotation,instanceColor,instanceCustomDataも参照してください 。