hkaSampleAndCombineUtils.h
上传用户:yisoukefu
上传日期:2020-08-09
资源大小:39506k
文件大小:6k
源码类别:

其他游戏

开发平台:

Visual C++

  1. /* 
  2.  * 
  3.  * Confidential Information of Telekinesys Research Limited (t/a Havok). Not for disclosure or distribution without Havok's
  4.  * prior written consent. This software contains code, techniques and know-how which is confidential and proprietary to Havok.
  5.  * Level 2 and Level 3 source code contains trade secrets of Havok. Havok Software (C) Copyright 1999-2009 Telekinesys Research Limited t/a Havok. All Rights Reserved. Use of this software is subject to the terms of an end user license agreement.
  6.  * 
  7.  */
  8. #ifndef HK_BLEND_UTILS_H
  9. #define HK_BLEND_UTILS_H
  10. #include <Common/Base/hkBase.h>
  11. /// Utility class for hkaAnimatedSkeleton
  12. class hkaSampleAndCombineUtils
  13. {
  14. public:
  15. /// Utility structure for blendNormal, blendAdditive below.
  16. struct TransformBlendParameters
  17. {
  18. HK_DECLARE_NONVIRTUAL_CLASS_ALLOCATOR( HK_MEMORY_CLASS_ANIM_RUNTIME, hkaSampleAndCombineUtils::TransformBlendParameters );
  19. /// Transforms in
  20. const hkQsTransform* m_animationTransformsIn;
  21. /// Max track to blend
  22. int m_maxTransformTrackIndex;
  23. /// Total number of bones
  24. int m_numBones;
  25. /// Master weight (control weight) of all tracks to be blended in (combined with per-track weights if they exist).
  26. hkReal m_masterWeight;
  27. /// Per track weights
  28. const hkUint8* m_perBoneWeights;
  29. /// Track-to-bone mapping (usually hkaBinding::m_transformTrackToBoneIndices)
  30. const hkInt16* m_trackToBoneMapping;
  31. /// Contructor
  32. TransformBlendParameters() : m_animationTransformsIn(HK_NULL),
  33. m_maxTransformTrackIndex(-1),
  34. m_numBones(0),
  35. m_masterWeight(1.0f),
  36. m_perBoneWeights(HK_NULL),
  37. m_trackToBoneMapping(HK_NULL)
  38. {}
  39. };
  40. /// Utility structure for blendNormal, blendAdditive below.
  41. struct FloatBlendParameters
  42. {
  43. HK_DECLARE_NONVIRTUAL_CLASS_ALLOCATOR( HK_MEMORY_CLASS_ANIM_RUNTIME, hkaSampleAndCombineUtils::FloatBlendParameters );
  44. /// Floats in
  45. const hkReal* m_floatTracksIn;
  46. /// Max track to blend
  47. int m_maxFloatTrackIndex;
  48. /// Total number of float slots
  49. int m_numFloatSlots;
  50. /// Master weight (control weight) of all tracks to be blended in (combined with per-track weights if they exist).
  51. hkReal m_masterWeight;
  52. /// Per track weights
  53. const hkUint8* m_perFloatTrackWeights;
  54. /// Track-to-slot mapping (usually hkaBinding::m_floatTrackToFloatSlotIndices)
  55. const hkInt16* m_floatTrackToFloatSlotMapping;
  56. /// Contructor
  57. FloatBlendParameters() : m_floatTracksIn(HK_NULL),
  58. m_maxFloatTrackIndex(-1),
  59. m_numFloatSlots(0),
  60. m_masterWeight(1.0f),
  61. m_perFloatTrackWeights(HK_NULL),
  62. m_floatTrackToFloatSlotMapping(HK_NULL)
  63. {}
  64. };
  65. /// Blends in a multiple of a new pose to an existing pose using perBoneWeights:  P' = P + t*Q, W' = W + t
  66. /// where, for each bone 'i' in the pose: <br>
  67. /// P = accumulationPoseInOut[i] <br>
  68. /// Q = paramsIn.m_animationTransformsIn[i] <br>
  69. /// W = accumulatedPerBoneWeightsInOut[i] <br>
  70. /// t = paramsIn.m_perBoneWeights[i]/255.0f (or 1.0 if there are no per bone weights in the control) <br>
  71. /// P' = accumulationPoseInOut[i] after above modification <br>
  72. /// W' = accumulatedPerBoneWeightsInOut[i] after above modification <br>
  73. /// The final result is not a normalized pose, and should be scaled by the wieghts array W' before use.
  74. static void HK_CALL blendNormal(TransformBlendParameters& paramsIn, hkQsTransform* accumulationPoseInOut, hkReal* accumulatedPerBoneWeightsInOut );
  75. /// Blends a new pose to an existing pose: P' = (1-t)*P + t*Q*P
  76. /// where: <br>
  77. /// P = accumulationPoseInOut[i] <br>
  78. /// Q = paramsIn.m_animationTransformsIn[i] <br>
  79. /// t = paramsIn.m_perBoneWeights[i]/255.0f (or 1.0 if there are no per bone weights in the control) <br>
  80. /// P' = accumulationPoseInOut[i] after above modification <br>
  81. /// The final pose is a normalized pose.
  82. static void HK_CALL blendAdditive(TransformBlendParameters& paramsIn, hkQsTransform* accumulationPoseInOut);
  83. /// Blends in a multiple of the float tracks to an existing set of slots using perFloatTrackWeights: P' = P + t*Q, W' = W + t
  84. /// where, for each bone 'i' in the pose: <br>
  85. /// P = accumulationPoseInOut[i] <br>
  86. /// Q = paramsIn.m_animationTransformsIn[i] <br>
  87. /// W = accumulatedPerBoneWeightsInOut[i] <br>
  88. /// t = paramsIn.m_perBoneWeights[i]/255.0f (or 1.0 if there are no per bone weights in the control) <br>
  89. /// P' = accumulationPoseInOut[i] after above modification <br>
  90. /// W' = accumulatedPerBoneWeightsInOut[i] after above modification <br>
  91. /// The final result is not a 'normalized' pose, and should be scaled by the wieghts array W' before use.
  92. static void HK_CALL blendNormalFloat(FloatBlendParameters& paramsIn, hkReal* accumulationInOut, hkReal* accumulatedWeightsInOut);
  93. /// Finds largest track index with non-zero (> HK_REAL_EPSILON) weighting.
  94. /// return The index of the index of the largest track with non-trivial weighting
  95. /// param trackToBoneMapping Array of track to bone (or slot) indices
  96. /// param perTrackWeights Array of weights for each track
  97. /// param maxBone Can ignore all tracks mapping to bone >= maxBone
  98. /// param numTracks Total number of tracks in the animation
  99. static hkUint32 HK_CALL getMaxTrackIndex(const hkInt16* trackToBoneMapping, const hkUint8* perTrackWeights, hkUint32 maxBone, hkUint32 numTracks);
  100. /// Scales the m_translation component of each given hkQsTransform.
  101. /// Useful when changing the size of a character dynamically
  102. static void HK_CALL scaleTranslations( hkReal scale, hkQsTransform* poseInOut, int numTransforms );
  103. };
  104. #endif // HK_BLEND_UTILS_H
  105. /*
  106. * Havok SDK - NO SOURCE PC DOWNLOAD, BUILD(#20090216)
  107. * Confidential Information of Havok.  (C) Copyright 1999-2009
  108. * Telekinesys Research Limited t/a Havok. All Rights Reserved. The Havok
  109. * Logo, and the Havok buzzsaw logo are trademarks of Havok.  Title, ownership
  110. * rights, and intellectual property rights in the Havok software remain in
  111. * Havok and/or its suppliers.
  112. * Use of this software for evaluation purposes is subject to and indicates
  113. * acceptance of the End User licence Agreement for this product. A copy of
  114. * the license is included with this software and is also available at www.havok.com/tryhavok.
  115. */