このページでは

Qt3DRender::QRayCasterHit Class

class Qt3DRender::QRayCasterHit

モデルにレイを照射した際のヒットに関する詳細。詳細はこちら...

ヘッダー: #include <qraycasterhit.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

パブリック型

enum HitType { TriangleHit, LineHit, PointHit, EntityHit }

プロパティ

公開関数

float distance() const
Qt3DCore::QEntity *entity() const
Qt3DCore::QNodeId entityId() const
QVector3D localIntersection() const
uint primitiveIndex() const
Qt3DRender::QRayCasterHit::HitType type() const
uint vertex1Index() const
uint vertex2Index() const
uint vertex3Index() const
QVector3D worldIntersection() const

詳細な説明

Qt3DRender::QRayCasterHit Qt3DRender::QRayCaster または コンポーネントを使用してモデルにレイを投射した際に、ヒットが成功した詳細情報を格納します。Qt3DRender::QScreenRayCaster

「 Qt3DRender::QRayCaster 」、「Qt3DRender::QScreenRayCaster 」、および「Qt3DRender::QPickingSettings 」も参照してください 。

メンバ型のドキュメント

enum QRayCasterHit::HitType

返されたヒットの種類を指定します。これは QPickingSettings を使用して制御されます。

定数値説明
Qt3DRender::QRayCasterHit::TriangleHit0選択されたプリミティブは三角形であり、頂点インデックスは三角形を構成する 3 つの点を指しています
Qt3DRender::QRayCasterHit::LineHit1選択されたプリミティブは線分であり、最初の 2 つの頂点インデックスは、その線を構成する 2 つの点を指します
Qt3DRender::QRayCasterHit::PointHit2選択されたプリミティブは単一の点であり、3つの頂点インデックスはすべて未定義となります
Qt3DRender::QRayCasterHit::EntityHit3バウンディングボリュームのみが考慮されたため、プリミティブおよび頂点インデックスは未定義になります

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

[read-only] distance : const float

このプロパティは、光線の原点と交点との間の距離を保持します。

レイの起点から、レイがエンティティと交差した点までの距離を保持します。

アクセス関数:

float distance() const

[read-only] entity : Qt3DCore::QEntity* const

このプロパティは、ヒットしたエンティティへのポインタを保持します。

レイが当たった QEntity へのポインタを保持します。

アクセス関数:

Qt3DCore::QEntity *entity() const

[read-only] entityId : const Qt3DCore::QNodeId

このプロパティには、レイが当たったエンティティのIDが格納されます。

レイが当たったエンティティのノードIDを保持します。

アクセス関数:

Qt3DCore::QNodeId entityId() const

[read-only] localIntersection : const QVector3D

このプロパティには、エンティティの座標系における交点の座標が格納されます。

エンティティのローカル座標系における交点の座標を保持します。

アクセス関数:

QVector3D localIntersection() const

[read-only] primitiveIndex : const uint

このプロパティには、選択されたプリミティブのインデックスが格納されます。

ピックされたプリミティブ(三角形、線、または点)のインデックスを保持します。

アクセス関数:

uint primitiveIndex() const

[read-only] type : const QRayCasterHit::HitType

このプロパティには、ヒットの型が格納されます。

ヒットの型を保持します。型は、TriangleHit 、LineHit 、PointHit 、またはEntityHit のいずれかです。

アクセス関数:

Qt3DRender::QRayCasterHit::HitType type() const

[read-only] vertex1Index : const uint

このプロパティには、選択されたプリミティブの最初の頂点のインデックスが格納されます。

選択されたプリミティブの最初の頂点のインデックスを保持します。三角形がヒットした場合は、3つの頂点のいずれかになります。線がヒットした場合は、2つの頂点のいずれかになります。

アクセス関数:

uint vertex1Index() const

[read-only] vertex2Index : const uint

このプロパティには、選択されたプリミティブの2番目の頂点のインデックスが格納されます。

選択されたプリミティブの2番目の頂点のインデックスを保持します。三角形とのヒットの場合、これは3つの頂点のいずれかになります。線分とのヒットの場合、これは2つの頂点のいずれかになります。

アクセス関数:

uint vertex2Index() const

[read-only] vertex3Index : const uint

このプロパティには、選択されたプリミティブの3番目の頂点のインデックスが格納されます。

選択されたプリミティブの3番目の頂点のインデックスを保持します。これは、三角形とのヒットの場合にのみ有効です。

アクセス関数:

uint vertex3Index() const

[read-only] worldIntersection : const QVector3D

このプロパティには、モデルの座標系における交点の座標が格納されます。

ワールド座標系における交点の座標を保持します。

アクセス関数:

QVector3D worldIntersection() const

メンバ関数のドキュメント

float QRayCasterHit::distance() const

光線の原点と交点の間の距離を返します

注: プロパティ distanceのゲッター 関数です。

Qt3DCore::QEntity *QRayCasterHit::entity() const

ヒットしたエンティティへのポインタを返します

注: プロパティ「entity」のゲッター 関数です。

Qt3DCore::QNodeId QRayCasterHit::entityId() const

ヒットしたエンティティのIDを返します

注: プロパティ entityIdのゲッター 関数です。

QVector3D QRayCasterHit::localIntersection() const

エンティティの座標系における交点の座標を返します

注: プロパティ localIntersectionのゲッター 関数です 。

uint QRayCasterHit::primitiveIndex() const

選択されたプリミティブのインデックスを返します

注: プロパティ `primitiveIndex`のゲッター 関数です。

Qt3DRender::QRayCasterHit::HitType QRayCasterHit::type() const

ヒットのタイプを返します

注: プロパティ typeのゲッター 関数です。

uint QRayCasterHit::vertex1Index() const

選択されたプリミティブの最初の頂点のインデックスを返します

注: プロパティ vertex1Indexのゲッター関数です 。

uint QRayCasterHit::vertex2Index() const

選択されたプリミティブの2番目の頂点のインデックスを返します

注: プロパティ vertex2Indexのゲッター関数です 。

uint QRayCasterHit::vertex3Index() const

選択されたプリミティブの3番目の頂点のインデックスを返します

注: プロパティ `vertex3Index`のゲッター関数です 。

QVector3D QRayCasterHit::worldIntersection() const

モデルの座標系における交点の座標を返します

注: プロパティ worldIntersection のゲッター 関数です。

© 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.