STK Graphics PrimitivesSend comments on this topic.
SetCartographic Method (IAgStkGraphicsMarkerBatchPrimitive)
See Also
CentralBody
The central body the positions are defined on.
Positions
An array containing the new positions for markers in the marker batch, in the order latitude, longitude, altitude.
Windows





Windows & Linux

Description

For convenience. Defines the positions of markers in a marker batch using Cartographic positions. This is equivalent to converting each position in positions to Cartesian and calling Set.

Syntax

[Visual Basic .NET]
Public Sub SetCartographic( _
    ByVal CentralBody As String, _
    ByVal Positions As System.Array _
)
[C#]
public void SetCartographic(
    string CentralBody,
    System.Array Positions
);
[Managed C++]
public: void SetCartographic(
    String __gc ^ CentralBody,
    System::Array ^ Positions
);
[Unmanaged C++]
public: HRESULT SetCartographic(
    BSTR CentralBody,
    SAFEARRAY * * Positions
);
[Java]
public void setCartographic(
    String CentralBody,
    AgSafeArray Positions
);
[Python - STK API ]
def SetCartographic(self, CentralBody:str, Positions:list) -> None:

Parameters

CentralBody
The central body the positions are defined on.
Positions
An array containing the new positions for markers in the marker batch, in the order latitude, longitude, altitude.

Remarks

See Set for a full discussion.

See Also

Example

Shows the format of the Colors, Positions and Indices parameters when updating a marker batch primitive with cartographic positions.
[C#]
Array colors = new object[]
{
    Color.Red.ToArgb(),
    Color.Green.ToArgb(),
    Color.Blue.ToArgb(),
    Color.White.ToArgb()
};

IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters parameters = sceneManager.Initializers.MarkerBatchPrimitiveOptionalParameters.Initialize();
parameters.SetColors(ref colors);

Array positions = new object[]
{
    39.88, -75.25, 0,
    38.85, -77.04, 0,   
    29.98, -90.25, 0,
    37.37, -121.92, 0
};

Array indices = new object[]
{
    0,
    1,
    2,
    3
};

markerBatch.SetPartialCartographicWithOptionalParametersIndicesOrderAndRenderPass(
    "Earth", 
    ref positions,
    parameters, 
    ref indices,
    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending,
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);
Shows the format of the Colors, Positions and Indices parameters when updating a marker batch primitive with cartographic positions.
[Visual Basic .NET]
Dim colors As Array = New Object() {Color.Red.ToArgb(), Color.Green.ToArgb(), Color.Blue.ToArgb(), Color.White.ToArgb()}

Dim parameters As IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters = sceneManager.Initializers.MarkerBatchPrimitiveOptionalParameters.Initialize()
parameters.SetColors(colors)

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}

Dim indices As Array = New Object() {0, 1, 2, 3}

markerBatch.SetPartialCartographicWithOptionalParametersIndicesOrderAndRenderPass("Earth", positions, parameters, indices, AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque)
© 2024 Analytical Graphics, Inc. All Rights Reserved.