Constructs a plane normal to a specified object and through a specified point.
Input Arguments
0 |
Collection Object Name |
Resultant Plane Name |
The name of the resulting plane. |
1 |
Collection Object Name |
‘Normal to’ Object Name |
The object defining the normal for the plane. |
2 |
Point Name |
‘Through’ Point Name |
The point through which the plane should pass. |
3 |
Double |
Plane Edge Dimension |
The length of each edge of the plane as depicted in the graphical view. |
Return Arguments
None.
Returned Status
SUCCESS |
The plane was created successfully. |
FAILURE |
The normal object or through point was not found. |
Remarks
The normal direction is defined by the Z-axis of the object defining the direction (if you were to built the objects frame using Construct>Frame>On Object). However, if a B-Spline is selected as the normal direction of the plane then the normal direct of the b-spline at the selected point (if the point lies on the curve or the projected closes point) will be used to define the plane direction.
If the specified plane name already exists, the name will be incremented to avoid duplicates.
While the plane edge dimension can be zero or negative, this could potentially cause problems with other calcula- tions, so a positive edge dimension should always be specified. The edge dimension is merely used to draw the plane in the graphical view. When used for analysis, a plane extends infinitely in two dimensions.