NoiseFloor 发表于 2021-3-24 19:01

Unreal动画实时重定向的源码分析

基本原理


每个动画(AnimSequence)要指定一个重定向源(RetargetSource),然后实时的时候根据重定向源的TPose和当前角色的TPose进行重定向的计算。

实时重定向的计算方法又分为五种: Animation, Skeleton, AnimationScale, AnimationRelative, OrientAndScale

骨骼重定向方法的设置粒度是骨骼级别,具体使用方法参见官方文档

官方文档:
https://docs.unrealengine.com/en-US/Engine/Animation/AnimationRetargeting/index.html

我印象中的常用操作,通常有问题都是用以下操作解决:

某个动画重定向结果不对:在动画编辑器里指定下重定向源

某根骨骼的效果结果不对:在骨骼树窗口里更改此骨骼的重定向设置

新角色的动画,需要在最大化骨架编辑器里新增一下新角色的重定向源

双手武器重定向后,挂接效果不对。这时候可能就需要ik了,ik和重定向是一个搭档。
实时重定向源码


UE中获取任何的骨骼动画数据,都会调用 UAnimSequence::GetBonePose

GetBonePose就像古代的关隘,连接动画逻辑(动画树、Montage等)与动画数据
压缩动画的重定向


压缩动画的重定向核心代码就直接在GetBonePose函数的末尾

由于压缩动画重定向和非压缩动画的重定向的原理是一样的,只是读取动画数据的方式不同,所以重定向源码分析放到下节
非压缩动画的重定向


GetBonePose函数并没有直接处理非压缩动画的重定向,而是通过如下调用栈:

BuildPoseFromRawData -> RetargetBoneTransform -> FAnimationRuntime::RetargetBoneTransform

所以非压缩动画的重定向核心逻辑如下
void FAnimationRuntime::RetargetBoneTransform(const USkeleton* MySkeleton, const FName& RetargetSource, FTransform& BoneTransform, const int32 SkeletonBoneIndex, const FCompactPoseBoneIndex& BoneIndex, const FBoneContainer& RequiredBones, const bool bIsBakedAdditive){    if (MySkeleton)    {      switch (MySkeleton->GetBoneTranslationRetargetingMode(SkeletonBoneIndex))      {            case EBoneTranslationRetargetingMode::AnimationScaled:            {                // @todo - precache that in FBoneContainer when we have SkeletonIndex->TrackIndex mapping. So we can just apply scale right away.                const TArray<FTransform>& SkeletonRefPoseArray = MySkeleton->GetRefLocalPoses(RetargetSource);                const float SourceTranslationLength = SkeletonRefPoseArray.GetTranslation().Size();                if (SourceTranslationLength > KINDA_SMALL_NUMBER)                {                  const float TargetTranslationLength = RequiredBones.GetRefPoseTransform(BoneIndex).GetTranslation().Size();                  BoneTransform.ScaleTranslation(TargetTranslationLength / SourceTranslationLength);                }                break;            }            case EBoneTranslationRetargetingMode::Skeleton:            {                BoneTransform.SetTranslation(bIsBakedAdditive ? FVector::ZeroVector : RequiredBones.GetRefPoseTransform(BoneIndex).GetTranslation());                break;            }            case EBoneTranslationRetargetingMode::AnimationRelative:            {                // With baked additive animations, Animation Relative delta gets canceled out, so we can skip it.                // (A1 + Rel) - (A2 + Rel) = A1 - A2.                if (!bIsBakedAdditive)                {                  const TArray<FTransform>& AuthoredOnRefSkeleton = MySkeleton->GetRefLocalPoses(RetargetSource);                  const TArray<FTransform>& PlayingOnRefSkeleton = RequiredBones.GetRefPoseCompactArray();                  const FTransform& RefPoseTransform = RequiredBones.GetRefPoseTransform(BoneIndex);                  // Apply the retargeting as if it were an additive difference between the current skeleton and the retarget skeleton.                     BoneTransform.SetRotation(BoneTransform.GetRotation() * AuthoredOnRefSkeleton.GetRotation().Inverse() * RefPoseTransform.GetRotation());                  BoneTransform.SetTranslation(BoneTransform.GetTranslation() + (RefPoseTransform.GetTranslation() - AuthoredOnRefSkeleton.GetTranslation()));                  BoneTransform.SetScale3D(BoneTransform.GetScale3D() * (RefPoseTransform.GetScale3D() * AuthoredOnRefSkeleton.GetSafeScaleReciprocal(AuthoredOnRefSkeleton.GetScale3D())));                  BoneTransform.NormalizeRotation();                }                break;            }            case EBoneTranslationRetargetingMode::OrientAndScale:            {                if (!bIsBakedAdditive)                {                  const FRetargetSourceCachedData& RetargetSourceCachedData = RequiredBones.GetRetargetSourceCachedData(RetargetSource);                  const TArray<FOrientAndScaleRetargetingCachedData>& OrientAndScaleDataArray = RetargetSourceCachedData.OrientAndScaleData;                  const TArray<int32>& CompactPoseIndexToOrientAndScaleIndex = RetargetSourceCachedData.CompactPoseIndexToOrientAndScaleIndex;                  // If we have any cached retargeting data.                  if ((OrientAndScaleDataArray.Num() > 0) && (CompactPoseIndexToOrientAndScaleIndex.Num() == RequiredBones.GetCompactPoseNumBones()))                  {                        const int32 OrientAndScaleIndex = CompactPoseIndexToOrientAndScaleIndex;                        if (OrientAndScaleIndex != INDEX_NONE)                        {                            const FOrientAndScaleRetargetingCachedData& OrientAndScaleData = OrientAndScaleDataArray;                            const FVector AnimatedTranslation = BoneTransform.GetTranslation();                            // If Translation is not animated, we can just copy the TargetTranslation. No retargeting needs to be done.                            const FVector NewTranslation = (AnimatedTranslation - OrientAndScaleData.SourceTranslation).IsNearlyZero(BONE_TRANS_RT_ORIENT_AND_SCALE_PRECISION) ?                              OrientAndScaleData.TargetTranslation :                              OrientAndScaleData.TranslationDeltaOrient.RotateVector(AnimatedTranslation) * OrientAndScaleData.TranslationScale;                            BoneTransform.SetTranslation(NewTranslation);                        }                  }                }                break;            }      }    }}
这个函数只是一根骨骼的重定向计算。

当前角色的TPose就存在RequiredBones里。

重定向源的TPose都是存在最大化骨架MySkeleton中的,根据AnimSequence.RetargetSource来获取当前的重定向源数据

大部分的实时重定向的方法主要改的就是骨骼的translation,scale和rotation不会动,AnimationRelative模式例外
Animation: 纯动画,不做任何重定向Skeleton: 直接用角色TPose的translationAnimationScale: 用动画的Translation,但是会根据当前角色的TPose和RetargetSource的TPose的比例对Translation进行缩放。 和AnimationRelative相比,delta是用除法算出来的,且只改TranslationAnimationRelative: 用动画的Translation,scale,rotation,但是会根据当前角色的TPose和RetargetSource的TPose的差值对动画的prs进行增减。和AnimationScale相比,delta是用减法算出来的。OrientAndScale: 用动画的Translation,实时会根据OrientAndScaleData的信息对Translation进行变换
OrientAndScale模式下的OrientAndScaleData的计算

OrientAndScaleData.TranslationDeltaOrient是一个四元数旋转: 是从重定向源的骨骼translation(SourceSkelTransDir)到当前角色TPose的骨骼Translation(TargetSkelTransDir)的一个旋转OrientAndScaleData.TranslationScale是一个scale的除法: 当前角色TPose的骨骼Translation的长度(TargetSkelTransLength) / 重定向源的骨骼translation的长度(SourceSkelTransLength)
const FRetargetSourceCachedData& FBoneContainer::GetRetargetSourceCachedData(const FName& InRetargetSourceName) const{    FRetargetSourceCachedData* RetargetSourceCachedData = RetargetSourceCachedDataLUT.Find(InRetargetSourceName);    if (!RetargetSourceCachedData)    {      RetargetSourceCachedData = &RetargetSourceCachedDataLUT.Add(InRetargetSourceName);      // Build Cached Data for OrientAndScale retargeting.      const TArray<FTransform>& AuthoredOnRefSkeleton = AssetSkeleton->GetRefLocalPoses(InRetargetSourceName);      const TArray<FTransform>& PlayingOnRefSkeleton = GetRefPoseCompactArray();      const int32 CompactPoseNumBones = GetCompactPoseNumBones();      RetargetSourceCachedData->CompactPoseIndexToOrientAndScaleIndex.Reset();      for (int32 CompactBoneIndex = 0; CompactBoneIndex < CompactPoseNumBones; CompactBoneIndex++)      {            const int32& SkeletonBoneIndex = CompactPoseToSkeletonIndex;            if (AssetSkeleton->GetBoneTranslationRetargetingMode(SkeletonBoneIndex) == EBoneTranslationRetargetingMode::OrientAndScale)            {                const FVector SourceSkelTrans = AuthoredOnRefSkeleton.GetTranslation();                const FVector TargetSkelTrans = PlayingOnRefSkeleton.GetTranslation();                // If translations are identical, we don't need to do any retargeting                if (!SourceSkelTrans.Equals(TargetSkelTrans, BONE_TRANS_RT_ORIENT_AND_SCALE_PRECISION))                {                  const float SourceSkelTransLength = SourceSkelTrans.Size();                  const float TargetSkelTransLength = TargetSkelTrans.Size();                  // this only works on non zero vectors.                  if (!FMath::IsNearlyZero(SourceSkelTransLength * TargetSkelTransLength))                  {                        const FVector SourceSkelTransDir = SourceSkelTrans / SourceSkelTransLength;                        const FVector TargetSkelTransDir = TargetSkelTrans / TargetSkelTransLength;                        const FQuat DeltaRotation = FQuat::FindBetweenNormals(SourceSkelTransDir, TargetSkelTransDir);                        const float Scale = TargetSkelTransLength / SourceSkelTransLength;                        const int32 OrientAndScaleIndex = RetargetSourceCachedData->OrientAndScaleData.Add(FOrientAndScaleRetargetingCachedData(DeltaRotation, Scale, SourceSkelTrans, TargetSkelTrans));                        // initialize CompactPoseBoneIndex to OrientAndScale Index LUT on demand                        if (RetargetSourceCachedData->CompactPoseIndexToOrientAndScaleIndex.Num() == 0)                        {                            RetargetSourceCachedData->CompactPoseIndexToOrientAndScaleIndex.Init(INDEX_NONE, CompactPoseNumBones);                        }                        RetargetSourceCachedData->CompactPoseIndexToOrientAndScaleIndex = OrientAndScaleIndex;                  }                }            }      }    }    return *RetargetSourceCachedData;}
页: [1]
查看完整版本: Unreal动画实时重定向的源码分析