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 (array of 3 items, in [-inf, inf], default (1.0, 0.0, 0.0))

Type:

mathutils.Vector

count

Number of duplicates to make (in [1, inf], default 2)

Type:

int

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 (in [0, inf], default 0.0)

Type:

float

fit_type

Array length calculation method (default 'FIXED_COUNT')

  • 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:

Literal[‘FIXED_COUNT’, ‘FIT_LENGTH’, ‘FIT_CURVE’]

merge_threshold

Limit below which to merge vertices (in [0, inf], default 0.01)

Type:

float

offset_object

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

Type:

Object

offset_u

Amount to offset array UVs on the U axis (in [-1, 1], default 0.0)

Type:

float

offset_v

Amount to offset array UVs on the V axis (in [-1, 1], default 0.0)

Type:

float

relative_offset_displace

The size of the geometry will determine the distance between arrayed items (array of 3 items, in [-inf, inf], default (1.0, 0.0, 0.0))

Type:

mathutils.Vector

start_cap

Mesh object to use as a start cap

Type:

Object

use_constant_offset

Add a constant offset (default False)

Type:

bool

use_merge_vertices

Merge vertices in adjacent duplicates (default False)

Type:

bool

use_merge_vertices_cap

Merge vertices in first and last duplicates (default False)

Type:

bool

use_object_offset

Add another object’s transformation to the total offset (default False)

Type:

bool

use_relative_offset

Add an offset relative to the object’s bounding box (default True)

Type:

bool

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions