DetourTileCacheBuilder.h

//
// Copyright (c) 2009-2010 Mikko Mononen memon@inside.org
//
// This software is provided 'as-is', without any express or implied
// warranty.  In no event will the authors be held liable for any damages
// arising from the use of this software.
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it
// freely, subject to the following restrictions:
// 1. The origin of this software must not be misrepresented; you must not
//    claim that you wrote the original software. If you use this software
//    in a product, an acknowledgment in the product documentation would be
//    appreciated but is not required.
// 2. Altered source versions must be plainly marked as such, and must not be
//    misrepresented as being the original software.
// 3. This notice may not be removed or altered from any source distribution.
//
 
#ifndef DETOURTILECACHEBUILDER_H
#define DETOURTILECACHEBUILDER_H
 
#include <AtomsUtils/Globals.h>
#include <AtomsUtils/NavigationMesh/Detour/DetourAlloc.h>
#include <AtomsUtils/NavigationMesh/Detour/DetourStatus.h>
 
namespace AtomsUtils {
 
static const int DT_TILECACHE_MAGIC = 'D'<<24 | 'T'<<16 | 'L'<<8 | 'R'; 
static const int DT_TILECACHE_VERSION = 1;
 
static const unsigned char DT_TILECACHE_NULL_AREA = 0;
static const unsigned char DT_TILECACHE_WALKABLE_AREA = 63;
static const unsigned short DT_TILECACHE_NULL_IDX = 0xffff;
 
struct dtTileCacheLayerHeader
{
    int magic;                              
    int version;                            
    int tx,ty,tlayer;
    float bmin[3], bmax[3];
    unsigned short hmin, hmax;              
    unsigned short width, height;           
    unsigned short minx, maxx, miny, maxy;  
};
 
struct dtTileCacheLayer
{
    dtTileCacheLayerHeader* header;
    unsigned short regCount;                    
    unsigned short* heights;
    unsigned char* areas;
    unsigned char* cons;
    unsigned short* regs;
};
 
struct dtTileCacheContour
{
    int nverts;
    unsigned short* verts;
    unsigned short reg;
    unsigned char area;
};
 
struct dtTileCacheContourSet
{
    int nconts;
    dtTileCacheContour* conts;
};
 
struct dtTileCacheClusterSet
{
    int nclusters;              
    int nregs;                  
    int npolys;                 
    unsigned short* regMap;     
    unsigned short* polyMap;    
};
 
struct dtTileCachePolyMesh
{
    int nvp;
    int nverts;             
    int npolys;             
    unsigned short* verts;  
    unsigned short* polys;  
    unsigned short* flags;  
    unsigned char* areas;   
    unsigned short* regs;   
};
 
 
struct dtTileCachePolyMeshDetail
{
    int nmeshes;            
    int nverts;             
    int ntris;              
    unsigned int* meshes;   
    float* verts;           
    unsigned char* tris;    
};
 
struct dtTileCacheDistanceField
{
    unsigned short maxDist; 
    unsigned short* data;   
};
 
class ATOMSUTILS_EXPORT dtTileCacheLogContext
{
public:
    void dtLog(const char* format, ...);
 
protected:
 
    virtual void doDtLog(const char* /*msg*/, const int /*len*/) {}
};
 
 
 
struct ATOMSUTILS_EXPORT dtTileCacheAlloc
{
    virtual ~dtTileCacheAlloc() = default;
 
    virtual void reset()
    {
    }
    
    virtual void* alloc(const int size)
    {
        return dtAlloc(size, DT_ALLOC_TEMP);
    }
    
    virtual void free(void* ptr)
    {
        dtFree(ptr);
    }
};
 
struct ATOMSUTILS_EXPORT dtTileCacheCompressor
{
    virtual int maxCompressedSize(const int bufferSize) = 0;
    virtual dtStatus compress(const unsigned char* buffer, const int bufferSize,
                              unsigned char* compressed, const int maxCompressedSize, int* compressedSize) = 0;
    virtual dtStatus decompress(const unsigned char* compressed, const int compressedSize,
                                unsigned char* buffer, const int maxBufferSize, int* bufferSize) = 0;
};
 
 
template<class T> class dtFixedArray
{
    dtTileCacheAlloc* m_alloc;
    T* m_ptr;
    const int m_size;
    inline T* operator=(T* p);
    inline void operator=(dtFixedArray<T>& p);
    inline dtFixedArray();
public:
    inline dtFixedArray(dtTileCacheAlloc* a, const int s) : m_alloc(a), m_ptr((T*)a->alloc(sizeof(T)*s)), m_size(s) {}
    inline ~dtFixedArray() { if (m_alloc) m_alloc->free(m_ptr); }
    inline operator T*() { return m_ptr; }
    inline int size() const { return m_size; }
    inline void set(unsigned char v) { memset(m_ptr, v, sizeof(T)*m_size); }
};
 
inline int getDirOffsetX(int dir)
{
    const int offset[4] = { -1, 0, 1, 0, };
    return offset[dir&0x03];
}
 
inline int getDirOffsetY(int dir)
{
    const int offset[4] = { 0, 1, 0, -1 };
    return offset[dir&0x03];
}
 
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheLayer(dtTileCacheCompressor* comp,
                               dtTileCacheLayerHeader* header,
                               const unsigned short* heights,
                               const unsigned char* areas,
                               const unsigned char* cons,
                               unsigned char** outData, int* outDataSize);
 
ATOMSUTILS_EXPORT void dtFreeTileCacheLayer(dtTileCacheAlloc* alloc, dtTileCacheLayer* layer);
 
ATOMSUTILS_EXPORT dtStatus dtDecompressTileCacheLayer(dtTileCacheAlloc* alloc, dtTileCacheCompressor* comp,
                                    unsigned char* compressed, const int compressedSize,
                                    dtTileCacheLayer** layerOut);
 
ATOMSUTILS_EXPORT dtTileCacheContourSet* dtAllocTileCacheContourSet(dtTileCacheAlloc* alloc);
ATOMSUTILS_EXPORT void dtFreeTileCacheContourSet(dtTileCacheAlloc* alloc, dtTileCacheContourSet* cset);
 
ATOMSUTILS_EXPORT dtTileCacheClusterSet* dtAllocTileCacheClusterSet(dtTileCacheAlloc* alloc);
ATOMSUTILS_EXPORT void dtFreeTileCacheClusterSet(dtTileCacheAlloc* alloc, dtTileCacheClusterSet* clusters);
 
ATOMSUTILS_EXPORT dtTileCachePolyMesh* dtAllocTileCachePolyMesh(dtTileCacheAlloc* alloc);
ATOMSUTILS_EXPORT void dtFreeTileCachePolyMesh(dtTileCacheAlloc* alloc, dtTileCachePolyMesh* lmesh);
 
 
ATOMSUTILS_EXPORT dtTileCachePolyMeshDetail* dtAllocTileCachePolyMeshDetail(dtTileCacheAlloc* alloc);
ATOMSUTILS_EXPORT void dtFreeTileCachePolyMeshDetail(dtTileCacheAlloc* alloc, dtTileCachePolyMeshDetail* dmesh);
 
ATOMSUTILS_EXPORT dtTileCacheDistanceField* dtAllocTileCacheDistanceField(dtTileCacheAlloc* alloc);
ATOMSUTILS_EXPORT void dtFreeTileCacheDistanceField(dtTileCacheAlloc* alloc, dtTileCacheDistanceField* dfield);
 
 
ATOMSUTILS_EXPORT dtStatus dtMarkCylinderArea(dtTileCacheLayer& layer, const float* orig, const float cs, const float ch,
    const float* pos, const float radius, const float height, const unsigned char areaId);
 
 
ATOMSUTILS_EXPORT dtStatus dtMarkBoxArea(dtTileCacheLayer& layer, const float* orig, const float cs, const float ch,
    const float* pos, const float* extent, const unsigned char areaId);
 
ATOMSUTILS_EXPORT dtStatus dtMarkConvexArea(dtTileCacheLayer& layer, const float* orig, const float cs, const float ch,
    const float* verts, const int nverts, const float hmin, const float hmax, const unsigned char areaId);
 
ATOMSUTILS_EXPORT dtStatus dtReplaceCylinderArea(dtTileCacheLayer& layer, const float* orig, const float cs, const float ch,
    const float* pos, const float radius, const float height, const unsigned char areaId,
    const unsigned char filterAreaId);
 
ATOMSUTILS_EXPORT dtStatus dtReplaceBoxArea(dtTileCacheLayer& layer, const float* orig, const float cs, const float ch,
    const float* pos, const float* extent, const unsigned char areaId, const unsigned char filterAreaId);
 
ATOMSUTILS_EXPORT dtStatus dtReplaceConvexArea(dtTileCacheLayer& layer, const float* orig, const float cs, const float ch,
    const float* verts, const int nverts, const float hmin, const float hmax, const unsigned char areaId,
    const unsigned char filterAreaId);
 
ATOMSUTILS_EXPORT dtStatus dtReplaceArea(dtTileCacheLayer& layer, const unsigned char areaId, const unsigned char filterAreaId);
 
 
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheDistanceField(dtTileCacheAlloc* alloc, dtTileCacheLayer& layer, dtTileCacheDistanceField& dfield);
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheRegions(dtTileCacheAlloc* alloc,
                                const int minRegionArea, const int mergeRegionArea,
                                dtTileCacheLayer& layer, dtTileCacheDistanceField dfield);
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheRegionsMonotone(dtTileCacheAlloc* alloc,
                                const int minRegionArea, const int mergeRegionArea,
                                dtTileCacheLayer& layer);
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheRegionsChunky(dtTileCacheAlloc* alloc,
                                const int minRegionArea, const int mergeRegionArea,
                                dtTileCacheLayer& layer, int regionChunkSize);
 
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheContours(dtTileCacheAlloc* alloc,
                                dtTileCacheLayer& layer,
                                const int walkableClimb, const float maxError,
                                const float cs, const float ch,
                                dtTileCacheContourSet& lcset,
                                dtTileCacheClusterSet& lclusters);
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCachePolyMesh(dtTileCacheAlloc* alloc,
                                dtTileCacheLogContext* ctx,
                                dtTileCacheContourSet& lcset,
                                dtTileCachePolyMesh& mesh);
 
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCachePolyMeshDetail(dtTileCacheAlloc* alloc,
                                const float cs, const float ch,
                                const float sampleDist, const float sampleMaxError,
                                dtTileCacheLayer& layer,
                                dtTileCachePolyMesh& lmesh,
                                dtTileCachePolyMeshDetail& dmesh);
 
ATOMSUTILS_EXPORT dtStatus dtBuildTileCacheClusters(dtTileCacheAlloc* alloc,
                                dtTileCacheClusterSet& lclusters,
                                dtTileCachePolyMesh& lmesh);
 
 
ATOMSUTILS_EXPORT bool dtTileCacheHeaderSwapEndian(unsigned char* data, const int dataSize);
 
}
 
#endif // DETOURTILECACHEBUILDER_H