Documentation - Maxscript

Stretch_Constraint : Matrix3Controller

The Stretch_Constraint controller constraints an object's transformation between the position of two objects (start and end). The position will be constrained to the "start" object and the rotation will be constrained aiming at the "end" object's position using the quat aim method. Optionally the scale can be stretched depending on the distance of the two target objects.

Properties

<Stretch_Constraint>.start Node

Get/set the first target node of the constraint.

<Stretch_Constraint>.use_start Boolean default: true

Enables or disables the start target node.

<Stretch_Constraint>.end Node

Get/set the last target node of the constraint.

<Stretch_Constraint>.use_end Boolean default: true

Enables or disables the end target node.

<Stretch_Constraint>.aim_axis Integer default: 0

Get/set the axis that is aiming to the end target node:

0 - X.
1 - Y.
2 - Z.

<Stretch_Constraint>.aim_axis_flip Boolean default: false

This parameter flips the axis that is aiming to the end target node.

<Stretch_Constraint>.align_axis Integer default: 0

Get/set the reference axis that is used in the Quat method to build the aim rotation. The flip will happen at the negative side of this axis. The flip will happen only in this angle instead of the two flipping angles that the look at constraint has.

0 - X.
1 - Y.
2 - Z.

<Stretch_Constraint>.align_axis_flip Boolean default: false

This parameter flips the align axis.

<Stretch_Constraint>.align Integer default: 0

Get/set the alignment reference type that is used in this controller:

0 - World.
1 - Parent.
2 - Start.
3 - End.

<Stretch_Constraint>.inherit_scale Integer default: 0

Get/set the scale inheritance type that is used in this controller:

0 - World.
1 - Parent.
2 - Start.
3 - End.

<Stretch_Constraint>.stretch_scale_active Boolean default: true

If this parameter is on, the scale will be stretched depending on the distance of the two target objects and the stretch parameters.

<Stretch_Constraint>.stretch Percent default: 100.0

Get/Set how much the aim axis scale is going to be affected by the distance between the target objects.

<Stretch_Constraint>.squash Percent default: 100.0

Get/Set how much the other axes scale is going to be affected by the distance between the target objects.

<Stretch_Constraint>.length WorldUnits

Get/Set the distance in which the whole system is at rest, when the distance between the start and end node is the same as this value the scale won't be affected.

<Stretch_Constraint>.viewline_length Float default: 100.0

Get/set the length of the lookat vector in the viewport either in generic units (when .viewline_length_abs is set to true,) or as percentage of the distance from the start object to the end object.

<Stretch_Constraint>.viewline_length_abs Boolean default: true

Get/set the state of the Viewline Length Absolute checkbox. When set to true, the lookat line in the viewport will have a length in absolute generic units. When set to false (the default), the length will be relative to the distance from the start object to the end object. See .viewline_length description above.

Methods

<void> <Stretch_Constraint>.ResetLength()

The .length property will be reset to the current distance between the start and end node.

< Back to main maxscript documentation