minetest/src/mapnode.h

671 lines
15 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
#include <iostream>
#include "common_irrlicht.h"
#include "light.h"
#include "utility.h"
#include "exceptions.h"
#include "serialization.h"
#include "tile.h"
#include "materials.h"
/*
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 bytes are free
*/
typedef u16 content_t;
2011-07-23 15:55:26 +02:00
#define MAX_CONTENT 0xfff
/*
Initializes all kind of stuff in here.
Many things depend on this.
2011-02-11 15:43:26 +01:00
This accesses g_texturesource; if it is non-NULL, textures are set.
Client first calls this with g_texturesource=NULL to run some
unit tests and stuff, then it runs this again with g_texturesource
defined to get the textures.
Server only calls this once with g_texturesource=NULL.
*/
2011-02-11 15:43:26 +01:00
void init_mapnode();
/*
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 255
#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 254
#define CONTENT_AIR 126
2010-11-27 00:02:21 +01:00
/*
Content feature list
*/
enum ContentParamType
{
CPT_NONE,
CPT_LIGHT,
2011-04-04 10:18:14 +02:00
CPT_MINERAL,
// Direction for chests and furnaces and such
CPT_FACEDIR_SIMPLE
};
enum LiquidType
{
LIQUID_NONE,
LIQUID_FLOWING,
LIQUID_SOURCE
};
2011-08-02 19:18:30 +02:00
struct MapNode;
2011-04-05 01:56:29 +02:00
class NodeMetadata;
struct ContentFeatures
{
2011-07-23 15:55:26 +02:00
// Type of MapNode::param1
ContentParamType param_type;
/*
0: up
1: down
2: right
3: left
4: back
5: front
*/
TileSpec tiles[6];
2011-02-11 15:43:26 +01:00
video::ITexture *inventory_texture;
2011-07-23 01:04:24 +02:00
// True for all ground-like things like stone and mud, false for eg. trees
2011-04-04 10:18:14 +02:00
bool is_ground_content;
bool light_propagates;
bool sunlight_propagates;
u8 solidness; // Used when choosing which face is drawn
// This is used for collision detection.
// Also for general solidness queries.
bool walkable;
// Player can point to these
bool pointable;
// Player can dig these
bool diggable;
2011-08-15 01:04:56 +02:00
// Player can climb these
bool climbable;
// Player can build on these
bool buildable_to;
// Whether the node has no liquid, source liquid or flowing liquid
enum LiquidType liquid_type;
// If true, param2 is set to direction when placed. Used for torches.
// NOTE: the direction format is quite inefficient and should be changed
bool wall_mounted;
// If true, node is equivalent to air. Torches are, air is. Water is not.
// Is used for example to check whether a mud block can have grass on.
bool air_equivalent;
// Inventory item string as which the node appears in inventory when dug.
// Mineral overrides this.
std::string dug_item;
2011-04-04 02:45:08 +02:00
// Initial metadata is cloned from this
NodeMetadata *initial_metadata;
// If the content is liquid, this is the flowing version of the liquid.
// If content is liquid, this is the same content.
2011-07-23 15:55:26 +02:00
content_t liquid_alternative_flowing;
// If the content is liquid, this is the source version of the liquid.
content_t liquid_alternative_source;
2011-08-16 19:56:57 +02:00
// Viscosity for fluid flow, ranging from 1 to 7, with
// 1 giving almost instantaneous propagation and 7 being
// the slowest possible
u8 liquid_viscosity;
2011-08-15 01:04:56 +02:00
// Used currently for flowing liquids
u8 vertex_alpha;
// Special irrlicht material, used sometimes
video::SMaterial *special_material;
AtlasPointer *special_atlas;
// Amount of light the node emits
u8 light_source;
// Digging properties for different tools
DiggingPropertiesList digging_properties;
2011-08-15 10:49:39 +02:00
u32 damage_per_second;
// NOTE: Move relevant properties to here from elsewhere
void reset()
{
param_type = CPT_NONE;
2011-02-11 15:43:26 +01:00
inventory_texture = NULL;
is_ground_content = false;
light_propagates = false;
sunlight_propagates = false;
solidness = 2;
walkable = true;
pointable = true;
diggable = true;
2011-07-27 23:38:48 +02:00
climbable = false;
buildable_to = false;
liquid_type = LIQUID_NONE;
wall_mounted = false;
air_equivalent = false;
dug_item = "";
2011-04-04 02:45:08 +02:00
initial_metadata = NULL;
liquid_alternative_flowing = CONTENT_IGNORE;
2011-08-15 01:04:56 +02:00
liquid_alternative_source = CONTENT_IGNORE;
2011-08-16 19:56:57 +02:00
liquid_viscosity = 0;
2011-08-15 01:04:56 +02:00
vertex_alpha = 255;
special_material = NULL;
special_atlas = NULL;
light_source = 0;
digging_properties.clear();
2011-08-15 10:49:39 +02:00
damage_per_second = 0;
}
ContentFeatures()
{
reset();
}
~ContentFeatures();
2010-11-27 00:02:21 +01:00
/*
Quickhands for simple materials
*/
void setTexture(u16 i, std::string name, u8 alpha=255);
void setAllTextures(std::string name, u8 alpha=255)
{
for(u16 i=0; i<6; i++)
{
setTexture(i, name, alpha);
}
// Force inventory texture too
setInventoryTexture(name);
}
2011-02-08 00:12:55 +01:00
void setTile(u16 i, const TileSpec &tile)
{
2011-02-08 00:12:55 +01:00
tiles[i] = tile;
}
void setAllTiles(const TileSpec &tile)
{
for(u16 i=0; i<6; i++)
{
setTile(i, tile);
}
}
2011-02-11 15:43:26 +01:00
void setInventoryTexture(std::string imgname);
void setInventoryTextureCube(std::string top,
std::string left, std::string right);
};
2010-11-27 00:02:21 +01:00
/*
Call this to access the ContentFeature list
*/
2011-07-23 15:55:26 +02:00
ContentFeatures & content_features(content_t i);
ContentFeatures & content_features(MapNode &n);
/*
Here is a bunch of DEPRECATED functions.
*/
2010-11-27 00:02:21 +01:00
/*
If true, the material allows light propagation and brightness is stored
in param.
NOTE: Don't use, use "content_features(m).whatever" instead
2010-11-27 00:02:21 +01:00
*/
2011-07-23 15:55:26 +02:00
inline bool light_propagates_content(content_t m)
2010-11-27 00:02:21 +01:00
{
return content_features(m).light_propagates;
2010-11-27 00:02:21 +01:00
}
/*
If true, the material allows lossless sunlight propagation.
2010-12-25 00:54:39 +01:00
NOTE: It doesn't seem to go through torches regardlessly of this
NOTE: Don't use, use "content_features(m).whatever" instead
2010-11-27 00:02:21 +01:00
*/
2011-07-23 15:55:26 +02:00
inline bool sunlight_propagates_content(content_t m)
2010-11-27 00:02:21 +01:00
{
return content_features(m).sunlight_propagates;
2010-11-27 00:02:21 +01:00
}
/*
On a node-node surface, the material of the node with higher solidness
is used for drawing.
0: Invisible
1: Transparent
2: Opaque
NOTE: Don't use, use "content_features(m).whatever" instead
2010-11-27 00:02:21 +01:00
*/
2011-07-23 15:55:26 +02:00
inline u8 content_solidness(content_t m)
2010-11-27 00:02:21 +01:00
{
return content_features(m).solidness;
2010-11-27 00:02:21 +01:00
}
2010-12-13 02:19:12 +01:00
// Objects collide with walkable contents
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_walkable(content_t m)
2010-11-30 14:35:03 +01:00
{
return content_features(m).walkable;
2010-11-30 14:35:03 +01:00
}
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_liquid(content_t m)
2010-11-30 14:35:03 +01:00
{
return content_features(m).liquid_type != LIQUID_NONE;
2010-11-30 14:35:03 +01:00
}
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_flowing_liquid(content_t m)
{
return content_features(m).liquid_type == LIQUID_FLOWING;
}
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_liquid_source(content_t m)
{
return content_features(m).liquid_type == LIQUID_SOURCE;
}
// CONTENT_WATER || CONTENT_WATERSOURCE -> CONTENT_WATER
// CONTENT_LAVA || CONTENT_LAVASOURCE -> CONTENT_LAVA
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline content_t make_liquid_flowing(content_t m)
{
u8 c = content_features(m).liquid_alternative_flowing;
assert(c != CONTENT_IGNORE);
return c;
}
2010-12-13 02:19:12 +01:00
// Pointable contents can be pointed to in the map
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_pointable(content_t m)
2010-11-30 14:35:03 +01:00
{
return content_features(m).pointable;
2010-11-30 14:35:03 +01:00
}
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_diggable(content_t m)
2010-11-30 14:35:03 +01:00
{
return content_features(m).diggable;
2010-11-30 14:35:03 +01:00
}
// NOTE: Don't use, use "content_features(m).whatever" instead
2011-07-23 15:55:26 +02:00
inline bool content_buildable_to(content_t m)
2010-11-30 14:35:03 +01:00
{
return content_features(m).buildable_to;
}
2010-11-27 00:02:21 +01:00
/*
2010-12-13 02:19:12 +01:00
Nodes make a face if contents differ and solidness differs.
2010-11-27 00:02:21 +01:00
Return value:
0: No face
2010-12-13 02:19:12 +01:00
1: Face uses m1's content
2: Face uses m2's content
2010-11-27 00:02:21 +01:00
*/
2011-07-23 15:55:26 +02:00
inline u8 face_contents(content_t m1, content_t m2)
2010-11-27 00:02:21 +01:00
{
2010-12-13 02:19:12 +01:00
if(m1 == CONTENT_IGNORE || m2 == CONTENT_IGNORE)
2010-11-27 00:02:21 +01:00
return 0;
2010-12-13 02:19:12 +01:00
bool contents_differ = (m1 != m2);
2011-01-24 00:58:15 +01:00
// Contents don't differ for different forms of same liquid
if(content_liquid(m1) && content_liquid(m2)
&& make_liquid_flowing(m1) == make_liquid_flowing(m2))
contents_differ = false;
2010-12-13 02:19:12 +01:00
bool solidness_differs = (content_solidness(m1) != content_solidness(m2));
bool makes_face = contents_differ && solidness_differs;
2010-11-27 00:02:21 +01:00
if(makes_face == false)
return 0;
2010-12-13 02:19:12 +01:00
if(content_solidness(m1) > content_solidness(m2))
2010-11-27 00:02:21 +01:00
return 1;
else
return 2;
}
2010-12-13 02:19:12 +01:00
/*
Packs directions like (1,0,0), (1,-1,0)
*/
inline u8 packDir(v3s16 dir)
{
u8 b = 0;
if(dir.X > 0)
b |= (1<<0);
else if(dir.X < 0)
b |= (1<<1);
if(dir.Y > 0)
b |= (1<<2);
else if(dir.Y < 0)
b |= (1<<3);
if(dir.Z > 0)
b |= (1<<4);
else if(dir.Z < 0)
b |= (1<<5);
return b;
}
inline v3s16 unpackDir(u8 b)
{
v3s16 d(0,0,0);
if(b & (1<<0))
d.X = 1;
else if(b & (1<<1))
d.X = -1;
if(b & (1<<2))
d.Y = 1;
else if(b & (1<<3))
d.Y = -1;
if(b & (1<<4))
d.Z = 1;
else if(b & (1<<5))
d.Z = -1;
return d;
}
2011-04-04 10:18:14 +02:00
/*
facedir: CPT_FACEDIR_SIMPLE param1 value
dir: The face for which stuff is wanted
return value: The face from which the stuff is actually found
NOTE: Currently this uses 2 bits for Z-,X-,Z+,X+, should there be Y+
and Y- too?
2011-04-04 10:18:14 +02:00
*/
v3s16 facedir_rotate(u8 facedir, v3s16 dir);
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)
*/
union
{
u8 param0;
2011-07-23 15:55:26 +02:00
//u8 d;
};
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.
- Mineral content (should be removed from here)
- Uhh... well, most blocks have light or nothing in here.
2010-11-27 00:02:21 +01:00
*/
2011-04-04 10:18:14 +02:00
union
{
u8 param1;
2011-07-23 15:55:26 +02:00
//s8 param;
2011-04-04 10:18:14 +02:00
};
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
*/
2010-12-13 02:19:12 +01:00
union
{
2011-02-08 00:12:55 +01:00
u8 param2;
2011-07-23 15:55:26 +02:00
//u8 dir;
2010-12-13 02:19:12 +01:00
};
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
//param0 = a_param0;
param1 = a_param1;
param2 = a_param2;
2011-07-23 15:55:26 +02:00
// Set after other params because this needs to override part of param2
setContent(content);
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
content_t getContent()
{
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;
}
}
/*
These four are DEPRECATED I guess. -c55
*/
2010-11-27 00:02:21 +01:00
bool light_propagates()
{
2011-07-23 15:55:26 +02:00
return light_propagates_content(getContent());
2010-11-27 00:02:21 +01:00
}
bool sunlight_propagates()
{
2011-07-23 15:55:26 +02:00
return sunlight_propagates_content(getContent());
2010-11-27 00:02:21 +01:00
}
u8 solidness()
{
2011-07-23 15:55:26 +02:00
return content_solidness(getContent());
2010-11-27 00:02:21 +01:00
}
u8 light_source()
{
2011-07-23 15:55:26 +02:00
return content_features(*this).light_source;
2010-11-27 00:02:21 +01:00
}
2010-12-18 16:46:00 +01:00
u8 getLightBanksWithSource()
{
// Select the brightest of [light source, propagated light]
u8 lightday = 0;
u8 lightnight = 0;
2011-07-23 15:55:26 +02:00
if(content_features(*this).param_type == CPT_LIGHT)
2010-12-18 16:46:00 +01:00
{
2011-07-23 15:55:26 +02:00
lightday = param1 & 0x0f;
lightnight = (param1>>4)&0x0f;
2010-12-18 16:46:00 +01:00
}
if(light_source() > lightday)
lightday = light_source();
if(light_source() > lightnight)
lightnight = light_source();
return (lightday&0x0f) | ((lightnight<<4)&0xf0);
}
u8 getLight(enum LightBank bank)
2010-11-27 00:02:21 +01:00
{
2010-12-13 02:19:12 +01:00
// Select the brightest of [light source, propagated light]
2010-11-27 00:02:21 +01:00
u8 light = 0;
2011-07-23 15:55:26 +02:00
if(content_features(*this).param_type == CPT_LIGHT)
2010-12-18 16:46:00 +01:00
{
if(bank == LIGHTBANK_DAY)
2011-07-23 15:55:26 +02:00
light = param1 & 0x0f;
2010-12-18 16:46:00 +01:00
else if(bank == LIGHTBANK_NIGHT)
2011-07-23 15:55:26 +02:00
light = (param1>>4)&0x0f;
2010-12-18 16:46:00 +01:00
else
assert(0);
}
2010-11-27 00:02:21 +01:00
if(light_source() > light)
light = light_source();
return light;
}
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
2010-12-18 16:46:00 +01:00
u8 getLightBlend(u32 daylight_factor)
{
u8 l = ((daylight_factor * getLight(LIGHTBANK_DAY)
+ (1000-daylight_factor) * getLight(LIGHTBANK_NIGHT))
)/1000;
u8 max = LIGHT_MAX;
if(getLight(LIGHTBANK_DAY) == LIGHT_SUN)
max = LIGHT_SUN;
if(l > max)
l = max;
return l;
}
2010-12-21 17:08:24 +01:00
/*// 0 <= daylight_factor <= 1000
// 0 <= return value <= 255
u8 getLightBlend(u32 daylight_factor)
{
u8 daylight = decode_light(getLight(LIGHTBANK_DAY));
u8 nightlight = decode_light(getLight(LIGHTBANK_NIGHT));
u8 mix = ((daylight_factor * daylight
+ (1000-daylight_factor) * nightlight)
)/1000;
return mix;
}*/
2010-11-27 00:02:21 +01:00
2010-12-18 16:46:00 +01:00
void setLight(enum LightBank bank, u8 a_light)
2010-11-27 00:02:21 +01:00
{
// If node doesn't contain light data, ignore this
2011-07-23 15:55:26 +02:00
if(content_features(*this).param_type != CPT_LIGHT)
2010-11-27 00:02:21 +01:00
return;
2010-12-18 16:46:00 +01:00
if(bank == LIGHTBANK_DAY)
{
2011-07-23 15:55:26 +02:00
param1 &= 0xf0;
param1 |= a_light & 0x0f;
2010-12-18 16:46:00 +01:00
}
else if(bank == LIGHTBANK_NIGHT)
{
2011-07-23 15:55:26 +02:00
param1 &= 0x0f;
param1 |= (a_light & 0x0f)<<4;
2010-12-18 16:46:00 +01:00
}
else
assert(0);
2010-11-27 00:02:21 +01:00
}
// In mapnode.cpp
/*
Get tile of a face of the node.
dir: direction of face
Returns: TileSpec. Can contain miscellaneous texture coordinates,
which must be obeyed so that the texture atlas can be used.
*/
TileSpec getTile(v3s16 dir);
/*
Gets mineral content of node, if there is any.
MINERAL_NONE if doesn't contain or isn't able to contain mineral.
*/
u8 getMineral();
/*
Serialization functions
*/
static u32 serializedLength(u8 version);
void serialize(u8 *dest, u8 version);
void deSerialize(u8 *source, u8 version);
2010-11-27 00:02:21 +01:00
};
/*
Gets lighting value at face of node
Parameters must consist of air and !air.
Order doesn't matter.
2010-11-27 00:02:21 +01:00
If either of the nodes doesn't exist, light is 0.
parameters:
daynight_ratio: 0...1000
n: getNodeParent(p)
n2: getNodeParent(p + face_dir)
face_dir: axis oriented unit vector from p to p2
returns encoded light value.
*/
u8 getFaceLight(u32 daynight_ratio, MapNode n, MapNode n2,
v3s16 face_dir);
2010-11-27 00:02:21 +01:00
#endif