#include <astarquery.h>
Runs an A-star algorithm to find a Path through the navigation data (NavMesh & NavGraph) from a starting point to a destination, refines the path found, and fills an object of type Path.
The template argument must be a class that have at least these three static functions :
The template argument must also have to define a type CanEnterNavTagMode with typedef as follow, depending whether or not you have one-way navTag transition :
or
If you are using UseCanEnterNavTag, you also have to implement this function :
This function must tell if, at position pos, we can go from exitNavTag to enterNavTag. Please refer to the SimpleTraverseLogic class documentation for details on these functions Note that the template argument is stored in value within this class.
The propagation of the AStarQuery is bound to 2d oriented bounding box computed by inflating the segment going from startPos to destPos by a boxExtent that can be modified by calling the SetPropagationBoxExtent method. Note that bounds are only in 2D.
/// Propagation bounding box /// ____________________________________________________________________________ /// | ^ /// | | /// |<-----------> <----------->| boxExtent /// | boxExtent boxExtent | /// | x===============================================x x /// | startPos destPos | /// | | boxExtent /// | | /// |___________________________________________________________________________v ///
Inherits Kaim::BaseAStarQuery.
Public Types | |
enum | PathFinderResult { PathFinderNotInitialized, PathFinderNotComputed, PathFinderUnderProcess, PathFinderSuccess, PathFinderFailure, PathFinderFailure_NavDataChanged } |
Public Attributes | |
Database * | m_database |
QueryStatusInQueue | m_inQueueStatus |
QueryQueue * | m_queue |
void * | m_traverseLogicUserData |
Public Member Functions | |
AStarQuery () | |
virtual | ~AStarQuery () |
Functions to set up the query | |
void | BindToDatabase (Database *database) |
void | Initialize (const Vec3f &startPos, const Vec3f &destPos) |
write accessors for query inputs | |
void | SetStartTrianglePtr (const NavTrianglePtr &startTrianglePtr) |
void | SetStartNavGraphEdgePtr (const NavGraphEdgePtr &startNavGraphEdgePtr, NavGraphEdgeDirection navGraphEdgePathfindMode) |
void | SetStartNavGraphVertexPtr (const NavGraphVertexPtr &startNavGraphVertexPtr) |
void | SetDestTrianglePtr (const NavTrianglePtr &destTrianglePtr) |
void | SetDestNavGraphEdgePtr (const NavGraphEdgePtr &startNavGraphEdgePtr, NavGraphEdgeDirection navGraphEdgePathfindMode) |
void | SetDestNavGraphVertexPtr (const NavGraphVertexPtr &startNavGraphVertexPtr) |
write accessors for query parameters | |
void | SetPropagationBoxExtent (KyFloat32 propagationBoxExtent) |
void | SetTryCanGoMode (AStarQueryTryCanGoMode tryCanGoMode) |
void | SetFromOutsideNavMeshDistance (KyFloat32 fromOutsideNavMeshDistance) |
void | SetToOutsideNavMeshDistance (KyFloat32 toOutsideNavMeshDistance) |
void | SetPositionSpatializationRange (const PositionSpatializationRange &positionSpatializationRange) |
void | SetComputeChannelMode (PathFinderQueryComputeChannelMode computeChannelMode) |
void | SetChannelComputerConfig (const ChannelComputerConfig &channelComputerConfig) |
void | SetAbstractGraphTraversalMode (PathFinderAbstractGraphTraversalMode abstractGraphTraversalMode) |
void | SetNumberOfProcessedNodePerFrame (KyUInt32 numberOfProcessedNodePerFrame) |
Query framework functions | |
virtual void | Advance (WorkingMemory *workingMemory) |
virtual void | ReleaseWorkingMemoryOnCancelDuringProcess (WorkingMemory *workingMemory=0) |
Accessors | |
AStarQueryResult | GetResult () const |
AStarQueryTryCanGoMode | GetTryCanGoMode () const |
KyFloat32 | GetFromOutsideNavMeshDistance () const |
KyFloat32 | GetToOutsideNavMeshDistance () const |
KyFloat32 | GetPropagationBoxExtent () const |
const Vec3f & | GetStartPos () const |
const Vec3f & | GetDestPos () const |
const NavTrianglePtr & | GetStartTrianglePtr () const |
const NavGraphEdgePtr & | GetStartNavGraphEdgePtr () const |
const NavGraphVertexPtr & | GetStartNavGraphVertexPtr () const |
const NavTrianglePtr & | GetDestTrianglePtr () const |
const NavGraphEdgePtr & | GetDestNavGraphEdgePtr () const |
const NavGraphVertexPtr & | GetDestNavGraphVertexPtr () const |
Path * | GetPath () const |
KyUInt32 | GetNumberOfProcessedNodePerFrame () const |
const PositionSpatializationRange & | GetPositionSpatializationRange () const |
void | ComputePathRefinerConfigInternals () |
const PathRefinerConfig & | GetPathRefinerConfig () const |
Public Member Functions | |
ChannelArray * | GetChannelArray () const |
void | SetNavigationProfileId (KyUInt32 navigationProfileId) |
KyUInt32 | GetNavigationProfileId () const |
Public Data Members | |
Vec3f | m_startPos3f |
Ptr< Path > | m_path |
KyUInt32 | m_navigationProfileId |
PathFinderQueryComputeChannelMode | m_computeChannelMode |
ChannelComputerConfig | m_channelComputerConfig |
KyUInt32 | m_dataBaseChangeIdx |
bool | m_enableAdvancedVisualDebug |
Main API functions | |
virtual void | GetPathFinderTextResult (String &) const |
virtual void | DisplayPropagationBounds (ScopedDisplayList &displayList) const |
virtual PathFinderResult | GetPathFinderResult () const |
virtual const Vec3f * | GetDestination () const |
PathFinderQueryComputeChannelMode | GetComputeChannelMode () const |
const ChannelComputerConfig & | GetChannelComputerConfig () const |
Path * | GetAbstractPath () const |
PathFinderAbstractGraphTraversalMode | GetAbstractGraphTraversalMode () const |
Main API Functions | |
bool | CanBeInitialized () const |
bool | IsInAQueryQueue () const |
bool | IsSafeToReadResult () const |
void | PerformQueryBlocking (WorkingMemory *workingMemory=0) |
void | OnDone () |
KyResult | SendVisualDebug () |
void | SetTraverseLogicUserData (void *traverseLogicUserData) |
void * | GetTraverseLogicUserData () const |
For internal use only | |
static const char * | GetQueryTypeName (QueryType queryType) |
Public Data Members | |
QueryProcessStatus | m_processStatus |
Ptr< IOnDone > | m_onDone |
Public Member Functions | |
void | Initialize () |
|
inherited |
Enumerates the possible status of a IPathFinderQuery.
Enumerator | |
---|---|
PathFinderNotInitialized |
The IPathFinderQuery is not yet initialized. |
PathFinderNotComputed |
The IPathFinderQuery is initialized but has not been processed. |
PathFinderUnderProcess |
The IPathFinderQuery is currently under process. |
PathFinderSuccess |
The IPathFinderQuery has been completed and a Path has been found. |
PathFinderFailure |
The IPathFinderQuery has been completed but no Path has been found. |
PathFinderFailure_NavDataChanged |
The IPathFinderQuery ended prematurely due to changes into NavData. |
|
inlinevirtual |
Performs a single iteration of the PathFinder.
This function is called by the QueryQueue to process one step on the query. It MUST NEVER, under any circumstances, take too long. As a guideline, consider 0.1ms as too long.
It is under the responsibility of this function to update m_processStatus. Obviously, if the query is atomic (i.e. not time-sliced), a call to Advance() will fully perform the query and set m_processStatus to QueryDone. If the query is time-sliced, several calls to Advance() will be needed to complete the query; the first call should set m_processStatus to Kaim::QueryInProcess and the last one to Kaim::QueryDone.
workingMemory | Sandbox memory used to perform queries. |
Implements Kaim::IQuery.
void Kaim::AStarQuery< TLogic >::BindToDatabase | ( | Database * | database | ) |
|
inlineinherited |
In the case of a query processed in a QueryQueue, this must be tested before initializing the query, to prevent modifying the query during the process.
|
virtualinherited |
Fill the displayList with display info that may help to understand a PathFinderFailure (mainly propagation bounds)
Reimplemented from Kaim::IPathFinderQuery.
|
inlinevirtualinherited |
This function is virtual because not all the PathFinders have a preset destination, it may return KY_NULL.
Implements Kaim::IPathFinderQuery.
|
virtualinherited |
Fills the String with an explanation of the result. Use this to debug your pathfinder query.
Reimplemented from Kaim::IPathFinderQuery.
void Kaim::AStarQuery< TLogic >::Initialize | ( | const Vec3f & | startPos, |
const Vec3f & | destPos | ||
) |
Sets an instance of this class with minimum input requirements.
Clears all the input and output, lets all configuration parameters unchanged. They may be changed by calling the corresponding write accessors.
startPos | Sets the value of m_startPos3f. |
destPos | Sets the value of m_destPos3f. |
|
inlineinherited |
Should be called by the derived class before trying to perform the query or to push it in a QueryQueue.
This function calls IQuery::Initialize().
|
inlineinherited |
Returns true if the query is currently registered in a QueryQueue.
If true, you must not push it again in QueryQueue (even the same one).
If false, you must not try to cancel it from the QueryQueue.
|
inlineinherited |
Returns true if the query has been processed, is no longer in a queue, and OnDone (if there is one) has been called.
If true, it's guaranteed to be safe to read the results of this query.
Will return false if the Query has been cancelled or has not yet been processed.
|
inlineinherited |
Calls the OnDone function of the IOnDone object if provided.
Called automatically by the QueryQueue during the World::Update() (in FlushQueries() step) when this query has been completed.
Not called if this query is canceled.
Note that the member m_onDone is reset to KY_NULL at the end of this function.
|
inherited |
Process the query at once whether it is time-sliced or not.
workingMemory | Sandbox memory used to perform queries. If let to KY_NULL, the m_database internal WorkingMemory is used. |
|
inlinevirtual |
Called when a query is canceled in FlushCommands while its status is QueryInProcess to make sure that the WorkingMemory is left in valid state (typically, no WorkingMemory buffer should be in used after this call).
Implements Kaim::ITimeSlicedQuery.
|
inline |
Write accessor for TraversalParams::m_abstractGraphTraversalMode.
Call this method after BindToDatabase(), during which TraversalParams::m_abstractGraphTraversalMode is set to its default value.
|
inline |
Write accessor for m_channelComputerConfig.
Call this method after BindToDatabase(), during which m_channelComputerConfig is set to its default value.
|
inline |
Write accessor for m_computeChannelMode.
Call this method after BindToDatabase(), during which m_computeChannelMode is set to its default value.
|
inline |
Optional NavGraph edge you want the dest position must be considered to lie on.
If specified, we won't try to project the dest position in the NavMesh and the path, if found, will end on this NavGraphEdge.
Call this method after Initialize(), during which it is cleared.
|
inline |
Optional NavGraph Vertex you want the dest position must be considered to be on.
If specified, we won't try to project the dest position in the NavMesh and the path, if found, will end on this navGraphVertex.
Note that you pass the same NavGraphVertexPtr to SetStartNavGraphVertexPtr and SetDestNavGraphVertexPtr, no path will be calculated.
Call this method after Initialize(), during which it is cleared.
|
inline |
The NavMesh triangle that corresponds to m_destPos3f.
If a valid NavTrianglePtr is specified, this value will be used.
If no value is specified, it will be automatically computed during the query.
Call this method after Initialize(), during which it is cleared.
|
inline |
Write accessor for TraversalParams::m_fromOutsideNavMeshDistance.
Call this method after BindToDatabase(), during which TraversalParams::m_fromOutsideNavMeshDistance is set to its default value.
|
inline |
Write accessor for TraversalParams::m_numberOfVisitedNodePerFrame.
Call this method after BindToDatabase(), during which TraversalParams::m_numberOfVisitedNodePerFrame is set to its default value.
|
inline |
Write accessor for TraversalParams::m_positionSpatializationRange.
Call this method after BindToDatabase(), during which TraversalParams::m_positionSpatializationRange is set to its default value.
|
inline |
Write accessor for m_propagationBoxExtent.
Call this method after BindToDatabase(), during which m_propagationBoxExtent is set to its default value.
|
inline |
Optional NavGraph edge you want the start position must be considered to lie on.
If specified, we won't try to project the startPosition in the NavMesh and the path, if found, will start on this NavGraphEdge.
Call this method after Initialize(), during which it is cleared.
|
inline |
Optional NavGraph Vertex you want the start position must be considered to be on.
If specified, we won't try to project the startPosition in the NavMesh and the path, if found, will start on this navGraphVertex.
Call this method after Initialize(), during which it is cleared.
|
inline |
The NavMesh triangle that corresponds to m_startPos3f.
If a valid NavTrianglePtr is specified, this value will be used.
If no value is specified, it will be automatically computed during the query. Call this method after Initialize(), during which it is cleared.
|
inline |
Write accessor for TraversalParams::m_toOutsideNavMeshDistance.
Call this method after BindToDatabase(), during which TraversalParams::m_toOutsideNavMeshDistance is set to its default value.
|
inlineinherited |
Should be set for queries templated by a traverse logic, useless otherwise.
|
inline |
Write accessor for m_tryCanGoMode.
Call this method after BindToDatabase(), during which m_tryCanGoMode is set to its default value.
|
protectedinherited |
The Abstract Path found by the query.
|
inherited |
The parameter set specific to Channels computation.
|
inherited |
The mode toggling Channels computation.
|
inherited |
The database on which the query will be performed. Set in Initialize(), do not directly modify.
|
inherited |
|
protectedinherited |
if m_destPos3f is slightly outside and we hook on the NavMesh, it is the computed inside pos, else it is equal to m_destPos3f.
|
protectedinherited |
The destination point for the path request.
|
protectedinherited |
The NavMesh triangle that corresponds to m_destPos3f.
If a valid NavTrianglePtr is specified, this value will be used.
If no value is specified, it will be automatically computed during the query.
As an input AND output parameter, this member is cleared during the Setup of the Query and should therefore be specified
|
inherited |
Used by the QueryQueue. Do not modify.
|
protectedinherited |
Whether we should pathfind on that edge both ways or not.
|
inherited |
|
inherited |
Modified by the query within Advance().
Do not modify.
Before reading m_processStatus, always ensure IsInAQueryQueue() returns false.
|
protectedinherited |
the propagation is limited to a 2d oriented bounding box computed by inflating the segment going from startPos to destPos by this value
|
inherited |
Updated by the QueryQueue. Do not modify.
|
protectedinherited |
Updated during processing to indicate the result of the PathFinderQueryResult query.
|
protectedinherited |
if m_startPos3f is slightly outside and we hook on the NavMesh, it is the computed inside pos, else it is equal to m_startPos3f.
|
protectedinherited |
When this NavGraph edge is valid, that means that you want the path to start with that edge.
|
protectedinherited |
When this NavGraph vertex is valid, that means that you want the path to start at that vertice.
|
protectedinherited |
The NavMesh triangle that corresponds to m_startPos3f.
If a valid NavTrianglePtr is specified, this value will be used.
If no value is specified, it will be automatically computed during the query.
As an input AND output parameter, this member is cleared during the Setup of the Query and should therefore be specified
|
inherited |
This userData is typically passed by the Bot.