This page has been translated automatically.
Video Tutorials
How To
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Light Sources
World Objects
Sound Objects
Pathfinding Objects
Setting Up Development Environment
Usage Examples
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
Double Precision Coordinates
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
Art Samples

Geodetic Pivot

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.
In UNIGINE SDK editions other than Engineering and Sim, the geodetic pivot object is equivalent to NodeDummy.

A geodetic pivot object is an abstract object that contains an ellipsoid with a pivot point. By using geodetic pivot you can place objects on the scene on the corresponding places in the real world.

Geodetic pivot helps to place world objects on their real world positions (latitude, longitude and altitude) by curving a plane with objects on it. Pivot converts real geodetic data to Cartesian and simultaneously "curves" objects to simulate the contorted Earth's surface.

Geodetic pivot works with:

Curved ObjectMeshStatic with WorldClutter

See Also#

Adding a Geodetic Pivot#

To add a static mesh to the scene via UnigineEditor do the following:

  1. Run the project with UnigineEditor.
  2. On the Menu bar, click Create -> Geodetics -> Pivot.

  3. Place the pivot somewhere in the world.

Setting Up a Geodetic Pivot#

After adding the Geodetic Pivot on the scene, set up the parameters located in the Geodetic Pivot section (Parameters window -> Node tab).

  • Location settings. The geodetic location on the Earth of the pivot point. It is specified by 3 components:
    • Latitude is the north–south position in degrees of a point on the Earth's surface. For example, Tomsk city latitude is 56.4977100. 0 value means equator, 90 value means the North Pole, -90 means the South Pole.
    • Longitude is the east-west position in degrees of a point on the Earth's surface. For example, Tomsk city longitude is 84.9743700. 0 value means a prime meridian (Greenwich). This field supports two ranges: from -180 to 180 and from 0 to 360.
    • Altitude is the height above sea level of a location. For example, Tomsk city altitude is 117 meters.
    • Coordinates
      • X - Y - Z (Local) disables the binding to geo-coordinates. Geodetic Pivot can be placed everywhere.
      • East - North - Up (Earth-Centric) places Geodetic Pivot to the world ECF position with ENU orientation according to given latitude / longitude / altitude. The Geodetic Pivot position is blocked.
        The Up-axis (Z+) direction in ENU points upward along the ellipsoid normal, while in UNIGINE implementation of ENU it goes from the Earth's center.
    • Flat geopositioning mode of the Geodetic Pivot. This mode should be used, when it is necessary only to set node positions via geo coordinates (latitude, longitude, altitude) without curving the terrain, clouds, etc.
  • Ellipsoid settings.
    • Reference is a mathematically defined ellipsoid that approximates the surface of the planet. We offer popular geocentric reference ellipsoids: WGS84, GRS80, Airy 1830, etc.

Working with Geodetic Pivot#

After adding and setting up the Geodetic Pivot, you can simply add objects to "curve" them:

  1. Choose the necessary nodes (static meshes, grass, clutters, etc.) in the Nodes window and set them as children of the Geodetic Pivot.

  2. Specify the necessary settings of the Geodetic Pivot.
  3. The update will be performed automatically.

As you add a node as a child to the Geodetic Pivot, its geo position coordinates (latitude, longitude, and altitude) are displayed in the Common section of the Node tab:

Geo Position Specifies the geo position coordinates for the node (latitude, longitude, and altitude).

By default only the following objects are curved by the Geodetic Pivot:

  • global terrain (ObjectTerrainGlobal)
  • global water (ObjectWaterGlobal)
  • cloud layers (ObjectCloudLayer)

As for static meshes, mesh decals, and billboards, sometimes you might just want to set their positions in real world coordinates an leave their geometry as is, but in some cases they should be curved (e.g., large static meshes, or roads represented as mesh decals). For this purpose you should use the following two buttons:

Make Curved Curves the geometry of the object according to the specified settings. A curved clone of the initial node is created, the initial node (using a non-curved mesh) is simply disabled, so you can use it when you need to return geometry back to normal (uncurved) state.
Buttons described above are available only for Static Mesh, Mesh Decal, and Billboards objects, when they are added as children to the Geodetic Pivot.
Last update: 2021-04-29
Build: ()