lljoint.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:5k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file lljoint.h
  3.  * @brief Implementation of LLJoint class.
  4.  *
  5.  * $LicenseInfo:firstyear=2001&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2001-2010, Linden Research, Inc.
  8.  * 
  9.  * Second Life Viewer Source Code
  10.  * The source code in this file ("Source Code") is provided by Linden Lab
  11.  * to you under the terms of the GNU General Public License, version 2.0
  12.  * ("GPL"), unless you have obtained a separate licensing agreement
  13.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  14.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  15.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  16.  * 
  17.  * There are special exceptions to the terms and conditions of the GPL as
  18.  * it is applied to this Source Code. View the full text of the exception
  19.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  20.  * online at
  21.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  22.  * 
  23.  * By copying, modifying or distributing this software, you acknowledge
  24.  * that you have read and understood your obligations described above,
  25.  * and agree to abide by those obligations.
  26.  * 
  27.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  28.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  29.  * COMPLETENESS OR PERFORMANCE.
  30.  * $/LicenseInfo$
  31.  */
  32. #ifndef LL_LLJOINT_H
  33. #define LL_LLJOINT_H
  34. //-----------------------------------------------------------------------------
  35. // Header Files
  36. //-----------------------------------------------------------------------------
  37. #include <string>
  38. #include "linked_lists.h"
  39. #include "v3math.h"
  40. #include "v4math.h"
  41. #include "m4math.h"
  42. #include "llquaternion.h"
  43. #include "xform.h"
  44. #include "lldarray.h"
  45. const S32 LL_CHARACTER_MAX_JOINTS_PER_MESH = 15;
  46. const U32 LL_CHARACTER_MAX_JOINTS = 32; // must be divisible by 4!
  47. const U32 LL_HAND_JOINT_NUM = 31;
  48. const U32 LL_FACE_JOINT_NUM = 30;
  49. const S32 LL_CHARACTER_MAX_PRIORITY = 7;
  50. const F32 LL_MAX_PELVIS_OFFSET = 5.f;
  51. //-----------------------------------------------------------------------------
  52. // class LLJoint
  53. //-----------------------------------------------------------------------------
  54. class LLJoint
  55. {
  56. public:
  57. // priority levels, from highest to lowest
  58. enum JointPriority
  59. {
  60. USE_MOTION_PRIORITY = -1,
  61. LOW_PRIORITY = 0,
  62. MEDIUM_PRIORITY,
  63. HIGH_PRIORITY,
  64. HIGHER_PRIORITY,
  65. HIGHEST_PRIORITY,
  66. ADDITIVE_PRIORITY = LL_CHARACTER_MAX_PRIORITY
  67. };
  68. enum DirtyFlags
  69. {
  70. MATRIX_DIRTY = 0x1 << 0,
  71. ROTATION_DIRTY = 0x1 << 1,
  72. POSITION_DIRTY = 0x1 << 2,
  73. ALL_DIRTY = 0x7
  74. };
  75. protected:
  76. std::string mName;
  77. // parent joint
  78. LLJoint *mParent;
  79. // explicit transformation members
  80. LLXformMatrix mXform;
  81. public:
  82. U32 mDirtyFlags;
  83. BOOL mUpdateXform;
  84. // describes the skin binding pose
  85. LLVector3 mSkinOffset;
  86. S32 mJointNum;
  87. // child joints
  88. typedef std::list<LLJoint*> child_list_t;
  89. child_list_t mChildren;
  90. // debug statics
  91. static S32 sNumTouches;
  92. static S32 sNumUpdates;
  93. public:
  94. LLJoint();
  95. LLJoint( const std::string &name, LLJoint *parent=NULL );
  96. virtual ~LLJoint();
  97. // set name and parent
  98. void setup( const std::string &name, LLJoint *parent=NULL );
  99. void touch(U32 flags = ALL_DIRTY);
  100. // get/set name
  101. const std::string& getName() const { return mName; }
  102. void setName( const std::string &name ) { mName = name; }
  103. // getParent
  104. LLJoint *getParent() { return mParent; }
  105. // getRoot
  106. LLJoint *getRoot();
  107. // search for child joints by name
  108. LLJoint *findJoint( const std::string &name );
  109. // add/remove children
  110. void addChild( LLJoint *joint );
  111. void removeChild( LLJoint *joint );
  112. void removeAllChildren();
  113. // get/set local position
  114. const LLVector3& getPosition();
  115. void setPosition( const LLVector3& pos );
  116. // get/set world position
  117. LLVector3 getWorldPosition();
  118. LLVector3 getLastWorldPosition();
  119. void setWorldPosition( const LLVector3& pos );
  120. // get/set local rotation
  121. const LLQuaternion& getRotation();
  122. void setRotation( const LLQuaternion& rot );
  123. // get/set world rotation
  124. LLQuaternion getWorldRotation();
  125. LLQuaternion getLastWorldRotation();
  126. void setWorldRotation( const LLQuaternion& rot );
  127. // get/set local scale
  128. const LLVector3& getScale();
  129. void setScale( const LLVector3& scale );
  130. // get/set world matrix
  131. const LLMatrix4 &getWorldMatrix();
  132. void setWorldMatrix( const LLMatrix4& mat );
  133. void updateWorldMatrixChildren();
  134. void updateWorldMatrixParent();
  135. void updateWorldPRSParent();
  136. void updateWorldMatrix();
  137. // get/set skin offset
  138. const LLVector3 &getSkinOffset();
  139. void setSkinOffset( const LLVector3 &offset);
  140. LLXformMatrix *getXform() { return &mXform; }
  141. void clampRotation(LLQuaternion old_rot, LLQuaternion new_rot);
  142. virtual BOOL isAnimatable() const { return TRUE; }
  143. S32 getJointNum() const { return mJointNum; }
  144. void setJointNum(S32 joint_num) { mJointNum = joint_num; }
  145. };
  146. #endif // LL_LLJOINT_H