Direct3DRMVisualArray

Applications use the methods of the Direct3DRMVisualArray interface to organize groups of visual objects. The visual array is zero based (0 to N-1).

Visuals are objects that can be rendered in a scene. Visuals are visible only when they are added to a frame in that scene. An application can add a visual to a frame by using the Direct3DRMFrame3.AddVisual method. The frame provides the visual with position and orientation for rendering.

The most common visual types are Direct3DRMMeshBuilder3 and Direct3DRMTexture3 objects.

The Direct3DRMVisualArray interface supports the following methods.

GetElement
GetSize

The Direct3DRMVisualArray object is obtained by calling the Direct3DRMFrame3.GetVisuals method.

Direct3DRMVisualArray.GetElement

Direct3DRMVisualArray

Retrieves a specified element in a Direct3DRMVisualArray object.

Syntax

object.GetElement(index As Long) As Direct3DRMVisual

Parts

object

Object expression that resolves to a Direct3DRMVisualArray object.

index
Element in the array.

Return Value

An Direct3DRMVisual object.

Error Values

For a list of possible errors, see Direct3D Retained Mode Error Values.

Direct3DRMVisualArray.GetSize

Direct3DRMVisualArray

Retrieves the number of elements contained in a Direct3DRMVisualArray object.

Syntax

object.GetSize( ) As Long

Parts

object

Object expression that resolves to a Direct3DRMVisualArray object.

Return Value

Returns the number of elements.

Error Values

For a list of possible errors, see Direct3D Retained Mode Error Values.