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





Description

For convenience. Updates a subset of positions and/or optional per-marker parameters of markers 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 SetPartialCartographicWithOptionalParameters( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByVal OptionalParameters As IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters, _
   ByRef Indices As System.Array _
)
[C#] 
public void SetPartialCartographicWithOptionalParameters(

   string CentralBody, 

   ref System.Array Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters, 

   ref System.Array Indices

);
[Managed C++] 
public: void SetPartialCartographicWithOptionalParameters(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters ^ OptionalParameters, 

   System::Array ^^ Indices

);
[Java] 
public  setPartialCartographicWithOptionalParameters(

   String CentralBody, 

   Object[] Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters, 

   Object[] Indices

);
[Unmanaged C++] 
public: HRESULT SetPartialCartographicWithOptionalParameters(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters * OptionalParameters, 

   SAFEARRAY ** Indices

);

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.

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); 
 
Shows the format of the Colors, Positions and Indices parameters when updating a marker 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 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)

See Also

© 2016 All Rights Reserved.

STK Programming Interface 11.0.1