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

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llgesturemgr.h
  3.  * @brief Manager for playing gestures on the viewer
  4.  *
  5.  * $LicenseInfo:firstyear=2004&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2004-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_LLGESTUREMGR_H
  33. #define LL_LLGESTUREMGR_H
  34. #include <map>
  35. #include <string>
  36. #include <vector>
  37. #include "llassetstorage.h" // LLAssetType
  38. #include "llinventoryobserver.h"
  39. #include "llsingleton.h"
  40. #include "llviewerinventory.h"
  41. class LLMultiGesture;
  42. class LLGestureStep;
  43. class LLUUID;
  44. class LLVFS;
  45. class LLGestureManagerObserver
  46. {
  47. public:
  48. virtual ~LLGestureManagerObserver() { };
  49. virtual void changed() = 0;
  50. };
  51. class LLGestureManager : public LLSingleton<LLGestureManager>, public LLInventoryFetchObserver
  52. {
  53. public:
  54. typedef boost::function<void (LLMultiGesture* loaded_gesture)> gesture_loaded_callback_t;
  55. // Maps inventory item_id to gesture
  56. typedef std::map<LLUUID, LLMultiGesture*> item_map_t;
  57. typedef std::map<LLUUID, gesture_loaded_callback_t> callback_map_t;
  58. LLGestureManager();
  59. ~LLGestureManager();
  60. void init();
  61. // Call once per frame to manage gestures
  62. void update();
  63. // Loads a gesture out of inventory into the in-memory active form
  64. // Note that the inventory item must exist, so we can look up the 
  65. // asset id.
  66. void activateGesture(const LLUUID& item_id);
  67. // Activate a list of gestures
  68. void activateGestures(LLViewerInventoryItem::item_array_t& items);
  69. // If you change a gesture, you need to build a new multigesture
  70. // and call this method.
  71. void replaceGesture(const LLUUID& item_id, LLMultiGesture* new_gesture, const LLUUID& asset_id);
  72. void replaceGesture(const LLUUID& item_id, const LLUUID& asset_id);
  73. // Load gesture into in-memory active form.
  74. // Can be called even if the inventory item isn't loaded yet.
  75. // inform_server TRUE will send message upstream to update database
  76. // user_gesture_active table, which isn't necessary on login.
  77. // deactivate_similar will cause other gestures with the same trigger phrase
  78. // or keybinding to be deactivated.
  79. void activateGestureWithAsset(const LLUUID& item_id, const LLUUID& asset_id, BOOL inform_server, BOOL deactivate_similar);
  80. // Takes gesture out of active list and deletes it.
  81. void deactivateGesture(const LLUUID& item_id);
  82. // Deactivates all gestures that match either this trigger phrase,
  83. // or this hot key.
  84. void deactivateSimilarGestures(LLMultiGesture* gesture, const LLUUID& in_item_id);
  85. BOOL isGestureActive(const LLUUID& item_id);
  86. BOOL isGesturePlaying(const LLUUID& item_id);
  87. BOOL isGesturePlaying(LLMultiGesture* gesture);
  88. const item_map_t& getActiveGestures() const { return mActive; }
  89. // Force a gesture to be played, for example, if it is being
  90. // previewed.
  91. void playGesture(LLMultiGesture* gesture);
  92. void playGesture(const LLUUID& item_id);
  93. // Stop all requested or playing anims for this gesture
  94. // Also remove from playing list
  95. void stopGesture(LLMultiGesture* gesture);
  96. void stopGesture(const LLUUID& item_id);
  97. /**
  98.  * Add cb into callbackMap.
  99.  * Note:
  100.  * Manager will call cb after gesture will be loaded and will remove cb automatically. 
  101.  */
  102. void setGestureLoadedCallback(LLUUID inv_item_id, gesture_loaded_callback_t cb)
  103. {
  104. mCallbackMap[inv_item_id] = cb;
  105. }
  106. // Trigger the first gesture that matches this key.
  107. // Returns TRUE if it finds a gesture bound to that key.
  108. BOOL triggerGesture(KEY key, MASK mask);
  109. // Trigger all gestures referenced as substrings in this string
  110. BOOL triggerAndReviseString(const std::string &str, std::string *revised_string = NULL);
  111. // Does some gesture have this key bound?
  112. BOOL isKeyBound(KEY key, MASK mask);
  113. S32 getPlayingCount() const;
  114. void addObserver(LLGestureManagerObserver* observer);
  115. void removeObserver(LLGestureManagerObserver* observer);
  116. void notifyObservers();
  117. // Overriding so we can update active gesture names and notify observers 
  118. void changed(U32 mask); 
  119. BOOL matchPrefix(const std::string& in_str, std::string* out_str);
  120. // Copy item ids into the vector
  121. void getItemIDs(std::vector<LLUUID>* ids);
  122. protected:
  123. // Handle the processing of a single gesture
  124. void stepGesture(LLMultiGesture* gesture);
  125. // Do a single step in a gesture
  126. void runStep(LLMultiGesture* gesture, LLGestureStep* step);
  127. // LLInventoryCompletionObserver trigger
  128. void done();
  129. // Used by loadGesture
  130. static void onLoadComplete(LLVFS *vfs,
  131.    const LLUUID& asset_uuid,
  132.    LLAssetType::EType type,
  133.    void* user_data, S32 status, LLExtStat ext_status);
  134. private:
  135. // Active gestures.
  136. // NOTE: The gesture pointer CAN BE NULL.  This means that
  137. // there is a gesture with that item_id, but the asset data
  138. // is still on its way down from the server.
  139. item_map_t mActive;
  140. S32 mLoadingCount;
  141. std::string mDeactivateSimilarNames;
  142. std::vector<LLGestureManagerObserver*> mObservers;
  143. callback_map_t mCallbackMap;
  144. std::vector<LLMultiGesture*> mPlaying;
  145. BOOL mValid;
  146. };
  147. #endif