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

其他游戏

开发平台:

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_SKELETON_MAPPER_H
  9. #define HK_SKELETON_MAPPER_H
  10. #include <Common/Base/hkBase.h>
  11. #include <Animation/Animation/Mapper/hkaSkeletonMapperData.h>
  12. class hkaPose;
  13. extern const hkClass hkaSkeletonMapperClass;
  14. /// This run-time class converts a pose from one skeleton (A) to another (B). The poses can be specified by either hkaPose objects or arrays of transforms.
  15. /// It uses mapping data (hkaSkeletonMapperData), which can be created using the hkaSkeletonMapperUtils utility class.
  16. class hkaSkeletonMapper : public hkReferencedObject
  17. {
  18. public:
  19. HK_DECLARE_CLASS_ALLOCATOR( HK_MEMORY_CLASS_ANIM_RIG );
  20. HK_DECLARE_REFLECTION();
  21. /// Constructor - Takes mapping data as a parameter; this data can be created using the hkaSkeletonMapperUtils class.
  22. hkaSkeletonMapper( const hkaSkeletonMapperData& mapping );
  23. /// Destructor
  24. virtual ~hkaSkeletonMapper();
  25. /// Constraints source.
  26. enum ConstraintSource
  27. {
  28. /// No constraints
  29. NO_CONSTRAINTS,
  30. /// Reference pose
  31. REFERENCE_POSE,
  32. /// Current pose
  33. CURRENT_POSE
  34. };
  35. /// Maps a pose from an skeleton to another.
  36. /// param poseAModelSpace      The poseA in model space. The number of elements must be equal to mapping.m_skeletonA->m_numBones
  37. /// param originalPoseBLocalSpace
  38. ///                             The poseB in local space. The number of elements must be equal to mapping.m_skeletonB->m_numBones.
  39. /// This pose is used as an additional input to calculate output bones which do
  40. /// not map simply to an input bone 
  41. /// like bones in the middle of a chain or unmapped bones.
  42. /// param poseBModelSpaceInOut The output pose. The number of elements must be equal to mapping.m_skeletonB->m_numBones.
  43. ///                             Typically for all mapped bones, this array is a simply output parameter. For unmapped bones
  44. /// (especially the root bone), the output may be untouched
  45. /// param source Chooses between no adjustment, using the reference pose or the current pose when adjusting bone lengths. Usually the current pose is the best choice.
  46. void HK_CALL mapPose(const hkQsTransform* poseAModelSpace, const hkQsTransform* originalPoseBLocalSpace, hkQsTransform* poseBModelSpaceInOut, ConstraintSource source ) const;
  47. /// Maps a pose from an skeleton to another, using hkaPose objects.
  48. /// param poseAIn The input pose. The skeleton of poseAIn should be the same skeleton as m_mapping.m_skeletonA
  49. /// param poseBInOut The output pose. This pose should be initialized, as the transform of some of the bones in B may be used.
  50. /// The skeleton of poseBInOut should be the same skeleton as in m_mapping.m_skeletonB
  51. /// param source Chooses between no adjustment, using the reference pose or the current pose when adjusting bone lengths. Usually the current pose is the best choice.
  52. void HK_CALL mapPose(const hkaPose& poseAIn, hkaPose& poseBInOut, ConstraintSource source ) const;
  53. public:
  54. /// The mapping data
  55. class hkaSkeletonMapperData m_mapping;
  56. public:
  57. /// For DEBUG builds only - Checks the mapping data and generates HK_WARN errors for troublesome mappings; called by the constructor in DEBUG.
  58. static void HK_CALL checkMapping(const hkaSkeletonMapperData& mapping);
  59. public:
  60. hkaSkeletonMapper( hkFinishLoadedObjectFlag f ) : hkReferencedObject(f), m_mapping(f) { }
  61. };
  62. #endif // HK_SKELETON_MAPPER_H
  63. /*
  64. * Havok SDK - NO SOURCE PC DOWNLOAD, BUILD(#20090216)
  65. * Confidential Information of Havok.  (C) Copyright 1999-2009
  66. * Telekinesys Research Limited t/a Havok. All Rights Reserved. The Havok
  67. * Logo, and the Havok buzzsaw logo are trademarks of Havok.  Title, ownership
  68. * rights, and intellectual property rights in the Havok software remain in
  69. * Havok and/or its suppliers.
  70. * Use of this software for evaluation purposes is subject to and indicates
  71. * acceptance of the End User licence Agreement for this product. A copy of
  72. * the license is included with this software and is also available at www.havok.com/tryhavok.
  73. */