*morphmaptonodesnodelistoffset

Maps a node list to a line along a vector.

Syntax

*morphmaptonodesnodelistoffset 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:

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