ArrayModifier(Modifier)

base classes — bpy_struct, Modifier

class bpy.types.ArrayModifier(Modifier)

Array duplication modifier

constant_offset_displace

Value for the distance between arrayed items

Type:float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)
count

Number of duplicates to make

Type:int in [1, inf], default 0
curve

Curve object to fit array length to

Type:Object
end_cap

Mesh object to use as an end cap

Type:Object
fit_length

Length to fit array within

Type:float in [0, inf], default 0.0
fit_type

Array length calculation method

  • FIXED_COUNT Fixed Count, Duplicate the object a certain number of times.
  • FIT_LENGTH Fit Length, Duplicate the object as many times as fits in a certain length.
  • FIT_CURVE Fit Curve, Fit the duplicated objects to a curve.
Type:enum in [‘FIXED_COUNT’, ‘FIT_LENGTH’, ‘FIT_CURVE’], default ‘FIXED_COUNT’
merge_threshold

Limit below which to merge vertices

Type:float in [0, inf], default 0.0
offset_object

Use the location and rotation of another object to determine the distance and rotational change between arrayed items

Type:Object
relative_offset_displace

The size of the geometry will determine the distance between arrayed items

Type:float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)
start_cap

Mesh object to use as a start cap

Type:Object
use_constant_offset

Add a constant offset

Type:boolean, default False
use_merge_vertices

Merge vertices in adjacent duplicates

Type:boolean, default False
use_merge_vertices_cap

Merge vertices in first and last duplicates

Type:boolean, default False
use_object_offset

Add another object’s transformation to the total offset

Type:boolean, default False
use_relative_offset

Add an offset relative to the object’s bounding box

Type:boolean, default False

Inherited Properties

Inherited Functions