IFileHeader.hpp

#ifndef DM_IO_FILE_HEADER_HPP_INCLUDED
#define DM_IO_FILE_HEADER_HPP_INCLUDED

#ifdef _MSC_VER
  #pragma once
#endif

#include "DM/config.hpp"
#include "DM/AutoLink.hpp" //enable autolink
#include "DM/Handle.hpp"
#include "DM/ObjectBase.hpp"
#include "DM/IBox.hpp"
#include "DM/IAddInfoLayout.hpp"

DM_NAMESPACE_BEGIN

/// coordinate reference system type 
namespace CoordRefSys {
  enum Type {
    none,             ///< not definied/unset
    internallyStored, ///< crs is stored internally
    separatePrjFile   ///< crs is stored in a separate prj file
  };
}

class DM_API IFileHeader : public ObjectBase 
{
protected:
  virtual ~IFileHeader() {}

public:
  virtual long long getPointCount()         const = 0;
  virtual long long getLineCount()          const = 0;
  virtual long long getLinePointCount()     const = 0;
  virtual long long getPolygonCount()       const = 0;
  virtual long long getPolygonPointCount()  const = 0;

  /// get the bounding box of the data set
  virtual BoxHandle getBoundingBox()  const = 0;

  /// The 'epsilon' of coordinates (e.g. coordinates with mm-precision: 0.001)
  /// Relevant only for ASCII files.
  virtual void getPrecision( double& precX, double& precY, double& precZ ) const = 0;

  /// The highest dimensionality of contained geometries (e.g. 0 for points)
  virtual int getDim() const = 0;

  /// Get coordinate reference system as WKT string (can be empty)
  virtual const char* getCRS() const = 0;
  /// Get coordinate reference system type (enum if stored internally or a separate ".prj" file)
  virtual CoordRefSys::Type getCRSType() const = 0;

  /// Get the attributes (as addinfo layout) that can be retrieved when reading the corresponding file
  virtual AddInfoLayoutHandle getImportLayout() const = 0;
  
  /// Get the attribute layout of the data that will be returned by the import object
  /** 
      The returned layout is merged from the provided layout during import object creation and the actual import attribute layout. In case
      no layout was provided during import creation (or the import class doesn't support this feature), the data and import layout are identical.
  */
  virtual AddInfoLayoutHandle getDataLayout() const = 0;
  
  //list of supported properties
  // GDAL format:
  //    GridWidthX  double
  //    GridWidthY  double
  // LAS format:
  //    MajorVersion      unsigned
  //    MinorVersion      unsigned
  //    PointRecordFormat unsigned

  virtual bool getPropetry(const char* name, unsigned &value) const = 0;
  virtual bool getPropetry(const char* name, long long &value) const = 0;
  virtual bool getPropetry(const char* name, double &value) const = 0;
};

typedef Handle<IFileHeader> FileHeaderHandle;

DM_NAMESPACE_END


#endif //DM_IO_FILE_HEADER_HPP_INCLUDED