zjf
2023-03-06 392b76515f40376b6d36f40a114850ef63650384
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/////////////////////////////////////////////////////////////////////////////// 
// Copyright (C) 2002-2016, 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 Teigha(R) software pursuant to a license 
//   agreement with Open Design Alliance.
//   Teigha(R) Copyright (C) 2002-2016 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 _OD_DB_GEODATA_PE_
#define _OD_DB_GEODATA_PE_
 
#include "RxObject.h"
#include "SmartPtr.h"
#include "DbExport.h"
 
#include "DbGeoData.h"
 
#include "TD_PackPush.h"
/** \details
An abstract class that represents a protocol extension for an OdDbGeoData object.
 
<group OdDb_Classes> 
*/
class TOOLKIT_EXPORT OdDbGeoDataPE : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdDbGeoDataPE);
  
  /** \details
    Virtual destructor.
  */
  virtual ~OdDbGeoDataPE() {};
  /** \details
    Transforms the geographic point into an equivalent design point.
    
    \param pGeoData [in] Pointer to an OdDbGeoData object.
    \param dblLongitude [in] Longitude ordinate of the point to be transformed. 
    \param dblLatitude [in] Latitude ordinate of the point to be transformed. 
    \param dblAltitude [in] Altitude ordinate of the point to be transformed. 
    \param dblDwgX [out] X ordinate of the transformed point.
    \param dblDwgY [out] Y ordinate of the transformed point.
    \param dblDwgZ [out] Z ordinate of the transformed point.
    
    \returns Returns eOK if successful, or an appropriate error code if not.
  */
  virtual OdResult transformFromLonLatAlt(const OdDbGeoData* pGeoData, const double& dblLongitude, const double& dblLatitude, const double& dblAltitude,
                                                             double& dblDwgX, double& dblDwgY, double& dblDwgZ) = 0;
  /** \details
    Transforms the design point into an equivalent geographic point.
    
    \param pGeoData [in] Pointer to an OdDbGeoData object.
    \param dblDwgX [in] X ordinate of the design point.
    \param dblDwgY [in] Y ordinate of the design point.
    \param dblDwgZ [in] Z ordinate of the design point.
    \param dblLongitude [out] Longitude ordinate of the transformed point. 
    \param dblLatitude [out] Latitude ordinate of the transformed point. 
    \param dblAltitude [out] Altitude (elevation) ordinate of the transformed point. 
    
    \returns Returns eOK if successful, or an appropriate error code if not.
  */
  virtual OdResult transformToLonLatAlt(const OdDbGeoData* pGeoData, const double& dblDwgX, const double& dblDwgY, const double& dblDwgZ,
                                                             double& dblLongitude, double& dblLatitude, double& dblAltitude) = 0;
  /** \details
    This method is used for user validation.
    
    \param coordinateSystem [in] Coordinate system name.
     
    \returns Returns true if validation passed successfully, or false if not.
  */
  virtual bool validateCs(const OdString & coordinateSystem) = 0;
  
  /** \details
    Returns xml representation of the coordinate system.
    
    \param pGeoData [in] Pointer to an OdDbGeoData object.
    \param inputName [in] Coordinate system name.
    \param resultXml [out] Xml representation of the coordinate system.
     
    \returns Returns eOK if successful, or an appropriate error code if not.
  */
  virtual OdResult parseCsName(const OdDbGeoData* pGeoData, const OdString & inputName, OdString & resultXml) = 0;
  
  /** \details
    This method is called when the coordinate system will be changed.
    
    \param pGeoData [in/out] Pointer to an OdDbGeoData object.
    \param oldName [in] Coordinate system name.
     
    \returns Returns eOK if successful, or an appropriate error code if not.
  */
  virtual OdResult geoCoordinateSystemWillChange(OdDbGeoData* pGeoData, const OdString& newName) = 0;
  
  /** \details
    This method is called when the coordinate system is changed.
    
    \param pGeoData [in/out] Pointer to an OdDbGeoData object.
    \param oldName [in] Coordinate system name.
     
    \returns Returns eOK if successful, or an appropriate error code if not.
  */
  virtual OdResult geoCoordinateSystemChanged(OdDbGeoData* pGeoData, const OdString& oldName) = 0;
  
  /** \details
    Parses and returns the coordinate system ID.
    
    \param xml [in] String with xml representation of coordinate system.
  */
  virtual OdString parseIdFromXml(const OdString& xml) = 0;
};
 
typedef OdSmartPtr<OdDbGeoDataPE> OdDbGeoDataPEPtr;
 
#include "TD_PackPop.h"
 
#endif //_OD_DB_GEODATA_PE_