AGI GPS 6 Send comments on this topic.
GPS_Pos_Array Method (IAgAsGPSSatSelectPluginResultEval)
See Also 
Index
An integer identifier
Frame
Requested frame to express the results
Windows








Description

Satellite position for specified GPS in the requested frame (in internal units), returned as an array representing x, y, z. Only eUtFrameInertial and eUtFrameFixed frames are supported. Useful for scripting clients.

Syntax

[Visual Basic .NET]
Public Function GPS_Pos_Array( _
   ByVal Index As Integer, _
   ByVal Frame As AgEUtFrame _
) As System.Array

[C#]
public System.Array GPS_Pos_Array(
int Index,
AgEUtFrame Frame
);

[Managed C++]
public: System::Array GPS_Pos_Array(
int Index,
AgEUtFrame Frame
);

[Unmanaged C++]
public: HRESULT GPS_Pos_Array(
long Index,
AgEUtFrame Frame,
SAFEARRAY ** Array
);

[VBScript]
'Function object.GPS_Pos_Array(...)  returns an array
' Index is type ppLong
' Frame is type AgEUtFrame (an integer)
result = object.GPS_Pos_Array(Index, Frame)

[Perl]
$return_value = $objectReference->GPS_Pos_Array(# $return_value is an array reference
$Index, # type int (scalar)
$Frame# type AgEUtFrame (scalar integer)
);

Parameters

Index
An integer identifier
Frame
Member Value Description
eUtFrameInertial 0  
eUtFrameFixed 1  
eUtFrameLVLH 2  
eUtFrameNTC 3  
eUtFrameICRF 4  
eUtFrameJ2000 5  
Requested frame to express the results

Return Type

An array containing the position, in the requested frame, of the identified GPS satellite

Remarks

An array containing the visible GPS satellites is determined before every plugin Evaluate() call. The number of GPS satellites that are visible at the current time can be found using the NumSatsVisible property. The index number identifies a particular GPS satellite from that array (index 0 is the first satellite, index NumSatsVisible-1 is the last satellite). Use the GPS_PRN() method to identify the PRN from the index number if it is needed. The size of the array and even the order of the GPS satellites in the array may change between different Evaluate() calls; therefore, you can only associate an particular index number with a particular GPS satellite during the same Evaluate() call---you cannot, for example, determine during one call that index 0 is PRN 24 and believe that index 0 will continue to be asscoiated with PRN 24 on a later Evaluate() call.

See Also

© 2017 Analytical Graphics, Inc. All Rights Reserved.

ODTK 6.5