CogsTerrainBase.h

#pragma once
 
#include "Rendering/DataFormat.h"
 
#include <stdint.h>
 
#undef COGSTERRAIN_DLL_API
 
#ifdef _WIN32
  // Alignment specifier causing structure padding is intended behavior.
  #pragma warning(disable:4324)
 
  // Nameless struct/union no longer non-standard (C11).
  #pragma warning(disable:4201)
 
  // When building the library:
  #ifdef COGSCORE_TERRAIN_BUILD
    #ifdef COGSTERRAIN_DLL
      #define COGSTERRAIN_API __declspec(dllexport)
    #else
      #define COGSTERRAIN_API
    #endif
  // When using the library:
  #else
    #ifdef COGSTERRAIN_DLL
      #define COGSTERRAIN_API __declspec(dllimport)
    #else
      #define COGSTERRAIN_API
    #endif
  #endif
#else
  #define COGSTERRAIN_API
#endif
 
namespace Cogs
{
  struct TileData;
}
 
typedef void TileLoadCallback(void * userData, int level, int x, int y, Cogs::TileData * data);
typedef bool TileRequestCallback(void * userData, TileLoadCallback tileLoadCallback, int level, int x, int y);
 
typedef void AllocationCallback(void * userData, unsigned int size);
typedef void DeallocationCallback(void * userData, unsigned int size);
 
struct CogsContext;
 
namespace Cogs
{
  struct ClipmapParameters
  {
    size_t clipmapPosts = 255;
    double imageryResolutionFactor[16];
    size_t imageryIndexOffset[16];
    bool precomputeNormals = false;
  };
 
  struct RasterSourceFlags
  {
    enum ERasterSourceFlags
    {
      None = 0,
      Queryable = 1,
      CompressCache = 1 << 1,
    };
  };
 
  struct RasterSourceParameters
  {
    const char * name;
 
    int64_t id;
 
    TextureFormat format;
    float noData;
 
    double minX;
    double minY;
    double maxX;
    double maxY;
 
    int numLevels;
    int tileWidth;
    int tileHeight;
    double deltaX;
    double deltaY;
 
    unsigned int cacheSize;
    unsigned int flags;
 
    TileRequestCallback * tileRequestCallback;
    AllocationCallback * allocationCallback;
    DeallocationCallback * deallocationCallback;
  };
 
  struct TileDataFlags
  {
    enum ETileDataFlags
    {
      None = 0,
      IsHeight = 1 << 0,
      ShouldConvert = 1 << 1,
      ShouldFlip = 1 << 2,
      LinearColorSpace = 1 << 3
    };
  };
 
  struct TileData
  {
    bool isHeight() const { return (flags & TileDataFlags::IsHeight) != 0; }
    bool isLinear() const { return (flags & TileDataFlags::LinearColorSpace) != 0; }
    bool shouldFlip() const { return (flags & TileDataFlags::ShouldFlip) != 0; }
    bool shouldConvert() const
    {
      return (flags & TileDataFlags::ShouldConvert) != 0 ||
        format == TextureFormat::B8G8R8 ||
        format == TextureFormat::B8G8R8A8;
    }
 
    const void * imageData;
 
    int width;
    int height;
    TextureFormat format;
    int stride;
    int flags;
    float minZ;
    float maxZ;
  };
 
  struct TerrainQuery
  {
    void * userData;
 
    double * positions;
    int numPositions;
 
    int layer;
    int level;
    int policy;
  };
 
  struct TerrainQueryResults
  {
    void * userData;
 
    void * results;
    int numResults;
 
    int resultLevel;
  };
 
  struct ShadingOptions
  {
    const char * customComputeColor;
  };
 
#define METRICS_MAX_SOURCES 8
 
  struct TerrainMetrics
  {
    int64_t numFrames;
 
    int64_t clipmapTextureBuffer;
 
    int64_t sourceMemoryBuffers[8];
    int64_t sourceTextureBuffers[8];
  };
 
  typedef void TerrainQueryCallback(TerrainQueryResults * results);
}