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

其他游戏

开发平台:

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 HKSERIALZE_VERSION_CHECKING_UTILS_H
  9. #define HKSERIALZE_VERSION_CHECKING_UTILS_H
  10. #include <Common/Serialize/Version/hkVersionUtil.h>
  11. class hkOstream;
  12. struct hkVersioningExceptionsArray;
  13. class hkVersionPatchManager;
  14. class hkDataWorld;
  15. /// Utility routine to help maintain version compatability
  16. /// We use these routines to help ensure we don't break backward compatability
  17. namespace hkVersionCheckingUtils
  18. {
  19. struct VersionDifference
  20. {
  21. VersionDifference(const hkClass* oldClass, const hkClass* newClass) : m_oldClass(oldClass), m_newClass(newClass) {}
  22. bool operator==(const VersionDifference& other) { return (other.m_oldClass == m_oldClass) && (other.m_newClass == m_newClass); }
  23. const hkClass* m_oldClass; // If null then newClass has been added
  24. const hkClass* m_newClass; // If null then oldClass has been removed
  25. private:
  26. HK_DECLARE_NONVIRTUAL_CLASS_ALLOCATOR( HK_MEMORY_CLASS_SERIALIZE, VersionDifference );
  27. };
  28. /// Compares two null terminated sets of classes - usually these sets represent different versions
  29. /// Ignore all differences specified in the exceptions array
  30. void HK_CALL checkVersions( const hkClass* const * oldVersions, const hkClass* const * newVersions, hkArray<VersionDifference>& differences, const hkVersioningExceptionsArray* exceptions = HK_NULL );
  31. /// Write a human readable description of the difference between these 2 versions
  32. /// For this to be useful the classes should be different versions of the same hkClass
  33. /// If detailed is true then this reports member offset and class size changes too.
  34. void HK_CALL summarizeChanges(hkOstream& output, const hkClass& oldVersion, const hkClass& newVersion, bool detailed = false);
  35. enum Flags
  36. {
  37. NONE = 0,
  38. VERBOSE = 1,
  39. IGNORE_REMOVED = 2
  40. };
  41. /// Verify that an update description is complete.
  42. /// For each class in oldClasses, verify that it is identical to the new version
  43. /// or that a version function exists to update it. A human readable report is
  44. /// written to the report stream.
  45. hkResult HK_CALL verifyUpdateDescription( hkOstream& report,
  46. const hkClassNameRegistry& oldClassReg,
  47. const hkClassNameRegistry& newClassReg,
  48. const hkVersionRegistry::UpdateDescription& updateDescriptionHead,
  49. Flags flags = NONE );
  50. hkResult HK_CALL verifyClassPatches(hkOstream& report, const hkDataWorld& world, const hkClassNameRegistry& classReg, const hkVersionPatchManager& patchManager, Flags flags = NONE);
  51. }
  52. #endif // HKSERIALZE_VERSION_CHECKING_UTILS_H
  53. /*
  54. * Havok SDK - NO SOURCE PC DOWNLOAD, BUILD(#20090216)
  55. * Confidential Information of Havok.  (C) Copyright 1999-2009
  56. * Telekinesys Research Limited t/a Havok. All Rights Reserved. The Havok
  57. * Logo, and the Havok buzzsaw logo are trademarks of Havok.  Title, ownership
  58. * rights, and intellectual property rights in the Havok software remain in
  59. * Havok and/or its suppliers.
  60. * Use of this software for evaluation purposes is subject to and indicates
  61. * acceptance of the End User licence Agreement for this product. A copy of
  62. * the license is included with this software and is also available at www.havok.com/tryhavok.
  63. */