AGI STK Util 11Send comments on this topic.
ConvertPositionArray Method (IAgConversionUtility)
See Also  Example
PositionType
PositionArray
ConvertTo
Windows






Windows & Linux

Description

Converts the specified position values from a given position type to another position type.

Syntax

[Visual Basic .NET]
Public Function ConvertPositionArray( _
   ByVal PositionType As AgEPositionType, _
   ByRef PositionArray As System.Array, _
   ByVal ConvertTo As AgEPositionType _
) As System.Array
[C#]
public System.Array ConvertPositionArray(
   AgEPositionType PositionType, 
   ref System.Array PositionArray, 
   AgEPositionType ConvertTo
);
[Managed C++]
public: System::Array ConvertPositionArray(
   AgEPositionType PositionType, 
   System::Array ^^ PositionArray, 
   AgEPositionType ConvertTo
);
[Java]
public Object[] convertPositionArray(
   AgEPositionType PositionType, 
   Object[] PositionArray, 
   AgEPositionType ConvertTo
);
[Unmanaged C++]
public: HRESULT ConvertPositionArray(
   AgEPositionType PositionType, 
   SAFEARRAY ** PositionArray, 
   AgEPositionType ConvertTo, 
   SAFEARRAY ** Array
);

Parameters

PositionType
MemberValueDescription
eCartesian0Cartesian: position specified in terms of the X, Y and Z components of the object's position vector, where the Z-axis points to the North pole, and the X-axis crosses 0 degrees latitude/0 degrees longitude.
eCylindrical1Cylindrical: position specified in terms of radius (polar), longitude (measured in degrees from -360.0 degrees to +360.0 degrees), and the Z component of the object's position vector.
eGeocentric2Geocentric: position specified in terms of latitude (spherical latitude of the sub-point on the surface of the Earth), longitude and altitude.
eGeodetic3Geodetic: position specified in terms of latitude (angle between the normal to the reference ellipsoid and the equatorial plane), longitude and altitude.
eSpherical4Spherical: position specified in terms of latitude (spherical latitude of the sub-point on the surface of the Earth), longitude and radius (distance of the object from the center of the Earth).
ePlanetocentric5Planetocentric: position specified in terms of latitude (spherical latitude of the sub-point on the surface of the Earth), longitude and altitude.
ePlanetodetic6Planetodetic: position specified in terms of latitude (angle between the normal to the reference ellipsoid and the equatorial plane), longitude and altitude.
PositionArray
ConvertTo
MemberValueDescription
eCartesian0Cartesian: position specified in terms of the X, Y and Z components of the object's position vector, where the Z-axis points to the North pole, and the X-axis crosses 0 degrees latitude/0 degrees longitude.
eCylindrical1Cylindrical: position specified in terms of radius (polar), longitude (measured in degrees from -360.0 degrees to +360.0 degrees), and the Z component of the object's position vector.
eGeocentric2Geocentric: position specified in terms of latitude (spherical latitude of the sub-point on the surface of the Earth), longitude and altitude.
eGeodetic3Geodetic: position specified in terms of latitude (angle between the normal to the reference ellipsoid and the equatorial plane), longitude and altitude.
eSpherical4Spherical: position specified in terms of latitude (spherical latitude of the sub-point on the surface of the Earth), longitude and radius (distance of the object from the center of the Earth).
ePlanetocentric5Planetocentric: position specified in terms of latitude (spherical latitude of the sub-point on the surface of the Earth), longitude and altitude.
ePlanetodetic6Planetodetic: position specified in terms of latitude (angle between the normal to the reference ellipsoid and the equatorial plane), longitude and altitude.

Example

Convert a position to another representation
[C#]Copy Code
IAgConversionUtility converter = root.ConversionUtility; 
 
// ConvertPositionArray expects a two dimensional array of positions 
Array cartesianPositions = new object[,] 
    { 
        { 1216.47, -4736.12, 4081.39 }, 
        { 1000, -2000, 2000 } 
    }; 
 
// Convert cartesian dates to cylindrical 
// ConvertPositionArray returns a two dimensional array of cartesian dates 
Array cylindricalPositions = converter.ConvertPositionArray(AgEPositionType.eCartesian, ref cartesianPositions, AgEPositionType.eCylindrical); 
 
// Print results 
for (int i = 0; i < cylindricalPositions.GetLength(0); i++) 
{ 
    Console.WriteLine("X: {0}, Y: {1}, Z: {2}", 
        cylindricalPositions.GetValue(i, 0), 
        cylindricalPositions.GetValue(i, 1), 
        cylindricalPositions.GetValue(i, 2)); 
} 
 

Convert a position to another representation
[Visual Basic .NET]Copy Code
Dim converter As IAgConversionUtility = root.ConversionUtility

' ConvertPositionArray expects a two dimensional array of positions
Dim cartesianPositions As Array = New Object(,) {{1216.47, -4736.12, 4081.39}, {1000, -2000, 2000}}

' Convert cartesian dates to cylindrical
' ConvertPositionArray returns a two dimensional array of cartesian dates
Dim cylindricalPositions As Array = converter.ConvertPositionArray(AgEPositionType.eCartesian, cartesianPositions, AgEPositionType.eCylindrical)

' Print results
Dim i As Integer = 0
While i < cylindricalPositions.GetLength(0)
    Console.WriteLine("X: {0}, Y: {1}, Z: {2}", cylindricalPositions.GetValue(i, 0), cylindricalPositions.GetValue(i, 1), cylindricalPositions.GetValue(i, 2))
    System.Math.Max(System.Threading.Interlocked.Increment(i),i - 1)
End While

See Also

© 2018 Analytical Graphics, Inc. All Rights Reserved.