STK Graphics PrimitivesSend comments on this topic.
SetSubsetCartographic Method (IAgStkGraphicsPolylinePrimitive)
See Also
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.
Windows





Windows & Linux

Description

For convenience. Defines the positions of a polyline using a subset of input Cartographic positions. 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, _
    ByVal Positions As System.Array, _
    ByVal Index As Integer, _
    ByVal Count As Integer _
)
[C#]
public void SetSubsetCartographic(
    string CentralBody,
    System.Array Positions,
    int Index,
    int Count
);
[Managed C++]
public: void SetSubsetCartographic(
    String __gc ^ CentralBody,
    System::Array ^ Positions,
    int Index,
    int Count
);
[Unmanaged C++]
public: HRESULT SetSubsetCartographic(
    BSTR CentralBody,
    SAFEARRAY * * Positions,
    int Index,
    int Count
);
[Java]
public void setSubsetCartographic(
    String CentralBody,
    AgSafeArray Positions,
    Integer Index,
    Integer Count
);
[Python - STK API ]
def SetSubsetCartographic(self, CentralBody:str, Positions:list, Index:int, Count:int) -> None:

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.

See Also

Example

Shows the format of the Positions parameter when updating a polyline primitive with cartographic positions.
[C#]
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);
Shows the format of the Positions parameter when updating a polyline primitive with cartographic positions.
[Visual Basic .NET]
Dim positions As Array = 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", positions, 1, 2)
© 2024 Analytical Graphics, Inc. All Rights Reserved.