AGI STK Graphics 11Send comments on this topic.
SetWithColorsAndRenderPass Method (IAgStkGraphicsPointBatchPrimitive)
See Also
Positions
An array containing new positions (in the order x, y, z) for the point batch.
Colors
An array containing the numeric representation of colors for the point batch. There must be one color for each position in positions. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.
RenderPassHint
Windows






Windows & Linux

Description

Defines the positions and colors of points in a point batch. The points are rendered in the primitive's Reference Frame. renderPassHint is provided for efficiency.

Syntax

[Visual Basic .NET]
Public Sub SetWithColorsAndRenderPass( _
    ByVal Positions As System.Array, _
    ByVal Colors As System.Array, _
    ByVal RenderPassHint As AgEStkGraphicsRenderPassHint _
) As
[C#]
public void SetWithColorsAndRenderPass(
    System.Array Positions,
    System.Array Colors,
    AgEStkGraphicsRenderPassHint RenderPassHint
);
[Managed C++]
public: void SetWithColorsAndRenderPass(
    System::Array ^ Positions,
    System::Array ^ Colors,
    AgEStkGraphicsRenderPassHint RenderPassHint
);
[Java]
public void setWithColorsAndRenderPass(
    VariantArray Positions,
    VariantArray Colors,
    AgEStkGraphicsRenderPassHint RenderPassHint
);
[Unmanaged C++]
public: HRESULT SetWithColorsAndRenderPass(
    SAFEARRAY * * Positions,
    SAFEARRAY * * Colors,
    AgEStkGraphicsRenderPassHint RenderPassHint
);

Parameters

Positions
An array containing new positions (in the order x, y, z) for the point batch.
Colors
An array containing the numeric representation of colors for the point batch. There must be one color for each position in positions. In .NET a Color should be translated to a number by calling its ToArgb method and casting the result as an unsigned integer.
RenderPassHint

Remarks

Calling this method with a renderPassHint of Unknown is equivalent to calling Set with just positions and colors. When a more specific renderPassHint is used, this method can be more efficient.

See Set for a full discussion.

See Also

Example

Shows the format of the Positions, Colors and Indices parameters when updating a point batch.
[C#]
Array positions = new object[]
{
    1247.87, -4739.74, 4067.77,
    1115.48, -4847.09, 3979.36,   
    -24.12, -5529.31, 3168.45,
    -2683.42, -4307.74, 3850.11
};

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

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

pointBatch.SetPartialWithColorsIndicesOrderAndRenderPass(
    ref positions, 
    ref colors, 
    ref indices,
    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending,
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);
Shows the format of the Positions, Colors and Indices parameters when updating a point batch.
[Visual Basic .NET]
Dim positions As Array = New Object() {1247.87, -4739.74, 4067.77, 1115.48, -4847.09, 3979.36, _
	-24.12, -5529.31, 3168.45, -2683.42, -4307.74, 3850.11}

Dim colors As Array = New Object() {Color.Red.ToArgb(), Color.Green.ToArgb(), Color.Blue.ToArgb(), Color.White.ToArgb()}

Dim indices As Array = New Object() {0, 1, 2, 3}

pointBatch.SetPartialWithColorsIndicesOrderAndRenderPass(positions, colors, indices, AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque)
© 2019 Analytical Graphics, Inc. All Rights Reserved.