STK Graphics PrimitivesSend comments on this topic.
SetWithColorsAndOptionalParameters Method (IAgStkGraphicsPolylinePrimitive)
See Also
Positions
An array containing new positions (in the order x, y, z) for the polyline.
Colors
An array containing the numeric representation of 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. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.
OptionalParameters
Optional parameters corresponding to positions. Each optional property must have the same number of elements as positions.
Windows





Windows & Linux

Description

Defines the positions, colors, and/or optional point properties of a polyline. The polyline is rendered in its Reference Frame.

Syntax

[Visual Basic .NET]
Public Sub SetWithColorsAndOptionalParameters( _
    ByVal Positions As System.Array, _
    ByVal Colors As System.Array, _
    ByVal OptionalParameters As IAgStkGraphicsPolylinePrimitiveOptionalParameters _
)
[C#]
public void SetWithColorsAndOptionalParameters(
    System.Array Positions,
    System.Array Colors,
    IAgStkGraphicsPolylinePrimitiveOptionalParameters OptionalParameters
);
[Managed C++]
public: void SetWithColorsAndOptionalParameters(
    System::Array ^ Positions,
    System::Array ^ Colors,
    IAgStkGraphicsPolylinePrimitiveOptionalParameters ^ OptionalParameters
);
[Unmanaged C++]
public: HRESULT SetWithColorsAndOptionalParameters(
    SAFEARRAY * * Positions,
    SAFEARRAY * * Colors,
    IAgStkGraphicsPolylinePrimitiveOptionalParameters * OptionalParameters
);
[Java]
public void setWithColorsAndOptionalParameters(
    AgSafeArray Positions,
    AgSafeArray Colors,
    IAgStkGraphicsPolylinePrimitiveOptionalParameters OptionalParameters
);
[Python - STK API ]
def SetWithColorsAndOptionalParameters(self, Positions:list, Colors:list, OptionalParameters:"IAgStkGraphicsPolylinePrimitiveOptionalParameters") -> None:

Parameters

Positions
An array containing new positions (in the order x, y, z) for the polyline.
Colors
An array containing the numeric representation of 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. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.
OptionalParameters
Optional parameters corresponding to positions. Each optional property must have the same number of elements as positions.

Remarks

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 Position Interpolator is not null, positions are interpolated before they are rendered. If the polyline's Polyline Type 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 Invalid Operation Exception.

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.

See Also

© 2024 Analytical Graphics, Inc. All Rights Reserved.