extentTerrainImplementation.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2011 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/

//\file extentTerrainImplementation.h
//\ingroup terrainInterface

//\brief

#pragma once

#include "terrainInterface/terrainImplementation.h"
#include "terrainInterface/terrainCapabilities.h"

class DtCoordinateSystem;
namespace makArchives
{
   class DtGenericTerrainRecord;
}

//This terrain implementation is an algorithmic representation of the world
//as a flat earth extent.  All soil types are returned as 
//the undefined soil type.
class DtExtentTerrainImplementation : public DtTerrainImplementation
{
public:

   DtExtentTerrainImplementation(DtConsoleCommandManager* cmdMgr);
   virtual ~DtExtentTerrainImplementation();

   //Static creator function
   static DtTerrainImplementation* create(DtConsoleCommandManager* cmdMgr);

   //Called with the generic terrain record from the mtf file.
   //Use to setup initial values on terrain load.
   virtual bool loadTerrain(const makArchives::DtGenericTerrainRecord& record);

   //Returns myCoordinateSystem 
   virtual const Coordinate_System* coordinateSystem() const;

   //Returns topmost intersection of chord with terrain in record. 
   //data should be filled in for the record.
   virtual bool chordIntersect(DtTerrainIntersectStatus& status,
      const DtChord& chord,
      DtVrfChordIntersectionRecord& record,
      const DtTerrainIntersectOptions& options) const;

   //Returns all intersections of chord with terrain. intList is the list of each intersection record.
   //In this example there will only ever be at most 1 intersection.
   virtual bool allIntersectsAlongChord(DtTerrainIntersectStatus& status,
      const DtChord& chord,
      DtVrfChordIntersectRecordList& intList,
      const DtTerrainIntersectOptions& options) const;

   //Returns the capabilities of the current terrain.
   virtual const DtTerrainCapabilities* terrainCapabilities() const;

   //Used by B-HAVE for creating path data.  output is an interface to be called
   //on the triangles in the terrain.  box is an extent that determines which
   //triangles should be considered.  finalize is called once all triangles
   //have been processed.
   virtual void processTrianglesInArea(
      DtTriangleOutputInterface& output,
      const DtTerrainProcessPolygonsBox& box) const;

protected:

   //Fill in the intersection record based on the result of the intersection
   //test.
   void fillHitRecord(DtChordIntersectionRecord& rec, 
      const DtChord& chord, const DtPoint& chordNormal, double intersectTime,
      DtIntersectionRecord::DtIntersectionType irtFlag) const;

   //Function that actually does the chord-extent intersection test.
   bool chordExtentIntersect(const DtChord& chord, 
      DtChordIntersectionRecord& hit, 
      DtIntersectionRecord::DtIntersectionType irtFlag) const;

   virtual void cacheTerrainArea(int requestId, int lowestLOD, int highestLOD, const DtExtent& cacheArea, DtCacheProgressCallbackFunction fcn = 0, void* usr = 0);

   virtual void cancelCacheTerrainArea(int requestId);

protected:
   Coordinate_System* myCoordinateSystem;
   DtTerrainCapabilities myCapabilities;
};