Path_Constraint - superclass: PositionController; super-superclass:MAXWrapper - 12:0 - classID: #(8209, 0)
Value > MAXWrapper > PositionController > Path_Constraint |
A PathConstraint restricts an object’s movement along a spline or at an averaged distance between multiple splines.
Gets/sets the first path on the list of paths to constrain to.
This property is exposed mainly for backwards compatibility with the legacy PathPositionController available in 3ds Max prior to version 4 before the Path_Constraint was introduced. The old controller supported only one path that can be get/set using the .path property.
The .path property in the Path_Constraint always returns the first object from the list of paths.
Setting the .path property will always replace the top path on the list with a new one.
If there are two or more objects on the list and the object assigned to the .path property is already on the list, but not the first one, the new object will replace the first entry on the list and because the path can only be on the list once, the second entry will be removed.
To set and manage multiple paths, use the methods exposed in the constraints interface that is described later in this topic.
Sets the percent that the object is positioned along the path. Corresponds to the % Along Path spinner.
Aligns one object axis to the tangent at the current position along the spline. The axis to follow with can be specified using the . axis and . axisflip properties.
Allows the object to bank (roll about the follow axis) as it negotiates the curves of the spline. This property only has effect when the .follow property is set to true . The axis to roll about when banking is the same as for the follow behavior.
Adjusts the amount of banking to one side or the other, depending on whether the value is positive or negative.
Controls how rapidly the roll angle changes as the object moves through bends in the trajectory. Smaller values will make the object more responsive to subtle changes in the curve, while larger values smooth out jerking. The default value is a good value for general damping along the curve. Values below two tend to make the action jerky, but values around three can be very useful for simulating a certain degree of realistic instability.
Set to true to avoid the situation in which an object flips when going around a vertically oriented path.
When set to true, provides a constant velocity along the path using path length interpolation. When set to false, the velocity of the object along the path varies depending on the distance between the vertices on the path.
See notes and examples in SplineShape-VertexandLengthInterpolationMethods for details on the two interpolation methods.
If set to false and the constrained object reaches the end of a path, it can no longer move past the end point. When set to true (default) and the constrained object reaches the end of the path, it loops back to the starting point.
When set to true , the constrained object will maintain its original position. The object will follow the path(s) with an offset distance based on its original world space position. When set to false (default), the object will be moved to the path or the weighted position between the multiple paths.
Gets/sets which axis of the object is aligned to the tangent of the path when the .follow property is set to true .
When set to false , the axis specified by the .axis property will be used. When set to true , the axis specified by the .axis property will be taken with the negative sign (flipped).
Returns the number of target nodes (paths) in the Target list.
Returns the indexed node from the list of paths.
Gets the weight of the indexed path node from the list of Targets. Returns the target's weight value at the current time if the target Number is less then the number of targets, 0.0 otherwise.
Sets the weight of the indexed node specified by targetNumber to the given value. Returns true on success, false otherwise.
Appends the specified node to the list. The default weight is 50.0. Returns true on success, false otherwise.
Deletes the indexed target. Returns true on success, false otherwise.