AGI STK Graphics 11	Send comments on this topic.
SetSubsetCartographic Method (IAgStkGraphicsPolylinePrimitive)
See Also Example

CentralBody: The central body the positions are defined on.

Positions: An array containing positions in the order latitude, longitude, altitude. The subset of this array defined by index and count define the new positions for the polyline.

Index: A zero-based index into positions that defines the first position copied to the polyline. Note that this index considers a set of latitude, longitude, and altitude as a single element.

Count: The number of elements in positions copied to the polyline. Note that this number considers a set of latitude, longitude, and altitude as a single element.

Description

For convenience. Defines the positions of a polyline using a subset of input Cartographic positions. Longitude and latitude are in radians, and altitude is in meters. This is equivalent to converting the subset of positions to Cartesian and calling SetSubset.

Syntax

[Visual Basic .NET]
Public Sub SetSubsetCartographic( _ ByVal CentralBody As String, _ ByRef Positions As System.Array, _ ByVal Index As Integer, _ ByVal Count As Integer _ )

[Visual Basic .NET]

Public Sub SetSubsetCartographic( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByVal Index As Integer, _
   ByVal Count As Integer _
)

[C#]
public void SetSubsetCartographic( string CentralBody, ref System.Array Positions, int Index, int Count );

[C#]

public void SetSubsetCartographic(

   string CentralBody, 

   ref System.Array Positions, 

   int Index, 

   int Count

);

[Managed C++]
public: void SetSubsetCartographic( String __gc ^ CentralBody, System::Array ^^ Positions, int Index, int Count );

[Managed C++]

public: void SetSubsetCartographic(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   int Index, 

   int Count

);

[Java]
public setSubsetCartographic( String CentralBody, Object[] Positions, ppInteger Index, ppInteger Count );

[Java]

public  setSubsetCartographic(

   String CentralBody, 

   Object[] Positions, 

   ppInteger Index, 

   ppInteger Count

);

[Unmanaged C++]
public: HRESULT SetSubsetCartographic( BSTR CentralBody, SAFEARRAY ** Positions, int Index, int Count );

[Unmanaged C++]

public: HRESULT SetSubsetCartographic(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   int Index, 

   int Count

);

Parameters

CentralBody: The central body the positions are defined on.
Positions: An array containing positions in the order latitude, longitude, altitude. The subset of this array defined by index and count define the new positions for the polyline.
Index: A zero-based index into positions that defines the first position copied to the polyline. Note that this index considers a set of latitude, longitude, and altitude as a single element.
Count: The number of elements in positions copied to the polyline. Note that this number considers a set of latitude, longitude, and altitude as a single element.

Remarks

See SetSubset for a full discussion.

Example

Shows the format of the Positions parameter when updating a polyline primitive with cartographic positions.

[C#] Copy Code

Array positions = new object[] 

{ 

    39.88, -75.25, 0, 

    38.85, -77.04, 0, 

    29.98, -90.25, 0, 

    37.37, -121.92, 0 

}; 

 

polyline.SetSubsetCartographic( 

    "Earth", 

    ref positions, 

    1, 

    2);