STK Graphics PrimitivesSend comments on this topic.
SetPartialCartographic Method (IAgStkGraphicsMarkerBatchPrimitive)
See Also
CentralBody
The central body the positions are defined on.
Positions
An array containing new positions used to update a subset of positions in the marker batch, provided in the order latitude, longitude, altitude.
Indices
An array of integers containing the indices into positions. A set of latitude, longitude, and altitude elements is considered a single index.
Windows






Windows & Linux

Description

For convenience. Updates a subset of positions in a marker batch using Cartographic positions. Longitude and latitude are in radians, and altitude is in meters. This is equivalent to converting each position in positions to Cartesian and calling Set Partial.

Syntax

[Visual Basic .NET]
Public Sub SetPartialCartographic( _
    ByVal CentralBody As String, _
    ByVal Positions As System.Array, _
    ByVal Indices As System.Array _
) As 
[C#]
public void SetPartialCartographic(
    string CentralBody,
    System.Array Positions,
    System.Array Indices
);
[Managed C++]
public: void SetPartialCartographic(
    String __gc ^ CentralBody,
    System::Array ^ Positions,
    System::Array ^ Indices
);
[Java]
public void setPartialCartographic(
    String CentralBody,
    VariantArray Positions,
    VariantArray Indices
);
[Unmanaged C++]
public: HRESULT SetPartialCartographic(
    BSTR CentralBody,
    SAFEARRAY * * Positions,
    SAFEARRAY * * Indices
);

Parameters

CentralBody
The central body the positions are defined on.
Positions
An array containing new positions used to update a subset of positions in the marker batch, provided in the order latitude, longitude, altitude.
Indices
An array of integers containing the indices into positions. A set of latitude, longitude, and altitude elements is considered a single index.

Remarks

See Set Partial 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)
© 2020 Analytical Graphics, Inc. All Rights Reserved.