PolylinePrimitiveSetCartographic Method (CentralBody, IEnumerableCartographic, IEnumerableColor, PolylinePrimitiveOptionalParameters)

For convenience. Defines the positions, colors, and/or optional point properties of a polyline 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.

Namespace: AGI.Foundation.Graphics
Assembly: AGI.Foundation.Graphics (in AGI.Foundation.Graphics.dll) Version: 24.2.419.0 (24.2.419.0)

Syntax

C++

Copy

public void SetCartographic(
	CentralBody centralBody,
	IEnumerable<Cartographic> positions,
	IEnumerable<Color> colors,
	PolylinePrimitiveOptionalParameters optionalParameters
)

Public Sub SetCartographic ( 
	centralBody As CentralBody,
	positions As IEnumerable(Of Cartographic),
	colors As IEnumerable(Of Color),
	optionalParameters As PolylinePrimitiveOptionalParameters
)

public:
void SetCartographic(
	CentralBody^ centralBody, 
	IEnumerable<Cartographic>^ positions, 
	IEnumerable<Color>^ colors, 
	PolylinePrimitiveOptionalParameters^ optionalParameters
)

member SetCartographic : 
        centralBody : CentralBody * 
        positions : IEnumerable<Cartographic> * 
        colors : IEnumerable<Color> * 
        optionalParameters : PolylinePrimitiveOptionalParameters -> unit

Parameters

centralBody: Type: AGI.Foundation.CelestialCentralBody
The central body the positions are defined on.
positions: Type: System.Collections.GenericIEnumerableCartographic
The new positions for the polyline.
colors: Type: System.Collections.GenericIEnumerableColor
The new colors for the polyline. There must be one color for each position in positions. The first color is ignored, each additional color defines the color of the line segment ending at that position.
optionalParameters: Type: AGI.Foundation.GraphicsPolylinePrimitiveOptionalParameters
Optional parameters corresponding to positions. Each optional property must have the same number of elements as positions.

Exceptions

Exception	Condition
ArgumentNullException	centralBody is .
InvalidOperationException	The primitive's ReferenceFrame is not equal to centralBody fixed frame.

Remarks

centralBody is used to convert positions to Cartesian. The primitive's ReferenceFrame must be equal to the centralBody fixed frame. If the primitive's ReferenceFrame is changed after calling this method, the Cartesian positions stored by the primitive are not modified and are unlikely to represent the original Cartographic positions provided to this method.

See Set for a full discussion.

Reference

PolylinePrimitive Class

SetCartographic Overload

AGI.Foundation.Graphics Namespace

Set