minetest/src/mapnode.h

228 lines
5.5 KiB
C
Raw Normal View History

2010-11-27 00:02:21 +01:00
/*
2010-11-29 19:05:30 +01:00
Minetest-c55
2011-02-04 13:32:30 +01:00
Copyright (C) 2010-2011 celeron55, Perttu Ahola <celeron55@gmail.com>
2010-11-29 19:05:30 +01:00
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 2 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, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
2010-11-27 00:02:21 +01:00
*/
#ifndef MAPNODE_HEADER
#define MAPNODE_HEADER
2011-11-13 12:09:45 +01:00
#include "irrlichttypes.h"
2010-11-27 00:02:21 +01:00
#include "light.h"
2011-11-14 20:41:30 +01:00
class INodeDefManager;
/*
Naming scheme:
- Material = irrlicht's Material class
2011-07-23 15:55:26 +02:00
- Content = (content_t) content of a node
- Tile = TileSpec at some side of a node of some content type
2010-11-27 00:02:21 +01:00
2011-07-23 15:55:26 +02:00
Content ranges:
0x000...0x07f: param2 is fully usable
0x800...0xfff: param2 lower 4 bits are free
*/
typedef u16 content_t;
2011-07-23 15:55:26 +02:00
#define MAX_CONTENT 0xfff
/*
Ignored node.
Anything that stores MapNodes doesn't have to preserve parameters
associated with this material.
Doesn't create faces with anything and is considered being
out-of-map in the game map.
*/
#define CONTENT_IGNORE 127
2010-12-13 02:19:12 +01:00
#define CONTENT_IGNORE_DEFAULT_PARAM 0
/*
The common material through which the player can walk and which
is transparent to light
*/
#define CONTENT_AIR 126
2010-11-27 00:02:21 +01:00
2010-12-18 16:46:00 +01:00
enum LightBank
{
LIGHTBANK_DAY,
LIGHTBANK_NIGHT
};
/*
Masks for MapNode.param2 of flowing liquids
*/
#define LIQUID_LEVEL_MASK 0x07
#define LIQUID_FLOW_DOWN_MASK 0x08
2011-08-16 08:31:33 +02:00
/* maximum amount of liquid in a block */
#define LIQUID_LEVEL_MAX LIQUID_LEVEL_MASK
#define LIQUID_LEVEL_SOURCE (LIQUID_LEVEL_MAX+1)
/*
This is the stuff what the whole world consists of.
*/
2010-11-27 00:02:21 +01:00
struct MapNode
{
/*
Main content
0x00-0x7f: Short content type
0x80-0xff: Long content type (param2>>4 makes up low bytes)
*/
u8 param0;
2010-11-27 00:02:21 +01:00
/*
Misc parameter. Initialized to 0.
- For light_propagates() blocks, this is light intensity,
stored logarithmically from 0 to LIGHT_MAX.
Sunlight is LIGHT_SUN, which is LIGHT_MAX+1.
- Contains 2 values, day- and night lighting. Each takes 4 bits.
- Uhh... well, most blocks have light or nothing in here.
2010-11-27 00:02:21 +01:00
*/
u8 param1;
2010-12-13 02:19:12 +01:00
2011-04-04 10:18:14 +02:00
/*
The second parameter. Initialized to 0.
E.g. direction for torches and flowing water.
2011-07-23 15:55:26 +02:00
If param0 >= 0x80, bits 0xf0 of this is extended content type data
2011-04-04 10:18:14 +02:00
*/
u8 param2;
2010-12-01 14:20:12 +01:00
2010-11-27 00:02:21 +01:00
MapNode(const MapNode & n)
{
*this = n;
}
2011-07-23 15:55:26 +02:00
MapNode(content_t content=CONTENT_AIR, u8 a_param1=0, u8 a_param2=0)
2010-11-27 00:02:21 +01:00
{
2011-07-23 15:55:26 +02:00
param1 = a_param1;
param2 = a_param2;
// Set content (param0 and (param2&0xf0)) after other params
// because this needs to override part of param2
2011-07-23 15:55:26 +02:00
setContent(content);
2010-11-27 00:02:21 +01:00
}
2011-11-16 15:47:20 +01:00
// Create directly from a nodename
// If name is unknown, sets CONTENT_IGNORE
MapNode(INodeDefManager *ndef, const std::string &name,
u8 a_param1=0, u8 a_param2=0);
2010-11-27 00:02:21 +01:00
bool operator==(const MapNode &other)
{
2011-07-23 15:55:26 +02:00
return (param0 == other.param0
&& param1 == other.param1
&& param2 == other.param2);
}
// To be used everywhere
2011-11-14 20:41:30 +01:00
content_t getContent() const
{
2011-07-23 15:55:26 +02:00
if(param0 < 0x80)
return param0;
else
return (param0<<4) + (param2>>4);
}
void setContent(content_t c)
{
2011-07-23 15:55:26 +02:00
if(c < 0x80)
{
if(param0 >= 0x80)
param2 &= ~(0xf0);
param0 = c;
}
else
{
param0 = c>>4;
param2 &= ~(0xf0);
param2 |= (c&0x0f)<<4;
}
}
2011-11-17 10:22:24 +01:00
u8 getParam1() const
{
return param1;
}
void setParam1(u8 p)
{
param1 = p;
}
u8 getParam2() const
{
if(param0 < 0x80)
return param2;
else
return param2 & 0x0f;
}
void setParam2(u8 p)
{
if(param0 < 0x80)
param2 = p;
else{
param2 &= 0xf0;
param2 |= (p&0x0f);
}
}
2011-11-14 20:41:30 +01:00
void setLight(enum LightBank bank, u8 a_light, INodeDefManager *nodemgr);
u8 getLight(enum LightBank bank, INodeDefManager *nodemgr) const;
bool getLightBanks(u8 &lightday, u8 &lightnight, INodeDefManager *nodemgr) const;
2010-12-18 16:46:00 +01:00
// 0 <= daylight_factor <= 1000
2010-12-21 17:08:24 +01:00
// 0 <= return value <= LIGHT_SUN
2011-11-14 20:41:30 +01:00
u8 getLightBlend(u32 daylight_factor, INodeDefManager *nodemgr) const
2010-12-18 16:46:00 +01:00
{
u8 lightday = 0;
u8 lightnight = 0;
getLightBanks(lightday, lightnight, nodemgr);
return blend_light(daylight_factor, lightday, lightnight);
2010-12-18 16:46:00 +01:00
}
2010-11-27 00:02:21 +01:00
u8 getFaceDir(INodeDefManager *nodemgr) const;
u8 getWallMounted(INodeDefManager *nodemgr) const;
v3s16 getWallMountedDir(INodeDefManager *nodemgr) const;
/*
Serialization functions
*/
static u32 serializedLength(u8 version);
void serialize(u8 *dest, u8 version);
2011-11-16 12:03:28 +01:00
void deSerialize(u8 *source, u8 version);
// Serializes or deserializes a list of nodes in bulk format (first the
// content of all nodes, then the param1 of all nodes, then the param2
// of all nodes).
// version = serialization version. Must be >= 22
// content_width = the number of bytes of content per node
// params_width = the number of bytes of params per node
// compressed = true to zlib-compress output
static void serializeBulk(std::ostream &os, int version,
const MapNode *nodes, u32 nodecount,
u8 content_width, u8 params_width, bool compressed);
static void deSerializeBulk(std::istream &is, int version,
MapNode *nodes, u32 nodecount,
u8 content_width, u8 params_width, bool compressed);
private:
// Deprecated serialization methods
void serialize_pre22(u8 *dest, u8 version);
void deSerialize_pre22(u8 *source, u8 version);
2010-11-27 00:02:21 +01:00
};
#endif