|
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.SharpEngineAssembly: Ab4d.SharpEngine (in Ab4d.SharpEngine.dll) Version: 2.0.8956+4c7684e186ca1be74e7a284fbe739d9a1b843d3c
Syntax 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
RayHitTestResultRayHitTestResult 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