lljoint.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:5k
- /**
- * @file lljoint.h
- * @brief Implementation of LLJoint class.
- *
- * $LicenseInfo:firstyear=2001&license=viewergpl$
- *
- * Copyright (c) 2001-2010, Linden Research, Inc.
- *
- * Second Life Viewer Source Code
- * The source code in this file ("Source Code") is provided by Linden Lab
- * to you under the terms of the GNU General Public License, version 2.0
- * ("GPL"), unless you have obtained a separate licensing agreement
- * ("Other License"), formally executed by you and Linden Lab. Terms of
- * the GPL can be found in doc/GPL-license.txt in this distribution, or
- * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
- *
- * There are special exceptions to the terms and conditions of the GPL as
- * it is applied to this Source Code. View the full text of the exception
- * in the file doc/FLOSS-exception.txt in this software distribution, or
- * online at
- * http://secondlifegrid.net/programs/open_source/licensing/flossexception
- *
- * By copying, modifying or distributing this software, you acknowledge
- * that you have read and understood your obligations described above,
- * and agree to abide by those obligations.
- *
- * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
- * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
- * COMPLETENESS OR PERFORMANCE.
- * $/LicenseInfo$
- */
- #ifndef LL_LLJOINT_H
- #define LL_LLJOINT_H
- //-----------------------------------------------------------------------------
- // Header Files
- //-----------------------------------------------------------------------------
- #include <string>
- #include "linked_lists.h"
- #include "v3math.h"
- #include "v4math.h"
- #include "m4math.h"
- #include "llquaternion.h"
- #include "xform.h"
- #include "lldarray.h"
- const S32 LL_CHARACTER_MAX_JOINTS_PER_MESH = 15;
- const U32 LL_CHARACTER_MAX_JOINTS = 32; // must be divisible by 4!
- const U32 LL_HAND_JOINT_NUM = 31;
- const U32 LL_FACE_JOINT_NUM = 30;
- const S32 LL_CHARACTER_MAX_PRIORITY = 7;
- const F32 LL_MAX_PELVIS_OFFSET = 5.f;
- //-----------------------------------------------------------------------------
- // class LLJoint
- //-----------------------------------------------------------------------------
- class LLJoint
- {
- public:
- // priority levels, from highest to lowest
- enum JointPriority
- {
- USE_MOTION_PRIORITY = -1,
- LOW_PRIORITY = 0,
- MEDIUM_PRIORITY,
- HIGH_PRIORITY,
- HIGHER_PRIORITY,
- HIGHEST_PRIORITY,
- ADDITIVE_PRIORITY = LL_CHARACTER_MAX_PRIORITY
- };
- enum DirtyFlags
- {
- MATRIX_DIRTY = 0x1 << 0,
- ROTATION_DIRTY = 0x1 << 1,
- POSITION_DIRTY = 0x1 << 2,
- ALL_DIRTY = 0x7
- };
- protected:
- std::string mName;
- // parent joint
- LLJoint *mParent;
- // explicit transformation members
- LLXformMatrix mXform;
- public:
- U32 mDirtyFlags;
- BOOL mUpdateXform;
- // describes the skin binding pose
- LLVector3 mSkinOffset;
- S32 mJointNum;
- // child joints
- typedef std::list<LLJoint*> child_list_t;
- child_list_t mChildren;
- // debug statics
- static S32 sNumTouches;
- static S32 sNumUpdates;
- public:
- LLJoint();
- LLJoint( const std::string &name, LLJoint *parent=NULL );
- virtual ~LLJoint();
- // set name and parent
- void setup( const std::string &name, LLJoint *parent=NULL );
- void touch(U32 flags = ALL_DIRTY);
- // get/set name
- const std::string& getName() const { return mName; }
- void setName( const std::string &name ) { mName = name; }
- // getParent
- LLJoint *getParent() { return mParent; }
- // getRoot
- LLJoint *getRoot();
- // search for child joints by name
- LLJoint *findJoint( const std::string &name );
- // add/remove children
- void addChild( LLJoint *joint );
- void removeChild( LLJoint *joint );
- void removeAllChildren();
- // get/set local position
- const LLVector3& getPosition();
- void setPosition( const LLVector3& pos );
- // get/set world position
- LLVector3 getWorldPosition();
- LLVector3 getLastWorldPosition();
- void setWorldPosition( const LLVector3& pos );
- // get/set local rotation
- const LLQuaternion& getRotation();
- void setRotation( const LLQuaternion& rot );
- // get/set world rotation
- LLQuaternion getWorldRotation();
- LLQuaternion getLastWorldRotation();
- void setWorldRotation( const LLQuaternion& rot );
- // get/set local scale
- const LLVector3& getScale();
- void setScale( const LLVector3& scale );
- // get/set world matrix
- const LLMatrix4 &getWorldMatrix();
- void setWorldMatrix( const LLMatrix4& mat );
- void updateWorldMatrixChildren();
- void updateWorldMatrixParent();
- void updateWorldPRSParent();
- void updateWorldMatrix();
- // get/set skin offset
- const LLVector3 &getSkinOffset();
- void setSkinOffset( const LLVector3 &offset);
- LLXformMatrix *getXform() { return &mXform; }
- void clampRotation(LLQuaternion old_rot, LLQuaternion new_rot);
- virtual BOOL isAnimatable() const { return TRUE; }
- S32 getJointNum() const { return mJointNum; }
- void setJointNum(S32 joint_num) { mJointNum = joint_num; }
- };
- #endif // LL_LLJOINT_H