lllandmark.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:3k
- /**
- * @file lllandmark.h
- * @brief Landmark asset class
- *
- * $LicenseInfo:firstyear=2002&license=viewergpl$
- *
- * Copyright (c) 2002-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_LLLANDMARK_H
- #define LL_LLLANDMARK_H
- #include <map>
- #include <boost/function.hpp>
- #include "llframetimer.h"
- #include "lluuid.h"
- #include "v3dmath.h"
- class LLMessageSystem;
- class LLHost;
- class LLLandmark
- {
- public:
- // for calling back interested parties when a region handle comes back.
- typedef boost::function<void(const LLUUID& region_id, const U64& region_handle)> region_handle_callback_t;
- ~LLLandmark() {}
- // returns true if the position is known.
- bool getGlobalPos(LLVector3d& pos);
- // setter used in conjunction if more information needs to be
- // collected from the server.
- void setGlobalPos(const LLVector3d& pos);
- // return true if the region is known
- bool getRegionID(LLUUID& region_id);
- // return the local coordinates if known
- LLVector3 getRegionPos() const;
- // constructs a new LLLandmark from a string
- // return NULL if there's an error
- static LLLandmark* constructFromString(const char *buffer);
- // register callbacks that this class handles
- static void registerCallbacks(LLMessageSystem* msg);
- // request information about region_id to region_handle.Pass in a
- // callback pointer which will be erase but NOT deleted after the
- // callback is made. This function may call into the message
- // system to get the information.
- static void requestRegionHandle(
- LLMessageSystem* msg,
- const LLHost& upstream_host,
- const LLUUID& region_id,
- region_handle_callback_t callback);
- // Call this method to create a lookup for this region. This
- // simplifies a lot of the code.
- static void setRegionHandle(const LLUUID& region_id, U64 region_handle);
-
- private:
- LLLandmark();
- LLLandmark(const LLVector3d& pos);
- static void processRegionIDAndHandle(LLMessageSystem* msg, void**);
- static void expireOldEntries();
- private:
- LLUUID mRegionID;
- LLVector3 mRegionPos;
- bool mGlobalPositionKnown;
- LLVector3d mGlobalPos;
-
- struct CacheInfo
- {
- U64 mRegionHandle;
- LLFrameTimer mTimer;
- };
- static std::pair<LLUUID, U64> mLocalRegion;
- typedef std::map<LLUUID, CacheInfo> region_map_t;
- static region_map_t mRegions;
- typedef std::multimap<LLUUID, region_handle_callback_t> region_callback_map_t;
- static region_callback_map_t sRegionCallbackMap;
- };
- #endif