This page has been translated automatically.
Click here to view the original English version instead.
Getting Started
What's Inside?
Project Workflow
Basic Tutorial: Importing FBX Model
Hardware Requirements
Principles of Operation
Virtual World Structure
World Management
Rendering
Rendering Sequence
Scattering
HDR Rendering
Temporal Anti-Aliasing
Alpha Blending
Postprocessing
Hiding Shading Artifacts with AppBorder Plugin
Physics
Shapes
Collision Detection
Joints
Simulation of Physics
Bit Masking
File System
SDK Browser
Projects
Licenses
Add-Ons
ARTTRACK Add-On
Game Framework Add-On
Kinect2 Add-On
LVC Game Add-On
Perception Neuron Add-On
Tutorials Content Add-On
Vegetation Add-On
VRPN Add-On
UnigineEditor
Overview
Controls
Managing Worlds
Scene Navigation
Setting Up Cameras
Importing Nodes
Selecting and Positioning Nodes
Organizing Nodes
Exporting Nodes
Rendering Settings
Camera Effects
Setting Up Materials
Setting Up Properties
Setting Up Physics
Terrain Editor
Terrain Grabber
System Menu
Video Grabber
Mask Editor
Tools Panel
LUT Generation Tool
Plugins
Collada Import Plugin
OpenFlight Import Plugin
Importing Large Populated Areas with City Import Plugin
Making Environment Look Realistic with Randomizer Plugin
Exporting Nodes with Node Export Plugin
Baking Meshes into One Mesh with Mesh Combiner Plugin
Creating Large Terrains with Landscape Plugin
Interface Plugin
Making Custom Editor Plugins
Tools
Plugins for 3D Editors
Plugins for 3ds Max
Plugins for Maya
Performance Profiling Tools
Performance Profiler
Microprofile
ResourceEditor
MeshViewer
NormalCombiner
NormalMapper
AmbientMapper
AlphaMapper
ImageDDS
ImageTTF
USC Interpreter
Archiver
Resource
MeshImport
Upgrade Script
Built-in Node Types
Nodes
Node
Node Reference
Dummy Node
Layer
Pivot
Trigger
Objects
Dummy Object
Static Mesh
Skinned Mesh
Dynamic Mesh
Mesh Cluster
Mesh Clutter
Text Object
Sky
Effects
Particle System
Decals
Projected Decal
Orthographic Decal
Mesh Decal
Light Sources
Light Sources Parameters
Omni Light
Projected Light
World Light
Environment Probe
Geodetics
Geodetic Pivot
World Objects
World Layer
Sector
Portal
World Trigger
World Cluster
World Clutter
Switcher
World Expression
Sound Objects
Sound Source
Sound Reverb
Pathfinding Objects
Players
Player Actor
Player Dummy
Player Persecutor
Player Spectator
Programming
Fundamentals
Programming Overview
Engine Architecture
Typical Architecture of a Unigine-Based Application
Memory Management
Matrix Transformations
Setting Up Development Environment
Windows Development Environment
Linux Development Environment
OS X Development Environment
UnigineScript
Creating UnigineScript Application
Adding Scripts to the Project
Script Debugging
High-Level Systems
UnigineScript Basic Utilities
Unigine::Schemer
Unigine::Skinner
Input System
Character System
KeyLine System
Dialogs Script
Cache Files
C++
Creating C++ Application
Creating C++ Plugin
C#
Creating C# Application
C# API Reference
UUSL (Unified UNIGINE Shader Language)
UUSL Keywords
UUSL Common Intrinsic Functions
UUSL GBuffer Structure
UUSL Data Structure
UUSL Parameters
UUSL Textures
UUSL Semantics
UUSL Tessellation
Creating of Custom Shader for Deferred Rendering Pass
Creating of Custom Shader for Forward Rendering Pass
Creating of Custom Shader for Post-Processing
File Formats
Mesh File Formats
Material File Format
Startup Command-Line Options
Console
Configuration File
Rebuilding the Engine and Tools
Rebuild in Windows via Visual Studio
Rebuild in OS X via Xcode
Semi-automatic Compilation with Build Script
Manual Compilation with SCons
Preprocessor Macros for Rebuilding the Engine
Rebuild Qt Libraries
Protecting Your Data with a Password
GUI
RC Files
Skin Layout
Usage Example
Double Precision Coordinates
Usage
Performance Analyzer
How to Generate Shaders Cache
API
Containers
Container Functions
ArrayVector Class
Map Class
Set Class
Common Functionality
Async Class
Atomiclock Class
Blob Class
CallbackBase Class
Checksum Class
Compress Class
ConsoleVariableFloat Class
ConsoleVariableInt Class
ConsoleVariableString Class
Expression Class
ExternClass Class
FunctionBase Class
Image Class
Iterator Class
Interpreter Class
Json Class
Log Class
OS Functions
Path Class
Plugin Class
Property Class
Ptr Class
Reflection Class
RegExp Class
Resource Class
Stream Class
String Class
System Functions
Thread Class
Timer Class
TypeInfo Class
Unigine Namespace Items
Xml Class
Variable Class
Controls-Related Classes
Controls Class
ControlsApp Class
ControlsDummy Class
ControlsJoystick Class
ControlsSixAxis
ControlsXPad360 Class
Engine-Related Classes
App Class
Config Class
Console Class
Editor Class
Engine Class
EngineEditor Class
EnginePtr Class
EngineWorld Class
engine.system Functions
EnginePlugins Class
Game Class
GameIntersection Class
Memory Class
Profiler Class
Properties Class
Sound Class
Sounds Class
Splash Class
Visualizer Class
World Class
Filesystem Functionality
Dir Class
File Class
Filesystem Class
Package Class
GUI-Related Classes
Gui Class
UserInterface Class
Widget Class
WidgetButton Class
WidgetCanvas Class
WidgetCheckBox Class
WidgetComboBox Class
WidgetDialog Class
WidgetDialogColor Class
WidgetDialogFile Class
WidgetDialogImage Class
WidgetDialogMessage Class
WidgetEditLine Class
WidgetEditText Class
WidgetExternBase Class
WidgetExtern Class
WidgetGridBox Class
WidgetGroupBox Class
WidgetHBox Class
WidgetHPaned Class
WidgetIcon Class
WidgetLabel Class
WidgetListBox Class
WidgetManipulator Class
WidgetManipulatorRotator Class
WidgetManipulatorScaler Class
WidgetManipulatorTranslator Class
WidgetMenuBar Class
WidgetMenuBox Class
WidgetScroll Class
WidgetScrollBox Class
WidgetSlider Class
WidgetSpacer Class
WidgetSpinBox Class
WidgetSprite Class
WidgetSpriteNode Class
WidgetSpriteShader Class
WidgetSpriteVideo Class
WidgetSpriteViewport Class
WidgetTabBox Class
WidgetTreeBox Class
WidgetVBox Class
WidgetVPaned Class
WidgetWindow Class
Math Functionality
Geometry Class
Math Common Functions
Math Exponential Functions
Math Matrix Functions
Math Random Functions
Math Trigonometrical Functions
bvec4 Class
dmat4 Class
dvec2 Class
dvec3 Class
dvec4 Class
half Class
hvec2 Class
hvec3 Class
hvec4 Class
ivec2 Class
ivec3 Class
ivec4 Class
mat2 Class
mat3 Class
mat4 Class
quat Class
vec2 Class
vec3 Class
vec4 Class
Node-Related Classes
Node Class
NodeDummy Class
NodeExtern Class
NodeExternBase Class
NodeLayer Class
NodePivot Class
NodeReference Class
NodeTrigger Class
Geodetics-Related Classes
Ellipsoid Class
GeodeticPivot Class
Networking Functionality
Socket Class
Pathfinding-Related Classes
Navigation Class
NavigationMesh Class
NavigationSector Class
Obstacle Class
ObstacleBox Class
ObstacleCapsule Class
ObstacleSphere Class
PathRoute Class
PathRouteIntersection Class
Physics-Related Classes
Physics Class
PhysicsIntersection Class
PhysicsIntersectionNormal Class
Plugins-Related Classes
AutodeskImport Class
ColladaImport Class
OpenFlightImport Class
engine.border Functions
engine.grabber Functions
engine.kinect Functions
engine.oculus Functions
engine.projection Functions
engine.surround Functions
engine.vive Functions
engine.wall Functions
Rendering-Related Classes
Camera Class
Ffp Class
Material Class
Materials Class
Mesh Class
Render Class
Renderer Class
RenderState Class
Shader Class
Texture Class
TextureRender Class
Viewport Class
Content Creation
Content Pipeline
3D Models Requirements
Art Assets Conversion
Content Optimization
Materials
Hierarchy and Inheritance
Custom Materials
Tutorials
Adding Morph Targets
Setting Up Object LODs
Adding Sun, Sky and Clouds
Adding Impostors to Clutters
Unigine Demos
Migrating to UNIGINE 2.3
API Migration
Console Migration
Table of Contents
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.

Ellipsoid Class

List of functions:

List of Variables:

ELLIPSOID_MODE_ACCURATE
ELLIPSOID_MODE_FAST

The Ellipsoid class.

Ellipsoid Class

Members

static Ellipsoid(double semimajor_axis, double flattening)

Arguments

  • double semimajor_axis
  • double flattening

static Ellipsoid()

Constructor. Creates a new Ellipsoid class instance (WGS84 Ellipsoid).

dvec3 getENUSurfacePoint(dvec3 geodetic_origin, dvec3 tangent_point)

Arguments

  • dvec3 geodetic_origin
  • dvec3 tangent_point

dvec3 getENUTangentPoint(dvec3 geodetic_origin, dvec3 surface_point)

Arguments

  • dvec3 geodetic_origin
  • dvec3 surface_point

quat getENUWorldRotation(dvec3 geodetic_origin)

Returns the world rotation quaternion in ENU coordinates.

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).

Return value

World rotation in ENU coordinates.

dmat4 getENUWorldTransform(dvec3 geodetic_origin)

Returns the world transformation matrix in ENU coordinates.

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).

Return value

World transformation matrix in ENU coordinates.

void setFlattening(double flattening)

Sets new flattening for the ellipsoid.

Arguments

  • double flattening - Flattening coefficient of the ellipsoid. If the value is 0, the ellipsoid has a sphere shape, for 1 the ellipsoid has a circle (completely flat) shape.

double getFlattening()

Returns flattening coefficient of the ellipsoid.

Return value

Flattening coefficient of the ellipsoid.

double getMeanRadius()

Returns the mean radius of the ellipsoid.

Return value

The mean radius of the ellipsoid.

void setMode(int mode)

Sets the calculation mode.

Arguments

int getMode()

Returns the calculation mode int value: 1 if the mode is MODE_ACCURATE, 0 if the mode is MODE_FAST.

Return value

1 if the mode is MODE_ACCURATE, 0 if the mode is MODE_FAST.

vec3 getNEDSurfacePoint(dvec3 geodetic_origin, dvec3 tangent_point)

Returns surface point by using tangent point coordinates.

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).
  • dvec3 tangent_point - Tangent point coordinates to converted (curved) to surface coordinates (offset related to point of junction).

Return value

Surface point coordinates.

vec3 getNEDTangentPoint(dvec3 geodetic_origin, dvec3 surface_point)

Returns tangent point NED coordinates based on the geographical coordinates.

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).
  • dvec3 surface_point - Surface point coordinates to be converted (flatten) to tangent point (offset related to point of junction).

Return value

Tangent point coordinates.

quat getNEDWorldRotation(dvec3 geodetic_origin)

Returns the world rotation quaternion in NED coordinates.

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).

Return value

World rotation in NED coordinates.

dmat4 getNEDWorldTransform(dvec3 geodetic_origin)

Returns the world transformation matrix in NED coordinates.

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).

Return value

World transformation matrix in NED coordinates.

void setSemimajorAxis(double axis)

Sets new semimajor axis of the ellipsoid.

Arguments

  • double axis - Semimajor axis length in units.

double getSemimajorAxis()

Returns semimajor axis length of the ellipsoid in units.

Return value

Semimajor axis of the ellipsoid.

double getSemimajorEccentricitySqr()

Returns the squared eccentricity calculated along the semimajor axis.

Return value

Squared eccentricity calculated along the semimajor axis.

double getSemiminorAxis()

Returns semiminor axis of the ellipsoid in units.

Return value

Semiminor axis of the ellipsoid in units.

double getSemiminorEccentricitySqr()

Returns the squared eccentricity calculated along the semiminor axis.

Return value

Squared eccentricity calculated along the semiminor axis.

dvec3 solveGeodeticDirect(dvec3 geodetic_start, double bearing, double distance)

Arguments

  • dvec3 geodetic_start
  • double bearing
  • double distance

void solveGeodeticInverse(dvec3 geodetic_start, dvec3 geodetic_end, double & bearing, double & distance)

Arguments

  • dvec3 geodetic_start
  • dvec3 geodetic_end
  • double & bearing
  • double & distance

dvec3 toECF(dvec3 geodetic_coords)

Converts geodetic coordinates to Cartesian (ECF).

Arguments

  • dvec3 geodetic_coords - Ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters)) to be converted to Cartesian.

Return value

Cartesian coordinates.

dvec3 toENU(dvec3 geodetic_origin, dvec3 geodetic_coords)

Converts geodetic coordinates to ENU (East, North, Up).

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).
  • dvec3 geodetic_coords - Coordinates to be converted to ENU.

Return value

ENU coordinates.

dvec3 toGeodetic(dvec3 ecf_coords)

Converts Cartesian (ECF) coordinates to Ellipsoid.

Arguments

  • dvec3 ecf_coords - Cartesian ECF coordinates to be converted.

Return value

Ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters)

dvec3 toNED(dvec3 geodetic_origin, dvec3 geodetic_coords)

Converts geodetics coordinates to NED (North, East, Down).

Arguments

  • dvec3 geodetic_origin - The origin in ellipsoid coordinates (latitude (degrees), longitude (degrees) and altitude (meters).
  • dvec3 geodetic_coords - Coordinates to be converted to NED.

Return value

NED coordinates.

int ELLIPSOID_MODE_ACCURATE

Description

A calculation mode uses Vincenty's formula to calculate distances on the surface of the ellipsoid with a millimeter precision. It takes more time for calculation, but the accuracy of positioning is awesome.

int ELLIPSOID_MODE_FAST

Description

A calculation mode is computed by using Great-circle distance formula. It works pretty fast, but you'll get positioning errors on big (~80000x80000 units) distances.
Last update: 2017-07-03
Build: ()