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 "ecs/components/GripPose.hpp"
#include "ecs/components/WeaponHoldPose.hpp"
 
#include <array>
#include <glm/glm.hpp>
#include <glm/gtc/quaternion.hpp>
#include <memory>
#include <vector>

struct AnimationInputs
{
    glm::vec3 velocityWorld{0.0f};    
    float yawRad = 0.0f;              
    float pitchRad = 0.0f;            
    float spineBendMultiplier = 1.0f; 
    float hipLeanMultiplier = 0.0f;   
    float dtSec =
        0.0f; 
    bool grounded = false;  
    bool sprinting = false; 
    bool crouching = false; 
    int moveMode = 0;       
    int wallRunSide = 0;    
    int emoteClip = static_cast<int>(ClipId::_Count);
};

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;        
};

static constexpr size_t kHandFingerIkCount = 5;

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;

    void applyWeaponHoldPose(const WeaponHoldPose& pose, float weight);

    void updateSkinMatrices();

    void applyRecoilImpulse(float strengthRad);

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

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

    void setFrozen(bool frozen) 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_;
};

[[nodiscard]] float computeIdleGroundedMinY(const CharacterRig& rig, const AnimationLibrary& library,
                                            const glm::quat& orientationFix, float bindMeshMinY);