Warnings
This function is not suitable for large area searches. If the search extents overlaps more than 128 polygons it may return an invalid result.
Module |
|
Header |
/Engine/Source/Runtime/Navmesh/Public/Detour/DetourNavMeshQuery.h |
Include |
#include "Detour/DetourNavMeshQuery.h" |
Source |
/Engine/Source/Runtime/Navmesh/Private/Detour/DetourNavMeshQuery.cpp |
dtStatus findNearestContainingPoly
(
const float * center,
const float * extents,
const dtQueryFilter * filter,
dtPolyRef * nearestRef,
float * nearestPt
) const
Finds the nearest polygon containing the specified center point.
If the search box does not intersect any polygons the search will return #DT_SUCCESS, but nearestRef_ will be zero. So if in doubt, check
nearestRef before using `nearestPt.
This function is not suitable for large area searches. If the search extents overlaps more than 128 polygons it may return an invalid result.
The status flags for the query.
Parameter |
Description |
---|---|
center |
The center of the search box. [(x, y, z)] |
extents |
The search distance along each axis. [(x, y, z)] |
filter |
The polygon filter to apply to the query. |
nearestRef |
The reference id of the nearest polygon. |
nearestPt |
The nearest point on the polygon. [opt] [(x, y, z)] |