AGI STK Graphics 11Send comments on this topic.
SetPartialCartographicWithColorsIndicesOrderAndRenderPass 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.
IndicesOrderHint
RenderPassHint
Windows






Windows & Linux

Description

For convenience. Updates a subset of positions and/or colors in a point 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 SetPartialCartographicWithColorsIndicesOrderAndRenderPass( _
    ByVal CentralBody As String, _
    ByVal Positions As System.Array, _
    ByVal Colors As System.Array, _
    ByVal Indices As System.Array, _
    ByVal IndicesOrderHint As AgEStkGraphicsIndicesOrderHint, _
    ByVal RenderPassHint As AgEStkGraphicsRenderPassHint _
) As 
[C#]
public void SetPartialCartographicWithColorsIndicesOrderAndRenderPass(
    string CentralBody,
    System.Array Positions,
    System.Array Colors,
    System.Array Indices,
    AgEStkGraphicsIndicesOrderHint IndicesOrderHint,
    AgEStkGraphicsRenderPassHint RenderPassHint
);
[Managed C++]
public: void SetPartialCartographicWithColorsIndicesOrderAndRenderPass(
    String __gc ^ CentralBody,
    System::Array ^ Positions,
    System::Array ^ Colors,
    System::Array ^ Indices,
    AgEStkGraphicsIndicesOrderHint IndicesOrderHint,
    AgEStkGraphicsRenderPassHint RenderPassHint
);
[Java]
public void setPartialCartographicWithColorsIndicesOrderAndRenderPass(
    String CentralBody,
    VariantArray Positions,
    VariantArray Colors,
    VariantArray Indices,
    AgEStkGraphicsIndicesOrderHint IndicesOrderHint,
    AgEStkGraphicsRenderPassHint RenderPassHint
);
[Unmanaged C++]
public: HRESULT SetPartialCartographicWithColorsIndicesOrderAndRenderPass(
    BSTR CentralBody,
    SAFEARRAY * * Positions,
    SAFEARRAY * * Colors,
    SAFEARRAY * * Indices,
    AgEStkGraphicsIndicesOrderHint IndicesOrderHint,
    AgEStkGraphicsRenderPassHint RenderPassHint
);

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.
IndicesOrderHint
RenderPassHint

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)
© 2019 Analytical Graphics, Inc. All Rights Reserved.