Class: QgsRayCastHit

Contains details about the ray intersecting entities when ray casting in a 3D map canvas.

Added in version 4.0.

class qgis._3d.QgsRayCastHit

Bases: object

distance(self) → float

Returns the hit’s distance from the ray’s origin

Return type:

float

mapCoordinates(self) → QgsVector3D

Returns the hit position in 3d map coordinates

Return type:

QgsVector3D

properties(self) → Dict[str, Any]

Returns a map with the properties of the intersected entity. For vector layer hits, the FID value is stored in key “fid”. For point cloud layer hits, it contains the point attributes keys/values. For tiled scene layer hits, it contains the intersecting node details.

Return type:

Dict[str, Any]

setDistance(self, distance: float)

Sets the hit’s distance from the ray’s origin

Parameters:

distance (float)

setMapCoordinates(self, point: QgsVector3D)

Sets the hit point position in 3d map coordinates

Parameters:

point (QgsVector3D)

setProperties(self, attributes: Dict[str, Any])

Sets the point cloud point attributes, empty map if hit was not on a point cloud point

Parameters:

attributes (Dict[str, Any])