QRayCaster Class

class Qt3DRender::QRayCaster

Qt3DRender::QRayCaster is used to perform ray casting tests in 3d world coordinates. More...

Header:	#include <QRayCaster>
CMake:	find_package(Qt6 COMPONENTS 3drender REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake:	QT += 3drender
Since:	Qt 5.11
Instantiated By:	RayCaster
Inherits:	Qt3DRender::QAbstractRayCaster

• List of all members, including inherited members

Properties

• direction : QVector3D
• length : float
• origin : QVector3D

Public Functions

QVector3D	direction() const
float	length() const
QVector3D	origin() const

Public Slots

void	setDirection(const QVector3D &direction)
void	setLength(float length)
void	setOrigin(const QVector3D &origin)
void	trigger(const QVector3D &origin, const QVector3D &direction, float length)
void	trigger()

Signals

void	directionChanged(const QVector3D &direction)
void	lengthChanged(float length)
void	originChanged(const QVector3D &origin)

Detailed Description

The 3d ray is defined by its origin, direction and length. It will be affected by the transformations applied to the entity it belongs to.

Ray casting tests will be performed every frame as long as the component is enabled. The hits property will be updated with the list of intersections.

See also QAbstractRayCaster, QScreenRayCaster, and QNoPicking.

Member Function Documentation

[slot] void QRayCaster::setLength(float length)

Sets the length of the ray to length.

If the value is less than or equal to zero, the ray is concidered to be infinite.

Note: Setter function for property length.

See also length().

[slot] void QRayCaster::trigger(const QVector3D &origin, const QVector3D &direction, float length)

Convenience method to set the ray details origin, direction, and length, and enable the component to trigger tests.

[slot] void QRayCaster::trigger()

Convenience method to enable the component and trigger tests using the current ray.