AGI STK Graphics 11 Send comments on this topic.
SetCartographic Method (IAgStkGraphicsMarkerBatchPrimitive)
See Also  Example
CentralBody
The central body the positions are defined on.
Positions
An array containing the new positions for markers in the marker batch, in the order latitude, longitude, altitude.





Description

For convenience. Defines the positions 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.

Syntax

[Visual Basic .NET]
Public Sub SetCartographic( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array _
) 

[C#]
public void SetCartographic(
string CentralBody,
ref System.Array Positions
);

[Managed C++]
public: void SetCartographic(
String __gc ^ CentralBody,
System::Array ^^ Positions
);

[Java]
public  setCartographic(
String CentralBody,
Object[] Positions
);

[Unmanaged C++]
public: HRESULT SetCartographic(
BSTR CentralBody,
SAFEARRAY ** Positions
);

Parameters

CentralBody
The central body the positions are defined on.
Positions
An array containing the new positions for markers in the marker batch, in the order latitude, longitude, altitude.

Remarks

See Set 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.250
    38.85, -77.040
    29.98, -90.250
    37.37, -121.920 
}; 
 
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