Click or drag to resize
Ab4d.SharpEngine logo

SceneGetClosestHitObject Method

GetClosestHitObject method executes a hit testing on the SceneNodes in this Scene (or when specified on rootSceneNode and its children) and returns a RayHitTestResult object with the closest triangle hit by the specified ray. When no triangle is hit, null is returned.

Namespace: Ab4d.SharpEngine
Assembly: Ab4d.SharpEngine (in Ab4d.SharpEngine.dll) Version: 2.0.8956+4c7684e186ca1be74e7a284fbe739d9a1b843d3c
Syntax
C#
public RayHitTestResult? GetClosestHitObject(
	Ray ray,
	SceneNode? rootSceneNode = null,
	HitTestOptions? customHitTestOptions = null
)

Parameters

ray  Ray
Ray object that defines the ray that is used for hit testing
rootSceneNode  SceneNode  (Optional)
SceneNode where the hit testing begins and continues to SceneNode's children. When not set or null, then DXScene.RootNode is used (optional)
customHitTestOptions  HitTestOptions  (Optional)
Optional HitTestOptions that will be used for this hit test. When null (by default), then DefaultHitTestOptions will be used.

Return Value

RayHitTestResult
RayHitTestResult with the closest hit object or null if no object was hit
Remarks

HitTest method executes a hit testing on the SceneNodes in this Scene (or when specified on rootSceneNode and its children) and returns RayHitTestResult object with the closest triangle hit by the specified ray. When no triangle is hit, null is returned.

To control advanced hit-testing options set the customHitTestOptions parameter (HitTestOptions) or change the DefaultHitTestOptions that is used when customHitTestOptions parameter is not set (null by default).

To get all hit results, use the GetAllHitObjects(Ray, SceneNode, HitTestOptions) method.

See Also