This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Unigine.GeodeticsTransformer Class

Warning
The functionality described in this article is not available in the Community SDK edition.
You should upgrade to Engineering / Sim SDK edition to use it.

This class is used to transform geodetic coordinates (latitude, longitude and altitude) to the 3D world position and vice versa.

Notice
Geodetics transformations are available only if GeodeticsPlugin is launched.

GeodeticsTransformer Class

Members


GeodeticsTransformer Get ( ) #

Returns a pointer to the existing geodetics instance.

Return value

Pointer to the existing geodetics transformer instance. If GeodeticsPlugin is not launched, nullptr is returned.

dmat4 GeodeticToWorld ( dvec3 geo_coords, bool rotate_to_en ) #

Transforms geodetic coordinates of the selected coordinate system to the 3D world coordinates: position and rotation (the Y axis is directed to the North, the X axis — to the East, and the Z axis — upwards).

Arguments

  • dvec3 geo_coords - Geodetic coordinates (lat,lon,alt).
  • bool rotate_to_en - true to rotate data as follows: East => X, North => Y (ENU and similar systems); false if the data source uses another alignment (for example NED).

Return value

World position and orientation.

dvec3 WorldToGeodetic ( dvec3 world_pos, bool rotate_to_en ) #

Transforms the 3D world coordinates to geodetic coordinates of the selected coordinate system.

Arguments

  • dvec3 world_pos - World position.
  • bool rotate_to_en - true to rotate data as follows: East => X, North => Y (ENU and similar systems); false if the data source uses another alignment (for example NED).

Return value

Geodetic coordinates (lat,lon,alt).

int SetProjectionWkt ( string projection_cs_wkt_string, dvec3 world_origin_geo_coords, string geodetic_cs_string, int geodetic_cs_is_well_known ) #

Sets a projection by WKT description, which is used as the world coordinate projection, and defines a geodetic coordinate system.

Arguments

  • string projection_cs_wkt_string - Description of the projection in the OpenGIS WKT format.
  • dvec3 world_origin_geo_coords - World origin in geodetic coordinates (lat,lon,alt).
  • string geodetic_cs_string - Description of a geodetic coordinate system.
  • int geodetic_cs_is_well_known - 1 or 0.

    If set to 1, a well-known coordinate system description is used as the geodetic_cs_string argument.

    The following well-known text values are supported:

    • WGS84 — same as EPSG:4326, but has no dependence on EPSG data files.
    • WGS72 — same as EPSG:4322, but has no dependence on EPSG data files.
    • NAD27 — same as EPSG:4267, but has no dependence on EPSG data files.
    • NAD83 — same as EPSG:4269, but has no dependence on EPSG data files.
    • EPSG:nn is a GCS code from the horizontal coordinate system table.

    If set to 0, a detailed WKT description is used.

Return value

1 on success; otherwise, 0.

int SetProjectionEpsg ( int projection_cs_epsg_code, dvec3 world_origin_geo_coords, string geodetic_cs_string, int geodetic_cs_is_well_known ) #

Sets a projection by EPSG code, which is used as the world coordinate projection, and defines a geodetic coordinate system.

Arguments

  • int projection_cs_epsg_code - EPSG code of the projection.
  • dvec3 world_origin_geo_coords - World origin in geodetic coordinates (lat,lon,alt).
  • string geodetic_cs_string - Description of a geodetic coordinate system.
  • int geodetic_cs_is_well_known - 1 or 0.

    If set to 1, a well-known coordinate system description is used as the geodetic_cs_string argument.

    The following well-known text values are supported:

    • WGS84 — same as EPSG:4326, but has no dependence on EPSG data files.
    • WGS72 — same as EPSG:4322, but has no dependence on EPSG data files.
    • NAD27 — same as EPSG:4267, but has no dependence on EPSG data files.
    • NAD83 — same as EPSG:4269, but has no dependence on EPSG data files.
    • EPSG:nn is a GCS code from the horizontal coordinate system table.

    If set to 0, a detailed WKT description is used.

Return value

1 on success; otherwise, 0.
Last update: 2022-12-14
Build: ()