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. renderPassHint is provided for efficiency. This is equivalent to converting each position in positions to Cartesian and calling Set.

Syntax

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

[Visual Basic .NET]

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

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

[C#]

public void SetCartographicWithOptionalParametersAndRenderPassHint(
   string CentralBody, 
   ref System.Array Positions, 
   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters, 
   AgEStkGraphicsRenderPassHint RenderPassHint
);

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

[Managed C++]

public: void SetCartographicWithOptionalParametersAndRenderPassHint(
   String __gc ^ CentralBody, 
   System::Array ^^ Positions, 
   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters ^ OptionalParameters, 
   AgEStkGraphicsRenderPassHint RenderPassHint
);

[Java]
public setCartographicWithOptionalParametersAndRenderPassHint( String CentralBody, Object[] Positions, IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters, AgEStkGraphicsRenderPassHint RenderPassHint );

[Java]

public  setCartographicWithOptionalParametersAndRenderPassHint(
   String CentralBody, 
   Object[] Positions, 
   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters, 
   AgEStkGraphicsRenderPassHint RenderPassHint
);

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

[Unmanaged C++]

public: HRESULT SetCartographicWithOptionalParametersAndRenderPassHint(
   BSTR CentralBody, 
   SAFEARRAY ** Positions, 
   IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters * OptionalParameters, 
   AgEStkGraphicsRenderPassHint RenderPassHint
);

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.

RenderPassHint

Member	Value	Description
eStkGraphicsRenderPassHintOpaque	0	The collection of Color contains only opaque colors. This implies that each color's alpha component is 255.
eStkGraphicsRenderPassHintTranslucent	1	The collection of Color contains translucent colors. This implies that at least one color has an alpha component that is not 255.
eStkGraphicsRenderPassHintUnknown	2	It is unknown if the collection of Color contains opaque or translucent colors.

An optimization hint indicating the Render Pass implied by per-marker colors defined in optionalParameters.

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