//////////////////////////////////////////////////////////////////////// // OpenTibia - an opensource roleplaying game //////////////////////////////////////////////////////////////////////// // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see . //////////////////////////////////////////////////////////////////////// #ifndef __CYLINDER__ #define __CYLINDER__ #include "otsystem.h" #include "thing.h" class Item; class Creature; #define INDEX_WHEREEVER -1 enum cylinderflags_t { FLAG_NOLIMIT = 1, //Bypass limits like capacity/container limits, blocking items/creatures etc. FLAG_IGNOREBLOCKITEM = 2, //Bypass moveable blocking item checks FLAG_IGNOREBLOCKCREATURE = 4, //Bypass creature checks FLAG_CHILDISOWNER = 8, //Used by containers to query capacity of the carrier (player) FLAG_PATHFINDING = 16, //An additional check is done for floor changing/teleport items FLAG_IGNOREFIELDDAMAGE = 32, //Bypass field damage checks FLAG_IGNORENOTMOVEABLE = 64 //Bypass check for movability }; enum cylinderlink_t { LINK_OWNER, LINK_PARENT, LINK_TOPPARENT, LINK_NEAR }; class Cylinder : virtual public Thing { public: /** * Query if the cylinder can add an object * \param index points to the destination index (inventory slot/container position) * -1 is a internal value and means add to a empty position, with no destItem * \param thing the object to move/add * \param count is the amount that we want to move/add * \param flags if FLAG_CHILDISOWNER if set the query is from a child-cylinder (check cap etc.) * if FLAG_NOLIMIT is set blocking items/container limits is ignored * \returns ReturnValue holds the return value */ virtual ReturnValue __queryAdd(int32_t index, const Thing* Item, uint32_t count, uint32_t flags) const = 0; /** * Query the cylinder how much it can accept * \param index points to the destination index (inventory slot/container position) * -1 is a internal value and means add to a empty position, with no destItem * \param item the object to move/add * \param count is the amount that we want to move/add * \param maxQueryCount is the max amount that the cylinder can accept * \param flags optional flags to modifiy the default behaviour * \returns ReturnValue holds the return value */ virtual ReturnValue __queryMaxCount(int32_t index, const Thing* thing, uint32_t count, uint32_t& maxQueryCount, uint32_t flags) const = 0; /** * Query if the cylinder can remove an object * \param item the object to move/remove * \param count is the amount that we want to remove * \param flags optional flags to modifiy the default behaviour * \returns ReturnValue holds the return value */ virtual ReturnValue __queryRemove(const Thing* thing, uint32_t count, uint32_t flags) const = 0; /** * Query the destination cylinder * \param index points to the destination index (inventory slot/container position), * -1 is a internal value and means add to a empty position, with no destItem * this method can change the index to point to the new cylinder index * \param destItem is the destination object * \param flags optional flags to modifiy the default behaviour * this method can modifiy the flags * \returns Cylinder returns the destination cylinder */ virtual Cylinder* __queryDestination(int32_t& index, const Thing* thing, Item** destItem, uint32_t& flags) = 0; /** * Add the object to the cylinder * \param actor is creature adding the object (can be NULL) * \param item is the object to add */ virtual void __addThing(Creature* actor, Thing* thing) = 0; /** * Add the object to the cylinder * \param actor is creature adding the object (can be NULL) * \param index points to the destination index (inventory slot/container position) * \param item is the object to add */ virtual void __addThing(Creature* actor, int32_t index, Thing* thing) = 0; /** * Update the item count or type for an object * \param thing is the object to update * \param itemId is the new item id * \param count is the new count value */ virtual void __updateThing(Thing* thing, uint16_t itemId, uint32_t count) = 0; /** * Replace an object with a new * \param index is the position to change (inventory slot/container position) * \param thing is the object to update */ virtual void __replaceThing(uint32_t index, Thing* thing) = 0; /** * Remove an object * \param thing is the object to delete * \param count is the new count value */ virtual void __removeThing(Thing* thing, uint32_t count) = 0; /** * Is sent after an operation (move/add) to update internal values * \param actor is the creature that is responsible (can be NULL) * \param thing is the object that has been added * \param index is the objects new index value * \param link holds the relation the object has to the cylinder */ virtual void postAddNotification(Creature* actor, Thing* thing, const Cylinder* oldParent, int32_t index, cylinderlink_t link = LINK_OWNER) = 0; /** * Is sent after an operation (move/remove) to update internal values * \param actor is the creature that is responsible (can be NULL) * \param thing is the object that has been removed * \param index is the previous index of the removed object * \param isCompleteRemoval indicates if the item was completely removed or just partially (stackables) * \param link holds the relation the object has to the cylinder */ virtual void postRemoveNotification(Creature* actor, Thing* thing, const Cylinder* newParent, int32_t index, bool isCompleteRemoval, cylinderlink_t link = LINK_OWNER) = 0; /** * Gets the index of an object * \param thing the object to get the index value from * \returns the index of the object, returns -1 if not found */ virtual int32_t __getIndexOfThing(const Thing* thing) const {return -1;} /** * Returns the first index * \returns the first index, if not implemented -1 is returned */ virtual int32_t __getFirstIndex() const {return -1;} /** * Returns the last index * \returns the last index, if not implemented -1 is returned */ virtual int32_t __getLastIndex() const {return -1;} /** * Gets the object based on index * \returns the object, returns NULL if not found */ virtual Thing* __getThing(uint32_t index) const {return NULL;} /** * Get the amount of items of a certain type * \param itemId is the item type to the get the count of * \param subType is the extra type an item can have such as charges/fluidtype, -1 means not used * \param itemCount if set to true it will only count items and not other subtypes like charges * \param returns the amount of items of the asked item type */ virtual uint32_t __getItemTypeCount(uint16_t itemId, int32_t subType = -1, bool itemCount = true) const {return 0;} /** * Get the amount of items of a all types * \param countMap a map to put the itemID:count mapping in * \param itemCount if set to true it will only count items and not other subtypes like charges * \param returns a map mapping item id to count (same as first argument) */ virtual std::map& __getAllItemTypeCount(std::map& countMap, bool itemCount = true) const {return countMap;} /** * Adds an object to the cylinder without sending to the client(s) * \param thing is the object to add */ virtual void __internalAddThing(Thing* thing) {} /** * Adds an object to the cylinder without sending to the client(s) * \param thing is the object to add * \param index points to the destination index (inventory slot/container position) */ virtual void __internalAddThing(uint32_t index, Thing* thing) {} virtual void __startDecaying() {} }; class VirtualCylinder : public Cylinder { public: static VirtualCylinder* virtualCylinder; virtual ReturnValue __queryAdd(int32_t index, const Thing* thing, uint32_t count, uint32_t flags) const {return RET_NOTPOSSIBLE;} virtual ReturnValue __queryMaxCount(int32_t index, const Thing* thing, uint32_t count, uint32_t& maxQueryCount, uint32_t flags) const {return RET_NOTPOSSIBLE;} virtual ReturnValue __queryRemove(const Thing* thing, uint32_t count, uint32_t flags) const {return (thing->getParent() == this ? RET_NOERROR : RET_NOTPOSSIBLE);} virtual Cylinder* __queryDestination(int32_t& index, const Thing* thing, Item** destItem, uint32_t& flags) {return NULL;} virtual void __addThing(Creature* actor, Thing* thing) {} virtual void __addThing(Creature* actor, int32_t index, Thing* thing) {} virtual void __updateThing(Thing* thing, uint16_t itemId, uint32_t count) {} virtual void __replaceThing(uint32_t index, Thing* thing) {} virtual void __removeThing(Thing* thing, uint32_t count) {} virtual void postAddNotification(Creature* actor, Thing* thing, const Cylinder* oldParent, int32_t index, cylinderlink_t link = LINK_OWNER) {} virtual void postRemoveNotification(Creature* actor, Thing* thing, const Cylinder* oldParent, int32_t index, bool isCompleteRemoval, cylinderlink_t link = LINK_OWNER) {} virtual bool isPushable() const {return false;} virtual int getThrowRange() const {return 1;} virtual std::string getDescription(int32_t lookDistance) const {return "";} virtual bool isRemoved() const {return false;} }; #endif