Tutorial: Constraint

`constraint`

A physics constraint that can be configured along 6 degrees of freedom. In its default state it behaves as a fixed constraint - that is, it rigidly fixes the constraint frames of its two entities. However, individual degrees of freedom may be unlocked to permit any combination of rotation around the x-, y- and z- axes, and translation along these axes.

Dependencies

joint

Attributes

Attribute	Type	Default	Description
motionAlongX	`integer`	0	Motion along the X axis
motionAlongY	`integer`	0	Motion along the Y axis
motionAlongZ	`integer`	0	Motion along the Z axis
motionAroundX	`integer`	0	Motion around the X axis
motionAroundY	`integer`	0	Motion around the Y axis
motionAroundZ	`integer`	0	Motion around the Z axis
motionLowerLimit	`vec3`	[ 0, 0, 0 ]	The lower distance of the limit.
motionUpperLimit	`vec3`	[ 0, 0, 0 ]	The upper distance of the limit.
motionLimitSpringStiffness	`vec3`	[ 0, 0, 0 ]	If greater than zero, the limit is soft, i.e. a spring pulls the joint back to the limit.
motionLimitSpringDamping	`vec3`	[ 0, 0, 0 ]	If greater than zero, this is the damping of the limit spring.
swingLimitAngle	`vec2`	[ 0, 0 ]	The limit angle from the Y-axis and the Z-axis of the constraint frame. The cone limit is used if either or both swing axes are limited. The extents are symmetrical and measured in the frame of the parent. If only one swing degree of freedom is limited, the corresponding value from the cone limit defines the limit range.
swingSpringStiffness	`float`	0	If greater than zero, the limit is soft, i.e. a spring pulls the joint back to the limit.
swingSpringDamping	`float`	0	If greater than zero, this is the damping of the limit spring.
twistLimitAngle	`vec2`	[ 0, 0 ]	The twist limit controls the range of motion around the twist axis. The limit angle range is (-360, 360).
twistSpringStiffness	`float`	0	If greater than zero, the limit is soft, i.e. a spring pulls the joint back to the limit.
twistSpringDamping	`float`	0	If greater than zero, this is the damping of the limit spring.
linearDriveStiffness	`vec3`	[ 0, 0, 0 ]	If greater than zero, the limit is soft, i.e. a spring pulls the joint back to the limit.
linearDriveDamping	`vec3`	[ 0, 0, 0 ]	If greater than zero, this is the damping of the limit spring.
linearDriveForceLimit	`vec3`	[ -1, -1, -1 ]	The maximum impulse or force that can be exerted by the drive. -1 for no limit.
angularDriveStiffness	`vec3`	[ 0, 0, 0 ]	If greater than zero, the limit is soft, i.e. a spring pulls the joint back to the limit.
angularDriveDamping	`vec3`	[ 0, 0, 0 ]	If greater than zero, this is the damping of the limit spring.
angularDriveForceLimit	`vec3`	[ -1, -1, -1 ]	The maximum impulse or force that can be exerted by the drive. -1 for no limit.
driveType	`integer`	1	The drive type
driveLinearVelocity	`vec3`	[ 0, 0, 0 ]	The goal velocity for linear drive.
driveAngularVelocity	`vec3`	[ 0, 0, 0 ]	The goal velocity for angular drive.