AnimSkin.h

浏览该文件的文档.

#pragma once
 
#include "animation/AnimMath.h"
 
#include <string>
#include <vector>
 
namespace eve::model3d {
class ModelData;
}
 
namespace eve::animation {
 
class AnimSkeleton;
class AnimPose;
 
class AnimSkin {
public:
    static constexpr int kMaxInfluences = 4;
 
    AnimSkin() = default;
    ~AnimSkin() = default;
 
    AnimSkin(const AnimSkin &)            = delete;
    AnimSkin &operator=(const AnimSkin &) = delete;
 
    static AnimSkin *fromModel(const model3d::ModelData *model, int meshIndex,
                               const AnimSkeleton *skeleton);
 
    int getVertexCount() const { return vertexCount_; }
    int getBoneCount() const { return static_cast<int>(skeletonBone_.size()); }
    int getInfluenceCount() const { return kMaxInfluences; }
 
    int getSkeletonBone(int skinBoneIndex) const;
    std::string getSkinBoneName(int skinBoneIndex) const;
 
    float getInverseBindElement(int skinBoneIndex, int elementIndex) const;
 
    void skinPositions(const AnimPose *pose, float *outPosXYZ) const;
 
    bool skinPositionsTo(const AnimPose *pose, std::vector<float> &outPosXYZ) const;
 
    bool updateSkinnedPositions(const AnimPose *pose);
 
    bool hasSkinnedPositions() const { return skinnedValid_; }
 
    float getSkinnedPositionX(int vertexIndex) const;
    float getSkinnedPositionY(int vertexIndex) const;
    float getSkinnedPositionZ(int vertexIndex) const;
 
    float getBindPositionX(int vertexIndex) const;
    float getBindPositionY(int vertexIndex) const;
    float getBindPositionZ(int vertexIndex) const;
 
    int   getVertexBone(int vertexIndex, int influenceIndex) const;
    float getVertexWeight(int vertexIndex, int influenceIndex) const;
 
private:
    struct Influence {
        int   bone   = -1;  // index into skeletonBone_ / inverseBind_
        float weight = 0.f;
    };
 
    void requireVertex(int vertexIndex) const;
    void requireSkinBone(int skinBoneIndex) const;
 
    int                      vertexCount_ = 0;
    std::vector<float>       bindPos_;       // xyz packed
    std::vector<Influence>   influences_;    // vertexCount_ * kMaxInfluences
    std::vector<int>         skeletonBone_;  // skin joint → skeleton bone
    std::vector<std::string> skinBoneNames_;
    std::vector<Mat4>        inverseBind_;
    std::vector<float>       skinnedPos_;    // xyz packed cache
    bool                     skinnedValid_ = false;
};
 
}  // namespace eve::animation