*morphmaptonodesnodeslistoffset

Maps a node list to a line along a vector.

Syntax

*morphmaptonodesnodeslistoffset list_id_nodes entity_type_handles mark_id_handles node_list_id use_symmetry use_constraints project vector_id 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).

In the map to geom tool, the line used in this command is created from a node list.

Inputs

list_id_nodes
The ID of the list 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.
node_list_id
The ID of the list containing the target nodes. 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 to 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.
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 list 1 normal to a line with ID 23 with an offset of 1.2:

*morphmaptonodesnodeslistoffset 1 handles 1 23 0 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

2020.1