*morphmapedgestoplaneoffset

Maps selected morph volume edges to the specified plane.

Syntax

*morphmapedgestoplaneoffset user_mark_id plane_id use_symmetry use_constraints project vector_id number_of_mid_handles offset

Type

HyperMesh Tcl Modify

Description

This command will project the handles on the marked morph volume edges to the specified plane along the specified vector, plane normal, or normal to any attached shell elements (unusual for morph volume edges).

Inputs

user_mark_id
The ID of the user mark containing the morph edges. Valid values are 0-3.
plane_id
The ID of the plane created using *createplane. Valid values are 1 and 2.
use_symmetry
0 - Do not use symmetry links
1 - Use symmetry links
use_constraints
0 - Do not use constraints
1 - Use constraints
project
0 or 10 - Project along vector defined by vector_id
1 or 11 - Project normal to surfaces
2 or 12 - Project normal to attached shell elements
If offset is non-zero, the offset will be measured from the closest point on the plane for values of 0, 1 and 2. The offset will be measured along the projection vector or normal for values of 10, 11, and 12.
vector_id
The ID of vector created using *createvector for the projection direction. Must be set to 1.
number_of_mid_handles
-1 - Do not change the handles on the edges
0 – 5 - Update the number of mid-handles on the edges to this number
offset
The distance to offset nodes from the target.
The offset will be measured from the closest point on the plane for values of project of 0, 1, and 2. The offset will be measured along the projection vector normal for values of project of 10, 11, and 12.

Examples

To map edges on mark 0 to a plane along a vector with offset of 1.2 and leaving the handles unchanged:

*morphmanageedgemark 0 0 3
*morphmanageedgemark 2 0 1
*morphmanageedgemark 4 0 1
*createplane 1 1.0 0.0 0.0 1.0 0.0 0.0
*createvector 1 1.0 0.0 0.0
*morphmapedgestoplaneoffset 0 1 1 1 0 1 -1 1.2
*morphmanageedgemark 0 0 3

To map edges on mark 1 to a plane along the plane normal with 3 mid-handles per edge:

*morphmanageedgemark 0 1 3
*morphmanageedgemark 2 1 1
*morphmanageedgemark 4 1 1
*createplane 1,1.0 0.0 0.0 1.0 0.0 0.0
*createvector 1 1.0 0.0 0.0
*morphmapedgestoplaneoffset 1 1 1 1 1 1 3 0.0
*morphmanageedgemark 0 1 3

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