Interface iQueryCallBack

Description

The client application creates objects deriving from this interface to pass into query methods such as iMesh::findShortestPath_WithQueryCallBack(), to enable the query to be aborted early.

PathEngine will call back to the abort() method periodically during the search.
If this abort() method returns true at any point then the search will be aborted and the best path found so far returned.

The desiredCallBackFrequency() method is called once at the start of each query, to determine how often the abort() method should be polled.

Refer to Aborting Pathfinding Early for more details about using the query callback mechanism.

Defined in SDKRoot/code/externalAPI/i_pathengine.h.

class iQueryCallBack
{
public:
    virtual ~iQueryCallBack()
    {
    }
    virtual int32_t desiredCallBackFrequency() = 0;
    virtual bool abort() = 0;
};
        

The virtual destructor is included just for good general programming practice.
Destruction remains the responsibility of the client application - PathEngine will not call this virtual destructor.

Methods: