3 Copyright (C) 2010-2011 celeron55, Perttu Ahola <celeron55@gmail.com>
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.
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.
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.
20 #ifndef MAPNODE_HEADER
21 #define MAPNODE_HEADER
24 #include "common_irrlicht.h"
27 #include "exceptions.h"
28 #include "serialization.h"
30 #include "iirrlichtwrapper.h"
33 Initializes all kind of stuff in here.
34 Many things depend on this.
36 This accesses g_texturesource; if it is non-NULL, textures are set.
38 Client first calls this with g_texturesource=NULL to run some
39 unit tests and stuff, then it runs this again with g_texturesource
40 defined to get the textures.
42 Server only calls this once with g_texturesource=NULL.
46 // Initializes g_content_inventory_texture_paths
47 void init_content_inventory_texture_paths();
50 // NOTE: This is not used appropriately everywhere.
51 #define MATERIALS_COUNT 256
56 Anything that stores MapNodes doesn't have to preserve parameters
57 associated with this material.
59 Doesn't create faces with anything and is considered being
60 out-of-map in the game map.
62 #define CONTENT_IGNORE 255
63 #define CONTENT_IGNORE_DEFAULT_PARAM 0
66 The common material through which the player can walk and which
67 is transparent to light
69 #define CONTENT_AIR 254
77 - Material = irrlicht's Material class
78 - Content = (u8) content of a node
79 - Tile = (u16) Material ID at some side of a node
82 #define CONTENT_STONE 0
83 #define CONTENT_GRASS 1
84 #define CONTENT_WATER 2
85 #define CONTENT_TORCH 3
86 #define CONTENT_TREE 4
87 #define CONTENT_LEAVES 5
88 #define CONTENT_GRASS_FOOTSTEPS 6
89 #define CONTENT_MESE 7
91 #define CONTENT_WATERSOURCE 9
92 // Pretty much useless, clouds won't be drawn this way
93 #define CONTENT_CLOUD 10
94 #define CONTENT_COALSTONE 11
95 #define CONTENT_WOOD 12
96 #define CONTENT_SAND 13
99 This is used by all kinds of things to allocate memory for all
100 contents except CONTENT_AIR and CONTENT_IGNORE
102 #define USEFUL_CONTENT_COUNT 14
108 enum ContentParamType
124 struct ContentFeatures
126 // If non-NULL, content is translated to this when deserialized
127 MapNode *translate_to;
129 // Type of MapNode::param
130 ContentParamType param_type;
142 // TODO: Somehow specify inventory image
143 //std::string inventory_image_path;
144 //TextureSpec inventory_texture;
145 //u32 inventory_texture_id;
146 video::ITexture *inventory_texture;
148 bool is_ground_content; //TODO: Remove, use walkable instead
149 bool light_propagates;
150 bool sunlight_propagates;
151 u8 solidness; // Used when choosing which face is drawn
156 enum LiquidType liquid_type;
157 bool wall_mounted; // If true, param2 is set to direction when placed
159 //TODO: Move more properties here
164 param_type = CPT_NONE;
165 inventory_texture = NULL;
166 is_ground_content = false;
167 light_propagates = false;
168 sunlight_propagates = false;
173 buildable_to = false;
174 liquid_type = LIQUID_NONE;
175 wall_mounted = false;
181 Quickhands for simple materials
184 void setTexture(u16 i, std::string name, u8 alpha=255);
186 void setAllTextures(std::string name, u8 alpha=255)
188 for(u16 i=0; i<6; i++)
190 setTexture(i, name, alpha);
194 /*void setTexture(u16 i, AtlasPointer p, u8 alpha=255)
196 tiles[i].texture = p;
199 tiles[i].alpha = alpha;
200 tiles[i].material_type = MATERIAL_ALPHA_VERTEX;
203 void setAllTextures(AtlasPointer p, u8 alpha=255)
205 for(u16 i=0; i<6; i++)
207 setTexture(i, p, alpha);
211 void setTile(u16 i, const TileSpec &tile)
215 void setAllTiles(const TileSpec &tile)
217 for(u16 i=0; i<6; i++)
223 void setInventoryTexture(std::string imgname);
225 void setInventoryTextureCube(std::string top,
226 std::string left, std::string right);
230 Call this to access the ContentFeature list
232 ContentFeatures & content_features(u8 i);
235 If true, the material allows light propagation and brightness is stored
237 NOTE: Don't use, use "content_features(m).whatever" instead
239 inline bool light_propagates_content(u8 m)
241 return content_features(m).light_propagates;
242 //return (m == CONTENT_AIR || m == CONTENT_TORCH || m == CONTENT_WATER || m == CONTENT_WATERSOURCE);
246 If true, the material allows lossless sunlight propagation.
247 NOTE: It doesn't seem to go through torches regardlessly of this
248 NOTE: Don't use, use "content_features(m).whatever" instead
250 inline bool sunlight_propagates_content(u8 m)
252 return content_features(m).sunlight_propagates;
253 //return (m == CONTENT_AIR || m == CONTENT_TORCH);
257 On a node-node surface, the material of the node with higher solidness
262 NOTE: Don't use, use "content_features(m).whatever" instead
264 inline u8 content_solidness(u8 m)
266 return content_features(m).solidness;
267 /*// As of now, every pseudo node like torches are added to this
268 if(m == CONTENT_AIR || m == CONTENT_TORCH || m == CONTENT_WATER)
270 if(m == CONTENT_WATER || m == CONTENT_WATERSOURCE)
275 // Objects collide with walkable contents
276 // NOTE: Don't use, use "content_features(m).whatever" instead
277 inline bool content_walkable(u8 m)
279 return content_features(m).walkable;
280 //return (m != CONTENT_AIR && m != CONTENT_WATER && m != CONTENT_WATERSOURCE && m != CONTENT_TORCH);
283 // NOTE: Don't use, use "content_features(m).whatever" instead
284 inline bool content_liquid(u8 m)
286 return content_features(m).liquid_type != LIQUID_NONE;
287 //return (m == CONTENT_WATER || m == CONTENT_WATERSOURCE);
290 // NOTE: Don't use, use "content_features(m).whatever" instead
291 inline bool content_flowing_liquid(u8 m)
293 return content_features(m).liquid_type == LIQUID_FLOWING;
294 //return (m == CONTENT_WATER);
297 // NOTE: Don't use, use "content_features(m).whatever" instead
298 inline bool content_liquid_source(u8 m)
300 return content_features(m).liquid_type == LIQUID_SOURCE;
301 //return (m == CONTENT_WATERSOURCE);
304 // CONTENT_WATER || CONTENT_WATERSOURCE -> CONTENT_WATER
305 // CONTENT_LAVA || CONTENT_LAVASOURCE -> CONTENT_LAVA
306 inline u8 make_liquid_flowing(u8 m)
308 if(m == CONTENT_WATER || m == CONTENT_WATERSOURCE)
309 return CONTENT_WATER;
313 // Pointable contents can be pointed to in the map
314 // NOTE: Don't use, use "content_features(m).whatever" instead
315 inline bool content_pointable(u8 m)
317 return content_features(m).pointable;
318 //return (m != CONTENT_AIR && m != CONTENT_WATER && m != CONTENT_WATERSOURCE);
321 // NOTE: Don't use, use "content_features(m).whatever" instead
322 inline bool content_diggable(u8 m)
324 return content_features(m).diggable;
325 //return (m != CONTENT_AIR && m != CONTENT_WATER && m != CONTENT_WATERSOURCE);
328 // NOTE: Don't use, use "content_features(m).whatever" instead
329 inline bool content_buildable_to(u8 m)
331 return content_features(m).buildable_to;
332 //return (m == CONTENT_AIR || m == CONTENT_WATER || m == CONTENT_WATERSOURCE);
336 Returns true for contents that form the base ground that
337 follows the main heightmap
339 /*inline bool is_ground_content(u8 m)
341 return content_features(m).is_ground_content;
345 Nodes make a face if contents differ and solidness differs.
348 1: Face uses m1's content
349 2: Face uses m2's content
351 inline u8 face_contents(u8 m1, u8 m2)
353 if(m1 == CONTENT_IGNORE || m2 == CONTENT_IGNORE)
356 bool contents_differ = (m1 != m2);
358 // Contents don't differ for different forms of same liquid
359 if(content_liquid(m1) && content_liquid(m2)
360 && make_liquid_flowing(m1) == make_liquid_flowing(m2))
361 contents_differ = false;
363 bool solidness_differs = (content_solidness(m1) != content_solidness(m2));
364 bool makes_face = contents_differ && solidness_differs;
366 if(makes_face == false)
369 if(content_solidness(m1) > content_solidness(m2))
376 Packs directions like (1,0,0), (1,-1,0)
378 inline u8 packDir(v3s16 dir)
399 inline v3s16 unpackDir(u8 b)
428 This is the stuff what the whole world consists of.
437 Misc parameter. Initialized to 0.
438 - For light_propagates() blocks, this is light intensity,
439 stored logarithmically from 0 to LIGHT_MAX.
440 Sunlight is LIGHT_SUN, which is LIGHT_MAX+1.
441 - Contains 2 values, day- and night lighting. Each takes 4 bits.
448 The second parameter. Initialized to 0.
449 Direction for torches and flowing water.
455 MapNode(const MapNode & n)
460 MapNode(u8 data=CONTENT_AIR, u8 a_param=0, u8 a_param2=0)
467 /*MapNode & operator=(const MapNode &other)
471 param2 = other.param2;
475 bool operator==(const MapNode &other)
478 && param == other.param
479 && param2 == other.param2);
482 bool light_propagates()
484 return light_propagates_content(d);
487 bool sunlight_propagates()
489 return sunlight_propagates_content(d);
494 return content_solidness(d);
500 Note that a block that isn't light_propagates() can be a light source.
502 if(d == CONTENT_TORCH)
508 u8 getLightBanksWithSource()
510 // Select the brightest of [light source, propagated light]
513 if(light_propagates())
515 lightday = param & 0x0f;
516 lightnight = (param>>4)&0x0f;
518 if(light_source() > lightday)
519 lightday = light_source();
520 if(light_source() > lightnight)
521 lightnight = light_source();
522 return (lightday&0x0f) | ((lightnight<<4)&0xf0);
525 void setLightBanks(u8 a_light)
530 u8 getLight(enum LightBank bank)
532 // Select the brightest of [light source, propagated light]
534 if(light_propagates())
536 if(bank == LIGHTBANK_DAY)
537 light = param & 0x0f;
538 else if(bank == LIGHTBANK_NIGHT)
539 light = (param>>4)&0x0f;
543 if(light_source() > light)
544 light = light_source();
548 // 0 <= daylight_factor <= 1000
549 // 0 <= return value <= LIGHT_SUN
550 u8 getLightBlend(u32 daylight_factor)
552 u8 l = ((daylight_factor * getLight(LIGHTBANK_DAY)
553 + (1000-daylight_factor) * getLight(LIGHTBANK_NIGHT))
556 if(getLight(LIGHTBANK_DAY) == LIGHT_SUN)
562 /*// 0 <= daylight_factor <= 1000
563 // 0 <= return value <= 255
564 u8 getLightBlend(u32 daylight_factor)
566 u8 daylight = decode_light(getLight(LIGHTBANK_DAY));
567 u8 nightlight = decode_light(getLight(LIGHTBANK_NIGHT));
568 u8 mix = ((daylight_factor * daylight
569 + (1000-daylight_factor) * nightlight)
574 void setLight(enum LightBank bank, u8 a_light)
576 // If not transparent, can't set light
577 if(light_propagates() == false)
579 if(bank == LIGHTBANK_DAY)
582 param |= a_light & 0x0f;
584 else if(bank == LIGHTBANK_NIGHT)
587 param |= (a_light & 0x0f)<<4;
594 TileSpec getTile(v3s16 dir);
599 These serialization functions are used when informing client
603 static u32 serializedLength(u8 version)
605 if(!ser_ver_supported(version))
606 throw VersionMismatchException("ERROR: MapNode format not supported");
610 else if(version <= 9)
615 void serialize(u8 *dest, u8 version)
617 if(!ser_ver_supported(version))
618 throw VersionMismatchException("ERROR: MapNode format not supported");
624 else if(version <= 9)
636 void deSerialize(u8 *source, u8 version)
638 if(!ser_ver_supported(version))
639 throw VersionMismatchException("ERROR: MapNode format not supported");
645 else if(version == 1)
648 // This version doesn't support saved lighting
649 if(light_propagates() || light_source() > 0)
654 else if(version <= 9)
666 // Translate deprecated stuff
667 // NOTE: This doesn't get used because MapBlock handles node
668 // parameters directly
669 MapNode *translate_to = content_features(d).translate_to;
672 dstream<<"MapNode: WARNING: Translating "<<d<<" to "
673 <<translate_to->d<<std::endl;
674 *this = *translate_to;
680 Returns integer position of the node in given
681 floating point position.
683 inline v3s16 floatToInt(v3f p)
686 (p.X + (p.X>0 ? BS/2 : -BS/2))/BS,
687 (p.Y + (p.Y>0 ? BS/2 : -BS/2))/BS,
688 (p.Z + (p.Z>0 ? BS/2 : -BS/2))/BS);
693 The same thing backwards
695 inline v3f intToFloat(v3s16 p)