Creates a line of a specified length normal to an object’s internal Z axis.
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. |
None.
SUCCESS |
The line was created successfully. |
FAILURE |
The source object was not found. |
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.