Instancing QML Type

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

Import Statement:	`import QtQuick3D`
Since:	Qt 6.2
In C++:	QQuick3DInstancing
Inherits:	Object3D
Inherited By:	FileInstancing, InstanceList, and RandomInstancing

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

プロパティ

メソッド

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

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

注意： インスタンスは互いに対してのみソートされます。インスタンスはシーン内の他のオブジェクトに対してソートされません。

Note: ソートにより、特にインスタンス数が多い場合、フレームの準備時間が長くなります。

hasTransparency : bool

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

注意： アルファブレンディングを有効にすると、インスタンスが重なったときにレンダリングの問題が発生することがあります。詳細については、アルファブレンディングとインスタンスのドキュメントを参照してください。

instanceCountOverride : int

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

メソッドの説明

[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も参照してください。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。