このページでは

Qt3DRender::QRayCasterHit Class

class Qt3DRender::QRayCasterHit

モデルを通してレイをキャストする際のヒットの詳細。詳細...

ヘッダー #include <QRayCasterHit>
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::QRayCasterQt3DRender::QScreenRayCasterQt3DRender::QPickingSettingsも参照してください

メンバ型ドキュメント

enum QRayCasterHit::HitType

返されたヒットのタイプを指定する。これはQPickingSettings を使用して制御します。

定数説明
Qt3DRender::QRayCasterHit::TriangleHit0ピックされたプリミティブが三角形で、頂点インデックスが三角形を構成する3点を指す。
Qt3DRender::QRayCasterHit::LineHit1選択されたプリミティブは線分であり、最初の2つの頂点は線を構成する2つの点を指します。
Qt3DRender::QRayCasterHit::PointHit2ピックしたプリミティブは1点で、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つの頂点のうちの1つです。線ヒットの場合、これは2つの頂点のうちの1つです。

アクセス関数:

uint vertex1Index() const

[read-only] vertex2Index : const uint

このプロパティは、ピックされたプリミティブの 2 番目の頂点のインデックスを保持します。

ピックされたプリミティブの2番目の頂点のインデックスを保持する。三角形のヒットの場合、これは3つの頂点のうちの1つです。直線がヒットした場合は、2つの頂点のうちの1つになります。

アクセス関数:

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

レイの原点から交点までの距離を返します。

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

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

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

注: プロパティ・エンティティのゲッター関数。

Qt3DCore::QNodeId QRayCasterHit::entityId() const

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

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

QVector3D QRayCasterHit::localIntersection() const

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

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

uint QRayCasterHit::primitiveIndex() const

ピックしたプリミティブのインデックスを返します。

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

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

ヒットのタイプを返す

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

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.