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,
    GrappleActive = 1u << 5,
    DoubleJumped = 1u << 6,
    GravityFlipped = 1u << 7,
    DepenCancelled = 1u << 8,
    DeepPenetration = 1u << 9,
    BumpExhausted = 1u << 10,
    SuspectedPhase = 1u << 11,
    InvalidState = 1u << 12,
    WallrunBlocked = 1u << 13,
    WallrunCeilingConstrained = 1u << 14,
    KccOscillationResolved = 1u << 15,
};
 
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 setFilePrefix(std::string_view prefix);

void startRecording();

void stopRecording();

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

void recordFrame(const PlayerFrame& frame) noexcept;

struct MovementFrame
{
    entt::entity entity{entt::null};
    glm::vec3 posBefore{0.0f};
    glm::vec3 posAfter{0.0f};
    glm::vec3 velBefore{0.0f};
    glm::vec3 velAfter{0.0f};
    int modeBefore = 0;
    int modeAfter = 0;
    bool groundedBefore = false;
    bool groundedAfter = false;
    bool inputForward = false;
    bool inputBack = false;
    bool inputLeft = false;
    bool inputRight = false;
    bool inputJump = false;
    bool inputCrouch = false;
    bool inputGrapple = false;
    float yaw = 0.0f;
    float pitch = 0.0f;
    bool wallFront = false;
    float groundDistance = 1e30f;
    glm::vec3 frontNormal{0.0f};
    glm::vec3 frontPoint{0.0f};
    PhaseFlag flags = PhaseFlag::None;
    char note[64] = {0};
};

void recordMovementFrame(const MovementFrame& frame) noexcept;

struct KccTimingFrame
{
    entt::entity entity{entt::null};
    uint64_t elapsedUs = 0;
    int substeps = 0;
    int caIterations = 0;
    int clearanceQueries = 0;
    int sweepQueries = 0;
    int sweepHits = 0;
    bool usedWalkCapsule = false;
    bool caExhausted = false;
    bool grounded = false;
    int moveMode = 0;
};

void recordKccTimingFrame(const KccTimingFrame& 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