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

interface IDatumTransform in Tinman.Terrain.Georef

An IDatumTransform transforms geographic coordinates from one horizontal datum to another one.

interface IDatumTransform extends IConfigurable
  ICoordinateFlip
  IEquatable<IDatumTransform>
  ISerializable
  base of DatumTransform

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

SerialType

Returns the serial type of this object.

property SerialType { get }
type ISerialTypeInfo
value [not-null] The serial type.
inherited ISerializable.SerialType

SerialVersion

Returns the serial data version.

property SerialVersion { get }
type int32
value [>=1] The serial data version tag.
inherited ISerializable.SerialVersion

Remarks:

An ISerializable implementation is required to support all versions up to the one returned by SerialVersion.

See also:

ISerializable.Serialize
ISerializable.Deserialize

Methods

Append

Appends the given datum transforms to this one.

method Append (IDatumTransform other)
type IDatumTransform
params other [not-null] The datum transform to append.
returns [not-null] The resulting transform.

Deserialize

Initializes the state of this object from the given data stream.

method Deserialize (int32 serialVersion, ISerializer data)
type ISerializable
params serialVersion [>=1] The serial data version.
  data [not-null] The serial data stream.
returns [not-null] The deserialized object. This will typically be this, but in some circumstances, another instance may be returned (e.g. singletons).
inherited ISerializable.Deserialize

Remarks:

The Deserialize method will be called immediately after the object has been instantiated via its default constructor.

The provided serialVersion number is guaranteed to be equal to or less than the SerialVersion returned by this object (i.e. ISerializable object must provide backwards compatibility).

See also:

ISerializable.Serialize
ISerializable.SerialVersion

Exceptions:

Equals

Compares this object with the given one.

[Pure]
method Equals (IDatumTransform other)
type bool
params other The object to compare to.
returns true if this object is equal to other, false if not.
inherited IEquatable.Equals

Reverse

Returns the reverse datum transform.

method Reverse ()
type IDatumTransform
returns [not-null] The reverse transform.

Serialize

Serializes the current state of this object to the given data stream.

method Serialize (ISerializer data)
params data [not-null] The serial data stream.
inherited ISerializable.Serialize

See also:

ISerializable.Deserialize
ISerializable.SerialVersion

Exceptions:

ToConfig

Returns the configuration value that describes this object.

method ToConfig ()
type ConfigValue
returns [not-null] The configuration value.
inherited IConfigurable.ToConfig

Remarks:

All configurable objects need to implement this interface. For simple types, it is preferable to delegate to ToValue.

The returned value may be of type Invalid, which means that this object in its current state cannot be described with the configuration API.

Before returning the resulting configuration value, Cache must be called on it, passing this IConfigurable object as parameter.

Exceptions:

Transform

Transforms the geographic coordinates from the source datum to the target datum.

method Transform (float64 latitude, float64 longitude, float64 height)
type Vec3D
params latitude Latitude in radians, in terms of source horizontal datum.
  longitude Longitude in radians, in terms of source horizontal datum.
  height Height value, in terms of source horizontal and vertical datums.
returns The resulting longitude (X), latitude (Y) and height (Z), in terms of target horizontal and vertical datums.