AGI STK Graphics 11 Send comments on this topic.
SetPartialWithIndicesOrder Method (IAgStkGraphicsMarkerBatchPrimitive)
See Also  Example
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





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

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

[Java]
public  setPartialWithIndicesOrder(
Object[] Positions,
Object[] 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.744067.77
    1115.48, -4847.093979.36
    -24.12, -5529.313168.45
    -2683.42, -4307.743850.11 
}; 
 
Array indices = new object[] 

    0
    1
    2
    3 
}; 
 
markerBatch.SetPartialWithOptionalParametersIndicesOrderAndRenderPass( 
    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.
[Visual Basic .NET] Copy Code
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() {1247.87, -4739.74, 4067.77, 1115.48, -4847.09, 3979.36, _
    -24.12, -5529.31, 3168.45, -2683.42, -4307.74, 3850.11}

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

markerBatch.SetPartialWithOptionalParametersIndicesOrderAndRenderPass(positions, parameters, indices, AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque)

See Also

© 2016 All Rights Reserved.

STK Programming Interface 11.0.1