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

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file lltexturectrl.h
  3.  * @author Richard Nelson, James Cook
  4.  * @brief LLTextureCtrl class header file including related functions
  5.  *
  6.  * $LicenseInfo:firstyear=2002&license=viewergpl$
  7.  * 
  8.  * Copyright (c) 2002-2010, Linden Research, Inc.
  9.  * 
  10.  * Second Life Viewer Source Code
  11.  * The source code in this file ("Source Code") is provided by Linden Lab
  12.  * to you under the terms of the GNU General Public License, version 2.0
  13.  * ("GPL"), unless you have obtained a separate licensing agreement
  14.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  15.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  16.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  17.  * 
  18.  * There are special exceptions to the terms and conditions of the GPL as
  19.  * it is applied to this Source Code. View the full text of the exception
  20.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  21.  * online at
  22.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  23.  * 
  24.  * By copying, modifying or distributing this software, you acknowledge
  25.  * that you have read and understood your obligations described above,
  26.  * and agree to abide by those obligations.
  27.  * 
  28.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  29.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  30.  * COMPLETENESS OR PERFORMANCE.
  31.  * $/LicenseInfo$
  32.  */
  33. #ifndef LL_LLTEXTURECTRL_H
  34. #define LL_LLTEXTURECTRL_H
  35. #include "llcoord.h"
  36. #include "llfloater.h"
  37. #include "llstring.h"
  38. #include "lluictrl.h"
  39. #include "llpermissionsflags.h"
  40. #include "lltextbox.h" // for params
  41. #include "llviewborder.h" // for params
  42. class LLButton;
  43. class LLFloaterTexturePicker;
  44. class LLInventoryItem;
  45. class LLViewerFetchedTexture;
  46. // used for setting drag & drop callbacks.
  47. typedef boost::function<BOOL (LLUICtrl*, LLInventoryItem*)> drag_n_drop_callback;
  48. //////////////////////////////////////////////////////////////////////////////////////////
  49. // LLTextureCtrl
  50. class LLTextureCtrl
  51. : public LLUICtrl
  52. {
  53. public:
  54. typedef enum e_texture_pick_op
  55. {
  56. TEXTURE_CHANGE,
  57. TEXTURE_SELECT,
  58. TEXTURE_CANCEL
  59. } ETexturePickOp;
  60. public:
  61. struct Params : public LLInitParam::Block<Params, LLUICtrl::Params>
  62. {
  63. Optional<LLUUID> image_id;
  64. Optional<LLUUID> default_image_id;
  65. Optional<std::string> default_image_name;
  66. Optional<bool> allow_no_texture;
  67. Optional<bool> can_apply_immediately;
  68. Optional<bool> no_commit_on_selection; // alternative mode: commit occurs and the widget gets dirty
  69. // only on DnD or when OK is pressed in the picker
  70. Optional<S32> label_width;
  71. Optional<LLUIColor> border_color;
  72. Optional<LLTextBox::Params> multiselect_text,
  73. caption_text;
  74. Optional<LLViewBorder::Params> border;
  75. Params()
  76. : image_id("image"),
  77. default_image_id("default_image_id"),
  78. default_image_name("default_image_name"),
  79. allow_no_texture("allow_no_texture"),
  80. can_apply_immediately("can_apply_immediately"),
  81. no_commit_on_selection("no_commit_on_selection", false),
  82.     label_width("label_width", -1),
  83. border_color("border_color"),
  84. multiselect_text("multiselect_text"),
  85. caption_text("caption_text"),
  86. border("border")
  87. {
  88. name = "texture picker";
  89. mouse_opaque(true);
  90. follows.flags(FOLLOWS_LEFT | FOLLOWS_TOP);
  91. }
  92. };
  93. protected:
  94. LLTextureCtrl(const Params&);
  95. friend class LLUICtrlFactory;
  96. public:
  97. virtual ~LLTextureCtrl();
  98. // LLView interface
  99. virtual BOOL handleMouseDown(S32 x, S32 y, MASK mask);
  100. virtual BOOL handleDragAndDrop(S32 x, S32 y, MASK mask,
  101. BOOL drop, EDragAndDropType cargo_type, void *cargo_data,
  102. EAcceptance *accept,
  103. std::string& tooltip_msg);
  104. virtual BOOL handleHover(S32 x, S32 y, MASK mask);
  105. virtual BOOL handleUnicodeCharHere(llwchar uni_char);
  106. virtual void draw();
  107. virtual void setVisible( BOOL visible );
  108. virtual void setEnabled( BOOL enabled );
  109. void setValid(BOOL valid);
  110. // LLUICtrl interface
  111. virtual void clear();
  112. // Takes a UUID, wraps get/setImageAssetID
  113. virtual void setValue(const LLSD& value );
  114. virtual LLSD getValue() const;
  115. // LLTextureCtrl interface
  116. void showPicker(BOOL take_focus);
  117. void setLabel(const std::string& label);
  118. void setLabelWidth(S32 label_width) {mLabelWidth =label_width;}
  119. const std::string& getLabel() const { return mLabel; }
  120. void setAllowNoTexture( BOOL b ) { mAllowNoTexture = b; }
  121. bool getAllowNoTexture() const { return mAllowNoTexture; }
  122. const LLUUID& getImageItemID() { return mImageItemID; }
  123. void setImageAssetID(const LLUUID &image_asset_id);
  124. const LLUUID& getImageAssetID() const { return mImageAssetID; }
  125. void setDefaultImageAssetID( const LLUUID& id ) { mDefaultImageAssetID = id; }
  126. const LLUUID& getDefaultImageAssetID() const { return mDefaultImageAssetID; }
  127. const std::string& getDefaultImageName() const { return mDefaultImageName; }
  128. void setFallbackImageName( const std::string& name ) { mFallbackImageName = name; }
  129. const std::string&  getFallbackImageName() const { return mFallbackImageName; }    
  130. void setCaption(const std::string& caption);
  131. void setCanApplyImmediately(BOOL b);
  132. void setImmediateFilterPermMask(PermissionMask mask)
  133. { mImmediateFilterPermMask = mask; }
  134. void setNonImmediateFilterPermMask(PermissionMask mask)
  135. { mNonImmediateFilterPermMask = mask; }
  136. PermissionMask getImmediateFilterPermMask() { return mImmediateFilterPermMask; }
  137. PermissionMask getNonImmediateFilterPermMask() { return mNonImmediateFilterPermMask; }
  138. void closeDependentFloater();
  139. void onFloaterClose();
  140. void onFloaterCommit(ETexturePickOp op);
  141. // This call is returned when a drag is detected. Your callback
  142. // should return TRUE if the drag is acceptable.
  143. void setDragCallback(drag_n_drop_callback cb) { mDragCallback = cb; }
  144. // This callback is called when the drop happens. Return TRUE if
  145. // the drop happened - resulting in an on commit callback, but not
  146. // necessariliy any other change.
  147. void setDropCallback(drag_n_drop_callback cb) { mDropCallback = cb; }
  148. void setOnCancelCallback(commit_callback_t cb) { mOnCancelCallback = cb; }
  149. void setOnSelectCallback(commit_callback_t cb) { mOnSelectCallback = cb; }
  150. void setShowLoadingPlaceholder(BOOL showLoadingPlaceholder);
  151. private:
  152. BOOL allowDrop(LLInventoryItem* item);
  153. BOOL doDrop(LLInventoryItem* item);
  154. private:
  155. drag_n_drop_callback  mDragCallback;
  156. drag_n_drop_callback  mDropCallback;
  157. commit_callback_t  mOnCancelCallback;
  158. commit_callback_t  mOnSelectCallback;
  159. LLPointer<LLViewerFetchedTexture> mTexturep;
  160. LLUIColor  mBorderColor;
  161. LLUUID  mImageItemID;
  162. LLUUID  mImageAssetID;
  163. LLUUID  mDefaultImageAssetID;
  164. std::string  mFallbackImageName;
  165. std::string  mDefaultImageName;
  166. LLHandle<LLFloater>  mFloaterHandle;
  167. LLTextBox*  mTentativeLabel;
  168. LLTextBox*  mCaption;
  169. std::string  mLabel;
  170. BOOL  mAllowNoTexture; // If true, the user can select "none" as an option
  171. PermissionMask  mImmediateFilterPermMask;
  172. PermissionMask  mNonImmediateFilterPermMask;
  173. BOOL  mCanApplyImmediately;
  174. BOOL  mCommitOnSelection;
  175. BOOL  mNeedsRawImageData;
  176. LLViewBorder*  mBorder;
  177. BOOL  mValid;
  178. BOOL  mShowLoadingPlaceholder;
  179. std::string  mLoadingPlaceholderString;
  180. S32  mLabelWidth;
  181. };
  182. // XUI HACK: When floaters converted, switch this file to lltexturepicker.h/cpp
  183. // and class to LLTexturePicker
  184. #define LLTexturePicker LLTextureCtrl
  185. #endif  // LL_LLTEXTURECTRL_H