AGI STK Graphics 11	Send comments on this topic.
SetPartialCartographicWithColors Method (IAgStkGraphicsPointBatchPrimitive)
See Also Example

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.

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 SetPartialCartographicWithColors( _ ByVal CentralBody As String, _ ByRef Positions As System.Array, _ ByRef Colors As System.Array, _ ByRef Indices As System.Array _ )

[Visual Basic .NET]

Public Sub SetPartialCartographicWithColors( _
   ByVal CentralBody As String, _
   ByRef Positions As System.Array, _
   ByRef Colors As System.Array, _
   ByRef Indices As System.Array _
)

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

[C#]

public void SetPartialCartographicWithColors(

   string CentralBody, 

   ref System.Array Positions, 

   ref System.Array Colors, 

   ref System.Array Indices

);

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

[Managed C++]

public: void SetPartialCartographicWithColors(

   String __gc ^ CentralBody, 

   System::Array ^^ Positions, 

   System::Array ^^ Colors, 

   System::Array ^^ Indices

);

[Java]
public setPartialCartographicWithColors( String CentralBody, Object[] Positions, Object[] Colors, Object[] Indices );

[Java]

public  setPartialCartographicWithColors(

   String CentralBody, 

   Object[] Positions, 

   Object[] Colors, 

   Object[] Indices

);

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

[Unmanaged C++]

public: HRESULT SetPartialCartographicWithColors(

   BSTR CentralBody, 

   SAFEARRAY ** Positions, 

   SAFEARRAY ** Colors, 

   SAFEARRAY ** Indices

);

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.

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