Point-Line Caliper

## Point-Line Caliper

Measures the distance from a point to a straight line.

## Parameter Configuration Description

### Main Interface Parameters
![](/media/202602/2026-02-13_164321_4155850.49897297692468157.png)

### Point Parameters
![](/media/202602/2026-02-13_165515_2460750.3479093892074696.png)

**[Extract Point Type]** Select the method to determine the point: Centroid, Nearest Point, or Farthest Point.

**[Grayscale Threshold]** Set the range for the grayscale threshold.
![](/media/202602/2026-02-13_171824_1729340.15442987177056666.png)

**[Area Filter]** Set the area range for pixels within the specified grayscale threshold.

### Line Parameters
![](/media/202602/2026-02-13_170516_4650180.0015647005365041489.png)

**[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-13_170558_5326250.9287419590352948.png)

**Filtering Parameters:**

**[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.

### Distance Parameters
![](/media/202602/2026-02-13_170649_0201790.9627029650543008.png)

**[Standard Value]** The theoretical target value.

**[Offset Value]** A calibration amount to correct for fixed system errors or process deviations.

**[Lower Deviation]** The maximum allowable amount below the standard value.

**[Upper Deviation]** The maximum allowable amount above the standard value.
*   **Formula:** `Measured Value + Offset Value` must be within `[Standard Value + Lower Deviation, Standard Value + Upper Deviation]`.

**[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/202602/2026-02-11_112623_9470530.7222533323260001.png)

**[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.

**[ROI Count]** Options for one or two ROIs:
*   **One ROI:** When extracting two lines (or a point and a line depending on context), they share the same ROI.
*   **Two ROIs:** The first ROI corresponds to point extraction, and the second ROI corresponds to line extraction.

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

## Output Description
*   **Run Result:** Outputs `True` if successful; outputs `False` if failed.
*   **Distance:** The measured distance from the detected point to the line.
*   **Distance Segment:** The line segment representing the distance from the point to the line.
*   **Output Point:** The detected point.
*   **Line Output:** The detected line.
*   **Line Midpoint:** The midpoint of the detected line.
*   **Skewed Rectangle ROI 1:** The ROI used for detection (Point or shared).
*   **Skewed Rectangle ROI 2:** The ROI used for line detection (if two ROIs are selected).
![](/media/202602/2026-02-13_170747_5476020.8459680810925216.png)

---

Click here to jump to the corresponding Chinese manual page: [Point-Line Caliper](/doc/94)