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

游戏引擎

开发平台:

C++ Builder

  1. /**
  2.  * @file llteleporthistorystorage.h
  3.  * @brief Saving/restoring of teleport history.
  4.  *
  5.  * $LicenseInfo:firstyear=2009&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2009-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_LLTELEPORTHISTORYSTORAGE_H
  33. #define LL_LLTELEPORTHISTORYSTORAGE_H
  34. #include <vector>
  35. #include "llsingleton.h"
  36. #include "lldate.h"
  37. #include "v3dmath.h"
  38. class LLSD;
  39. /**
  40.  * An item of the teleport history, stored in file
  41.  *
  42.  * Contains the location's global coordinates, title and date.
  43.  */
  44. class LLTeleportHistoryPersistentItem
  45. {
  46. public:
  47. LLTeleportHistoryPersistentItem()
  48. {}
  49. LLTeleportHistoryPersistentItem(const std::string title, const LLVector3d& global_pos)
  50. : mTitle(title), mGlobalPos(global_pos), mDate(LLDate::now())
  51. {}
  52. LLTeleportHistoryPersistentItem(const std::string title, const LLVector3d& global_pos, const LLDate& date)
  53. : mTitle(title), mGlobalPos(global_pos), mDate(date)
  54. {}
  55. LLTeleportHistoryPersistentItem(const LLSD& val);
  56. LLSD toLLSD() const;
  57. std::string mTitle;
  58. LLVector3d mGlobalPos;
  59. LLDate mDate;
  60. };
  61. /**
  62.  * Persistent teleport history.
  63.  *
  64.  */
  65. class LLTeleportHistoryStorage: public LLSingleton<LLTeleportHistoryStorage>
  66. {
  67. LOG_CLASS(LLTeleportHistoryStorage);
  68. public:
  69. typedef std::vector<LLTeleportHistoryPersistentItem> slurl_list_t;
  70. // removed_index is index of removed item, which replaced by more recent
  71. typedef boost::function<void(S32 removed_index)> history_callback_t;
  72. typedef boost::signals2::signal<void(S32 removed_index)> history_signal_t;
  73. LLTeleportHistoryStorage();
  74. ~LLTeleportHistoryStorage();
  75. /**
  76.  * @return history items.
  77.  */
  78. const slurl_list_t& getItems() const { return mItems; }
  79. void purgeItems();
  80. void addItem(const std::string title, const LLVector3d& global_pos);
  81. void addItem(const std::string title, const LLVector3d& global_pos, const LLDate& date);
  82. void removeItem(S32 idx);
  83. void save();
  84. void load();
  85. void dump() const;
  86. /**
  87.  * Set a callback to be called upon history changes.
  88.  * 
  89.  * Multiple callbacks can be set.
  90.  */
  91. boost::signals2::connection setHistoryChangedCallback(history_callback_t cb);
  92. /**
  93.  * Go to specific item in the history.
  94.  * 
  95.  * The item is specified by its index (starting from 0).
  96.  */
  97. void goToItem(S32 idx);
  98. private:
  99. void onTeleportHistoryChange();
  100. bool compareByTitleAndGlobalPos(const LLTeleportHistoryPersistentItem& a, const LLTeleportHistoryPersistentItem& b);
  101. slurl_list_t mItems;
  102. std::string mFilename;
  103. /**
  104.  * Signal emitted when the history gets changed.
  105.  * 
  106.  * Invokes callbacks set with setHistoryChangedCallback().
  107.  */
  108. history_signal_t mHistoryChangedSignal;
  109. };
  110. #endif //LL_LLTELEPORTHISTORYSTORAGE_H