ossimDtedRecord.h

Go to the documentation of this file.

//*******************************************************************
//
// License:  MIT
//
// See LICENSE.txt file in the top level directory for more details.
//
// Author: Ken Melero
// 
// Description:  This class gives access to the Data Record Description
//               of a DTED Level 1 file.
//
// Notes:  Each elevation is a true value referenced to meas sea level
//         (MSL) datum recorded to the nearest meter.  The horizontal
//         position is referenced to precise longitude-latitiude
//         locations in terms of the current World Geodetic System
//         (WGS84) determined for each file by reference to the origin
//         at the southwest corner.  The elevations are evenly spaced
//         in latitude and longitude at the interval designated in the
//         User Header Label (UHL) in South to North profile sequence.
//
//********************************************************************
// $Id: ossimDtedRecord.h 14248 2009-04-08 19:38:11Z dburken $
#ifndef ossimDtedRecord_H
#define ossimDtedRecord_H
#include <iosfwd>

#include <ossim/base/ossimConstants.h>
#include <ossim/base/ossimString.h>
#include <ossim/base/ossimErrorStatusInterface.h>

class OSSIM_DLL ossimDtedRecord : public ossimErrorStatusInterface
{
public:
   ossimDtedRecord(std::istream& in,
                   ossim_int32 offest,
                   ossim_int32 num_points);
   // NOTE:  When using this class be sure that as you cycle through
   //        all the points within a record, that you verify they are
   //        sequential.  According to the DTED Specification
   //        (MIL-PRF-89020A) issued in 19 April 1996, page 22 all
   //        records must be sequential.  If not, file may be corrupt.
   //
   //        To verify this, you can do the following:
   //
   //        int count = 0;
   //        for(int i = 0; i < num_lon_lines; i++)
   //          rec[i] = new ossimDtedRecord(theFileDesc, offset,
   //                       num_lat_points);
   //          if(count != (rec[i]->dataBlockCount() + 1))
   //             ERROR -- Records are not sequential
   //          count = rec[i]->dataBlockCount();

   ~ossimDtedRecord();
   
   enum
   {
      DATA_LENGTH = 12,
      DATA_BLOCK_COUNT = 2,
      DATA_LON_COUNT = 4,
      DATA_LAT_COUNT = 6,
      DATA_ELEV_START = 8,
      DATA_BYTES_PER_POINT = 2,
   };

   // The Recognition Sentinel signifies if the Data Record exists.
   ossimString recognitionSentinel() const;

   ossim_int32  dataBlockCount()   const;
   ossim_int32  lonCount()         const;
   ossim_int32  latCount()         const;
   ossim_uint32 checkSum()         const;
   ossim_uint32 computedCheckSum() const;
   ossim_int32  numPoints()        const;

   // Access methods for the elevation data
   ossim_int32   getPoint(ossim_int32 i)     const;
   ossim_uint16  getPointData(ossim_int32 i) const;
   ossim_int32*  points()                    const;
   ossim_uint16* pointsData()                const;
   
   ossim_int32 startOffset() const;
   ossim_int32 stopOffset()  const;

   friend OSSIM_DLL std::ostream& operator<<( std::ostream& os,
                                              const ossimDtedRecord& rec);
   void parse(std::istream& in);

private:
   // prevent use
   ossimDtedRecord(const ossimDtedRecord& source);

   ossim_int32  theFile;

   ossimString theRecSen;

   ossim_int32  theDataBlockCount;

   ossim_int32  theLonCount;

   ossim_int32  theLatCount;

   ossim_uint32  theCheckSum;

   ossim_int32* thePoints;

   ossim_uint16* thePointsData;

   ossim_uint32  theComputedCheckSum;

   ossim_int32  theNumPoints;

   ossim_int32  theStartOffset;
   ossim_int32  theStopOffset;

   bool validateCheckSum(std::istream& in);
};

#endif