*morphmaptolinevecoffset

Maps nodes to a line list along a vector.

Syntax

*morphmaptolinevecoffset entity_type_nodes mark_id_nodes entity_type_handles mark_id_handles line_list node_list use_symmetry use_constraints project vector_id mode offset

Type

HyperMesh Tcl Modify Command

Description

Maps nodes to, or offset from, a specified line using the temporary shape created by *morphmaptshp and *morphmaptshpedge as a guide. Selected handles can optionally follow behind the morphing operation.

Nodes can be projected on to the line along a vector, normal to the line, or spaced evenly along the line (if the nodes belong to edge domains).

Inputs

entity_type_nodes
Must be set to nodes.
mark_id_nodes
The ID of the mark containing the input nodes. Valid values are 1 and 2.
entity_type_handles
Must be set to handles.
mark_id_handles
The ID of the mark containing the handles. Valid values are 1 and 2.
line_list
The ID of the list containing the input lines. Valid values are 1 and 2.
node_list
The ID of the list containing any nodes to define input lines. Valid values are 1 and 2.
use_symmetry
0 - Do not use symmetry (only option)
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 line
2 - Fit to line
If offset is non-zero, the offset will be measured from the closest point on the line for values of 0 and 1. The offset will be measured along the projection vector or normal for values of 10 and 11. Offsets will not be applied for a value of 2.
vector_id
The ID of vector created using *createvector for the projection direction. Must be set to 1.
mode
0 - If *morphmaprecalc has been used to calculate new influences
1 - To recalculate new influences inside this command
offset
The distance to offset nodes from the target. Not used if project is 2.
The offset will be measured from the closest point on the line for values of project of 0 and 1. The offset will be measured along the projection vector normal for values of project of 10 and 11.

Example

To project nodes on mark 1 normal to the lines on list 1 with an offset of 1.2 when not using *morphmaprecalc:

*morphmaptolinevecoffset nodes 1 handles 1 1 1 0 1 1 1 1 1.2

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