Click or drag to resize

TextBatchPrimitiveSetCartographic Method (CentralBody, IEnumerableCartographic, IEnumerableString, TextBatchPrimitiveOptionalParameters, RenderPassHint)

For convenience. Defines the positions, text, and optional parameters of strings in a text 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(IEnumerableCartesian, IEnumerableString).

Namespace:  AGI.Foundation.Graphics
Assembly:  AGI.Foundation.Graphics (in AGI.Foundation.Graphics.dll) Version: 21.2.409.0 (21.2.409.0)
Syntax
public void SetCartographic(
	CentralBody centralBody,
	IEnumerable<Cartographic> positions,
	IEnumerable<string> text,
	TextBatchPrimitiveOptionalParameters optionalParameters,
	RenderPassHint renderPassHint
)

Parameters

centralBody
Type: AGI.Foundation.CelestialCentralBody
The central body the positions are defined on.
positions
Type: System.Collections.GenericIEnumerableCartographic
The new positions for strings in the text batch.
text
Type: System.Collections.GenericIEnumerableString
The text for strings in the text batch. Each element in this collection corresponds to an element in positions.
optionalParameters
Type: AGI.Foundation.GraphicsTextBatchPrimitiveOptionalParameters
Optional per-batch parameters or per-string parameters corresponding to positions. Each per-string parameter must have the same number of elements as positions.
renderPassHint
Type: AGI.Foundation.Graphics.AdvancedRenderPassHint
An optimization hint indicating the RenderPass implied by per-strings colors defined in optionalParameters.
Exceptions
ExceptionCondition
ArgumentNullExceptioncentralBody 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(IEnumerableCartesian, IEnumerableString, TextBatchPrimitiveOptionalParameters, RenderPassHint) for a full discussion.

See Also