PolylinePrimitiveSet Method (IEnumerableCartesian, IEnumerableColor, PolylinePrimitiveOptionalParameters)

public void Set(
	IEnumerable<Cartesian> positions,
	IEnumerable<Color> colors,
	PolylinePrimitiveOptionalParameters optionalParameters
)

Public Sub Set ( 
	positions As IEnumerable(Of Cartesian),
	colors As IEnumerable(Of Color),
	optionalParameters As PolylinePrimitiveOptionalParameters
)

public:
void Set(
	IEnumerable<Cartesian>^ positions, 
	IEnumerable<Color>^ colors, 
	PolylinePrimitiveOptionalParameters^ optionalParameters
)

member Set : 
        positions : IEnumerable<Cartesian> * 
        colors : IEnumerable<Color> * 
        optionalParameters : PolylinePrimitiveOptionalParameters -> unit 

Parameters

positions

Type: System.Collections.GenericIEnumerableCartesian
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.

This call overwrites the primitive's previous positions and per-position colors. To update a subset of positions and colors, use SetPartial.

If the polyline's PositionInterpolator is not null, positions are interpolated before they are rendered. If the polyline's PolylineType is LineStrip, for each position after the first position, a line segment is rendered that connects the position to the previous position. Otherwise, if Lines is used, a line segment is rendered for every two positions.

Each color in colors corresponds to a position in positions with the same location. For example, the first color in colors is applied to the first position in positions. These colors override the primitive's Color and Translucency properties. Accessing these properties will result in an InvalidOperationException.

To create translucent line segments, use the Color's alpha component. An alpha of 0 is completely transparent and an alpha of 255 is completely opaque.

If this method is called frequently, it is recommended to construct the primitive with Frequent, which is the default. If this method will be called only once or infrequently, construct the primitive with Infrequent. See the Set Hint topic for more information.

If the primitive's AutomaticallyComputeBoundingSphere property is , the primitive's BoundingSphere is computed based on positions. Otherwise, it is the caller's responsibility to update the primitive's BoundingSphere to a sphere that encompasses all the positions.

Reference