Instancing QML Type
インスタンステーブルの基本型。詳細...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.2 |
| In C++: | QQuick3DInstancing |
| Inherits: | |
| Inherited By: |
プロパティ
- depthSortingEnabled : bool
- hasTransparency : bool
- instanceCountOverride : int
方法
- 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 |
インスタンステーブルを再生成または再アップロードせずにインスタンス数を制限するには、このプロパティを設定します。これにより、レンダリングされるインスタンス数の非常に安価なアニメーションが可能になります。
メソッドのドキュメント
のインスタンスの色を返します。index
このメソッドは Qt 6.3 で導入されました。
instancePosition,instanceScale,instanceRotation, instanceColor,instanceCustomDataも参照してください 。
にあるインスタンスのカスタムデータを返します。index
このメソッドは Qt 6.3 で導入されました。
instancePosition,instanceScale,instanceRotation,instanceColor, instanceCustomDataも参照してください 。
におけるインスタンスの位置を返します。index
このメソッドは Qt 6.3 で導入されました。
instanceScale,instanceRotation,instanceColor,instanceCustomDataも参照してください 。
|
でのインスタンスの回転を表す四元数を返します。index
このメソッドは Qt 6.3 で導入されました。
instancePosition,instanceScale, instanceRotation,instanceColor,instanceCustomDataも参照してください 。
でのインスタンスのスケールを返します。index
このメソッドは Qt 6.3 で導入されました。
instancePosition, instanceScale,instanceRotation,instanceColor,instanceCustomDataも参照してください 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
