utility.h: Change Buffer's interface to be more compatible with SharedBuffer's interf...
[oweals/minetest.git] / src / nodemetadata.h
1 /*
2 Minetest-c55
3 Copyright (C) 2010-2011 celeron55, Perttu Ahola <celeron55@gmail.com>
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18 */
19
20 #ifndef NODEMETADATA_HEADER
21 #define NODEMETADATA_HEADER
22
23 #include "common_irrlicht.h"
24 #include <string>
25 #include <iostream>
26
27 /*
28         Used for storing:
29
30         Oven:
31                 - Item that is being burned
32                 - Burning time
33                 - Item stack that is being heated
34                 - Result item stack
35         
36         Sign:
37                 - Text
38 */
39
40 class Inventory;
41
42 class NodeMetadata
43 {
44 public:
45         typedef NodeMetadata* (*Factory)(std::istream&);
46
47         NodeMetadata();
48         virtual ~NodeMetadata();
49         
50         static NodeMetadata* deSerialize(std::istream &is);
51         void serialize(std::ostream &os);
52         
53         // This usually is the CONTENT_ value
54         virtual u16 typeId() const = 0;
55         virtual NodeMetadata* clone() = 0;
56         virtual void serializeBody(std::ostream &os) = 0;
57         virtual std::string infoText() {return "";}
58         virtual Inventory* getInventory() {return NULL;}
59         // This is called always after the inventory is modified, before
60         // the changes are copied elsewhere
61         virtual void inventoryModified(){}
62         // A step in time. Returns true if metadata changed.
63         virtual bool step(float dtime) {return false;}
64         virtual bool nodeRemovalDisabled(){return false;}
65         // Used to make custom inventory menus.
66         // See format in guiInventoryMenu.cpp.
67         virtual std::string getInventoryDrawSpecString(){return "";}
68         // primarily used for locking chests, but others can play too
69         virtual std::string getOwner(){ return std::string(""); }
70         virtual void setOwner(std::string t){  }
71
72 protected:
73         static void registerType(u16 id, Factory f);
74 private:
75         static core::map<u16, Factory> m_types;
76 };
77
78 /*
79         List of metadata of all the nodes of a block
80 */
81
82 class NodeMetadataList
83 {
84 public:
85         ~NodeMetadataList();
86
87         void serialize(std::ostream &os);
88         void deSerialize(std::istream &is);
89         
90         // Get pointer to data
91         NodeMetadata* get(v3s16 p);
92         // Deletes data
93         void remove(v3s16 p);
94         // Deletes old data and sets a new one
95         void set(v3s16 p, NodeMetadata *d);
96         
97         // A step in time. Returns true if something changed.
98         bool step(float dtime);
99
100 private:
101         core::map<v3s16, NodeMetadata*> m_data;
102 };
103
104 #endif
105