terrainDatabaseUtilities.h

Go to the documentation of this file.

/******************************************************************************
** Copyright (c) 2005 MAK Technologies, Inc.
** All rights reserved.
******************************************************************************/
/******************************************************************************
** $RCSfile: terrainDbUtilities.h,v $ $Revision: 1.5 $ $State: Exp $
******************************************************************************/
#ifndef terrainDatabaseUtilities_H_
#define terrainDatabaseUtilities_H_

//
// \file terrainDbUtilities.h
// \brief Contains functions related to the DtTerrainDatabase or operations performed 
//  on it that, while related, are not part of its interface.
//

#include "gdb/gdbDefines.h"
#include "gdb/gdbNode.h"

class DtTerrainDatabase;
class DtPoint;
class DtChordIntersectionRecord;
class DtVectorNetworkRecord;
class DtVectorNetworkIntersectionRecord;


// Intersect the specified terrain database, at the specified location, and return
// the intersection results, if any, in the specified chord intersection record.
// If the vector network parameters are present, then the associated intersection
// will be performed as well, and appropriate results returned if any.
// \return A boolean indicating whether or not any intersection occured, as configured.
DT_DLL_gdb bool intersectTerrain(DtTerrainDatabase& terrainDatabase, 
   const DtVector& localLocation, DtChordIntersectionRecord& record, 
   DtGdbNode::DtIntersectRecordType irtFlag, 
   DtVectorNetworkRecord* vectorRecord, 
   DtVectorNetworkIntersectionRecord* vectorIntersectionRecord);

// \return A chord at the specified location, of the specified half-length, 
// in the direction of gravity.  
DT_DLL_gdb DtChord createVerticleChord(const DtVector& location, 
   const DtVector& downDirection, double chordHalfLength);

// Merges the feature data from sourceData into the mergeTarget terrain
// database.  Coordinate systems are converted as necessary.
// \note sourceData may be altered if a coordinate system transform is
// necessary for the merge.  If connectEdges is false the shape edges
// will be left alone (unconnected)
DT_DLL_gdb bool mergeFeatureData(DtTerrainDatabase& sourceData,
                                 DtTerrainDatabase& mergeTarget,
                                 bool connectEdges = true);
#endif