PhaseDiagnostic.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <cstdint>
#include <entt/entt.hpp>
#include <glm/vec3.hpp>
#include <string_view>
 
namespace physics::diag
{

enum class PhaseFlag : uint32_t
{
    None = 0,
    Grounded = 1u << 0,
    WallRunning = 1u << 1,
    Sliding = 1u << 2,
    Climbing = 1u << 3,
    LedgeGrabbing = 1u << 4,
    GrappleActive = 1u << 5,
    DoubleJumped = 1u << 6,
    GravityFlipped = 1u << 7,
    DepenCancelled = 1u << 8,
    DeepPenetration = 1u << 9,
    BumpExhausted = 1u << 10,
    SuspectedPhase = 1u << 11,
};
 
inline PhaseFlag operator|(PhaseFlag a, PhaseFlag b) noexcept
{
    return static_cast<PhaseFlag>(static_cast<uint32_t>(a) | static_cast<uint32_t>(b));
}
inline PhaseFlag& operator|=(PhaseFlag& a, PhaseFlag b) noexcept
{
    a = a | b;
    return a;
}
inline bool any(PhaseFlag a) noexcept
{
    return static_cast<uint32_t>(a) != 0u;
}

struct PlayerFrame
{
    uint64_t tick = 0;
    entt::entity entity{entt::null};
    glm::vec3 posBefore{0.0f};       
    glm::vec3 posAfterDepen{0.0f};   
    glm::vec3 posAfter{0.0f};        
    glm::vec3 velBefore{0.0f};       
    glm::vec3 velAfter{0.0f};        
    glm::vec3 lastHitNormal{0.0f};   
    float depenPushDistance = 0.0f;  
    int bumpHits = 0;                
    int moveMode = 0;                
    int wallrunSide = 0;             
    int jumpCount = 0;
    PhaseFlag flags = PhaseFlag::None;
    char note[48] = {0};             
};

void setEnabled(bool on) noexcept;
[[nodiscard]] bool isEnabled() noexcept;

void recordFrame(const PlayerFrame& frame) noexcept;

void annotate(entt::entity entity, std::string_view label) noexcept;

void consumeAnnotation(entt::entity entity, char (&out)[48]) noexcept;

struct DepenContact
{
    uint32_t triId = 0;
    glm::vec3 playerPos{0.0f};   
    glm::vec3 faceNormal{0.0f};  
    glm::vec3 v0{0.0f};
    glm::vec3 v1{0.0f};
    glm::vec3 v2{0.0f};
    float signedDist = 0.0f;     
    float minkowskiR = 0.0f;     
    float depth = 0.0f;          
    int region = 0;              
    uint8_t edgeFlags = 0;       
    uint8_t vertFlags = 0;       
};

void recordDepenContact(const DepenContact& contact) noexcept;
 
} // namespace physics::diag