CharacterAnimator.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "AnimationLibrary.hpp"
#include "CharacterRig.hpp"
#include "SkinningBackend.hpp"
#include "ecs/components/AnimSnapshot.hpp"
 
#include <array>
#include <glm/glm.hpp>
#include <memory>
#include <vector>

struct AnimationInputs
{
    glm::vec3 velocityWorld{0.0f}; 
    float yawRad = 0.0f;           
    float pitchRad = 0.0f;         
    bool grounded = false;         
    bool sprinting = false;        
    bool crouching = false;        
    int moveMode = 0;              
    int wallRunSide = 0;           
};

static constexpr size_t kNumSamplerSlots = 5;

struct ClipSampler
{
    ClipId id = ClipId::Idle;   
    float timeRatio = 0.0f;     
    float playbackSpeed = 1.0f; 
    float weight = 0.0f;        
    bool active = false;        
};

class CharacterAnimator
{
public:
    CharacterAnimator(const CharacterRig& rig, const AnimationLibrary& library);
    ~CharacterAnimator();
    CharacterAnimator(const CharacterAnimator&) = delete;
    CharacterAnimator& operator=(const CharacterAnimator&) = delete;
    CharacterAnimator(CharacterAnimator&&) noexcept = delete;
    CharacterAnimator& operator=(CharacterAnimator&&) noexcept = delete;

    void setSkinningBackend(const ISkinningBackend* backend);

    void update(const AnimationInputs& inputs, float dt);

    void renderFromServer(const AnimSnapshot& serverState, const AnimationInputs& inputs);

    void computeSkinnedVertices(std::vector<std::vector<ModelVertex>>& out) const;

    void setDebugOverride(ClipId id, bool loop = true);

    [[nodiscard]] ClipId debugOverride() const noexcept;

    [[nodiscard]] const std::array<ClipSampler, kNumSamplerSlots>& samplers() const noexcept;

    void setDebugPlaybackSpeed(float mul) noexcept;

    [[nodiscard]] int numJoints() const noexcept;

    [[nodiscard]] const std::vector<glm::mat4>& jointModelMatrices() const noexcept;

    [[nodiscard]] const std::vector<glm::mat4>& skinMatrices() const noexcept;
 
private:
    void runSamplingAndSkinning(const AnimationInputs& inputs);
 
    struct Impl;
    std::unique_ptr<Impl> impl_;
};