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 SetPartialCartographicWithIndicesOrder( _ ByVal CentralBody As String, _ ByRef Positions As System.Array, _ ByRef Indices As System.Array, _ ByVal IndicesOrderHint As AgEStkGraphicsIndicesOrderHint _ )

[Visual Basic .NET]

Public Sub SetPartialCartographicWithIndicesOrder( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByRef Indices As System.Array, _
   ByVal IndicesOrderHint As AgEStkGraphicsIndicesOrderHint _
)

[C#]
public void SetPartialCartographicWithIndicesOrder( string CentralBody, ref System.Array Positions, ref System.Array Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint );

[C#]

public void SetPartialCartographicWithIndicesOrder(

   string CentralBody, 

   ref System.Array Positions, 

   ref System.Array Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

[Managed C++]
public: void SetPartialCartographicWithIndicesOrder( String __gc ^ CentralBody, System::Array ^^ Positions, System::Array ^^ Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint );

[Managed C++]

public: void SetPartialCartographicWithIndicesOrder(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   System::Array ^^ Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

[Java]
public setPartialCartographicWithIndicesOrder( String CentralBody, Object[] Positions, Object[] Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint );

[Java]

public  setPartialCartographicWithIndicesOrder(

   String CentralBody, 

   Object[] Positions, 

   Object[] Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

[Unmanaged C++]
public: HRESULT SetPartialCartographicWithIndicesOrder( BSTR CentralBody, SAFEARRAY ** Positions, SAFEARRAY ** Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint );

[Unmanaged C++]

public: HRESULT SetPartialCartographicWithIndicesOrder(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   SAFEARRAY ** Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

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.

IndicesOrderHint

Member	Value	Description
eStkGraphicsIndicesOrderHintNotSorted	0	The `indices` passed to `SetPartial` are not sorted. Therefore, the primitive may sort them to improve performance of writing its geometry to video memory.
eStkGraphicsIndicesOrderHintSortedAscending	1	The `indices` passed to `SetPartial` are sorted in ascending order. Therefore, the primitive does not need to sort them. It is recommended to only use `SortedAscending` if it is easy and efficient for you to provide the `indices` in ascending order. For example, do not use a standard sorting algorithm to sort your indices so you can use `SortedAscending`. Instead use `NotSorted` and let the primitive decide what is most efficient.

Remarks

See Set Partial for a full discussion.

Example

Shows the format of the Colors, Positions and Indices parameters when updating a marker batch primitive with cartographic positions.

[C#] Copy Code

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);