lltooldraganddrop.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:10k
- /**
- * @file lltooldraganddrop.h
- * @brief LLToolDragAndDrop class header file
- *
- * $LicenseInfo:firstyear=2001&license=viewergpl$
- *
- * Copyright (c) 2001-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_TOOLDRAGANDDROP_H
- #define LL_TOOLDRAGANDDROP_H
- #include "lldictionary.h"
- #include "lltool.h"
- #include "llview.h"
- #include "lluuid.h"
- #include "stdenums.h"
- #include "llassetstorage.h"
- #include "lldarray.h"
- #include "llpermissions.h"
- #include "llwindow.h"
- #include "llviewerinventory.h"
- class LLToolDragAndDrop;
- class LLViewerRegion;
- class LLVOAvatar;
- class LLPickInfo;
- class LLToolDragAndDrop : public LLTool, public LLSingleton<LLToolDragAndDrop>
- {
- public:
- typedef boost::signals2::signal<void ()> enddrag_signal_t;
- LLToolDragAndDrop();
- // overridden from LLTool
- virtual BOOL handleMouseUp(S32 x, S32 y, MASK mask);
- virtual BOOL handleHover(S32 x, S32 y, MASK mask);
- virtual BOOL handleKey(KEY key, MASK mask);
- virtual BOOL handleToolTip(S32 x, S32 y, MASK mask);
- virtual void onMouseCaptureLost();
- virtual void handleDeselect();
- void setDragStart( S32 x, S32 y ); // In screen space
- BOOL isOverThreshold( S32 x, S32 y ); // In screen space
- enum ESource
- {
- SOURCE_AGENT,
- SOURCE_WORLD,
- SOURCE_NOTECARD,
- SOURCE_LIBRARY
- };
- void beginDrag(EDragAndDropType type,
- const LLUUID& cargo_id,
- ESource source,
- const LLUUID& source_id = LLUUID::null,
- const LLUUID& object_id = LLUUID::null);
- void beginMultiDrag(const std::vector<EDragAndDropType> types,
- const std::vector<LLUUID>& cargo_ids,
- ESource source,
- const LLUUID& source_id = LLUUID::null);
- void endDrag();
- ESource getSource() const { return mSource; }
- const LLUUID& getSourceID() const { return mSourceID; }
- const LLUUID& getObjectID() const { return mObjectID; }
- EAcceptance getLastAccept() { return mLastAccept; }
- boost::signals2::connection setEndDragCallback( const enddrag_signal_t::slot_type& cb ) { return mEndDragSignal.connect(cb); }
- protected:
- enum EDropTarget
- {
- DT_NONE = 0,
- DT_SELF = 1,
- DT_AVATAR = 2,
- DT_OBJECT = 3,
- DT_LAND = 4,
- DT_COUNT = 5
- };
- protected:
- // dragOrDrop3dImpl points to a member of LLToolDragAndDrop that
- // takes parameters (LLViewerObject* obj, S32 face, MASK, BOOL
- // drop) and returns a BOOL if drop is ok
- typedef EAcceptance (LLToolDragAndDrop::*dragOrDrop3dImpl)
- (LLViewerObject*, S32, MASK, BOOL);
- void dragOrDrop(S32 x, S32 y, MASK mask, BOOL drop,
- EAcceptance* acceptance);
- void dragOrDrop3D(S32 x, S32 y, MASK mask, BOOL drop,
- EAcceptance* acceptance);
-
- static void pickCallback(const LLPickInfo& pick_info);
- void pick(const LLPickInfo& pick_info);
- protected:
- S32 mDragStartX;
- S32 mDragStartY;
-
- std::vector<EDragAndDropType> mCargoTypes;
- //void* mCargoData;
- std::vector<LLUUID> mCargoIDs;
- ESource mSource;
- LLUUID mSourceID;
- LLUUID mObjectID;
- LLVector3d mLastCameraPos;
- LLVector3d mLastHitPos;
- ECursorType mCursor;
- EAcceptance mLastAccept;
- BOOL mDrop;
- S32 mCurItemIndex;
- std::string mToolTipMsg;
- enddrag_signal_t mEndDragSignal;
- protected:
- // 3d drop functions. these call down into the static functions
- // named drop<ThingToDrop> if drop is TRUE and permissions allow
- // that behavior.
- EAcceptance dad3dNULL(LLViewerObject*, S32, MASK, BOOL);
- EAcceptance dad3dRezObjectOnLand(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dRezObjectOnObject(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dRezScript(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dTextureObject(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- // EAcceptance dad3dTextureSelf(LLViewerObject* obj, S32 face,
- // MASK mask, BOOL drop);
- EAcceptance dad3dWearItem(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dWearCategory(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dUpdateInventory(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dUpdateInventoryCategory(LLViewerObject* obj,
- S32 face,
- MASK mask,
- BOOL drop);
- EAcceptance dad3dGiveInventoryObject(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dGiveInventory(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dGiveInventoryCategory(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dRezFromObjectOnLand(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dRezFromObjectOnObject(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dRezAttachmentFromInv(LLViewerObject* obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dCategoryOnLand(LLViewerObject *obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dAssetOnLand(LLViewerObject *obj, S32 face,
- MASK mask, BOOL drop);
- EAcceptance dad3dActivateGesture(LLViewerObject *obj, S32 face,
- MASK mask, BOOL drop);
- // set the LLToolDragAndDrop's cursor based on the given acceptance
- ECursorType acceptanceToCursor( EAcceptance acceptance );
- // This method converts mCargoID to an inventory item or
- // folder. If no item or category is found, both pointers will be
- // returned NULL.
- LLInventoryObject* locateInventory(LLViewerInventoryItem*& item,
- LLViewerInventoryCategory*& cat);
- //LLInventoryObject* locateMultipleInventory(
- // LLViewerInventoryCategory::cat_array_t& cats,
- // LLViewerInventoryItem::item_array_t& items);
- void dropObject(LLViewerObject* raycast_target,
- BOOL bypass_sim_raycast,
- BOOL from_task_inventory,
- BOOL remove_from_inventory);
-
- // accessor that looks at permissions, copyability, and names of
- // inventory items to determine if a drop would be ok.
- static EAcceptance willObjectAcceptInventory(LLViewerObject* obj, LLInventoryItem* item);
- // deal with permissions of object, etc. returns TRUE if drop can
- // proceed, otherwise FALSE.
- static BOOL handleDropTextureProtections(LLViewerObject* hit_obj,
- LLInventoryItem* item,
- LLToolDragAndDrop::ESource source,
- const LLUUID& src_id);
- // give inventory item functionality
- static bool handleCopyProtectedItem(const LLSD& notification, const LLSD& response);
- static void commitGiveInventoryItem(const LLUUID& to_agent,
- LLInventoryItem* item,
- const LLUUID &im_session_id = LLUUID::null);
- // give inventory category functionality
- static bool handleCopyProtectedCategory(const LLSD& notification, const LLSD& response);
- static void commitGiveInventoryCategory(const LLUUID& to_agent,
- LLInventoryCategory* cat,
- const LLUUID &im_session_id = LLUUID::null);
- public:
- // helper functions
- static BOOL isInventoryDropAcceptable(LLViewerObject* obj, LLInventoryItem* item) { return (ACCEPT_YES_COPY_SINGLE <= willObjectAcceptInventory(obj, item)); }
- // This simple helper function assumes you are attempting to
- // transfer item. returns true if you can give, otherwise false.
- static BOOL isInventoryGiveAcceptable(LLInventoryItem* item);
- static BOOL isInventoryGroupGiveAcceptable(LLInventoryItem* item);
- BOOL dadUpdateInventory(LLViewerObject* obj, BOOL drop);
- BOOL dadUpdateInventoryCategory(LLViewerObject* obj, BOOL drop);
- // methods that act on the simulator state.
- static void dropScript(LLViewerObject* hit_obj,
- LLInventoryItem* item,
- BOOL active,
- ESource source,
- const LLUUID& src_id);
- static void dropTextureOneFace(LLViewerObject* hit_obj, S32 hit_face,
- LLInventoryItem* item,
- ESource source,
- const LLUUID& src_id);
- static void dropTextureAllFaces(LLViewerObject* hit_obj,
- LLInventoryItem* item,
- ESource source,
- const LLUUID& src_id);
- //static void dropTextureOneFaceAvatar(LLVOAvatar* avatar,S32 hit_face,
- // LLInventoryItem* item)
- static void dropInventory(LLViewerObject* hit_obj,
- LLInventoryItem* item,
- ESource source,
- const LLUUID& src_id);
- static void giveInventory(const LLUUID& to_agent,
- LLInventoryItem* item,
- const LLUUID &session_id = LLUUID::null);
- static void giveInventoryCategory(const LLUUID& to_agent,
- LLInventoryCategory* item,
- const LLUUID &session_id = LLUUID::null);
- static bool handleGiveDragAndDrop(LLUUID agent, LLUUID session, BOOL drop,
- EDragAndDropType cargo_type,
- void* cargo_data,
- EAcceptance* accept);
- // Classes used for determining 3d drag and drop types.
- private:
- struct DragAndDropEntry : public LLDictionaryEntry
- {
- DragAndDropEntry(dragOrDrop3dImpl f_none,
- dragOrDrop3dImpl f_self,
- dragOrDrop3dImpl f_avatar,
- dragOrDrop3dImpl f_object,
- dragOrDrop3dImpl f_land);
- dragOrDrop3dImpl mFunctions[DT_COUNT];
- };
- class LLDragAndDropDictionary : public LLSingleton<LLDragAndDropDictionary>,
- public LLDictionary<EDragAndDropType, DragAndDropEntry>
- {
- public:
- LLDragAndDropDictionary();
- dragOrDrop3dImpl get(EDragAndDropType dad_type, EDropTarget drop_target);
- };
- };
- // utility functions
- void pack_permissions_slam(LLMessageSystem* msg, U32 flags, const LLPermissions& perms);
- #endif // LL_TOOLDRAGANDDROP_H