STK Graphics PrimitivesSend comments on this topic.
SetPartialCartographicWithColors Method (IAgStkGraphicsPointBatchPrimitive)
See Also
CentralBody
The central body the positions are defined on.
Positions
An array of new positions used to update a subset of positions in the point batch, provided in the order latitude, longitude, altitude.
Colors
An array containing the numeric representation of the color used to update a subset of colors in the point batch. There must be one color for each position in positions. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.
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 and/or colors in a point batch using Cartographic positions. This is equivalent to converting each position in positions to Cartesian and calling Set Partial.

Syntax

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

Parameters

CentralBody
The central body the positions are defined on.
Positions
An array of new positions used to update a subset of positions in the point batch, provided in the order latitude, longitude, altitude.
Colors
An array containing the numeric representation of the color used to update a subset of colors in the point batch. There must be one color for each position in positions. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.
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 Positions, Colors and Indices parameters when updating a point batch 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
};

Array colors = new object[]
{
    Color.Red.ToArgb(),
    Color.Green.ToArgb(),
    Color.Blue.ToArgb(),
    Color.White.ToArgb()
};

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

pointBatch.SetPartialCartographicWithColorsIndicesOrderAndRenderPass(
    "Earth", 
    ref positions, 
    ref colors, 
    ref indices,
    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending,
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);
Shows the format of the Positions, Colors and Indices parameters when updating a point batch 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}

Dim colors As Array = New Object() {Color.Red.ToArgb(), Color.Green.ToArgb(), Color.Blue.ToArgb(), Color.White.ToArgb()}

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

pointBatch.SetPartialCartographicWithColorsIndicesOrderAndRenderPass("Earth", positions, colors, indices, AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque)
© 2024 Analytical Graphics, Inc. All Rights Reserved.