STK Graphics PrimitivesSend comments on this topic.
SetPartialCartographicWithOptionalParametersIndicesOrderAndRenderPass 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.
OptionalParameters
Optional per-marker parameters corresponding to positions. Each per-marker parameter must have the same number of elements as positions.
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
An optimization hint indicating the Render Pass implied by per-marker colors defined in optionalParameters.
Windows





Windows & Linux

Description

For convenience. Updates a subset of positions and/or optional per-marker parameters of markers in a marker batch using Cartographic positions. renderPassHint is provided for efficiency. This is equivalent to converting each position in positions to Cartesian and calling Set Partial.

Syntax

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

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.
OptionalParameters
Optional per-marker parameters corresponding to positions. Each per-marker parameter must have the same number of elements as positions.
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
An optimization hint indicating the Render Pass implied by per-marker colors defined in optionalParameters.

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