Description

Updates a subset of marker positions in a marker batch.

Syntax

[Visual Basic .NET]
Public Sub SetPartialWithIndicesOrder( _ ByRef Positions As System.Array, _ ByRef Indices As System.Array, _ ByVal IndicesOrderHint As AgEStkGraphicsIndicesOrderHint _ )

[Visual Basic .NET]

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

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

[C#]

public void SetPartialWithIndicesOrder(

   ref System.Array Positions, 

   ref System.Array Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

[Managed C++]
public: void SetPartialWithIndicesOrder( System::Array ^^ Positions, System::Array ^^ Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint );

[Managed C++]

public: void SetPartialWithIndicesOrder(

   System::Array ^^ Positions, 

   System::Array ^^ Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

[Java]
public setPartialWithIndicesOrder( Object[] Positions, Object[] Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint );

[Java]

public  setPartialWithIndicesOrder(

   Object[] Positions, 

   Object[] Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

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

[Unmanaged C++]

public: HRESULT SetPartialWithIndicesOrder(

   SAFEARRAY ** Positions, 

   SAFEARRAY ** Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint

);

Parameters

Positions

An array containing positions (in the order x, y, z) used to update a subset of positions in the marker batch.

Indices

An array of integers containing the indices into positions. A set of x, y, and z 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

Example

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

[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[] 

{ 

    1247.87, -4739.74, 4067.77, 

    1115.48, -4847.09, 3979.36, 

    -24.12, -5529.31, 3168.45, 

    -2683.42, -4307.74, 3850.11 

}; 

 

Array indices = new object[] 

{ 

    0, 

    1, 

    2, 

    3 

}; 

 

markerBatch.SetPartialWithOptionalParametersIndicesOrderAndRenderPass( 

    ref positions, 

    parameters, 

    ref indices, 

    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, 

    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);