GeometryAttributeConstraint(Constraint)

base classes — bpy_struct, Constraint

class bpy.types.GeometryAttributeConstraint(Constraint)

Create a constraint-based relationship with an attribute from geometry

apply_target_transform

Apply the target object’s world transform on top of the attribute’s transform (default False)

Type:

bool

attribute_name

Name of the attribute to retrieve the transform from (default “”, never None)

Type:

str

data_type

Select data type of attribute (default 'VECTOR')

  • VECTOR Vector – Vector data type, affects position.

  • QUATERNION Quaternion – Quaternion data type, affects rotation.

  • FLOAT4X4 4x4 Matrix – 4x4 Matrix data type, affects transform.

Type:

Literal[‘VECTOR’, ‘QUATERNION’, ‘FLOAT4X4’]

domain

Attribute domain (default 'POINT')

Type:

Literal[‘POINT’, ‘EDGE’, ‘FACE’, ‘FACE_CORNER’, ‘CURVE’, ‘INSTANCE’]

mix_loc

Mix Location (default False)

Type:

bool

mix_mode

Specify how the copied and existing transformations are combined (default 'REPLACE')

  • REPLACE Replace – Replace the original transformation with the transform from the attribute.

  • BEFORE_FULL Before Original (Full) – Apply copied transformation before original, using simple matrix multiplication as if the constraint target is a parent in Full Inherit Scale mode. Will create shear when combining rotation and non-uniform scale..

  • BEFORE_SPLIT Before Original (Split Channels) – Apply copied transformation before original, handling location, rotation and scale separately, similar to a sequence of three Copy constraints.

  • AFTER_FULL After Original (Full) – Apply copied transformation after original, using simple matrix multiplication as if the constraint target is a child in Full Inherit Scale mode. Will create shear when combining rotation and non-uniform scale..

  • AFTER_SPLIT After Original (Split Channels) – Apply copied transformation after original, handling location, rotation and scale separately, similar to a sequence of three Copy constraints.

Type:

Literal[‘REPLACE’, ‘BEFORE_FULL’, ‘BEFORE_SPLIT’, ‘AFTER_FULL’, ‘AFTER_SPLIT’]

mix_rot

Mix Rotation (default False)

Type:

bool

mix_scl

Mix Scale (default False)

Type:

bool

sample_index

Sample Index (in [0, inf], default 0)

Type:

int

target

Target geometry object

Type:

Object

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