Feature LinearArray

Feature (document object)

LinearArray feature makes a linear array of placements. The array can be linked to a straight edge.

Properties

Dir

Vector setting the direction of axis, along which the array is constructed. Together with Point property, this property sets the axis of the array.

If DirIsDriven is True, and Link is set, Dir is read-only and controlled by the linked edge.

Length of Dir doesn't matter, it is normalized internally before it's used.

DirIsDriven

If true, and Link is set, Dir is controlled by the linked edge. If false, Dir can be set up manually with property editor.

DrivenProperty

This property allows to set, what parameter of the array is made equal to the length of linked edge.

None
Span (default): 'SpanEnd' is made equal to ('SpanStart' + length)
SpanStart: SpanStart is made equal to length.
SpanEnd: SpanEnd is made equal to length.
Step: Step is made equal to length.

Link, LinkSubelement

Link to object to take an edge from, to control some properties of the array. LinkSubelement is a string, and should be like "Edge1" (without quotemarks).

If DirIsDriven is true, the linked edge controls Dir property. If PointIsDriven is true, Point is set to starting point of linked edge.

Another property that is controlled is specified by value of DrivenProperty.

OrientMode

Specifies how to set the orientations of placements of the resulting array.

None: orientation is tivial (no rotation). However, if the array is moved as a whole, the orientations will follow the orientation part of array's Placement property.
Along axis: X axes of placements are made colinear to Dir. Other axes are chosen automatically (with Z axis tending to point upwards).

Point

Point in space corresponding to a distance value of 0. Together with Dir property, this property sets the axis of the array.

If PointIsDriven is True, and Link is set, Point is read-only, and equals the starting point of the linked edge.

PointIsDriven

If true, and Link is set, Point is controlled by the linked edge. If false, Point can be set up manually with property editor.

Reverse

Reverses the array's axis (negates all values of Dir). If Dir is not controlled by link, Reverse self-resets to false on recompute.

This property also switches Point to become equal to the other end of the edge.

(series properties)

(this is a brief overview; click the title for more info)

Values are distances measured along axis (Point+Dir), where to put the placements.

Values can be typed in directly, sourced from a spreadsheed, or (default) generated in-place. The source is chosen with ValuesSource property.

Generator is set up with its own set of properties, the most important of them are Count, SpanStart, SpanEnd, Step. Since these four are interrelated, those which can be edited and those computed are set up with GeneratorMode property:

SpanN: fit Count placements into SpanStart-SpanEnd. Step is computed (read-only).
StepN (default): make Count placements spaced by Step, starting from SpanStart. SpanEnd is computed (read-only).
SpanStep: fill SpanStart-SpanEnd interval with placements spaced by Step. Count is computed (read-only).
Random: put Count placements into SpanStart-SpanEnd interval, randomly. Step is ignored.