PhxTerrainDatabase.h

Go to the documentation of this file.

#ifndef PHX_TERRAIN_DATABASE_H
#define PHX_TERRAIN_DATABASE_H

#include <Phx/Graphics/PhxTerrainGeometry.h>
#include <Phx/Util/PhxBuffer.h>
#include <Phx/Util/PhxRectangle.h>

namespace Phx {

  class GraphicsEngine::TerrainGeometry::TerrainDatabase : 
    public LockedPtrInterface<TerrainDatabase> {
  public:
    
    typedef uint64_t QuadIdentifier;

    typedef uint32_t ChildIndex;
    const static ChildIndex LL = 0;
    const static ChildIndex UL = 1;
    const static ChildIndex LR = 2;
    const static ChildIndex UR = 3;
    const static ChildIndex CHILD_COUNT = 4;

    const static QuadIdentifier INVALID_IDENTIFIER = ((uint64_t)-1);

    const static uint32_t ROOT_IDENTIFIER_BITS = 24;

    const static uint32_t QUAD_IDENTIFIER_BITS = 64 - ROOT_IDENTIFIER_BITS;

    const static QuadIdentifier MIN_ROOT_IDENTIFIER = ((uint64_t)1)<<(ROOT_IDENTIFIER_BITS-2);

    const static QuadIdentifier MAX_ROOT_IDENTIFIER = (((uint64_t)1)<<ROOT_IDENTIFIER_BITS)-1;

    static inline bool isRootIdentifier(QuadIdentifier identifier) {
      return !(identifier & ~MAX_ROOT_IDENTIFIER);
    }

    static inline QuadIdentifier rootIdentifier(QuadIdentifier quad) {
      while (!isRootIdentifier(quad)) { quad >>= 2; }
      return quad;
    }
    
    static inline QuadIdentifier childIdentifier(QuadIdentifier parent, ChildIndex c) {
      return (parent << 2)|c;
    }

    static inline QuadIdentifier parentIdentifier(QuadIdentifier quad) {
      if (isRootIdentifier(quad)) return INVALID_IDENTIFIER;
      return quad>>2;
    }

    static Rectangle<float> uvCoords(QuadIdentifier identifier);

    virtual Vector3 rootCorner(QuadIdentifier identifier, ChildIndex which) = 0;

    virtual double ellipsoidRadius(const Vector3& v) = 0;

    // Heights are floating point values.
    typedef float HeightValue;

    // must return resolution*resolution-sized buffer.
    virtual Ptr<const Buffer<HeightValue> > newHeightBuffer(QuadIdentifier identifier,
                                                            uint32_t resolution) = 0;

    // must return resolution*resolution*3-sized buffer.
    virtual Ptr<const Buffer<uint8_t> > newColorBuffer(QuadIdentifier identifier, 
                                                       uint32_t resolution) = 0;

    // must return resolution*resolution-sized buffer.
    virtual Ptr<const Buffer<uint8_t> > newBandBuffer(QuadIdentifier identifier, 
                                                      const String& band, uint32_t resolution) = 0;

  };

  class GraphicsEngine::TerrainGeometry::TerrainDatabaseDescription : 
    public Description {
  public:
    static const Description::Type DESCRIPTION_TYPE;
    static const String DESCRIPTION_TYPE_NAME;
  };
  
}; // namespace Phx

#endif /* PHX_TERRAIN_DATABASE_H */

---