*linecreateatsurfparams

Create lines at parametric locations on a surface.

Syntax

*linecreateatsurfparams surf_type surf_id u1 u2 ucount v1 v2 vcount mode comp_mode

Type

HyperMesh Tcl Modify Command

Description

This command creates lines on a given surface for given parametric values.

Inputs

surf_type
Input surface type. Valid values are surfs of faces.
surf_id
Input surface ID value.
u1
The lower bound of U parametric range. Must be within the range 0 to 1.
u2
The upper bound of U parametric range. Must be within the range 0 to 1.
ucount
The number of lines to create in U parametric direction. Must be >= 0. If the value is 1 then u1 is taken as U parametric value for created line.
v1
The lower bound of V parametric range. Must be within the range 0 to 1.
v2
The upper bound of V parametric range. Must be within the range 0 to 1.
vcount
The number of lines to create in V parametric direction. Must be >= 0. If the value is 1 then v1 is taken as V parametric value for created line.
mode
Specifies whether parameters are used relative to untrimmed surface parametric area or valid parametric area is scaled to visible region. Also used to specify whether created lines must reside inside visible trimmed surface area. Valid values are:
  • 0 - Untrimmed surface parametric area is used. Created lines must be inside visible surface area.
  • 1 - Surface parametric area is scaled to visible surface area. Created lines must be inside visible surface area.
  • 2 - Untrimmed surface parametric area is used. Created lines can be outside visible surface area.
  • 3 - Surface parametric area is scaled to visible surface area. Created lines can be outside visible surface area.
comp_mode
Parameter specifying how entities are organized into components:
  • 0 - Lines are created in the current component.
  • 1 - Lines are created in the surface component.

Example

To create 12 lines (3 lines in U, 4 lines in V) on surface 11 between the U locations 0.5 and 0.75, and the V locations 0.1 and 0.3:

*linecreateatsurfparams surfs 11 0.5 0.75 3 0.1 0.3 4 0

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.0