src/mesh_generator_thread.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013, 2017 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 Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser 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 MESH_GENERATOR_THREAD_HEADER
  21 #define MESH_GENERATOR_THREAD_HEADER
  22
  23 #include "mapblock_mesh.h"
  24 #include "threading/mutex_auto_lock.h"
  25 #include "util/thread.h"
  26
  27 struct CachedMapBlockData
  28 {
  29         v3s16 p;
  30         MapNode *data; // A copy of the MapBlock's data member
  31         int refcount_from_queue;
  32         int last_used_timestamp;
  33
  34         CachedMapBlockData();
  35         ~CachedMapBlockData();
  36 };
  37
  38 struct QueuedMeshUpdate
  39 {
  40         v3s16 p;
  41         bool ack_block_to_server;
  42         bool urgent;
  43         int crack_level;
  44         v3s16 crack_pos;
  45         MeshMakeData *data; // This is generated in MeshUpdateQueue::pop()
  46
  47         QueuedMeshUpdate();
  48         ~QueuedMeshUpdate();
  49 };
  50
  51 /*
  52         A thread-safe queue of mesh update tasks and a cache of MapBlock data
  53 */
  54 class MeshUpdateQueue
  55 {
  56         enum UpdateMode {
  57                 FORCE_UPDATE,
  58                 SKIP_UPDATE_IF_ALREADY_CACHED,
  59         };
  60 public:
  61         MeshUpdateQueue(Client *client);
  62
  63         ~MeshUpdateQueue();
  64
  65         // Caches the block at p and its neighbors (if needed) and queues a mesh
  66         // update for the block at p
  67         void addBlock(Map *map, v3s16 p, bool ack_block_to_server, bool urgent);
  68
  69         // Returned pointer must be deleted
  70         // Returns NULL if queue is empty
  71         QueuedMeshUpdate * pop();
  72
  73         u32 size()
  74         {
  75                 MutexAutoLock lock(m_mutex);
  76                 return m_queue.size();
  77         }
  78
  79 private:
  80         Client *m_client;
  81         std::vector<QueuedMeshUpdate*> m_queue;
  82         std::set<v3s16> m_urgents;
  83         std::map<v3s16, CachedMapBlockData*> m_cache;
  84         Mutex m_mutex;
  85
  86         // TODO: Add callback to update these when g_settings changes
  87         bool m_cache_enable_shaders;
  88         bool m_cache_use_tangent_vertices;
  89         bool m_cache_smooth_lighting;
  90         int m_meshgen_block_cache_size;
  91
  92         CachedMapBlockData* cacheBlock(Map *map, v3s16 p, UpdateMode mode,
  93                         size_t *cache_hit_counter=NULL);
  94         CachedMapBlockData* getCachedBlock(const v3s16 &p);
  95         void fillDataFromMapBlockCache(QueuedMeshUpdate *q);
  96         void cleanupCache();
  97 };
  98
  99 struct MeshUpdateResult
 100 {
 101         v3s16 p;
 102         MapBlockMesh *mesh;
 103         bool ack_block_to_server;
 104
 105         MeshUpdateResult():
 106                 p(-1338,-1338,-1338),
 107                 mesh(NULL),
 108                 ack_block_to_server(false)
 109         {
 110         }
 111 };
 112
 113 class MeshUpdateThread : public UpdateThread
 114 {
 115 public:
 116         MeshUpdateThread(Client *client);
 117
 118         // Caches the block at p and its neighbors (if needed) and queues a mesh
 119         // update for the block at p
 120         void updateBlock(Map *map, v3s16 p, bool ack_block_to_server, bool urgent);
 121
 122         v3s16 m_camera_offset;
 123         MutexedQueue<MeshUpdateResult> m_queue_out;
 124
 125 private:
 126         MeshUpdateQueue m_queue_in;
 127
 128         // TODO: Add callback to update these when g_settings changes
 129         int m_generation_interval;
 130
 131 protected:
 132         virtual void doUpdate();
 133 };
 134
 135 #endif