*add_remove_distance_manipulator

Adds or removes distance (dimension) manipulators between two surface vertices.

Syntax

*add_remove_distance_manipulator mode point_id1 point_id2 lock_turnover reserved

Type

HyperMesh Tcl Modify Command

Description

Adds or removes distance (dimension) manipulators between two surface vertices. The manipulators are displayed upon entering the Dimensioning panel.

Inputs

mode
The mode to use:
  • 0 - Remove the distance manipulator between the two points.
  • 1 - Add a distance manipulator between the two points.
  • 2 - Remove all distance manipulators.
point_id1
The first vertex point ID. Only used when mode is 0 or 1.
point_id2
The second vertex point ID. Only used when mode is 0 or 1.
lock_turnover
Specifies the end point lock controls which determine which manipulator side surfaces are selected automatically and what end(s) are movable. The value specified overwrites the area_selection_ratio constraint but cannot overwrite the max_pick_angle constraint. If the latter constraint does not allow the sides (point_id1 and point_id2) to move, or allows only one side to move, only the allowed side will move, regardless of this parameter.
Bit values are used and the value is calculated as (Bit0 + 2*Bit1 + 4*Bit2).
Bit0
0 - The point with the smaller ID cannot move during offset. Only valid when Bit2 is set to 1.
1 - The point with the smaller ID can move during offset. Only valid when Bit2 is set to 1.
Bit1
0 - The point with the larger ID cannot move during offset. Only valid when Bit2 is set to 1.
1 - The point with the larger ID can move during offset. Only valid when Bit2 is set to 1.
Bit2
0 - Do not edit the lock controls and ignore Bit0 and Bit1.
1 - Edit the lock controls based on Bit0 and Bit1 values.
reserved
Reserved for future use. Must be specified as 0.

Examples

To add a distance manipulator between vertices 100 and 101:

*add_remove_distance_manipulator 1 100 101 7 0

To remove a distance manipulator between vertices 100 and 101:

*add_remove_distance_manipulator 0 100 101 0 0

To remove all distance manipulators:

*add_remove_distance_manipulator 2 0 0 0 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

11.0