Description

For convenience. Defines the positions and text of strings in a text batch using Cartographic positions. This is equivalent to converting each position in positions to Cartesian and calling Set.

Syntax

[Visual Basic .NET]
Public Sub SetCartographic( _ ByVal CentralBody As String, _ ByVal Positions As System.Array, _ ByVal Text As System.Array _ )

[Visual Basic .NET]

Public Sub SetCartographic( _
    ByVal CentralBody As String, _
    ByVal Positions As System.Array, _
    ByVal Text As System.Array _
)

[C#]
public void SetCartographic( string CentralBody, System.Array Positions, System.Array Text );

[Managed C++]
public: void SetCartographic( String __gc ^ CentralBody, System::Array ^ Positions, System::Array ^ Text );

[Managed C++]

public: void SetCartographic(
    String __gc ^ CentralBody,
    System::Array ^ Positions,
    System::Array ^ Text
);

[Unmanaged C++]
public: HRESULT SetCartographic( BSTR CentralBody, SAFEARRAY * * Positions, SAFEARRAY * * Text );

[Unmanaged C++]

public: HRESULT SetCartographic(
    BSTR CentralBody,
    SAFEARRAY * * Positions,
    SAFEARRAY * * Text
);

[Java]
public void setCartographic( String CentralBody, AgSafeArray Positions, AgSafeArray Text );

[Python - STK API ]
def SetCartographic(self, CentralBody:str, Positions:list, Text:list) -> None:

Parameters

CentralBody: The central body the positions are defined on.
Positions: An array containing the new positions for each string in the text batch, provided in the order latitude, longitude, altitude.
Text: The text for strings in the text batch. Each element in this collection corresponds to a set of latitude, longitude, and altitude elements in positions.

Remarks

See Set for a full discussion.

Example

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

[C#]

Array colors = new object[]
{
    Color.Red.ToArgb(),
    Color.Green.ToArgb(),
    Color.Blue.ToArgb(),
    Color.White.ToArgb()
};

IAgStkGraphicsTextBatchPrimitiveOptionalParameters parameters = sceneManager.Initializers.TextBatchPrimitiveOptionalParameters.Initialize();
parameters.SetColors(ref colors);

Array text = new object[]
{
    "Philadelphia",
    "Washington D.C.",
    "New Orleans",
    "San Jose"
};

Array positions = new object[]
{
    39.88, -75.25, 0,    // Philadelphia
    38.85, -77.04, 0, // Washington, D.C.   
    29.98, -90.25, 0, // New Orleans
    37.37, -121.92, 0    // San Jose
};

Array indices = new object[]
{
    0,
    1,
    2,
    3
};

textBatch.SetPartialCartographicWithOptionalParametersIndicesOrderAndRenderPass(
    "Earth", 
    ref positions, 
    ref text,
    parameters, 
    ref indices,
    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending,
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);