*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.
- 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