Extract Quadrilateral

## Extract Quadrilateral

Find edge points that meet the gradient response value, then use the RANSAC algorithm to fit four straight lines.

## Parameter Configuration Description

### Main Interface Parameters
![](/media/202602/2026-02-10_175342_9790810.280608145039557.png)

**[Line Settings]**
*   **Line 1:** Select to configure parameters for Line 1.
*   **Line 2:** Select to configure parameters for Line 2.
*   **Line 3:** Select to configure parameters for Line 3.
*   **Line 4:** Select to configure parameters for Line 4.

**[Gradient Threshold]** The grayscale gradient of the edge position along the scanning direction; points greater than this threshold are retained.
*   For clear images with obvious edges: Set a higher value (>40).
*   For blurry images or indistinct edges: Set a lower value (10-30).
![](/media/202601/tidu_1769762616.png)

**[Line Scanning Direction]** Scan from top to bottom or from bottom to top, indicated by the arrow on the ROI.

**[Line Polarity]**:
*   **Black to White:** Along the rectangular arrow, pointing from a low grayscale area to a high grayscale area.
*   **White to Black:** Along the rectangular arrow, pointing from a high grayscale area to a low grayscale area.
*   **All:** Can detect both black-to-white and white-to-black transitions.
![](/media/202601/jixing_1769766940.png)

**[Fitting Point Selection]**:
*   **All Points:** Use all detected edge points.
*   **Strongest Point:** Use the edge point with the maximum gradient value encountered along the scanning direction.
*   **First Row Points:** Use the first edge point encountered along the scanning direction.
*   **Last Row Points:** Use the last edge point encountered along the scanning direction.
![](/media/202602/拟合点选择_1770083578.png)

**[Line Filtering]**:
*   **Optimal Fit:** Comprehensively considers the best-fitted line.
*   **Most Fitting Points:** The line with the highest number of qualifying fitting points among all fitted lines.
*   **Strongest Fit:** The line with the strongest gradient values for its fitting points among all fitted lines.
*   **First Line:** The first line fitted along the scanning direction.
*   **Last Line:** The last line fitted along the scanning direction.
*   **Specified ID Line:** Filters out the line with the specified ID along the scanning direction.

### Advanced Parameters
![](/media/202602/2026-02-10_175434_9054050.14687503191355578.png)

**Filtering Parameters:**

**[Synchronize Line Modifications]** When checked, modifying the parameters for any one line will automatically update the parameters for the other three lines.

**[Gaussian Filter Threshold]** The σ in the Gaussian function, which can be understood as half the width of the transition region pixels. (A larger value reduces noise impact but blurs edges; a smaller value retains more detail but increases noise impact.)
![](/media/202602/滤波阈值_1770111631.png)

**[Angle Range Relative to ROI]** The allowable deviation angle for the fitted line relative to the ROI. As shown in the figure below, if the "Angle Range Relative to ROI" is set to 16, and the difference between the Line Angle and ROI Angle is 9 (which is within 16), the line is considered valid.
![](/media/202602/与 ROI 角度_1770110521.png)

**[Sampling Points Count]** The number of uniform divisions perpendicular to the ROI scanning line direction.
![](/media/202602/采样点数_1770016300.png)

**[Sampling Point Width]** Based on the center points divided evenly by the sampling points count, take the sampling point width to form small rectangular regions. Calculate and judge along the scanning direction within these small rectangular regions to check for qualifying edge points.
![](/media/202602/采样点宽度_1770017004.png)

**[Fitting Points Count]** The minimum number of fitting points required for line fitting. If the count is less than this value, the fitting is considered failed. As shown in the figure below, with the fitting points count set to 5, there are a total of 6 points marked by white circles.
![](/media/202602/最少拟合点数_1770111223.png)

**[Distance Threshold]** Edge points whose perpendicular distance to the fitted line is less than this value will be used for line fitting. As shown in the figure below, detected edge points with a distance to the line less than the distance threshold are displayed in blue, while those greater than the threshold are displayed in red.
![](/media/202602/距离阈值_1770630645.png)

**[Maximum Iterations]** The maximum number of iterations required. If a line meeting the conditions is fitted early, the fitting process can stop prematurely.

**[Iterations Without Improvement]** Stop iteration if the line fitting effect does not continue to improve during the fitting process.

**[Score Threshold]** The final score used to judge the line. If the score is less than this threshold, the fitting is considered failed. The range is 0-1. The score is calculated by summing the perpendicular distances from all edge points to the fitted line; the smaller the sum, the higher the score. When all fitting points lie exactly on the fitted line, the score is 1.

**Other Parameters:**

**[Size Conversion]**
*   **Disable:** No size conversion is performed.
*   **Scale:** Manually enter a value to convert image coordinates to real-world coordinates.
*   **Calibration:** Connect to calibration data to convert image coordinates to real-world coordinates.

### ROI Settings
![](/media/202601//1767686688.3281448.png)

**[ROI Type]** The default ROI type for the detection area is a Skewed Rectangle.

**[ROI Source]**
*   **Manual ROI:** Allows manual dragging of the ROI position and size in the window.
*   **Referenced ROI:** Allows connecting to an external ROI via a port.

**[Position Correction]** Selecting pose correction allows connection to a coordinate system, enabling the ROI area to move with the coordinate system.

**[Position Adjustment]** Adjust the position and size of the ROI.

### Mask Settings
![](/media/202602/掩膜设置_1770632097.png)

**[Mask Enable]**
*   **Disable:** The mask will not take effect.
*   **Enable:** The mask takes effect.

**[Mask Type]**
*   **Exclude Mask:** Do not detect areas within the mask.
*   **Include Mask:** Only detect areas within the mask.

**[Mask Source]**
*   **Manual Mask:** Allows editing the mask using brushes, shapes, etc., to draw the mask area.
*   **Referenced Mask:** Allows connecting to existing ports to import port data and automatically draw the mask area.

## Output Description
*   **Run Result:** Outputs `True` if successful; outputs `False` if failed.
*   **Center Point:** The center point of the quadrilateral formed by the four detected lines.
*   **Vertex 1-2:** The intersection point of Line 1 and Line 2.
*   **Vertex 2-3:** The intersection point of Line 2 and Line 3.
*   **Vertex 3-4:** The intersection point of Line 3 and Line 4.
*   **Vertex 4-1:** The intersection point of Line 4 and Line 1.
*   **Angle 1-2:** The included angle between Line 1 and Line 2.
*   **Angle 2-3:** The included angle between Line 2 and Line 3.
*   **Angle 3-4:** The included angle between Line 3 and Line 4.
*   **Angle 4-1:** The included angle between Line 4 and Line 1.
*   **Line 1 Angle:** The angle of the detected Line 1.
*   **Line 2 Angle:** The angle of the detected Line 2.
*   **Line 3 Angle:** The angle of the detected Line 3.
*   **Line 4 Angle:** The angle of the detected Line 4.
*   **Line 1:** The detected Line 1.
*   **Line 2:** The detected Line 2.
*   **Line 3:** The detected Line 3.
*   **Line 4:** The detected Line 4.
*   **Skewed Rectangle ROI 1:** The ROI used for detecting Line 1.
*   **Skewed Rectangle ROI 2:** The ROI used for detecting Line 2.
*   **Skewed Rectangle ROI 3:** The ROI used for detecting Line 3.
*   **Skewed Rectangle ROI 4:** The ROI used for detecting Line 4.
*   **Mask Area 1:** Output Mask 1.
*   **Mask Area 2:** Output Mask 2.
*   **Mask Area 3:** Output Mask 3.
*   **Mask Area 4:** Output Mask 4.
![](/media/202602/2026-02-10_175752_0488740.1977279399522074.png)

---

Click here to jump to the corresponding Chinese manual page: [Extract Quadrilateral](/doc/93)