DgnGeoCoord.h

Go to the documentation of this file.

/*--------------------------------------------------------------------------------------+
|
|   Supplied under applicable software license agreement.
|
|   Copyright (c) 2018 Bentley Systems, Incorporated. All rights reserved.
|
+---------------------------------------------------------------------------------------*/
#pragma once

#if defined (__DGNGEOCOORD_BUILD__)
#   define DGNGEOCOORD_EXPORTED    __declspec(dllexport)
#else
#   define DGNGEOCOORD_EXPORTED    __declspec(dllimport)
#endif

#include    <GeoCoord\basegeocoord.h>
#include    <DgnPlatform/DgnPlatform.h>
#include    <DgnPlatform/DgnFileIO/UnitDefinition.h>
#include    <DgnPlatform/scancriteria.h>
#include    <Bentley/bvector.h>
#include    <DgnPlatform/DgnPlatformLib.h>

typedef struct GeoCoordType66 const*    GeoCoordType66CP;
typedef struct GeoCoordType66 *         GeoCoordType66P;
typedef union  ProjectionParams const*  ProjectionParamsCP;
typedef union  ProjectionParams *       ProjectionParamsP;

BEGIN_BENTLEY_NAMESPACE

namespace GeoCoordinates {

typedef RefCountedPtr<DgnGCS>   DgnGCSPtr;

enum GeoCoordinationState
    {
    NoGeoCoordination   = 0,
    Reprojected         = 1,
    AECTransform        = 2,
    };

enum GeoCoordInterpretation
    {
    Cartesian = 0,
    XYZ       = 1
    };

/*=================================================================================**/
struct          IGeoCoordinateEventHandler
{
/*---------------------------------------------------------------------------------**/
virtual StatusInt   BeforeCoordinateSystemChanged (DgnGCSP oldGCS, DgnGCSP  newGCS, DgnModelRefP modelRef, bool primaryCoordSys, bool writingToFile, bool reprojectData) = 0;

/*---------------------------------------------------------------------------------**/
virtual void        AfterCoordinateSystemChanged (DgnGCSP oldGCS, DgnGCSP newGCS, DgnModelRefP modelRef, bool primaryCoordSys, bool writtenToFile, bool reprojectData) = 0;

/*---------------------------------------------------------------------------------**/
virtual StatusInt   BeforeCoordinateSystemDeleted (DgnGCSP currentGCS, DgnModelRefP modelRef, bool primaryCoordSys) = 0;

/*---------------------------------------------------------------------------------**/
virtual void        AfterCoordinateSystemDeleted (DgnGCSP currentGCS, DgnModelRefP modelRef, bool primaryCoordSys) = 0;

/*---------------------------------------------------------------------------------**/
virtual void        BeforeReferenceGeoCoordinationChanged (DgnModelRefP modelRef, GeoCoordinationState oldState, GeoCoordinationState newState) = 0;

/*---------------------------------------------------------------------------------**/
virtual void        AfterReferenceGeoCoordinationChanged (DgnModelRefP modelRef, GeoCoordinationState oldState, GeoCoordinationState newState) = 0;

};

typedef bvector <IGeoCoordinateEventHandler*>   T_GeoCoordEventHandlers;

/*=================================================================================**/
struct DgnGCS : public BaseGCS, DgnPlatform::DgnModelAppData
{
private:
    virtual void MakeClassAbstract() = 0;
public:

public:

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static DgnGCSPtr      CreateGCS
(
WCharCP                 coordinateSystemName,
DgnModelRefP            modelRef
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static DgnGCSPtr      CreateGCS
(
DgnModelRefP            modelRef
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static DgnGCSPtr      CreateGCS
(
BaseGCSCP               baseGCS,
DgnModelRefP            modelRef
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED static DgnGCSPtr CreateGCS
(
DgnGCSCR dgnGcs
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  void                  CartesianFromUors
(
DPoint3dR               outCartesian,
DPoint3dCR              inUors
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED void                   CartesianFromUors2D
(
DPoint2dR               outCartesian,
DPoint2dCR              inUors
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  void                  UorsFromCartesian
(
DPoint3dR               outUors,
DPoint3dCR              inCartesian
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED void                   UorsFromCartesian2D
(
DPoint2dR               outUors,
DPoint2dCR              inCartesian
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       UorsFromLatLong
(
DPoint3dR               outUors,
GeoPointCR              inLatLong
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       LatLongFromUors
(
GeoPointR               outLatLong,
DPoint3dCR              inUors
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       LatLongFromUorsXYZ
(
GeoPointR               outLatLong,
DPoint3dCR              inUors
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED    ReprojectStatus     ReprojectUors
(
DPoint3dP               outUorsDest,
GeoPointP               outLatLongDest,
GeoPointP               outLatLongSrc,
DPoint3dCP              inUors,
int                     numPoints,
DgnGCSCR                destMstnGCS
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED    ReprojectStatus     ReprojectUors
(
DPoint3dP               outUorsDest,
GeoPointP               outLatLongDest,
GeoPointP               outLatLongSrc,
DPoint3dCP              inUors,
int                     numPoints,
GeoCoordInterpretation  interpretation,
DgnGCSCR                destMstnGCS
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       UorsFromLatLong2D
(
DPoint2dR               outUors,
GeoPoint2dCR            inLatLong
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       LatLongFromUors2D
(
GeoPoint2dR             outLatLong,
DPoint2dCR              inUors
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       ReprojectUors2D
(
DPoint2dP               outUorsDest,
GeoPoint2dP             outLatLongDest,
GeoPoint2dP             outLatLongSrc,
DPoint2dCP              inUors,
int                     numPoints,
DgnGCSCR                destMstnGCS
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       GetLocalTransform
(
TransformP              outTransform,
DPoint3dCR              elementOrigin,
DPoint3dCP              extent,
bool                    doRotate,
bool                    doScale,
DgnGCSCR                destMstnGCS
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  ReprojectStatus       GetLocalTransform
(
TransformP              outTransform,
DPoint3dCR              elementOrigin,
DPoint3dCP              extent,
bool                    doRotate,
bool                    doScale,
GeoCoordInterpretation  interpretation,
DgnGCSCR                destMstnGCS
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  WCharCP              GetProjectionName
(
WStringR                outputBuffer
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  WCharCP             GetDisplayName
(
WStringR                outputBuffer
) const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  StatusInt             ToModel
(
DgnModelRefP            modelRef,
bool                    primaryCoordSys,
bool                    writeToFile,
bool                    reprojectData,
bool                    reportProblems
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static DgnGCSP        FromModel
(
DgnModelRefP            modelRef,
bool                    primaryCoordSys
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static StatusInt      DeleteFromModel
(
DgnModelRefP            modelRef,
bool                    primaryCoordSys
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static DgnGCSP        FromCache
(
DgnModelP               cache,
bool                    primaryCoordSys
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static void           ReloadGeoReferences
(
DgnModelRefP            modelRef
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static void           SetEventHandler
(
IGeoCoordinateEventHandler*  handler
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED  static void           RemoveEventHandler
(
IGeoCoordinateEventHandler*  handler
);

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED double                 GetPaperScale () const;

/*---------------------------------------------------------------------------------**/
DGNGEOCOORD_EXPORTED StatusInt              SetPaperScale 
(
double paperScale, 
DgnModelRefP modelRef
);

};


} // ends GeoCoordinate namespace

END_BENTLEY_NAMESPACE