Description

For convenience. Defines the positions and colors of points in a point 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 SetCartographicWithColorsAndRenderPass( _ ByVal CentralBody As String, _ ByRef Positions As System.Array, _ ByRef Colors As System.Array, _ ByVal RenderPassHint As AgEStkGraphicsRenderPassHint _ )

[Visual Basic .NET]

Public Sub SetCartographicWithColorsAndRenderPass( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByRef Colors As System.Array, _
   ByVal RenderPassHint As AgEStkGraphicsRenderPassHint _
)

[C#]
public void SetCartographicWithColorsAndRenderPass( string CentralBody, ref System.Array Positions, ref System.Array Colors, AgEStkGraphicsRenderPassHint RenderPassHint );

[C#]

public void SetCartographicWithColorsAndRenderPass(

   string CentralBody, 

   ref System.Array Positions, 

   ref System.Array Colors, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

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

[Managed C++]

public: void SetCartographicWithColorsAndRenderPass(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   System::Array ^^ Colors, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

[Java]
public setCartographicWithColorsAndRenderPass( String CentralBody, Object[] Positions, Object[] Colors, AgEStkGraphicsRenderPassHint RenderPassHint );

[Java]

public  setCartographicWithColorsAndRenderPass(

   String CentralBody, 

   Object[] Positions, 

   Object[] Colors, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

[Unmanaged C++]
public: HRESULT SetCartographicWithColorsAndRenderPass( BSTR CentralBody, SAFEARRAY ** Positions, SAFEARRAY ** Colors, AgEStkGraphicsRenderPassHint RenderPassHint );

[Unmanaged C++]

public: HRESULT SetCartographicWithColorsAndRenderPass(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   SAFEARRAY ** Colors, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

Parameters

CentralBody

The central body the positions are defined on.

Positions

An array containing the new positions for the point batch, provided in the order latitude, longitude, altitude.

Colors

An array containing the numeric representation of colors for the point batch. There must be one color for each position in positions. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.

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.

Remarks

See Set for a full discussion.

Example

Shows the format of the Positions, Colors and Indices parameters when updating a point batch with cartographic positions.

[C#] Copy Code

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 colors = new object[] 

{ 

    Color.Red.ToArgb(), 

    Color.Green.ToArgb(), 

    Color.Blue.ToArgb(), 

    Color.White.ToArgb() 

}; 

 

Array indices = new object[] 

{ 

    0, 

    1, 

    2, 

    3 

}; 

 

pointBatch.SetPartialCartographicWithColorsIndicesOrderAndRenderPass( 

    "Earth", 

    ref positions, 

    ref colors, 

    ref indices, 

    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, 

    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);