Description

For convenience. Updates a subset of positions and/or colors in a point 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 SetPartialCartographicWithColorsIndicesOrderAndRenderPass( _ ByVal CentralBody As String, _ ByRef Positions As System.Array, _ ByRef Colors As System.Array, _ ByRef Indices As System.Array, _ ByVal IndicesOrderHint As AgEStkGraphicsIndicesOrderHint, _ ByVal RenderPassHint As AgEStkGraphicsRenderPassHint _ )

[Visual Basic .NET]

Public Sub SetPartialCartographicWithColorsIndicesOrderAndRenderPass( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByRef Colors As System.Array, _
   ByRef Indices As System.Array, _
   ByVal IndicesOrderHint As AgEStkGraphicsIndicesOrderHint, _
   ByVal RenderPassHint As AgEStkGraphicsRenderPassHint _
)

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

[C#]

public void SetPartialCartographicWithColorsIndicesOrderAndRenderPass(

   string CentralBody, 

   ref System.Array Positions, 

   ref System.Array Colors, 

   ref System.Array Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

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

[Managed C++]

public: void SetPartialCartographicWithColorsIndicesOrderAndRenderPass(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   System::Array ^^ Colors, 

   System::Array ^^ Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

[Java]
public setPartialCartographicWithColorsIndicesOrderAndRenderPass( String CentralBody, Object[] Positions, Object[] Colors, Object[] Indices, AgEStkGraphicsIndicesOrderHint IndicesOrderHint, AgEStkGraphicsRenderPassHint RenderPassHint );

[Java]

public  setPartialCartographicWithColorsIndicesOrderAndRenderPass(

   String CentralBody, 

   Object[] Positions, 

   Object[] Colors, 

   Object[] Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

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

[Unmanaged C++]

public: HRESULT SetPartialCartographicWithColorsIndicesOrderAndRenderPass(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   SAFEARRAY ** Colors, 

   SAFEARRAY ** Indices, 

   AgEStkGraphicsIndicesOrderHint IndicesOrderHint, 

   AgEStkGraphicsRenderPassHint RenderPassHint

);

Parameters

CentralBody

The central body the positions are defined on.

Positions

An array of new positions used to update a subset of positions in the point batch, provided in the order latitude, longitude, altitude.

Colors

An array containing the numeric representation of the color used to update a subset of colors in 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.

Indices

An array of integers containing the indices into positions. A set of latitude, longitude, and altitude elements is considered a single index.

IndicesOrderHint

Member	Value	Description
eStkGraphicsIndicesOrderHintNotSorted	0	The `indices` passed to `SetPartial` are not sorted. Therefore, the primitive may sort them to improve performance of writing its geometry to video memory.
eStkGraphicsIndicesOrderHintSortedAscending	1	The `indices` passed to `SetPartial` are sorted in ascending order. Therefore, the primitive does not need to sort them. It is recommended to only use `SortedAscending` if it is easy and efficient for you to provide the `indices` in ascending order. For example, do not use a standard sorting algorithm to sort your indices so you can use `SortedAscending`. Instead use `NotSorted` and let the primitive decide what is most efficient.

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