Instancing QML Type (Uncreatable)

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

注：これは作成不可能な型です。QML ではインスタンス化できません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• 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 プロパティを設定して、Instancingオブジェクトを参照するようにします。

アプリケーションは、QQuick3DInstancing をサブクラス化してC++でインスタンス化オブジェクトを定義することも、InstanceList 、FileInstancing 、またはRandomInstancing といった事前定義されたQML型のいずれかを使用することもできます。さらに、particle system を使用し、ModelParticle3D.instanceTable プロパティを利用してインスタンス化テーブルを定義することも可能です。

プロパティのドキュメント

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 。