pickResult QML Value Type
ピック結果が含まれています。詳細...
| Import Statement: | import QtQuick3D |
プロパティ
- distance : real
- hitType : enumeration
(since 6.8) - instanceIndex : int
(since 6.5) - itemHit : Item
(since 6.8) - normal : vector3d
- objectHit : Model
- position : vector3d
- sceneNormal : vector3d
- scenePosition : vector3d
- uvPosition : vector2d
詳細な説明
View3D::pick への戻り値オブジェクトとして作成されます。
プロパティのドキュメント
distance : real [read-only]
このプロパティには、ピック原点とヒット位置との間の距離、つまり光線の長さが格納されます。ピックにビューポート座標を使用する場合、ピック原点はアクティブなカメラの位置になります。
hitType : enumeration [read-only, since 6.8]
このプロパティには、ピックの結果のヒットタイプが格納されます。
| 定数 | 説明 |
|---|---|
PickResult.Null | ピックは何もヒットしませんでした。 |
PickResult.Model | ピックが何にもヒットしませんでした。ピックがモデルにヒットしました。 |
PickResult.Item | ピックがQQuickItem にヒットしました。 |
このプロパティはQt 6.8で導入されました。
instanceIndex : int [read-only, since 6.5]
このプロパティは、ピックがインスタンス化されたモデルのインスタンスにヒットした場合の、インスタンステーブル内のインデックスを保持します。
このプロパティは Qt 6.5 で導入されました。
itemHit : Item [read-only, since 6.8]
このプロパティは、ピックによって選択されたQt Quick アイテムを保持します。hitType がpickResult.Item でない場合、この値はnullになります。
このプロパティは Qt 6.8 で導入されました。
「objectHit」も参照してください 。
normal : vector3d [read-only]
このプロパティには、ローカル座標系におけるヒットした面の法線が格納されます。
注:これは 面の幾何法線であり、裏面がヒットした場合は、光線とは反対方向を向きます。裏面が検出されるのは、マテリアルの「cull mode 」設定で裏面が除外されていない場合のみです。
注: 2Dアイテムの場合、 これは常に (0, 0, 1) になります。
objectHit : Model [read-only]
このプロパティには、ピックによって選択されたモデルオブジェクトが格納されます。hitType がpickResult.Model でない場合、この値はnullになります。
「itemHit」も参照してください 。
position : vector3d [read-only]
このプロパティは、ローカル座標系におけるヒットした位置のシーン位置を保持します。
sceneNormal : vector3d [read-only]
このプロパティには、シーン座標系における衝突した面の法線が格納されます。
scenePosition : vector3d [read-only]
このプロパティには、ヒットした位置のシーン上の座標が格納されます。
uvPosition : vector2d [read-only]
このプロパティには、ヒットした位置のUV座標が格納されます。UV座標は、バウンディングボリュームを基準とした、ヒットポイントの正規化されたローカルx座標およびy座標として計算されます。画面外にレンダリングされたオブジェクトに対してさらにピックを行う際に役立ちます。
hitType がpickResult.Item に設定されている場合、この値はitemHit の座標空間におけるヒット位置を表します。
© 2026 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.