Description

Defines the positions of points in a point batch. The points are rendered in the primitive's Reference Frame.

Syntax

[Visual Basic .NET]
Public Sub Set( _ ByRef Positions As System.Array _ )

[Visual Basic .NET]

Public Sub Set( _
   ByRef Positions As System.Array _
)

[C#]
public void Set( ref System.Array Positions );

[C#]

public void Set(

   ref System.Array Positions

);

[Managed C++]
public: void Set( System::Array ^^ Positions );

[Managed C++]

public: void Set(

   System::Array ^^ Positions

);

[Java]
public set( Object[] Positions );

[Java]

public  set(

   Object[] Positions

);

[Unmanaged C++]
public: HRESULT Set( SAFEARRAY ** Positions );

[Unmanaged C++]

public: HRESULT Set(

   SAFEARRAY ** Positions

);

Parameters

Positions: An array containing the new positions (in the order x, y, z) for the point batch.

Remarks

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

Each point is rendered with the same color and translucency, which is defined by the primitive's Color and Translucency properties.

Example

Shows the format of the Positions, Colors and Indices parameters when updating a point batch.

[C#] Copy Code

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);