Construct Line Normal to Object

Creates a line of a specified length normal to an object’s internal Z axis.

 

Input Arguments

 

0

Collection Object Name

Line Name

The name of the resulting line.

1

Double

Line Length

The length of the resulting line.

2

Collection Object Name

Object

Object defining the normal for the resulting line.

 

Return Arguments

None.

 

Returned Status

 

SUCCESS

The line was created successfully.

FAILURE

The source object was not found.

 

Remarks

The resulting line direction will be along the specified object’s internal Z axis. For example, for planes this is normal to the plane. For lines, this is parallel to the line. For frames, it’s along the frame’s Z axis.

A line of zero length can be created, although analysis with a zero-length line is undefined. If the specified line name already exists, the name will be incremented to avoid duplicates.