hm_getuvvectors

Returns the parametric uv vectors at a node, point or xyz location on the referenced surface.

Syntax

hm_getuvvectors surf_id input_mode options ?scaled?

Type

HyperMesh Tcl Query

Description

Returns the parametric uv vectors at a node, point or xyz location on the referenced surface. The u and v vectors are returned as a list containing six values. The first three values are u_x, u_y and u_z. The second three values are v_x, v_y and v_z. The vectors are normalized and are relative to the global coordinate system.

This command is only valid for single surfaces or surfaces generated by trimming one original surface and suppressing edges. It is not valid for the generic case of surfaces composed from different parametric patches by suppressing edges only (for example, two separate surfaces stitched together, then edges suppressed).

Inputs

surf_id
The ID of the surface.
input_mode
Specifies how the input location is being defined. Valid values are:
"by xyz" - the location is specified using x,y,z coordinates.
"by node" - the location is specified using a node.
"by point" - the location is specified using a point.
options
Depending on the input_mode, these vary. Valid values for each input mode are:
"by xyz"
x y z
The x,y,z coordinates of interest, in global coordinates. The location is projected onto the surface if it does not directly lie on the surface.
"by node"
node_id
The ID of the node of interest. The node must either be associated to the input surface, or to no surface at all. If it is not associated to any surface, it is projected internally onto the surface.
"by point"
point_id
The ID of the point of interest. The point must either be associated to the input surface, or to no surface at all. If it is not associated to any surface, it is projected internally onto the surface.
scaled
Optional argument used when the referenced surface is a trimmed surface. If the value is set to 0 (default), the uv vectors returned will be in reference to the parametric space of original untrimmed surface. If the scale value is set to 1, the uv vectors returned will be in reference to the parametric space of the trimmed surface.

Examples

To get the uv vectors at (100,0,0) on surface 1:

hm_getuvvectors 1 "by xyz" 100 0 0

To get the uv vectors at node 100 on surface 1:

hm_getuvvectors 1 "by node" 100

To get the uv vectors at point 100 on surface 1:

hm_getuvvectors 1 "by point" 100

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

10-SA1-130