*mechadjustballjoint

Actuates a ball joint to reach a new value.

Syntax

*mechadjustballjoint name x y z tolerance lock angle_step

Type

HyperMesh Tcl Modify

Description

Actuates a ball joint to reach a new value. The mechanism must have the enabled flag set to true for this to be possible.

Inputs

name
The name of the joint to adjust.
x
The desired x Euler angle value of the joint (double).
y
The desired y Euler angle value of the joint (double).
z
The desired z Euler angle value of the joint (double).
tolerance
The tolerance allowed when adjusting (double).
lock
1 - All joints in the mechanism which are not part of the cycle of the given joint are locked.
angle_step
The size of the iterative steps used to solve for the new value of the joint. Only used for rotation.

Example

To move a joint named TORSO_to_RIGHT_UPPER_LEG to x=20, y=0, z=0 with a tolerance of 0.001, locking other joints and angle step = 0:
*mechadjustballjoint "TORSO_to_RIGHT_UPPER_LEG" 20.0 0.0 0.0 0.001 1 0

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0.120