DbGeoData.h

Go to the documentation of this file.

 
// Copyright (C) 2002-2022, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Open Design Alliance software pursuant to a license 
//   agreement with Open Design Alliance.
//   Open Design Alliance Copyright (C) 2002-2022 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
 
 
#ifndef _ODDB_GEODATA_INCLUDED_
#define _ODDB_GEODATA_INCLUDED_
 
#include "TD_PackPush.h"
 
#include "DbObject.h"
#include "OdDbGeoCoordinateSystem.h"
 
class TOOLKIT_EXPORT OdDbGeoData: public OdDbObject
{
public:
  ODDB_DECLARE_MEMBERS(OdDbGeoData);
  OdDbGeoData();
 
  enum TypeOfCoordinates
  {
    kCoordTypUnknown = 0,   // Unknown
    kCoordTypLocal,         // Local grid
    kCoordTypGrid,          // Projected grid
    kCoordTypGeographic     // Geographic (latitude/longitude)
  };
 
  enum ScaleEstimationMethod
  {
    kScaleEstMethodUnity = 1,       // Unity
    kScaleEstMethodUserDefined,     // User defined scale factor
    kScaleEstMethodReferencePoint,  // Grid scale at reference point
    kScaleEstMethodPrismoidal       // Prismoidal
  };
 
  OdDbObjectId blockTableRecordId() const;
  
  OdResult setBlockTableRecordId(const OdDbObjectId& blockId);
  
  OdResult postToDb(OdDbObjectId& objId);
 
  OdResult eraseFromDb();
 
  TypeOfCoordinates coordinateType() const;
  
  OdResult setCoordinateType(TypeOfCoordinates designCoordinateType);
 
  OdGePoint3d designPoint() const;
  
  OdResult setDesignPoint(const OdGePoint3d& point);
 
  OdGePoint3d referencePoint() const;
  
  OdResult setReferencePoint(const OdGePoint3d& point);
 
  double horizontalUnitScale() const;
  OdDb::UnitsValue horizontalUnits() const;
  
  OdResult setHorizontalUnitScale(double horzUnitScale);
  
  OdResult setHorizontalUnits(OdDb::UnitsValue horizUnits);
 
  double verticalUnitScale() const;
  OdDb::UnitsValue verticalUnits() const;
  OdResult setVerticalUnitScale(double vertUnitScale);
  OdResult setVerticalUnits(OdDb::UnitsValue vertUnits);
  
  OdGeVector3d upDirection() const;
  OdResult setUpDirection(const OdGeVector3d& vec);
 
  double northDirection() const;
  OdGeVector2d northDirectionVector() const;
  OdResult setNorthDirectionVector(const OdGeVector2d& north);
 
  ScaleEstimationMethod scaleEstimationMethod() const;
  OdResult setScaleEstimationMethod(ScaleEstimationMethod value);
 
  double scaleFactor() const;
  OdResult setScaleFactor(double value);
 
  bool doSeaLevelCorrection() const;
  OdResult setDoSeaLevelCorrection(bool seaLevelCorrectionOn);
 
  double seaLevelElevation() const;
  OdResult setSeaLevelElevation(double value);
 
  double coordinateProjectionRadius() const;
  OdResult setCoordinateProjectionRadius(double value);
 
  OdString coordinateSystem() const;
  OdResult setCoordinateSystem(const OdString& coordSystem);
 
  OdString geoRSSTag() const;
  OdResult setGeoRSSTag(const OdString& rssTag);
 
  OdString observationFrom() const;
  OdResult setObservationFrom(const OdString& from);
 
  OdString observationTo() const;
  OdResult setObservationTo(const OdString& to);
 
  OdString observationCoverage() const;
  OdResult setObservationCoverage(const OdString& coverage);
 
  OdInt32 numMeshPoints() const;
  OdResult getMeshPointMap(OdInt32 index, OdGePoint2d& srcPt, OdGePoint2d& dstPt) const;
  OdResult getMeshPointMaps(OdGePoint2dArray& srcPts, OdGePoint2dArray& dstPts) const;
  OdResult addMeshPointMap(OdInt32 index, const OdGePoint2d& srcPt, const OdGePoint2d& dstPt);
  OdResult setMeshPointMaps(const OdGePoint2dArray& srcPts, const OdGePoint2dArray& dstPts);
  OdResult resetMeshPointMaps();
 
  OdInt32 numMeshFaces() const;
  OdResult getMeshFace(OdInt32 faceIndex, OdInt32 & p0, OdInt32 & p1, OdInt32 & p2) const;
  OdResult addMeshFace(OdInt32 faceIndex, OdInt32 p0, OdInt32 p1, OdInt32 p2);
 
  virtual OdResult dwgInFields(
    OdDbDwgFiler* pFiler);
 
  virtual void dwgOutFields(
    OdDbDwgFiler* pFiler) const;
 
  virtual OdResult dxfInFields(
    OdDbDxfFiler* pFiler);
 
  virtual void dxfOutFields(
    OdDbDxfFiler* pFiler) const;
 
  OdResult transformToLonLatAlt(const OdGePoint3d& dwgPt, OdGePoint3d& geoPt) const;
  OdResult transformToLonLatAlt(double x, double y, double z, double& lon, double& lat, double& alt) const;
  
  OdResult transformFromLonLatAlt(const OdGePoint3d& geoPt, OdGePoint3d& dwgPt) const;
  OdResult transformFromLonLatAlt(double lon, double lat, double alt, double& x, double& y, double& z) const;
 
  OdResult updateTransformationMatrix();
 
  //DOM-IGNORE-BEGIN
  //For internal use only:
  const OdGeMatrix3d & getMatrixToLLA() const;
  const OdGeMatrix3d & getMatrixFromLLA() const;
  const OdGeMatrix3d & getMatrixLocalToLLA() const;
  const OdGeMatrix3d & getMatrixLocalFromLLA() const;
  OdResult meshTransformToLLA(const OdGePoint2d & ptIn, OdGePoint2d & ptOut) const;
  OdResult meshTransformFromLLA(const OdGePoint2d & ptIn, OdGePoint2d & ptOut) const;
  OdResult getSimpleTransformerToLLA(OdDbGeoCoordinateSystemTransformerPtr & pTransformer) const;
  OdResult getSimpleTransformerFromLLA(OdDbGeoCoordinateSystemTransformerPtr & pTransformer) const;
  //DOM-IGNORE-END
};
 
//GLOBAL API FUNCTIONS
TOOLKIT_EXPORT OdResult oddbGetGeoDataObjId(const OdDbDatabase *pDb, OdDbObjectId& objId);
 
TOOLKIT_EXPORT OdResult oddbGetGeoDataTransform(const OdDbDatabase* pDbSource, const OdDbDatabase* pDbTarget, OdGePoint3d& pt, double& dRotation, double& dScale);
 
typedef OdSmartPtr<OdDbGeoData> OdDbGeoDataPtr;
 
#include "TD_PackPop.h"
 
#endif //_ODDB_GEODATA_INCLUDED_