kphysicsobject.h

Go to the documentation of this file.

 
#ifndef KPHYSICSOBJECT_H
#define KPHYSICSOBJECT_H
 
#include "kexport.h"
#include "kdatatype.h"
 
#include <cstdint>
#include <vector>
 
namespace kemena
{
    // -------------------------------------------------------------------------
    // Shape descriptor
    // -------------------------------------------------------------------------

    enum class kPhysicsShapeType
    {
        Sphere,     
        Box,        
        Capsule,    
        Cylinder,   
        ConvexHull, 
        Mesh,       
        Plane,      
    };

    struct kPhysicsShapeDesc
    {
        kPhysicsShapeType     type        = kPhysicsShapeType::Box;
        kVec3                 halfExtents = kVec3(0.5f, 0.5f, 0.5f); 
        float                 radius      = 0.5f;                   
        float                 height      = 1.0f;                   
        kVec3                 customScale = kVec3(1.0f, 1.0f, 1.0f);
        std::vector<kVec3>    meshVertices;                         
        std::vector<uint32_t> meshIndices;                          
    };
 
    // -------------------------------------------------------------------------
    // Object type (motion mode)
    // -------------------------------------------------------------------------

    enum class kPhysicsObjectType
    {
        Dynamic,   
        Static,    
        Kinematic, 
        Trigger,   
    };
 
    // -------------------------------------------------------------------------
    // Creation descriptor
    // -------------------------------------------------------------------------

    struct kPhysicsObjectDesc
    {
        kPhysicsShapeDesc  shape;
        kPhysicsObjectType type          = kPhysicsObjectType::Dynamic;
        kVec3              position      = kVec3(0.0f, 0.0f, 0.0f);
        kQuat              rotation      = kQuat(1.0f, 0.0f, 0.0f, 0.0f); 
        float              mass          = 1.0f;   
        float              friction      = 0.5f;   
        float              restitution   = 0.0f;   
        float              linearDamping  = 0.05f; 
        float              angularDamping = 0.05f; 
        float              gravityFactor  = 1.0f;  
    };
 
    // -------------------------------------------------------------------------
    // kPhysicsObject
    // -------------------------------------------------------------------------

    class KEMENA3D_API kPhysicsObject
    {
    public:
        kPhysicsObject();
        ~kPhysicsObject();
 
        // --- Transform -------------------------------------------------------

        void setPosition(const kVec3 &position);

        void setRotation(const kQuat &rotation);

        kVec3 getPosition() const;

        kQuat getRotation() const;
 
        // --- Velocity --------------------------------------------------------

        void setLinearVelocity(const kVec3 &velocity);

        void setAngularVelocity(const kVec3 &velocity);

        kVec3 getLinearVelocity() const;

        kVec3 getAngularVelocity() const;
 
        // --- Forces ----------------------------------------------------------

        void applyForce(const kVec3 &force);

        void applyImpulse(const kVec3 &impulse);

        void applyTorque(const kVec3 &torque);
 
        // --- Properties ------------------------------------------------------

        void setMass(float mass);

        void setFriction(float friction);

        void setRestitution(float restitution);

        void setLinearDamping(float damping);

        void setAngularDamping(float damping);

        void setGravityFactor(float factor);
 
        // --- State queries ---------------------------------------------------

        bool isActive() const;

        kPhysicsObjectType getObjectType() const;

        kPhysicsShapeType getShapeType() const;
 
        // --- Internal (kPhysicsManager only) ---------------------------------

        bool init(void *physicsSystem, const kPhysicsObjectDesc &desc);

        void uninit();

        uint32_t getBodyId() const;
 
    protected:
    private:
        struct Impl;
        Impl *m_impl;
    };
 
} // namespace kemena
 
#endif // KPHYSICSOBJECT_H