AGI STK Graphics 11 Send comments on this topic.
SetPartialCartographicWithIndicesOrder Method (IAgStkGraphicsTextBatchPrimitive)
See Also  Example
CentralBody
The central body the positions are defined on.
Positions
An array containing new positions used to update a subset of positions in the text batch, provided in the order latitude, longitude, altitude.
Text
A collection of new text used to update a subset of text in the text batch.
Indices
An array of integers containing the indices into positions. A set of latitude, longitude, and altitude elements is considered a single index.
IndicesOrderHint





Description

For convenience. Updates a subset of positions and/or text in a text 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 Text 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 Text,
ref System.Array Indices,
AgEStkGraphicsIndicesOrderHint IndicesOrderHint
);

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

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

[Unmanaged C++]
public: HRESULT SetPartialCartographicWithIndicesOrder(
BSTR CentralBody,
SAFEARRAY ** Positions,
SAFEARRAY ** Text,
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 text batch, provided in the order latitude, longitude, altitude.
Text
A collection of new text used to update a subset of text in the text batch.
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 Text, Positions, Colors and Indices parameters when updating a text batch primitive with cartographic positions.
[C#] Copy Code
Array colors = new object[] 

    Color.Red.ToArgb(), 
    Color.Green.ToArgb(), 
    Color.Blue.ToArgb(), 
    Color.White.ToArgb() 
}; 
 
IAgStkGraphicsTextBatchPrimitiveOptionalParameters parameters = sceneManager.Initializers.TextBatchPrimitiveOptionalParameters.Initialize(); 
parameters.SetColors(ref colors); 
 
Array text = new object[] 

    "Philadelphia"
    "Washington D.C."
    "New Orleans"
    "San Jose" 
}; 
 
Array positions = new object[] 

    39.88, -75.250,    // Philadelphia 
    38.85, -77.040// Washington, D.C. 
    29.98, -90.250// New Orleans 
    37.37, -121.920    // San Jose 
}; 
 
Array indices = new object[] 

    0
    1
    2
    3 
}; 
 
textBatch.SetPartialCartographicWithOptionalParametersIndicesOrderAndRenderPass( 
    "Earth"
    ref positions, 
    ref text, 
    parameters, 
    ref indices, 
    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, 
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque); 
 

Shows the format of the Text, Positions, Colors and Indices parameters when updating a text batch primitive with cartographic positions.
[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 IAgStkGraphicsTextBatchPrimitiveOptionalParameters = sceneManager.Initializers.TextBatchPrimitiveOptionalParameters.Initialize()
parameters.SetColors(colors)

Dim text As Array = New Object() {"Philadelphia", "Washington D.C.", "New Orleans", "San Jose"}

' Philadelphia
' Washington, D.C.
' New Orleans
    ' San Jose
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}

textBatch.SetPartialCartographicWithOptionalParametersIndicesOrderAndRenderPass("Earth", positions, text, parameters, indices, AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, _
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque)

See Also

© 2016 All Rights Reserved.

STK Programming Interface 11.0.1