knavagent.h

Go to the documentation of this file.

 
#ifndef KNAVAGENT_H
#define KNAVAGENT_H
 
#include "kexport.h"
#include "kdatatype.h"
 
namespace kemena
{
    // -------------------------------------------------------------------------
    // Agent configuration
    // -------------------------------------------------------------------------

    struct kNavAgentConfig
    {
        float radius            = 0.6f;   
        float height            = 2.0f;   
        float maxAcceleration   = 8.0f;   
        float maxSpeed          = 3.5f;   

        float pathOptRange      = 30.0f;

        float separationWeight  = 2.0f;

        bool  anticipateTurns   = true;
        bool  optimizeVis       = true;   
        bool  optimizeTopo      = true;   
        bool  obstacleAvoidance = true;   
        bool  separation        = false;  
    };
 
    // -------------------------------------------------------------------------
    // kNavAgent
    // -------------------------------------------------------------------------

    class KEMENA3D_API kNavAgent
    {
    public:
        kNavAgent();

        ~kNavAgent();
 
        // --- Target ----------------------------------------------------------

        bool setTarget(const kVec3 &target);

        void stop();
 
        // --- Query -----------------------------------------------------------

        kVec3 getPosition() const;

        kVec3 getVelocity() const;

        bool  isMoving() const;

        bool  isValid() const;
 
        // --- Runtime parameter overrides ------------------------------------

        void  setMaxSpeed(float speed);

        void  setMaxAcceleration(float accel);

        float getMaxSpeed()        const;

        float getMaxAcceleration() const;
 
        // --- Internal (used by kNavManager) ----------------------------------

        bool init(void *crowd, void *navMeshQuery,
                  const kVec3 &position, const kNavAgentConfig &config);

        void uninit();

        int getAgentIndex() const;
 
    protected:
    private:
        struct Impl;
        Impl *m_impl;
    };
 
} // namespace kemena
 
#endif // KNAVAGENT_H