terrainImplementation.h

Go to the documentation of this file.

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



#pragma once

#include "terrainInterface/terrainInterfaceDefines.h"
#include <geometry/intersectionRecord.h>
#include <geometry/chord.h>
#include <gdb/vectorNetworkRecord.h>
#include <gdb/vectorNetworkIntersectionRecord.h>
#include <geometry/chordIntersectRecordList.h>
#include "tdbutil/stringKeyFactory.h"
#include "terrainInterface/terrainPagingGeometry.h"
#include "terrainInterface/terrainProcessPolygonsBox.h"
#include "features/feature.h"
#include "features/featureSet.h"
#include "features/featureContext.h"
#include "vrfutil/terrainInterfaceConfig.h"

#include <string>
#include <boost/noncopyable.hpp>

class DtChordIntersectionRecord;
class DtString;
class Coordinate_System;
class DtConsoleCommandManager;
class DtTerrainCapabilities;

namespace makArchives
{
   class DtGenericTerrainRecord;
}

namespace MAKVRinTerra
{
   class DtProj;
}

class DT_DLL_terrainInterface DtTerrainImplementation
   : boost::noncopyable
{
public:
   DtTerrainImplementation(DtConsoleCommandManager* cmdManager);
   virtual ~DtTerrainImplementation();

   virtual MAKVRinTerra::DtFeatureDatabase& featureDatabase();
   virtual const MAKVRinTerra::DtFeatureDatabase& featureDatabase() const;

   virtual MAKVRinTerra::DtFeatureContext& featureContext();
   virtual const MAKVRinTerra::DtFeatureContext& featureContext() const;

   virtual void init();

   virtual void finishedLoading(const MAKVRinTerra::DtProj& proj);

   virtual bool loadTerrain(const makArchives::DtGenericTerrainRecord& rec) = 0;

   virtual void shutdown(bool block=true);

   virtual const Coordinate_System* coordinateSystem() const = 0;

   virtual double modelHeightDifferencesFromAppearances(int oldApp, int newApp) const;

   virtual bool createFromExtent(const Dt3dBoundingVolume&);

   virtual bool loadModel(const DtFilename&, const DtEntityType& t = DtEntityType());

   virtual DtTerrainInterfaceConfig& configurationOptions();
   virtual const DtTerrainInterfaceConfig& configurationOptions() const;

   virtual bool chordIntersect(const DtChord& chord,
      DtChordIntersectionRecord& record,
      DtIntersectionRecord::DtIntersectionType irtFlag = 
      DtIntersectionRecord::INT_ALL_DATA, bool* dataAvailable = 0,
      bool overrideBlockingAssert = false, int flags = 0) const = 0;

   virtual bool allIntersectsAlongChord(const DtChord& chord,
      DtChordIntersectRecordList& intList,
      DtIntersectionRecord::DtIntersectionType irtFlag = 
      DtIntersectionRecord::INT_ALL_DATA, bool* dataAvailable = 0,
      bool overrideBlockingAssert = false, int flags = 0) const = 0;

   virtual void preloadTerrainAreas(
      const DtTerrainPagingGeometryList& preloadGeometry) {};

   virtual const DtTerrainCapabilities* terrainCapabilities() const = 0;

   virtual void setAssertOnBlockingTerrainCalls(bool assertBlock);
   virtual bool assertOnBlockingTerrainCalls() const;

   virtual void setWarnOnBlockingTerrainCalls(bool warnBlock);
   virtual bool warnOnBlockingTerrainCalls() const;

   virtual void setIntersectDataLoadExpireTime(const double& expireTime) {};

   virtual void expireDataLoadRequestsBeforeTime(const double& currentTime) {};

   virtual void processTrianglesInArea(DtTriangleCallbackFcn func, DtTriangleCallbackFinalizeFcn finalize, DtTerrainProcessPolygonsBox& box, void* usr) const;

   virtual void breakUpChords(const MAKVRinTerra::DtProj&, const DtChord& chord,
      std::vector<DtChord>& chords);

   virtual bool hasFeatureContext() const;

protected:
   DtTerrainInterfaceConfig myConfig;

   bool myAssertOnBlockingTerrainCalls;
   bool myWarnOnBlockingTerrainCalls;

   boost::scoped_ptr<MAKVRinTerra::DtFeatureDatabase> myFeatureDatabase;
   boost::scoped_ptr<MAKVRinTerra::DtFeatureContext> myFeatureContext;
};

typedef DtStringKeyFactoryWithParam<DtTerrainImplementation, 
   DtConsoleCommandManager*> DtTerrainImplementationFactory;
typedef DtTerrainImplementationFactory::DtCreatorFcn 
   DtTerrainImplementationCreatorFcn;