/*
-(c) 2010 Perttu Ahola <celeron55@gmail.com>
+Minetest-c55
+Copyright (C) 2010 celeron55, Perttu Ahola <celeron55@gmail.com>
+
+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.
*/
#ifndef MAPBLOCK_HEADER
#include "exceptions.h"
#include "serialization.h"
#include "constants.h"
-#include "mapblockobject.h"
+#include "voxel.h"
+#include "staticobject.h"
+#include "mapblock_nodemod.h"
+#include "modifiedstate.h"
-#define MAP_BLOCKSIZE 16
+class Map;
+class NodeMetadataList;
+class IGameDef;
+class IWritableNodeDefManager;
-// Named by looking towards z+
+#define BLOCK_TIMESTAMP_UNDEFINED 0xffffffff
+
+/*// Named by looking towards z+
enum{
FACE_BACK=0,
FACE_TOP,
FACE_FRONT,
FACE_BOTTOM,
FACE_LEFT
-};
+};*/
-struct FastFace
+// NOTE: If this is enabled, set MapBlock to be initialized with
+// CONTENT_IGNORE.
+/*enum BlockGenerationStatus
{
- u8 material;
- video::S3DVertex vertices[4]; // Precalculated vertices
-};
-
+ // Completely non-generated (filled with CONTENT_IGNORE).
+ BLOCKGEN_UNTOUCHED=0,
+ // Trees or similar might have been blitted from other blocks to here.
+ // Otherwise, the block contains CONTENT_IGNORE
+ BLOCKGEN_FROM_NEIGHBORS=2,
+ // Has been generated, but some neighbors might put some stuff in here
+ // when they are generated.
+ // Does not contain any CONTENT_IGNORE
+ BLOCKGEN_SELF_GENERATED=4,
+ // The block and all its neighbors have been generated
+ BLOCKGEN_FULLY_GENERATED=6
+};*/
+
+#if 0
enum
{
NODECONTAINER_ID_MAPBLOCK,
NODECONTAINER_ID_MAPSECTOR,
- NODECONTAINER_ID_MAP
+ NODECONTAINER_ID_MAP,
+ NODECONTAINER_ID_MAPBLOCKCACHE,
+ NODECONTAINER_ID_VOXELMANIPULATOR,
};
class NodeContainer
virtual MapNode getNode(v3s16 p) = 0;
virtual void setNode(v3s16 p, MapNode & n) = 0;
virtual u16 nodeContainerId() const = 0;
+
+ MapNode getNodeNoEx(v3s16 p)
+ {
+ try{
+ return getNode(p);
+ }
+ catch(InvalidPositionException &e){
+ return MapNode(CONTENT_IGNORE);
+ }
+ }
};
+#endif
-class MapBlock : public NodeContainer
-{
-private:
+/*
+ MapBlock itself
+*/
- NodeContainer *m_parent;
- // Position in blocks on parent
- v3s16 m_pos;
- /*
- If NULL, block is a dummy block.
- Dummy blocks are used for caching not-found-on-disk blocks.
- */
- MapNode * data;
- /*
- - On the client, this is used for checking whether to
- recalculate the face cache. (Is it anymore?)
- - On the server, this is used for telling whether the
- block has been changed from the one on disk.
- */
- bool changed;
- /*
- Used for some initial lighting stuff.
- At least /has been/ used. 8)
- */
- bool is_underground;
+class MapBlock /*: public NodeContainer*/
+{
+public:
+ MapBlock(Map *parent, v3s16 pos, IGameDef *gamedef, bool dummy=false);
+ ~MapBlock();
- MapBlockObjectList m_objects;
+ /*virtual u16 nodeContainerId() const
+ {
+ return NODECONTAINER_ID_MAPBLOCK;
+ }*/
-public:
-
- /*
- This used by Server's block creation stuff for not sending
- blocks that are waiting a lighting update.
+ Map * getParent()
+ {
+ return m_parent;
+ }
- If true, the block needs some work by the one who set this
- to true.
+ void reallocate()
+ {
+ if(data != NULL)
+ delete[] data;
+ u32 l = MAP_BLOCKSIZE * MAP_BLOCKSIZE * MAP_BLOCKSIZE;
+ data = new MapNode[l];
+ for(u32 i=0; i<l; i++){
+ //data[i] = MapNode();
+ data[i] = MapNode(CONTENT_IGNORE);
+ }
+ raiseModified(MOD_STATE_WRITE_NEEDED, "reallocate");
+ }
- While true, nobody else should touch the block.
+ /*
+ Flags
*/
- //bool is_incomplete;
+
+ bool isDummy()
+ {
+ return (data == NULL);
+ }
+ void unDummify()
+ {
+ assert(isDummy());
+ reallocate();
+ }
- scene::SMesh *mesh;
- JMutex mesh_mutex;
+ // m_modified methods
+ void raiseModified(u32 mod, const std::string &reason="unknown")
+ {
+ if(mod > m_modified){
+ m_modified = mod;
+ m_modified_reason = reason;
+ m_modified_reason_too_long = false;
- MapBlock(NodeContainer *parent, v3s16 pos, bool dummy=false):
- m_parent(parent),
- m_pos(pos),
- changed(true),
- is_underground(false),
- m_objects(this)
- //is_incomplete(false)
- {
- data = NULL;
- if(dummy == false)
- reallocate();
- mesh_mutex.Init();
- mesh = NULL;
- }
-
- ~MapBlock()
- {
- {
- JMutexAutoLock lock(mesh_mutex);
-
- if(mesh != NULL)
- {
- mesh->drop();
- mesh = NULL;
+ if(m_modified >= MOD_STATE_WRITE_AT_UNLOAD){
+ m_disk_timestamp = m_timestamp;
+ }
+ } else if(mod == m_modified){
+ if(!m_modified_reason_too_long){
+ if(m_modified_reason.size() < 40)
+ m_modified_reason += ", " + reason;
+ else{
+ m_modified_reason += "...";
+ m_modified_reason_too_long = true;
+ }
}
}
-
- if(data)
- delete[] data;
+ }
+ u32 getModified()
+ {
+ return m_modified;
+ }
+ std::string getModifiedReason()
+ {
+ return m_modified_reason;
+ }
+ void resetModified()
+ {
+ m_modified = MOD_STATE_CLEAN;
+ m_modified_reason = "none";
+ m_modified_reason_too_long = false;
}
- virtual u16 nodeContainerId() const
+ // is_underground getter/setter
+ bool getIsUnderground()
{
- return NODECONTAINER_ID_MAPBLOCK;
+ return is_underground;
}
-
- NodeContainer * getParent()
+ void setIsUnderground(bool a_is_underground)
{
- return m_parent;
+ is_underground = a_is_underground;
+ raiseModified(MOD_STATE_WRITE_NEEDED, "setIsUnderground");
}
- bool isDummy()
+#ifndef SERVER
+ void setMeshExpired(bool expired)
{
- return (data == NULL);
+ m_mesh_expired = expired;
+ }
+
+ bool getMeshExpired()
+ {
+ return m_mesh_expired;
}
+#endif
- void unDummify()
+ void setLightingExpired(bool expired)
{
- assert(isDummy());
- reallocate();
+ if(expired != m_lighting_expired){
+ m_lighting_expired = expired;
+ raiseModified(MOD_STATE_WRITE_NEEDED, "setLightingExpired");
+ }
}
-
- bool getChangedFlag()
+ bool getLightingExpired()
{
- return changed;
+ return m_lighting_expired;
}
- void resetChangedFlag()
+ bool isGenerated()
+ {
+ return m_generated;
+ }
+ void setGenerated(bool b)
{
- changed = false;
+ if(b != m_generated){
+ raiseModified(MOD_STATE_WRITE_NEEDED, "setGenerated");
+ m_generated = b;
+ }
}
- void setChangedFlag()
+ bool isValid()
{
- changed = true;
+ if(m_lighting_expired)
+ return false;
+ if(data == NULL)
+ return false;
+ return true;
}
+ /*
+ Position stuff
+ */
+
v3s16 getPos()
{
return m_pos;
return m_pos * MAP_BLOCKSIZE;
}
- bool getIsUnderground()
- {
- return is_underground;
- }
-
- void setIsUnderground(bool a_is_underground)
- {
- is_underground = a_is_underground;
- setChangedFlag();
- }
-
core::aabbox3d<s16> getBox()
{
return core::aabbox3d<s16>(getPosRelative(),
+ v3s16(MAP_BLOCKSIZE, MAP_BLOCKSIZE, MAP_BLOCKSIZE)
- v3s16(1,1,1));
}
-
- void reallocate()
- {
- if(data != NULL)
- delete[] data;
- u32 l = MAP_BLOCKSIZE * MAP_BLOCKSIZE * MAP_BLOCKSIZE;
- data = new MapNode[l];
- for(u32 i=0; i<l; i++){
- data[i] = MapNode();
- }
- setChangedFlag();
- }
+ /*
+ Regular MapNode get-setters
+ */
+
bool isValidPosition(v3s16 p)
{
if(data == NULL)
&& p.Z >= 0 && p.Z < MAP_BLOCKSIZE);
}
- /*
- Regular MapNode get-setters
- */
-
MapNode getNode(s16 x, s16 y, s16 z)
{
if(data == NULL)
return getNode(p.X, p.Y, p.Z);
}
+ MapNode getNodeNoEx(v3s16 p)
+ {
+ try{
+ return getNode(p.X, p.Y, p.Z);
+ }catch(InvalidPositionException &e){
+ return MapNode(CONTENT_IGNORE);
+ }
+ }
+
void setNode(s16 x, s16 y, s16 z, MapNode & n)
{
if(data == NULL)
if(y < 0 || y >= MAP_BLOCKSIZE) throw InvalidPositionException();
if(z < 0 || z >= MAP_BLOCKSIZE) throw InvalidPositionException();
data[z*MAP_BLOCKSIZE*MAP_BLOCKSIZE + y*MAP_BLOCKSIZE + x] = n;
- setChangedFlag();
+ raiseModified(MOD_STATE_WRITE_NEEDED, "setNode");
}
void setNode(v3s16 p, MapNode & n)
setNode(p.X, p.Y, p.Z, n);
}
+ /*
+ Non-checking variants of the above
+ */
+
+ MapNode getNodeNoCheck(s16 x, s16 y, s16 z)
+ {
+ if(data == NULL)
+ throw InvalidPositionException();
+ return data[z*MAP_BLOCKSIZE*MAP_BLOCKSIZE + y*MAP_BLOCKSIZE + x];
+ }
+
+ MapNode getNodeNoCheck(v3s16 p)
+ {
+ return getNodeNoCheck(p.X, p.Y, p.Z);
+ }
+
+ void setNodeNoCheck(s16 x, s16 y, s16 z, MapNode & n)
+ {
+ if(data == NULL)
+ throw InvalidPositionException();
+ data[z*MAP_BLOCKSIZE*MAP_BLOCKSIZE + y*MAP_BLOCKSIZE + x] = n;
+ raiseModified(MOD_STATE_WRITE_NEEDED, "setNodeNoCheck");
+ }
+
+ void setNodeNoCheck(v3s16 p, MapNode & n)
+ {
+ setNodeNoCheck(p.X, p.Y, p.Z, n);
+ }
+
/*
These functions consult the parent container if the position
is not valid on this MapBlock.
bool isValidPositionParent(v3s16 p);
MapNode getNodeParent(v3s16 p);
void setNodeParent(v3s16 p, MapNode & n);
+ MapNode getNodeParentNoEx(v3s16 p);
void drawbox(s16 x0, s16 y0, s16 z0, s16 w, s16 h, s16 d, MapNode node)
{
setNode(x0+x, y0+y, z0+z, node);
}
- static FastFace * makeFastFace(u8 material, u8 light, v3f p,
- v3f dir, v3f scale, v3f posRelative_f);
-
- u8 getFaceLight(v3s16 p, v3s16 face_dir);
-
/*
- Gets node material from any place relative to block.
- Returns MATERIAL_AIR if doesn't exist.
+ Graphics-related methods
*/
- u8 getNodeMaterial(v3s16 p);
+
+#ifndef SERVER // Only on client
+ u8 getFaceLight2(u32 daynight_ratio, v3s16 p, v3s16 face_dir,
+ INodeDefManager *nodemgr)
+ {
+ return getFaceLight(daynight_ratio,
+ getNodeParentNoEx(p),
+ getNodeParentNoEx(p + face_dir),
+ face_dir, nodemgr);
+ }
+
+#if 1
/*
- startpos:
- translate_dir: unit vector with only one of x, y or z
- face_dir: unit vector with only one of x, y or z
+ Thread-safely updates the whole mesh of the mapblock.
+ NOTE: Prefer generating the mesh separately and then using
+ replaceMesh().
*/
- void updateFastFaceRow(v3s16 startpos,
- u16 length,
- v3s16 translate_dir,
- v3s16 face_dir,
- core::list<FastFace*> &dest);
-
- void updateMesh();
-
- bool propagateSunlight(core::map<v3s16, bool> & light_sources);
+ void updateMesh(u32 daynight_ratio);
+#endif
+ // Replace the mesh with a new one
+ void replaceMesh(scene::SMesh *mesh_new);
+#endif
- // Doesn't write version by itself
- void serialize(std::ostream &os, u8 version);
-
- void deSerialize(std::istream &is, u8 version);
+ // See comments in mapblock.cpp
+ bool propagateSunlight(core::map<v3s16, bool> & light_sources,
+ bool remove_light=false, bool *black_air_left=NULL);
- void serializeObjects(std::ostream &os, u8 version)
+ // Copies data to VoxelManipulator to getPosRelative()
+ void copyTo(VoxelManipulator &dst);
+ // Copies data from VoxelManipulator getPosRelative()
+ void copyFrom(VoxelManipulator &dst);
+
+#ifndef SERVER // Only on client
+ /*
+ Methods for setting temporary modifications to nodes for
+ drawing
+
+ returns true if the mod was different last time
+ */
+ bool setTempMod(v3s16 p, const NodeMod &mod)
{
- m_objects.serialize(os, version);
+ /*dstream<<"setTempMod called on block"
+ <<" ("<<p.X<<","<<p.Y<<","<<p.Z<<")"
+ <<", mod.type="<<mod.type
+ <<", mod.param="<<mod.param
+ <<std::endl;*/
+ JMutexAutoLock lock(m_temp_mods_mutex);
+
+ return m_temp_mods.set(p, mod);
}
- // If smgr!=NULL, new objects are added to the scene
- void updateObjects(std::istream &is, u8 version,
- scene::ISceneManager *smgr)
+ // Returns true if there was one
+ bool getTempMod(v3s16 p, NodeMod *mod)
{
- m_objects.update(is, version, smgr);
+ JMutexAutoLock lock(m_temp_mods_mutex);
- setChangedFlag();
+ return m_temp_mods.get(p, mod);
}
- void clearObjects()
+ bool clearTempMod(v3s16 p)
{
- m_objects.clear();
+ JMutexAutoLock lock(m_temp_mods_mutex);
- setChangedFlag();
+ return m_temp_mods.clear(p);
}
- void addObject(MapBlockObject *object)
- throw(ContainerFullException, AlreadyExistsException)
+ bool clearTempMods()
{
- m_objects.add(object);
-
- setChangedFlag();
+ JMutexAutoLock lock(m_temp_mods_mutex);
+
+ return m_temp_mods.clear();
}
- void removeObject(s16 id)
+ void copyTempMods(NodeModMap &dst)
{
- m_objects.remove(id);
+ JMutexAutoLock lock(m_temp_mods_mutex);
+ m_temp_mods.copy(dst);
+ }
+#endif
- setChangedFlag();
+ /*
+ Update day-night lighting difference flag.
+
+ Sets m_day_night_differs to appropriate value.
+
+ These methods don't care about neighboring blocks.
+ It means that to know if a block really doesn't need a mesh
+ update between day and night, the neighboring blocks have
+ to be taken into account. Use Map::dayNightDiffed().
+ */
+ void updateDayNightDiff();
+
+ bool dayNightDiffed()
+ {
+ return m_day_night_differs;
}
- MapBlockObject * getObject(s16 id)
+
+ /*
+ Miscellaneous stuff
+ */
+
+ /*
+ Tries to measure ground level.
+ Return value:
+ -1 = only air
+ -2 = only ground
+ -3 = random fail
+ 0...MAP_BLOCKSIZE-1 = ground level
+ */
+ s16 getGroundLevel(v2s16 p2d);
+
+ /*
+ Timestamp (see m_timestamp)
+ NOTE: BLOCK_TIMESTAMP_UNDEFINED=0xffffffff means there is no timestamp.
+ */
+ void setTimestamp(u32 time)
{
- return m_objects.get(id);
+ m_timestamp = time;
+ raiseModified(MOD_STATE_WRITE_AT_UNLOAD, "setTimestamp");
}
- JMutexAutoLock * getObjectLock()
+ void setTimestampNoChangedFlag(u32 time)
{
- return m_objects.getLock();
+ m_timestamp = time;
}
- void stepObjects(float dtime, bool server)
+ u32 getTimestamp()
{
- m_objects.step(dtime, server);
-
- setChangedFlag();
+ return m_timestamp;
}
-
- /*void wrapObject(MapBlockObject *object)
+ u32 getDiskTimestamp()
{
- m_objects.wrapObject(object);
-
- setChangedFlag();
- }*/
-
- // origin is relative to block
- void getObjects(v3f origin, f32 max_d,
- core::array<DistanceSortedObject> &dest)
+ return m_disk_timestamp;
+ }
+
+ /*
+ See m_usage_timer
+ */
+ void resetUsageTimer()
{
- m_objects.getObjects(origin, max_d, dest);
+ m_usage_timer = 0;
}
-
- s32 getObjectCount()
+ void incrementUsageTimer(float dtime)
+ {
+ m_usage_timer += dtime;
+ }
+ u32 getUsageTimer()
{
- return m_objects.getCount();
+ return m_usage_timer;
}
+ /*
+ Serialization
+ */
+
+ // These don't write or read version by itself
+ // Set disk to true for on-disk format, false for over-the-network format
+ void serialize(std::ostream &os, u8 version, bool disk);
+ // If disk == true: In addition to doing other things, will add
+ // unknown blocks from id-name mapping to wndef
+ void deSerialize(std::istream &is, u8 version, bool disk);
+
private:
+ /*
+ Private methods
+ */
+
+ void serialize_pre22(std::ostream &os, u8 version, bool disk);
+ void deSerialize_pre22(std::istream &is, u8 version, bool disk);
/*
Used only internally, because changes can't be tracked
MapNode & getNodeRef(s16 x, s16 y, s16 z)
{
+ if(data == NULL)
+ throw InvalidPositionException();
if(x < 0 || x >= MAP_BLOCKSIZE) throw InvalidPositionException();
if(y < 0 || y >= MAP_BLOCKSIZE) throw InvalidPositionException();
if(z < 0 || z >= MAP_BLOCKSIZE) throw InvalidPositionException();
{
return getNodeRef(p.X, p.Y, p.Z);
}
+
+public:
+ /*
+ Public member variables
+ */
+
+#ifndef SERVER // Only on client
+ scene::SMesh *mesh;
+ JMutex mesh_mutex;
+#endif
+
+ NodeMetadataList *m_node_metadata;
+ StaticObjectList m_static_objects;
+
+private:
+ /*
+ Private member variables
+ */
+
+ // NOTE: Lots of things rely on this being the Map
+ Map *m_parent;
+ // Position in blocks on parent
+ v3s16 m_pos;
+
+ IGameDef *m_gamedef;
+
+ /*
+ If NULL, block is a dummy block.
+ Dummy blocks are used for caching not-found-on-disk blocks.
+ */
+ MapNode * data;
+
+ /*
+ - On the server, this is used for telling whether the
+ block has been modified from the one on disk.
+ - On the client, this is used for nothing.
+ */
+ u32 m_modified;
+ std::string m_modified_reason;
+ bool m_modified_reason_too_long;
+
+ /*
+ When propagating sunlight and the above block doesn't exist,
+ sunlight is assumed if this is false.
+
+ In practice this is set to true if the block is completely
+ undeground with nothing visible above the ground except
+ caves.
+ */
+ bool is_underground;
+
+ /*
+ Set to true if changes has been made that make the old lighting
+ values wrong but the lighting hasn't been actually updated.
+
+ If this is false, lighting is exactly right.
+ If this is true, lighting might be wrong or right.
+ */
+ bool m_lighting_expired;
+
+ // Whether day and night lighting differs
+ bool m_day_night_differs;
+
+ bool m_generated;
+
+#ifndef SERVER // Only on client
+ /*
+ Set to true if the mesh has been ordered to be updated
+ sometime in the background.
+ In practice this is set when the day/night lighting switches.
+ */
+ bool m_mesh_expired;
+
+ // Temporary modifications to nodes
+ // These are only used when drawing
+ NodeModMap m_temp_mods;
+ JMutex m_temp_mods_mutex;
+#endif
+
+ /*
+ When block is removed from active blocks, this is set to gametime.
+ Value BLOCK_TIMESTAMP_UNDEFINED=0xffffffff means there is no timestamp.
+ */
+ u32 m_timestamp;
+ // The on-disk (or to-be on-disk) timestamp value
+ u32 m_disk_timestamp;
+
+ /*
+ When the block is accessed, this is set to 0.
+ Map will unload the block when this reaches a timeout.
+ */
+ float m_usage_timer;
};
inline bool blockpos_over_limit(v3s16 p)
return getContainerPos(y, MAP_BLOCKSIZE);
}
+/*
+ Get a quick string to describe what a block actually contains
+*/
+std::string analyze_block(MapBlock *block);
+
#endif