ProceduralBoneConfig.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
#include "common/Result.h"
#include "common/Value.h"
 
#include <cstdint>
#include <string>
#include <string_view>
#include <vector>
 
namespace eve::animation {
class AnimSkeleton;
class DynamicBoneSolver;
class FootIKSolver;
 
struct DynamicBoneParticleConfig {
    float stiffness=0.5f,damping=0.7f,inertia=0.9f,gravityScale=1.f,radius=0.f;
};
 
struct DynamicBoneChainConfig {
    std::string rootBone,endBone;
    float stiffness=0.5f,damping=0.7f,inertia=0.9f,gravityScale=1.f,radius=0.f;
    int iterations=4,freezeAxis=0,endMode=0;
    bool selfCollision=false;
    float endLength=0.f,endX=0.f,endY=0.f,endZ=0.f;
    std::vector<DynamicBoneParticleConfig> particles;
};
 
struct DynamicBoneColliderConfig {
    std::string bone;
    float startX=0.f,startY=0.f,startZ=0.f,endX=0.f,endY=0.f,endZ=0.f,radius=0.f;
    bool capsule=false,inside=false,enabled=true;
};
 
struct FootIKLegConfig {
    std::string hip,knee,foot,toe;
    float soleOffset=0.f,toeSoleOffset=0.f;
};
 
struct FootIKConfig {
    bool enabled=false,footLockEnabled=false;
    std::string pelvisBone;
    FootIKLegConfig left,right;
    float maxPelvisOffset=0.35f,minGroundNormalY=0.35f,positionResponse=18.f,rotationResponse=14.f;
    float groundStartHeight=0.5f,groundQueryDistance=1.5f,contactGraceTime=0.08f;
    float lockEnterWeight=0.8f,lockExitWeight=0.2f;
};
 
struct EVENGINE_API_WORLD DynamicBoneConfig {
    static constexpr std::string_view SchemaId="eve.dynamic-bone";
    static constexpr std::uint32_t SchemaVersion=1;
 
    float gravityX=0.f,gravityY=-9.8f,gravityZ=0.f;
    float externalX=0.f,externalY=0.f,externalZ=0.f;
    float weight=1.f,updateRate=60.f,teleportThreshold=2.f,objectMoveResponse=1.f,distanceLimit=0.f;
    std::vector<DynamicBoneChainConfig> chains;
    std::vector<DynamicBoneColliderConfig> colliders;
    FootIKConfig footIK;
    Value::Object unknownFields;
 
    [[nodiscard]] Result<void> validate() const;
    [[nodiscard]] Result<Value> toValue() const;
    [[nodiscard]] static Result<DynamicBoneConfig> fromValue(const Value& value);
    [[nodiscard]] Result<void> apply(AnimSkeleton& skeleton,DynamicBoneSolver& solver) const;
    [[nodiscard]] Result<void> apply(AnimSkeleton& skeleton,DynamicBoneSolver& dynamicSolver,FootIKSolver& footSolver) const;
};
}