RigidBodyConstraint(bpy_struct)

base class — bpy_struct

class bpy.types.RigidBodyConstraint(bpy_struct)

Constraint influencing Objects inside Rigid Body Simulation

breaking_threshold

Impulse threshold that must be reached for the constraint to break (in [0, inf], default 10.0)

Type:

float

disable_collisions

Disable collisions between constrained rigid bodies (default False)

Type:

bool

enabled

Enable this constraint (default False)

Type:

bool

limit_ang_x_lower

Lower limit of X axis rotation (in [-6.28319, 6.28319], default -0.785398)

Type:

float

limit_ang_x_upper

Upper limit of X axis rotation (in [-6.28319, 6.28319], default 0.785398)

Type:

float

limit_ang_y_lower

Lower limit of Y axis rotation (in [-6.28319, 6.28319], default -0.785398)

Type:

float

limit_ang_y_upper

Upper limit of Y axis rotation (in [-6.28319, 6.28319], default 0.785398)

Type:

float

limit_ang_z_lower

Lower limit of Z axis rotation (in [-6.28319, 6.28319], default -0.785398)

Type:

float

limit_ang_z_upper

Upper limit of Z axis rotation (in [-6.28319, 6.28319], default 0.785398)

Type:

float

limit_lin_x_lower

Lower limit of X axis translation (in [-inf, inf], default -1.0)

Type:

float

limit_lin_x_upper

Upper limit of X axis translation (in [-inf, inf], default 1.0)

Type:

float

limit_lin_y_lower

Lower limit of Y axis translation (in [-inf, inf], default -1.0)

Type:

float

limit_lin_y_upper

Upper limit of Y axis translation (in [-inf, inf], default 1.0)

Type:

float

limit_lin_z_lower

Lower limit of Z axis translation (in [-inf, inf], default -1.0)

Type:

float

limit_lin_z_upper

Upper limit of Z axis translation (in [-inf, inf], default 1.0)

Type:

float

motor_ang_max_impulse

Maximum angular motor impulse (in [0, inf], default 1.0)

Type:

float

motor_ang_target_velocity

Target angular motor velocity (in [-inf, inf], default 1.0)

Type:

float

motor_lin_max_impulse

Maximum linear motor impulse (in [0, inf], default 1.0)

Type:

float

motor_lin_target_velocity

Target linear motor velocity (in [-inf, inf], default 1.0)

Type:

float

object1

First Rigid Body Object to be constrained

Type:

Object

object2

Second Rigid Body Object to be constrained

Type:

Object

solver_iterations

Number of constraint solver iterations made per simulation step (higher values are more accurate but slower) (in [1, 1000], default 10)

Type:

int

spring_damping_ang_x

Damping on the X rotational axis (in [0, inf], default 0.5)

Type:

float

spring_damping_ang_y

Damping on the Y rotational axis (in [0, inf], default 0.5)

Type:

float

spring_damping_ang_z

Damping on the Z rotational axis (in [0, inf], default 0.5)

Type:

float

spring_damping_x

Damping on the X axis (in [0, inf], default 0.5)

Type:

float

spring_damping_y

Damping on the Y axis (in [0, inf], default 0.5)

Type:

float

spring_damping_z

Damping on the Z axis (in [0, inf], default 0.5)

Type:

float

spring_stiffness_ang_x

Stiffness on the X rotational axis (in [0, inf], default 10.0)

Type:

float

spring_stiffness_ang_y

Stiffness on the Y rotational axis (in [0, inf], default 10.0)

Type:

float

spring_stiffness_ang_z

Stiffness on the Z rotational axis (in [0, inf], default 10.0)

Type:

float

spring_stiffness_x

Stiffness on the X axis (in [0, inf], default 10.0)

Type:

float

spring_stiffness_y

Stiffness on the Y axis (in [0, inf], default 10.0)

Type:

float

spring_stiffness_z

Stiffness on the Z axis (in [0, inf], default 10.0)

Type:

float

spring_type

Which implementation of spring to use (default 'SPRING1')

  • SPRING1 Blender 2.7 – Spring implementation used in Blender 2.7. Damping is capped at 1.0.

  • SPRING2 Blender 2.8 – New implementation available since 2.8.

Type:

Literal[‘SPRING1’, ‘SPRING2’]

type

Type of Rigid Body Constraint (default 'POINT')

Type:

Literal[Rigidbody Constraint Type Items]

use_breaking

Constraint can be broken if it receives an impulse above the threshold (default False)

Type:

bool

use_limit_ang_x

Limit rotation around X axis (default False)

Type:

bool

use_limit_ang_y

Limit rotation around Y axis (default False)

Type:

bool

use_limit_ang_z

Limit rotation around Z axis (default False)

Type:

bool

use_limit_lin_x

Limit translation on X axis (default False)

Type:

bool

use_limit_lin_y

Limit translation on Y axis (default False)

Type:

bool

use_limit_lin_z

Limit translation on Z axis (default False)

Type:

bool

use_motor_ang

Enable angular motor (default False)

Type:

bool

use_motor_lin

Enable linear motor (default False)

Type:

bool

use_override_solver_iterations

Override the number of solver iterations for this constraint (default False)

Type:

bool

use_spring_ang_x

Enable spring on X rotational axis (default False)

Type:

bool

use_spring_ang_y

Enable spring on Y rotational axis (default False)

Type:

bool

use_spring_ang_z

Enable spring on Z rotational axis (default False)

Type:

bool

use_spring_x

Enable spring on X axis (default False)

Type:

bool

use_spring_y

Enable spring on Y axis (default False)

Type:

bool

use_spring_z

Enable spring on Z axis (default False)

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

References