GlobeView.ToGeocentric Methods
Converts a camera position in geographic coordinates geocentric Cartesian coordinates.
Overload List
| Name | Description | |
|---|---|---|
 Public method | ToGeocentric(Point longLatElevation) | Converts a point expressed in geographic coordinates (longitude/latitude/elevation) to the geocentric Cartesian coordinate system. |
| Public method | ToGeocentric(Point longLatElevation, System.Double bearing, System.Double pitch, System.Double roll, out Point geocentricForwardVector, out Point geocentricUpVector) | Converts a camera position in geographic coordinates and camera orientation expressed as bearing/pitch/roll into geocentric Cartesian coordinates. |
ToGeocentric(Point longLatElevation)
Converts a point expressed in geographic coordinates (longitude/latitude/elevation) to the geocentric Cartesian coordinate system.Syntax
public static Point ToGeocentric (
Point longLatElevation
)Parameters
A point where x and y are longitude and latitude in degrees, while z is the elevation in meters.
Return Value
The corresponding point in geocentric Cartesian coordinates.
Remarks
The internal geocentric coordinate reference system is a Cartesian system in meters with origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.
The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.
There is a similar CRS method, Crs.UnprojectToGeocentricXYZ, which will use the reference ellipsoid of the CRS instead of a sphere.
ToGeocentric(Point longLatElevation, System.Double bearing, System.Double pitch, System.Double roll, out Point geocentricForwardVector, out Point geocentricUpVector)
Converts a camera position in geographic coordinates and camera orientation expressed as bearing/pitch/roll into geocentric Cartesian coordinates.Syntax
public static Point ToGeocentric (
Point longLatElevation,
System.Double bearing,
System.Double pitch,
System.Double roll,
out Point geocentricForwardVector,
out Point geocentricUpVector
)Parameters
The camera longitude and latitude in degrees, and elevation in meters.
The camera bearing in degrees, positive clockwise from north.
The camera pitch in degrees, positive up from horizontal.
The camera roll in degrees, positive roll meaning camera starboard goes down.
Returns a unit vector giving the forward direction of the camera, expressed in the geocentric Cartesian coordinate system.
Returns a unit vector giving the up direction of the camera, expressed in the geocentric Cartesian coordinate system.
Return Value
The camera position, expressed in the geocentric Cartesian coordinate system.
Remarks
The geocentric Cartesian coordinate system is meter-based and has its origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.
The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.
The method does not return the geocentric starboard vector for the camera, but it can be calculated afterwards as the cross product of the geocentric forward vector and the geocentric up vector.
Platforms
Windows, Linux, Android