SoArray

InventorModule

genre	InventorNodesAutomatic,InventorGroup
author	Silicon Graphics Inc
package	MeVisLab/Standard
definition	inventor.def

Purpose

The group node SoArray traverses its children in order several times, creating a regular 3D array of copies. The number of copies in each of the three directions is specified by fields, as are the vectors used to separate the copies in each dimension.

For example, an SoArray node can be used to create a 2x3x4 array of copies of its children, where the separation vectors between adjacent copies in the three array dimensions are (1, 2, 3), (-4, -5, -6), and (7, 8, 9), respectively. The base point of the array can be set to one of several values, as described in the Origin field.

Copies are traversed so that the first dimension cycles most quickly, followed by the second, and then the third. This order is important because SoArray sets the current switch value to N before traversing the children for the Nth time (for use with inherited switch values; see SoSwitch).

Windows

Default Panel

Input Fields

child

name: child, type: SoNode

Output Fields

self

name: self, type: SoNode

Parameter Fields

Field Index

Num Elements1: Integer

Num Elements2: Integer

Num Elements3: Integer

Origin: Enum

Separation1: Vector3

Separation2: Vector3

Separation3: Vector3

Visible Fields

Num Elements1

name: numElements1, type: Integer, default: 1

Sets the number of elements in the first array dimension.

Num Elements2

name: numElements2, type: Integer, default: 1

Sets the number of elements in the second array dimension.

Num Elements3

name: numElements3, type: Integer, default: 1

Sets the number of elements in the third array dimension.

Separation1

name: separation1, type: Vector3, default: 1 0 0

Sets the separation vector in the first array dimension.

Separation2

name: separation2, type: Vector3, default: 0 1 0

Sets the separation vector in the second array dimension.

Separation3

name: separation3, type: Vector3, default: 0 0 1

Sets the separation vector in the third array dimensions.

Origin

name: origin, type: Enum, default: FIRST

Defines the base point from which copies are distributed.

Values:

Title	Name	Description
First	FIRST	First copy is rendered at the current local origin; all other copies are distributed relative to it.
Center	CENTER	Copies are distributed relative to the center of the array.
Last	LAST	Last copy is rendered at the current local origin; all other copies are distributed relative to it.