hm_getuvbounds

Returns the parametric uv coordinate bounds associated with the referenced surface.

Syntax

hm_getuvbounds surf_id ?scaled?

Type

HyperMesh Tcl Query Command

Description

Returns the parametric uv coordinate bounds associated with the referenced surface.. The u and v values are returned as a list containing four values. The first two values in the list are the range for u, and the last two values are the range for v.

This is most useful to determine the bounds of trimmed surfaces, where the trimmed surface’s parametric space is a subset of the untrimmed surface’s parametric space. It can be used in conjunction with hm_getuvcoordinates.

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.
scaled (optional): Used when the referenced surface is a trimmed surface. If the value is set to 0 (default), the uv bounds returned will be in reference to the parametric space of original untrimmed surface. If the scale value is set to 1, the uv bounds returned will be in reference to the parametric space of the trimmed surface.

Example

To get the uv bounds of surface 1:

hm_getuvbounds 1

Errors

None.

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

9.0