EntityInterpolation.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "ecs/components/InterpolationBuffer.hpp" // NOLINT(misc-include-cleaner) — surfaced as part of the API contract for debug-UI consumers.
 
#include <SDL3/SDL_stdinc.h>
 
#include <entt/entity/fwd.hpp>
#include <glm/vec3.hpp>
 
namespace entity_interpolation
{

struct InterpolatedTransform
{
    glm::vec3 position{0.0f}; 
    glm::vec3 velocity{0.0f}; 
    float yaw = 0.0f;         
    float pitch = 0.0f;       
 
    // Discrete animator inputs — older-bracketing-sample, not lerped.
    std::uint8_t moveMode = 0;    
    std::uint8_t wallRunSide = 0; 
    bool grounded = false;        
    bool sprinting = false;       
    bool crouching = false;       

    AnimSnapshot anim{};
 
    bool fromBuffer = false; 
};

struct SampleInputs
{
    glm::vec3 position{0.0f};
    glm::vec3 velocity{0.0f};
    float yaw = 0.0f;
    float pitch = 0.0f;
    std::uint8_t moveMode = 0;
    std::uint8_t wallRunSide = 0;
    bool grounded = false;
    bool sprinting = false;
    bool crouching = false;

    AnimSnapshot anim{};
};

void appendSample(entt::registry& registry, entt::entity e, Uint64 captureNs, const SampleInputs& inputs);

InterpolatedTransform sample(const entt::registry& registry,
                             entt::entity e,
                             Uint64 renderTimeNs,
                             const glm::vec3& fallbackPos,
                             float fallbackYaw);
 
} // namespace entity_interpolation