Click or drag to resize

HorizontalVerticalTransformation Class

Used to transform coordinates of z-aware geometries between spatial references that have different geographic and/or vertical coordinate systems.
Inheritance Hierarchy
SystemObject
  Esri.ArcGISRuntime.GeometryDatumTransformation
    Esri.ArcGISRuntime.GeometryHorizontalVerticalTransformation

Namespace:  Esri.ArcGISRuntime.Geometry
Assembly:  Esri.ArcGISRuntime (in Esri.ArcGISRuntime.dll) Version: 100.9.0
Syntax
public sealed class HorizontalVerticalTransformation : DatumTransformation

The HorizontalVerticalTransformation type exposes the following members.

Constructors
Properties
  NameDescription
Public propertyInputSpatialReference
Gets the input SpatialReference.
(Inherited from DatumTransformation.)
Public propertyIsMissingProjectionEngineFiles
Gets true if the dataset needed by the Projection Engine is missing locally.
(Inherited from DatumTransformation.)
Public propertyCode exampleName
Returns the name of the datum transformation.
(Inherited from DatumTransformation.)
Public propertyOutputSpatialReference
Gets the output SpatialReference.
(Inherited from DatumTransformation.)
Public propertySteps
Gets the list of transformation steps that define this transformation.
Top
Methods
  NameDescription
Public methodGetInverse
Returns the inverse of this datum transformation or null if the transformation is not invertible.
(Inherited from DatumTransformation.)
Public methodIsEqual
Returns true if the two transformations are equal, false otherwise.
(Inherited from DatumTransformation.)
Top
Remarks

The inverse of this transformation, used to transform in the opposite direction, is returned from the GetInverse method.

A HorizontalVerticalTransformation can be constructed from a single HorizontalVerticalTransformationStep object, or from a number of transformation step objects that are chained together.

You can get a list of suitable transformations for a given input and output spatial reference using one of the methods on the TransformationCatalog class.

Some transformations require that certain Projection Engine data files be present on the local file system, and vertical transformation steps are especially likely to use such files, which can be very large in size. The IsMissingProjectionEngineFiles property indicates whether any of the files are missing. The complete list of necessary files for each specific step is available using the ProjectionEngineFilenames property.

A HorizontalVerticalTransformation object is immutable. A HorizontalVerticalTransformation is an ordered list of HorizontalVerticalTransformationStep objects. Each HorizontalVerticalTransformation has an input and an output SpatialReference, and this HorizontalVerticalTransformation object can be used to convert coordinates between the horizontal (geographic) and vertical datums of these spatial references using the series of steps it contains. Use the Project(Geometry, SpatialReference, DatumTransformation) method to transform the coordinates of a specific #ctor(SpatialReference). A horizontal transformation step is not needed when the input and output spatial references have the same underlying geographic coordinate systems. A vertical transformation is not needed if both datums (for ellipsoidal heights) or vertical datums (for gravity-related heights) are the same. To transform coordinates only between different horizontal (geographic) coordinate systems, you can use a GeographicTransformation instead.

See Also