Create Line from Features
Description
Use this Step to create a line from the geometric features such as point, line, and plane.
Workflow
The process of configuring this Step is shown below.
-
Configure the input. Connect the ports manually in the graphical programming workspace or select the input under Input in the parameter configuration panel.
-
In the Parameters section, select the Line Type to determine how a line is generated, and choose the corresponding input data in the Input section.
-
If there are additional parameters in the Parameters section, select and adjust them according to your actual needs.
-
Select the desired output items under Output. For an expandable output item, click ▶ and configure the Min and Max values to determine the acceptable range for the item.
Parameter Description
Line Type
The method to create a line.
For different types of lines, the geometric features input into the Step and the parameters that need to be adjusted will vary accordingly. The specific correspondences are as follows:
| Line type | Geometric features to be input | Parameter adjustment |
|---|---|---|
Constant line |
- |
You need to set the coordinates of two constant points. After the Step is run, it outputs the line connecting the two points. |
Line from two points |
Point 1, Point 2 |
After the Step is run, it outputs the line connecting the two points. No other parameters need to be adjusted. |
Perpendicular line from point to line |
Point, Line |
After the Step is run, it outputs the perpendicular line from the point to the line. No other parameters need to be adjusted. |
Perpendicular line from point to plane |
Point, Plane |
After the Step is run, it outputs the perpendicular line from the point to the plane. No other parameters need to be adjusted. |
Parallel line from point and line |
Point, Line |
After the Step is run, it outputs a line that passes through the given point and is parallel to the given line. No other parameters need to be adjusted. |
Intersection line of two planes |
Plane 1, Plane 2 |
After the Step is run, it outputs the intersection line of two planes. No other parameters need to be adjusted. |
Projected line on plane |
Line, Plane |
After the Step is run, it outputs the projection of the line onto the plane. In this case, you need to select the Projection Direction of the line onto the plane.
|
Centerline between two lines |
Line 1, Line 2 |
After the Step is run, it outputs the centerline between the two lines. No other parameters need to be adjusted. |
Projected centerline on plane |
Line 1, Line 2, Plane |
After the Step is run, it outputs the projection of the centerline between the two lines onto the plane. No other parameters need to be adjusted. |
Rotate line around point |
Point, Line |
You need to set the Rotation Axis Mode and the Rotation Angle of the line around the point. The rotation axis passes through the given point, and the given line will rotate around this axis by the specified angle. The Rotation Axis Mode is described as follows:
|
Given line |
Line |
After the Step is run, it outputs the given line. No other parameters need to be adjusted. |
Output Description
Select the output item(s) to add the output port(s) to the Step, and the corresponding data will be output after the Step is run. You can select the output according to the actual measurement requirements.
|
If you select an expandable output item, you should expand it by clicking ▶, and then set the Min and Max values to determine the acceptable range. If the output value falls within the acceptable range, the measurement item is judged as passing (OK), or else it is judged as failing (NG). |
| Output item | Description |
|---|---|
Rotation Angle about X-axis |
The angle between the projection of the created line on the YOZ plane and the positive Y-axis. |
Rotation Angle about Y-axis |
The angle between the projection of the created line on the XOZ plane and the positive X-axis. |
Rotation Angle about Z-axis |
The angle between the projection of the created line on the XOY plane and the positive X-axis. |
Created Line |
The line created on the basis of the selected line type, which can be used as an input for other Steps. |
Point X |
The X coordinate of a point on the created line. |
Point Y |
The Y coordinate of a point on the created line. |
Point Z |
The Z coordinate of a point on the created line. |
Included Angle |
The included angle between two planes. Only visible when the “Line Type” is set to “Intersection line of two planes.” |
Troubleshooting
|
CV-W8001
Error: Unable to create a unique line.
Possible cause: The input point is on the input line.
Solution: Ensure the input point is not on the input line.
CV-W8002
Error: The input points are the same point.
Solution: Ensure the input points are two different points.
CV-W8003
Error: Unable to obtain the intersection line.
Possible cause: The input two planes are parallel, and no intersection line can be obtained.
Solution: Ensure the input planes are not parallel.
CV-W8004
Error: The set “Projection Direction” is invalid.
Solution: Select a valid projection direction from the drop-down list.
CV-W8005
Error: Unable to obtain a projected line.
Possible cause: The line to be projected is perpendicular to the input plane, and no projected line cannot be obtained.
Solutions:
-
When the line type is “Projected line on plane,” ensure the line can be projected normally in the selected projection direction to result in a projected line.
-
When the line type is “Projected centerline on plane,” ensure the centerline between two lines is not perpendicular to the input plane.
CV-W8006
Error: Unable to obtain a projected line.
Possible cause: The plane is parallel to the Z-axis, and the projection direction is set to “Parallel to Z-axis.” In this case, no projected line can be obtained.
Solution: When the plane is parallel to the Z-axis, ensure the projection direction is set to “Perpendicular to plane.”