Description

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

Syntax

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

[Visual Basic .NET]

Public Sub SetCartographicWithOptionalParameters( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByVal OptionalParameters As IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters _
)

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

[C#]

public void SetCartographicWithOptionalParameters(

   string CentralBody, 

   ref System.Array Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters

);

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

[Managed C++]

public: void SetCartographicWithOptionalParameters(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters ^ OptionalParameters

);

[Java]
public setCartographicWithOptionalParameters( String CentralBody, Object[] Positions, IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters );

[Java]

public  setCartographicWithOptionalParameters(

   String CentralBody, 

   Object[] Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters

);

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

[Unmanaged C++]

public: HRESULT SetCartographicWithOptionalParameters(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters * OptionalParameters

);

Parameters

CentralBody: The central body the positions are defined on.
Positions: An array containing the new positions for markers 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.

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