*linecreatefromcoords

Create a line passing through a list of 3D points.

Syntax

*linecreatefromcoords type break_angle aspect linear_angle double_array number_of_doubles

Type

HyperMesh Tcl Modify Command

Description

Create a line passing through a list of 3D points.

Inputs

type
The type of line to generate. Valid values are:
0 - Linear
1 - Standard
2 - Smooth
3 - User controlled
When type is 3, input values for break_angle, aspect and linear_angle are used.
Adding 8 to any of the values above will create a closed line of that type.
break_angle
Specifies the minimum angle allowed between three points in a line. If the angle between a point and the two adjacent points is less than the angle specified, this point is considered to be a point of discontinuity in the line and a joint is placed (the start of a new NURBS) at this location.
Used when type is 3.
aspect
Specifies the maximum ratio allowed for the distance between a point and the previous point in the line and the distance between the same point and the next point in the line. If the ratio of the distance between the two adjacent segments exceeds the aspect ratio defined, a joint is placed between the segments.
Used when type is 3.
linear_angle
Defines the angle at which the line is considred a straight line. For example, if the line angle between three consecutive points along the line is greater than the linear angle specified, the center point is removed from the line.
Used when type is 3.
double_array
The ID of the double array that contains the values. The double array is created using the *createdoublearray command. This should always be set to 1
number_of_doubles
Integer indicating the size (number of doubles) in the array created using *createdoublearray.

Examples

To create a line that passes through 3 points:
*createdoublearray 9 -2.50392465 6.43642072 0 1.04395604 5.9811617 0 4.56043956 5.71428571 0
*linecreatefromcoords 0 150 5 179 1 9

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