TINMAN 3D / REALTIME TERRAIN
Software Development Kit - User Manual

interface ICoordinateTransform in Tinman.Terrain.Georef

An ICoordinateTransform object provides a mapping from to map coordinates (i.e. easting and northing) to geodetic coordinates (i.e. latitude and longitude).

interface ICoordinateTransform extends ICoordinateFlip
  base of CoordinateTransform

Attributes

IsFlip

Does this coordinate system transform flip the handedness?

property IsFlip { get }
type bool
value true if the coordinate system handedness if flipped, false if not.
inherited ICoordinateFlip.IsFlip

Methods

Flags

Applies the given coordinate system flags to this transform.

method Flags (CoordinateSystemFlags flags)
type ICoordinateTransform
params flags The coordinate system flags to apply.
returns [not-null] The resulting coordinate transform.

Remarks:

The given flags will change the interpretation of easting and northing values that are passed to MapToGeographic or returned from GeographicToMap.

GeographicClip

Checks if the given coordinates lie within a bad region of this transformation.

[Pure]
method GeographicClip (float64 latitude, float64 longitude)
type bool
params latitude Latitude in radians, in terms of horizontal datum of geodata.
  longitude Longitude in radians, in terms of horizontal datum of geodata.
returns true if the given coordinates are considered to be bad, false if they are ok.

Remarks:

Bad regions are where heavy distortion or coordinate wrap-around occurs. This method is intended to be used for visualization. It should not be used for data processing.

GeographicToMap

Performs the forward calculation.

[Pure]
method GeographicToMap (float64 latitude, float64 longitude)
type Vec2D
params latitude Latitude in radians, in terms of horizontal datum of geodata.
  longitude Longitude in radians, in terms of horizontal datum of geodata.
returns The resulting easting (X) and northing (Y) values, in map units.

MapToGeographic

Performs the reverse calculation.

[Pure]
method MapToGeographic (float64 easting, float64 northing)
type Vec2D
params easting The easting coordinate, in map units.
  northing The northing coordinate, in map units.
returns The resulting longitude (X) and latitude (Y) angles in radians, in terms of horizontal datum of geodata.

Extensions

GeographicToMap

Performs the forward calculation.

method GeographicToMap (LatLon latLon)
type Vec2D
params latLon The latitude and latitude angles.
returns The resulting easting (see X) and northing (see Y) values.

MapToGeographic

Performs the reverse calculation.

method MapToGeographic (Vec2D eastingNorthing)
type Vec2D
params eastingNorthing The easting (see X) and northing (see Y) values.
returns The resulting longitude (see X) and latitude (see Y) angles, in radians.