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

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file lllandmark.h
  3.  * @brief Landmark asset class
  4.  *
  5.  * $LicenseInfo:firstyear=2002&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2002-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_LLLANDMARK_H
  33. #define LL_LLLANDMARK_H
  34. #include <map>
  35. #include <boost/function.hpp>
  36. #include "llframetimer.h"
  37. #include "lluuid.h"
  38. #include "v3dmath.h"
  39. class LLMessageSystem;
  40. class LLHost;
  41. class LLLandmark
  42. {
  43. public:
  44. // for calling back interested parties when a region handle comes back.
  45. typedef boost::function<void(const LLUUID& region_id, const U64& region_handle)> region_handle_callback_t;
  46. ~LLLandmark() {}
  47. // returns true if the position is known.
  48. bool getGlobalPos(LLVector3d& pos);
  49. // setter used in conjunction if more information needs to be
  50. // collected from the server.
  51. void setGlobalPos(const LLVector3d& pos);
  52. // return true if the region is known
  53. bool getRegionID(LLUUID& region_id);
  54. // return the local coordinates if known
  55. LLVector3 getRegionPos() const;
  56. // constructs a new LLLandmark from a string
  57. // return NULL if there's an error
  58. static LLLandmark* constructFromString(const char *buffer);
  59. // register callbacks that this class handles
  60. static void registerCallbacks(LLMessageSystem* msg);
  61. // request information about region_id to region_handle.Pass in a
  62. // callback pointer which will be erase but NOT deleted after the
  63. // callback is made. This function may call into the message
  64. // system to get the information.
  65. static void requestRegionHandle(
  66. LLMessageSystem* msg,
  67. const LLHost& upstream_host,
  68. const LLUUID& region_id,
  69. region_handle_callback_t callback);
  70. // Call this method to create a lookup for this region. This
  71. // simplifies a lot of the code.
  72. static void setRegionHandle(const LLUUID& region_id, U64 region_handle);
  73. private:
  74. LLLandmark();
  75. LLLandmark(const LLVector3d& pos);
  76. static void processRegionIDAndHandle(LLMessageSystem* msg, void**);
  77. static void expireOldEntries();
  78. private:
  79. LLUUID mRegionID;
  80. LLVector3 mRegionPos;
  81. bool mGlobalPositionKnown;
  82. LLVector3d mGlobalPos;
  83. struct CacheInfo
  84. {
  85. U64 mRegionHandle;
  86. LLFrameTimer mTimer;
  87. };
  88. static std::pair<LLUUID, U64> mLocalRegion;
  89. typedef std::map<LLUUID, CacheInfo> region_map_t;
  90. static region_map_t mRegions;
  91. typedef std::multimap<LLUUID, region_handle_callback_t> region_callback_map_t;
  92. static region_callback_map_t sRegionCallbackMap;
  93. };
  94. #endif