二维测量
用于卡尺、拟合、交点和几何量测,输出亚像素位置与尺寸。
圆弧卡尺边缘
ArcCaliperEdge · 可执行
在圆弧卡尺区域中沿径向搜索最强边缘并输出亚像素位置。
签名
var edge = ArcCaliperEdge(angularSampleCount: 9, centerX: 60, centerY: 40, endAngleDegrees: 90, maximumTangentialStepPixels: 1, minimumContrast: 30, nominalRadiusPixels: 50, polarity: "Any", searchLength: 15, selection: "Strongest", smoothingKernel: 3, startAngleDegrees: 0);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
centerXdouble- 圆弧中心 X 坐标。
centerYdouble- 圆弧中心 Y 坐标。
nominalRadiusPixelsdouble- 标称半径像素值。
searchLengthint- 径向搜索长度,必须为奇数。
startAngleDegreesdouble- 起始角度。
endAngleDegreesdouble- 结束角度。
angularSampleCountint- 角度方向采样数,必须为奇数。
maximumTangentialStepPixelsdouble- 最大半径处切向采样步长上限。
smoothingKernelint- 平滑核大小,必须为奇数。
polaritystring- 边缘极性筛选。
selectionstring- 边缘选择策略。
minimumContrastdouble- 边缘最小对比度。
输出
outputImage- 在圆弧卡尺区域绘制边缘位置的彩色图像。
measurements量测值集合- 键为 edgeX/edgeY/edgeAngleDegrees/contrast/found/radiusPixels。
行为
- 沿圆弧径向投影并计算一维导数。
- 在亚像素精度上定位最强边缘。
- 未找到边缘时 found=0,其他值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
圆弧卡尺边缘对
ArcCaliperEdgePair · 可执行
在圆弧卡尺区域中沿径向搜索一对边缘并输出间距测量。
签名
var pair = ArcCaliperEdgePair(angularSamples: 9, centerX: 60, centerY: 40, maximumSeparationPixels: 20, minimumContrast: 30, minimumSeparationPixels: 5, nominalRadiusPixels: 50, objectPolarity: "BrightObject", radialSearchLength: 15, selection: "First", smoothingKernel: 3, startAngleDegrees: 0, sweepAngleDegrees: 90);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
centerXdouble- 圆弧中心 X 坐标。
centerYdouble- 圆弧中心 Y 坐标。
nominalRadiusPixelsdouble- 标称半径像素值。
startAngleDegreesdouble- 起始角度。
sweepAngleDegreesdouble- 有向扫角。
radialSearchLengthint- 径向搜索长度,必须为奇数。
angularSamplesint- 角度采样数。
smoothingKernelint- 平滑核大小,必须为奇数。
objectPolaritystring- 物体极性。
minimumContrastdouble- 边缘最小对比度。
minimumSeparationPixelsdouble- 边缘对最小间距。
maximumSeparationPixelsdouble- 边缘对最大间距。
selectionstring- 边缘选择策略。
输出
outputImage- 在圆弧卡尺区域绘制边缘对位置的彩色图像。
measurements量测值集合- 键为 edge1X/edge1Y/edge1Contrast/edge2X/edge2Y/edge2Contrast/separationPixels/foundPair。
行为
- 沿圆弧径向搜索一对边缘。
- 输出每对边缘的间距测量。
- 未找到有效边缘对时 foundPair=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
折线弧长
ArcLengthCurve · 可执行
计算由顶点序列定义的开放或闭合折线的总弧长。
签名
var length = ArcLengthCurve(closed: true, polylineVertexCount: 4);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
polylineVertexCountstring- 折线顶点数枚举。
closedbool- 是否为闭合折线(末点连回起点)。
输出
arcLengthdouble- 折线总弧长。
行为
- 计算折线所有相邻顶点的欧几里得距离之和。
- closed=true 时包含末点到起点的距离。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
连通轮廓面积筛选
Blob · 可执行
从二值化结果的外轮廓中按面积范围筛选目标,并汇总数量和面积。
签名
var blobs = Blob(maxArea: 5000, minArea: 25);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
minAreadouble- 保留轮廓的最小面积。
maxAreadouble- 保留轮廓的最大面积。
输出
outputImage- 在保留轮廓包围框上绘制标记的彩色图像。
measurements量测值集合- 键为 count 与 totalArea。
行为
- 先将输入转换为二值图,再按 External/ApproxSimple 提取轮廓。
- 只累计位于闭区间 [minArea,maxArea] 的轮廓。
- 无命中时 count 和 totalArea 均为 0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
多边形轴对齐包围框面积
BoundingRectArea · 可执行
计算多边形顶点集的轴对齐包围框面积。
签名
var result = BoundingRectArea(polygonVertexCount: 4);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
polygonVertexCountstring- 多边形顶点数枚举。
输出
resultdouble- 计算结果。
行为
- 按顶点坐标计算轴对齐包围框面积。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
直线卡尺边缘
CaliperEdge · 可执行
在旋转矩形卡尺区域中沿长度方向搜索最强边缘并输出亚像素位置。
签名
var edge = CaliperEdge(angleDegrees: 0, centerX: 60, centerY: 40, length: 31, minimumContrast: 30, polarity: "Any", smoothingKernel: 3, width: 5);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
centerXdouble- 卡尺中心 X 坐标。
centerYdouble- 卡尺中心 Y 坐标。
lengthint- 卡尺沿边缘方向的长度,必须为奇数。
widthint- 卡尺垂直边缘方向的宽度,必须为奇数。
angleDegreesdouble- 卡尺旋转角度。
polaritystring- 边缘极性筛选。
minimumContrastdouble- 边缘最小对比度。
smoothingKernelint- 平滑核大小,必须为奇数。
输出
outputImage- 在卡尺区域绘制边缘位置的彩色图像。
measurements量测值集合- 键为 edgeX/edgeY/edgeAngleDegrees/contrast/found。
行为
- 沿卡尺长度方向投影并计算一维导数。
- 在亚像素精度上定位最强边缘。
- 未找到边缘时 found=0,其他值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
直线卡尺边缘对
CaliperEdgePair · 可执行
在旋转矩形卡尺区域中沿长度方向搜索一对边缘并输出间距测量。
签名
var pair = CaliperEdgePair(angleDegrees: 0, centerX: 60, centerY: 40, length: 31, minimumContrast: 30, minimumSeparationPixels: 5, polarity: "Any", smoothingKernel: 3, width: 5);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
centerXdouble- 卡尺中心 X 坐标。
centerYdouble- 卡尺中心 Y 坐标。
lengthint- 卡尺沿边缘方向的长度,必须为奇数。
widthint- 卡尺垂直边缘方向的宽度,必须为奇数。
angleDegreesdouble- 卡尺旋转角度。
polaritystring- 边缘极性。
minimumContrastdouble- 边缘最小对比度。
minimumSeparationPixelsdouble- 边缘对最小间距。
smoothingKernelint- 平滑核大小,必须为奇数。
输出
outputImage- 在卡尺区域绘制边缘对位置的彩色图像。
measurements量测值集合- 键为 edge1X/edge1Y/edge1Contrast/edge2X/edge2Y/edge2Contrast/separationPixels/foundPair。
行为
- 沿卡尺长度方向投影并搜索一对边缘。
- 输出边缘对间距测量。
- 未找到有效边缘对时 foundPair=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
多边形形心
Centroid · 可执行
计算多边形的形心(几何中心)。
签名
var result = Centroid(polygonVertexCount: 4);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
polygonVertexCountstring- 多边形顶点数枚举。
输出
resultdouble- 计算结果。
行为
- 按顶点坐标计算多边形形心。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
两圆公切线
CircleCircleCommonTangents · 可执行
计算两个圆之间的所有公切线(内外公切线)。
签名
var tangents = CircleCircleCommonTangents(circle1CenterX: 50, circle1CenterY: 50, circle1RadiusPixels: 20, circle2CenterX: 80, circle2CenterY: 50, circle2RadiusPixels: 15);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
circle1CenterXdouble- 圆 1 中心 X。
circle1CenterYdouble- 圆 1 中心 Y。
circle1RadiusPixelsdouble- 圆 1 半径。
circle2CenterXdouble- 圆 2 中心 X。
circle2CenterYdouble- 圆 2 中心 Y。
circle2RadiusPixelsdouble- 圆 2 半径。
输出
countint- 公切线数量 (0–4)。
tangent1StartXdouble- 切线 1 起点 X。
tangent1StartYdouble- 切线 1 起点 Y。
tangent1EndXdouble- 切线 1 终点 X。
tangent1EndYdouble- 切线 1 终点 Y。
行为
- 计算两圆之间的所有内外公切线。
- 根据两圆位置关系返回 0–4 条切线。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
圆与圆交点
CircleCircleIntersections · 可执行
计算两个圆的交点坐标。
签名
var points = CircleCircleIntersections(circle1CenterX: 50, circle1CenterY: 50, circle1RadiusPixels: 30, circle2CenterX: 80, circle2CenterY: 50, circle2RadiusPixels: 30);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
circle1CenterXdouble- 圆 1 中心 X。
circle1CenterYdouble- 圆 1 中心 Y。
circle1RadiusPixelsdouble- 圆 1 半径。
circle2CenterXdouble- 圆 2 中心 X。
circle2CenterYdouble- 圆 2 中心 Y。
circle2RadiusPixelsdouble- 圆 2 半径。
输出
intersection1Xdouble- 第一个交点 X。
intersection1Ydouble- 第一个交点 Y。
intersection2Xdouble- 第二个交点 X。
intersection2Ydouble- 第二个交点 Y。
countint- 交点数量 (0/1/2)。
行为
- 计算两个圆的几何交点。
- 内含或相离时 count=0。
- 相切时两个交点相同。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
凸多边形距离
ConvexPolygonDistance · 可执行
计算两个凸多边形之间的最短距离。
签名
var distance = ConvexPolygonDistance(polygon1VertexCount: 3, polygon2VertexCount: 3);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
polygon1VertexCountstring- 多边形 1 顶点数枚举。
polygon2VertexCountstring- 多边形 2 顶点数枚举。
输出
distancePixelsdouble- 两凸多边形之间的最短距离。
行为
- 计算两个凸多边形之间的最短欧几里得距离。
- 相交时 distance=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
距离变换
DistanceMap · 可执行
对二值图像执行距离变换,输出每个前景像素到最近背景的距离。
签名
var distanceImage = DistanceMap(distanceType: "L2", maskSize: "PRECISE", thresholdPixels: 128);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
distanceTypestring- 距离类型。
maskSizestring- 距离变换掩码大小。
thresholdPixelsdouble- 二值化阈值。
输出
outputImage- 距离变换后的灰度图像(每个像素值为到最近背景的距离)。
行为
- 先将输入图像按阈值二值化。
- 对二值图像计算距离图。
- 前景像素的距离值为正,背景为 0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
椭圆轴长
EllipseAxes · 可执行
计算椭圆的主轴和次轴长度、焦点坐标和离心率。
签名
var axes = EllipseAxes(ellipseAngleDegrees: 0, ellipseCenterX: 60, ellipseCenterY: 40, semiMajorAxisPixels: 40, semiMinorAxisPixels: 20);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
ellipseCenterXdouble- 椭圆中心 X。
ellipseCenterYdouble- 椭圆中心 Y。
semiMajorAxisPixelsdouble- 椭圆半长轴。
semiMinorAxisPixelsdouble- 椭圆半短轴。
ellipseAngleDegreesdouble- 椭圆旋转角度。
输出
majorAxisPixelsdouble- 主轴全长 (2×半长轴)。
minorAxisPixelsdouble- 次轴全长 (2×半短轴)。
eccentricitydouble- 离心率 (0=圆, 1=抛物线)。
focalDistancePixelsdouble- 焦距。
行为
- 从中心、半轴和角度计算椭圆几何属性。
- 半长轴必须大于等于半短轴。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
直线与椭圆交点
EllipseLineIntersections · 可执行
计算无限直线与椭圆的交点坐标。
签名
var points = EllipseLineIntersections(ellipseAngleDegrees: 0, ellipseCenterX: 60, ellipseCenterY: 40, lineEndX: 150, lineEndY: 50, lineStartX: 50, lineStartY: 50, minimumLineLengthPixels: 5, semiMajorAxisPixels: 40, semiMinorAxisPixels: 20);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
lineStartXdouble- 直线起点 X。
lineStartYdouble- 直线起点 Y。
lineEndXdouble- 直线终点 X。
lineEndYdouble- 直线终点 Y。
ellipseCenterXdouble- 椭圆中心 X 坐标。
ellipseCenterYdouble- 椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble- 椭圆半长轴。
semiMinorAxisPixelsdouble- 椭圆半短轴。
ellipseAngleDegreesdouble- 椭圆旋转角度。
minimumLineLengthPixelsdouble- 直线最小长度。
输出
intersection1Xdouble- 第一个交点 X 坐标。
intersection1Ydouble- 第一个交点 Y 坐标。
intersection2Xdouble- 第二个交点 X 坐标。
intersection2Ydouble- 第二个交点 Y 坐标。
countint- 交点数量 (0/1/2)。
行为
- 计算无限直线与椭圆的几何交点。
- 椭圆方程由中心、半轴和旋转角度定义。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
Feret 直径
FeretDiameters · 可执行
从轮廓点集计算最小和最大 Feret 直径(卡钳直径)。
签名
var feret = FeretDiameters(maximumPoints: 2000, minimumContourArea: 25);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
minimumContourAreadouble- 有效轮廓的最小面积。
maximumPointsint- 从最大有效轮廓提取的最大点数。
输出
outputImage- 在轮廓上绘制最小/最大 Feret 直径的彩色图像。
measurements量测值集合- 键为 minFeretPixels/maxFeretPixels/minFeretAngleDegrees/maxFeretAngleDegrees。
行为
- 从最大有效轮廓提取点集并计算凸包。
- 使用旋转卡钳法计算最小和最大 Feret 直径。
- 无有效轮廓时所有值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
轮廓圆拟合
FitCircle · 可执行
使用归一化 Kasa 代数法拟合圆并输出半径、圆心和质量指标。
签名
var circle = FitCircle(maximumPoints: 2000, maximumRadiusPixels: 5000, method: "KasaAlgebraic", minimumConditionRatio: 1e-12, minimumContourArea: 25, minimumRadiusPixels: 0.000001, requireCenterInsideImage: false);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
methodstring- 圆拟合方法。
maximumPointsint- 从最大有效轮廓提取的最大点数。
minimumContourAreadouble- 有效轮廓的最小面积。
minimumConditionRatiodouble- 最小条件数比率,用于剔除退化点集。
minimumRadiusPixelsdouble- 有效拟合的最小半径。
maximumRadiusPixelsdouble- 有效拟合的最大半径。
requireCenterInsideImagebool- 要求拟合圆心位于图像边界内。
输出
outputImage- 在拟合圆上绘制标记的彩色图像。
measurements量测值集合- 键为 centerX/centerY/radiusPixels/sigmaMeanResidual/conditionNumber/pointsUsed。
行为
- 从最大有效轮廓提取亚像素点集。
- 使用归一化 Kasa 代数法进行圆拟合。
- 无有效轮廓时所有测量值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
轮廓椭圆拟合
FitEllipse · 可执行
使用 Standard、AMS 或 Direct 方法拟合椭圆并输出质量指标。
签名
var ellipse = FitEllipse(maximumAxisPixels: 5000, maximumPoints: 2000, method: "Standard", minimumAxisPixels: 0.000001, minimumConditionRatio: 1e-12, minimumContourArea: 25, requireCenterInsideImage: false);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
methodstring- 椭圆拟合方法。
maximumPointsint- 从最大有效轮廓提取的最大点数。
minimumContourAreadouble- 有效轮廓的最小面积。
minimumConditionRatiodouble- 最小条件数比率,用于剔除退化点集。
minimumAxisPixelsdouble- 有效拟合的最小轴长。
maximumAxisPixelsdouble- 有效拟合的最大轴长。
requireCenterInsideImagebool- 要求拟合椭圆中心位于图像边界内。
输出
outputImage- 在拟合椭圆上绘制标记的彩色图像。
measurements量测值集合- 键为 centerX/centerY/semiMajorPixels/semiMinorPixels/angleDegrees/sigmaMeanResidual/conditionNumber/pointsUsed。
行为
- 从最大有效轮廓提取亚像素点集。
- 按所选方法进行椭圆拟合。
- 无有效轮廓时所有测量值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
轮廓直线拟合
FitLine · 可执行
从最大有效轮廓拟合直线并输出残差、跨度和方向质量指标。
签名
var line = FitLine(maximumPoints: 2000, minimumContourArea: 25, minimumSpanPixels: 0.000001);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
maximumPointsint- 从最大有效轮廓提取的最大点数。
minimumContourAreadouble- 有效轮廓的最小面积。
minimumSpanPixelsdouble- 有效轮廓的最小跨度。
输出
outputImage- 在拟合直线上绘制箭头的彩色图像。
measurements量测值集合- 键为 startX/startY/endX/endY/angleDegrees/sigmaMeanResidual/spanPixels/lengthPixels。
行为
- 从最大有效轮廓提取亚像素点集。
- 以加权正交回归拟合直线。
- 无有效轮廓时所有测量值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
直线与圆交点
LineCircleIntersections · 可执行
计算无限直线与圆的交点坐标。
签名
var points = LineCircleIntersections(circleCenterX: 60, circleCenterY: 40, lineEndX: 150, lineEndY: 50, lineStartX: 50, lineStartY: 50, minimumLineLengthPixels: 5, radiusPixels: 30);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
lineStartXdouble- 直线起点 X。
lineStartYdouble- 直线起点 Y。
lineEndXdouble- 直线终点 X。
lineEndYdouble- 直线终点 Y。
circleCenterXdouble- 圆心 X 坐标。
circleCenterYdouble- 圆心 Y 坐标。
radiusPixelsdouble- 圆的半径。
minimumLineLengthPixelsdouble- 直线最小长度。
输出
intersection1Xdouble- 第一个交点 X 坐标。
intersection1Ydouble- 第一个交点 Y 坐标。
intersection2Xdouble- 第二个交点 X 坐标。
intersection2Ydouble- 第二个交点 Y 坐标。
countint- 交点数量 (0/1/2)。
行为
- 计算无限直线与圆的几何交点。
- 相切时两个交点相同。
- 不相交时 count=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
拟合线交点
LineIntersection · 可执行
从两个有效轮廓分别拟合无限直线并计算交点和夹角。
签名
var result = LineIntersection(maximumPoints: 2000, minimumContourArea: 25, minimumSpanPixels: 0.000001, parallelToleranceDegrees: 1, requireIntersectionInsideImage: false);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
maximumPointsint- 每个轮廓提取的最大点数。
minimumContourAreadouble- 有效轮廓的最小面积。
minimumSpanPixelsdouble- 有效轮廓的最小跨度。
parallelToleranceDegreesdouble- 判定两线平行时的容差角度。
requireIntersectionInsideImagebool- 要求交点位于图像边界内。
输出
outputImage- 在两拟合线上绘制标记的彩色图像。
measurements量测值集合- 键为 intersectionX/intersectionY/angleDegrees/isParallel。
行为
- 分别从两个最大有效轮廓拟合无限直线。
- 计算两线夹角和交点。
- 平行时 angleDegrees=0, intersectionX/Y 为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
两直线夹角
LineLineAngle · 可执行
计算两条由两点定义的无限直线的夹角。
签名
var angle = LineLineAngle(line1EndX: 150, line1EndY: 100, line1StartX: 50, line1StartY: 100, line2EndX: 100, line2EndY: 150, line2StartX: 100, line2StartY: 50, minimumLineLengthPixels: 5);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
line1StartXdouble- 直线 1 起点 X。
line1StartYdouble- 直线 1 起点 Y。
line1EndXdouble- 直线 1 终点 X。
line1EndYdouble- 直线 1 终点 Y。
line2StartXdouble- 直线 2 起点 X。
line2StartYdouble- 直线 2 起点 Y。
line2EndXdouble- 直线 2 终点 X。
line2EndYdouble- 直线 2 终点 Y。
minimumLineLengthPixelsdouble- 直线最小长度。
输出
acuteAngleDegreesdouble- 锐角 (0–90°)。
obtuseAngleDegreesdouble- 钝角 (90–180°)。
行为
- 计算两条无限直线之间的夹角。
- 平行时 acuteAngle=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
线段角度
LineSegmentAngle · 可执行
计算有限线段相对于参考轴的角度。
签名
var angle = LineSegmentAngle(endX: 150, endY: 100, minimumSegmentLengthPixels: 5, referenceAxisDegrees: 0, startX: 50, startY: 100);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
startXdouble- 线段起点 X。
startYdouble- 线段起点 Y。
endXdouble- 线段终点 X。
endYdouble- 线段终点 Y。
referenceAxisDegreesdouble- 参考轴角度。
minimumSegmentLengthPixelsdouble- 线段最小长度。
输出
angleDegreesdouble- 线段与参考轴的夹角。
行为
- 计算有限线段的方向角度。
- 角度相对于参考轴测量。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
线段与圆交点
LineSegmentCircleIntersections · 可执行
计算有限线段与圆的交点坐标。
签名
var points = LineSegmentCircleIntersections(circleCenterX: 60, circleCenterY: 40, circleRadiusPixels: 30, minimumSegmentLengthPixels: 5, segmentEndX: 150, segmentEndY: 50, segmentStartX: 50, segmentStartY: 50);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
segmentStartXdouble- 线段起点 X。
segmentStartYdouble- 线段起点 Y。
segmentEndXdouble- 线段终点 X。
segmentEndYdouble- 线段终点 Y。
circleCenterXdouble- 圆心 X 坐标。
circleCenterYdouble- 圆心 Y 坐标。
circleRadiusPixelsdouble- 圆的半径。
minimumSegmentLengthPixelsdouble- 线段最小长度。
输出
intersection1Xdouble- 第一个交点 X 坐标。
intersection1Ydouble- 第一个交点 Y 坐标。
intersection2Xdouble- 第二个交点 X 坐标。
intersection2Ydouble- 第二个交点 Y 坐标。
countint- 交点数量 (0/1/2)。
行为
- 计算有限线段与圆的几何交点。
- 交点必须在线段范围内。
- 不相交时 count=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
线段间距
LineSegmentDistance · 可执行
计算两条有限线段之间的最短距离。
签名
var distance = LineSegmentDistance(minimumSegmentLengthPixels: 5, segment1EndX: 150, segment1EndY: 100, segment1StartX: 50, segment1StartY: 100, segment2EndX: 100, segment2EndY: 150, segment2StartX: 100, segment2StartY: 50);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
segment1StartXdouble- 线段 1 起点 X。
segment1StartYdouble- 线段 1 起点 Y。
segment1EndXdouble- 线段 1 终点 X。
segment1EndYdouble- 线段 1 终点 Y。
segment2StartXdouble- 线段 2 起点 X。
segment2StartYdouble- 线段 2 起点 Y。
segment2EndXdouble- 线段 2 终点 X。
segment2EndYdouble- 线段 2 终点 Y。
minimumSegmentLengthPixelsdouble- 线段最小长度。
输出
distancePixelsdouble- 两条线段之间的最短距离。
行为
- 计算两条有限线段之间的最短欧几里得距离。
- 相交时 distance=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
线段与椭圆交点
LineSegmentEllipseIntersections · 可执行
计算有限线段与椭圆的交点坐标。
签名
var points = LineSegmentEllipseIntersections(ellipseAngleDegrees: 0, ellipseCenterX: 60, ellipseCenterY: 40, endX: 150, endY: 50, minimumSegmentLengthPixels: 5, semiMajorAxisPixels: 40, semiMinorAxisPixels: 20, startX: 50, startY: 50);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
startXdouble- 线段起点 X。
startYdouble- 线段起点 Y。
endXdouble- 线段终点 X。
endYdouble- 线段终点 Y。
ellipseCenterXdouble- 椭圆中心 X 坐标。
ellipseCenterYdouble- 椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble- 椭圆半长轴。
semiMinorAxisPixelsdouble- 椭圆半短轴。
ellipseAngleDegreesdouble- 椭圆旋转角度。
minimumSegmentLengthPixelsdouble- 线段最小长度。
输出
intersection1Xdouble- 第一个交点 X 坐标。
intersection1Ydouble- 第一个交点 Y 坐标。
intersection2Xdouble- 第二个交点 X 坐标。
intersection2Ydouble- 第二个交点 Y 坐标。
countint- 交点数量 (0/1/2)。
行为
- 计算有限线段与椭圆的几何交点。
- 交点必须在线段范围内。
- 不相交时 count=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
线段交点
LineSegmentIntersection · 可执行
计算两条有限线段的交点坐标。
签名
var result = LineSegmentIntersection(minimumSegmentLengthPixels: 5, segment1EndX: 150, segment1EndY: 100, segment1StartX: 50, segment1StartY: 100, segment2EndX: 100, segment2EndY: 150, segment2StartX: 100, segment2StartY: 50);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
segment1StartXdouble- 线段 1 起点 X。
segment1StartYdouble- 线段 1 起点 Y。
segment1EndXdouble- 线段 1 终点 X。
segment1EndYdouble- 线段 1 终点 Y。
segment2StartXdouble- 线段 2 起点 X。
segment2StartYdouble- 线段 2 起点 Y。
segment2EndXdouble- 线段 2 终点 X。
segment2EndYdouble- 线段 2 终点 Y。
minimumSegmentLengthPixelsdouble- 线段最小长度。
输出
intersectionXdouble- 交点 X 坐标。
intersectionYdouble- 交点 Y 坐标。
intersectbool- 线段是否相交。
行为
- 计算两条有限线段的交点。
- 平行或不相交时 intersect=false, 坐标为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
夹角测量
MeasureAngle · 可执行
以给定顶点和两条射线计算夹角,并输出锐角/钝角/有符号角。
签名
var angle = MeasureAngle(minimumRayLengthPixels: 5, minimumSineMagnitude: 0.001, ray1X: 50, ray1Y: 100, ray2X: 150, ray2Y: 100, vertexX: 100, vertexY: 100);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
vertexXdouble- 顶点的 X 坐标。
vertexYdouble- 顶点的 Y 坐标。
ray1Xdouble- 射线 1 上任意点的 X 坐标。
ray1Ydouble- 射线 1 上任意点的 Y 坐标。
ray2Xdouble- 射线 2 上任意点的 X 坐标。
ray2Ydouble- 射线 2 上任意点的 Y 坐标。
minimumRayLengthPixelsdouble- 从顶点到射线点的最小距离,用于防止退化。
minimumSineMagnitudedouble- 两射线方向向量叉积幅值下限,用于防止接近平行或退化。
输出
acuteAngleDegreesdouble- 锐角 (0-90度)。
obtuseAngleDegreesdouble- 钝角 (90-180度)。
signedAngleDegreesdouble- 有符号角 (-180-180度)。
isRay1Ray2Degeneratebool- 射线是否退化。
行为
- 计算 vertex->ray1 与 vertex->ray2 两个方向向量。
- 输出锐角、钝角和有符号角三种结果。
- 当射线退化或平行时 isRay1Ray2Degenerate=true。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
两点距离
MeasureDistance · 可执行
计算两点间像素距离,并按比例系数换算距离。
签名
var distance = MeasureDistance(x1: 0, x2: 100, y1: 0, y2: 0, scale: 1);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
x1double- 第一个点的 X 坐标。
y1double- 第一个点的 Y 坐标。
x2double- 第二个点的 X 坐标。
y2double- 第二个点的 Y 坐标。
scaledouble- 像素到真实物理单位的换算系数。
输出
pixelsdouble- 像素距离。
distancedouble- 换算后的物理距离 (= pixels * scale)。
行为
- 计算 (x1,y1) 与 (x2,y2) 之间的欧几里得距离。
- 不修改输入图像。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
最小面积外接矩形
MinAreaRectangle · 可执行
从最大有效轮廓计算最小面积外接旋转矩形。
签名
var rect = MinAreaRectangle(maximumPoints: 2000, minimumContourArea: 25);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
minimumContourAreadouble- 有效轮廓的最小面积。
maximumPointsint- 从最大有效轮廓提取的最大点数。
输出
outputImage- 在轮廓上绘制最小面积外接矩形的彩色图像。
measurements量测值集合- 键为 centerX/centerY/widthPixels/heightPixels/angleDegrees/areaPx2。
行为
- 从最大有效轮廓提取点集。
- 计算最小面积外接旋转矩形。
- 无有效轮廓时所有值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
最小包围圆
MinEnclosingCircle · 可执行
从最大有效轮廓计算最小面积外接圆。
签名
var circle = MinEnclosingCircle(maximumPoints: 2000, minimumContourArea: 25);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
minimumContourAreadouble- 有效轮廓的最小面积。
maximumPointsint- 从最大有效轮廓提取的最大点数。
输出
outputImage- 在轮廓上绘制最小包围圆的彩色图像。
measurements量测值集合- 键为 centerX/centerY/radiusPixels/areaPx2。
行为
- 从最大有效轮廓提取点集。
- 计算最小包围圆。
- 无有效轮廓时所有值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
最小包围三角形
MinimumEnclosingTriangle · 可执行
从最大有效轮廓计算最小面积外接三角形。
签名
var triangle = MinimumEnclosingTriangle(maximumPoints: 2000, minimumContourArea: 25);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
minimumContourAreadouble- 有效轮廓的最小面积。
maximumPointsint- 从最大有效轮廓提取的最大点数。
输出
outputImage- 在轮廓上绘制最小包围三角形的彩色图像。
measurements量测值集合- 键为 vertex1X/vertex1Y/vertex2X/vertex2Y/vertex3X/vertex3Y/areaPx2。
行为
- 从最大有效轮廓提取点集。
- 计算最小面积外接三角形。
- 无有效轮廓时所有值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到圆距离
PointCircleDistance · 可执行
计算指定点到圆周的最近距离。
签名
var distance = PointCircleDistance(circleCenterX: 60, circleCenterY: 40, pointX: 100, pointY: 50, radiusPixels: 30);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
circleCenterXdouble- 圆心 X 坐标。
circleCenterYdouble- 圆心 Y 坐标。
radiusPixelsdouble- 圆的半径。
输出
distancePixelsdouble- 点到圆周的最近距离。
nearestXdouble- 圆周上最近点的 X 坐标。
nearestYdouble- 圆周上最近点的 Y 坐标。
行为
- 计算点到圆周的最短距离。
- 点在圆内时距离为负(有符号)。
- 点与圆心重合时方向不唯一。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到圆切线
PointCircleTangents · 可执行
计算从指定点到圆的两条切线。
签名
var tangents = PointCircleTangents(circleCenterX: 60, circleCenterY: 40, pointX: 100, pointY: 80, radiusPixels: 20);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
circleCenterXdouble- 圆心 X 坐标。
circleCenterYdouble- 圆心 Y 坐标。
radiusPixelsdouble- 圆的半径。
输出
countint- 切线数量 (0/1/2)。
tangent1PointXdouble- 切线 1 切点 X。
tangent1PointYdouble- 切线 1 切点 Y。
tangent2PointXdouble- 切线 2 切点 X。
tangent2PointYdouble- 切线 2 切点 Y。
行为
- 计算从点到圆的切线。
- 点在圆内时 count=0。
- 点在圆上时 count=1。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到轮廓距离
PointContourDistance · 可执行
计算指定点到最大有效轮廓的有符号或无符号距离。
签名
var distance = PointContourDistance(maximumPoints: 2000, minimumContourArea: 25, pointX: 60, pointY: 40, signedDistance: true);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
signedDistancebool- 是否返回有符号距离(内正外负)。
minimumContourAreadouble- 有效轮廓的最小面积。
maximumPointsint- 从最大有效轮廓提取的最大点数。
输出
outputImage- 在轮廓和点上绘制距离标记的彩色图像。
measurements量测值集合- 键为 distancePixels/signedDistancePixels。
行为
- 从最大有效轮廓提取点集。
- 计算点到轮廓的有符号或无符号距离。
- 无有效轮廓时值为 NaN。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到椭圆距离
PointEllipseDistance · 可执行
计算指定点到椭圆边界的最短距离(迭代法)。
签名
var distance = PointEllipseDistance(convergenceTolerancePixels: 0.01, ellipseAngleDegrees: 0, ellipseCenterX: 60, ellipseCenterY: 40, maximumIterations: 100, pointX: 100, pointY: 50, semiMajorAxisPixels: 40, semiMinorAxisPixels: 20);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
ellipseCenterXdouble- 椭圆中心 X。
ellipseCenterYdouble- 椭圆中心 Y。
semiMajorAxisPixelsdouble- 椭圆半长轴。
semiMinorAxisPixelsdouble- 椭圆半短轴。
ellipseAngleDegreesdouble- 椭圆旋转角度。
convergenceTolerancePixelsdouble- 迭代收敛容差。
maximumIterationsint- 最大迭代次数。
输出
distancePixelsdouble- 点到椭圆边界的最近距离。
nearestXdouble- 椭圆上最近点 X 坐标。
nearestYdouble- 椭圆上最近点 Y 坐标。
行为
- 使用迭代法计算点到椭圆边界的最短距离。
- 点在椭圆内时距离为负。
- 收敛失败时返回当前迭代值。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到椭圆切线
PointEllipseTangents · 可执行
计算从指定点到椭圆的两条切线。
签名
var tangents = PointEllipseTangents(ellipseAngleDegrees: 0, ellipseCenterX: 60, ellipseCenterY: 40, pointX: 100, pointY: 80, semiMajorAxisPixels: 40, semiMinorAxisPixels: 20);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
ellipseCenterXdouble- 椭圆中心 X。
ellipseCenterYdouble- 椭圆中心 Y。
semiMajorAxisPixelsdouble- 椭圆半长轴。
semiMinorAxisPixelsdouble- 椭圆半短轴。
ellipseAngleDegreesdouble- 椭圆旋转角度。
输出
countint- 切线数量 (0/1/2)。
tangent1PointXdouble- 切线 1 切点 X。
tangent1PointYdouble- 切线 1 切点 Y。
tangent2PointXdouble- 切线 2 切点 X。
tangent2PointYdouble- 切线 2 切点 Y。
行为
- 计算从点到椭圆的切线。
- 点在椭圆内时 count=0。
- 使用数值法求解。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到直线距离
PointLineDistance · 可执行
计算指定点到由两点定义的无限直线的距离。
签名
var distance = PointLineDistance(lineEndX: 150, lineEndY: 50, lineStartX: 50, lineStartY: 50, minimumLineLengthPixels: 5, pointX: 100, pointY: 100);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
lineStartXdouble- 直线起点的 X 坐标。
lineStartYdouble- 直线起点的 Y 坐标。
lineEndXdouble- 直线终点的 X 坐标。
lineEndYdouble- 直线终点的 Y 坐标。
minimumLineLengthPixelsdouble- 直线最小长度,防止退化。
输出
distancePixelsdouble- 点到直线的垂直距离。
signedDistancePixelsdouble- 有符号距离。
行为
- 计算点到无限直线的垂直距离。
- 不修改输入图像。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
点到线段投影
PointSegmentProjection · 可执行
计算指定点到有限线段的投影点坐标和距离。
签名
var proj = PointSegmentProjection(endX: 150, endY: 50, minimumSegmentLengthPixels: 5, pointX: 100, pointY: 100, startX: 50, startY: 50);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
pointXdouble- 点的 X 坐标。
pointYdouble- 点的 Y 坐标。
startXdouble- 线段起点 X 坐标。
startYdouble- 线段起点 Y 坐标。
endXdouble- 线段终点 X 坐标。
endYdouble- 线段终点 Y 坐标。
minimumSegmentLengthPixelsdouble- 线段最小长度。
输出
projectionXdouble- 投影点 X 坐标。
projectionYdouble- 投影点 Y 坐标。
distancePixelsdouble- 点到线段的距离。
parameterdouble- 投影参数 (0=起点, 1=终点)。
行为
- 计算点到有限线段的垂直投影点。
- 当投影落在线段外时,distance 为到最近端点的距离。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
多边形面积
PolygonArea · 可执行
计算由顶点序列定义的多边形面积。
签名
var result = PolygonArea(polygonVertexCount: 4);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
polygonVertexCountstring- 多边形顶点数枚举。
输出
resultdouble- 计算结果。
行为
- 按顶点坐标计算多边形面积。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
多边形周长
PolygonPerimeter · 可执行
计算由顶点序列定义的多边形周长。
签名
var result = PolygonPerimeter(polygonVertexCount: 4);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
polygonVertexCountstring- 多边形顶点数枚举。
输出
resultdouble- 计算结果。
行为
- 按顶点顺序计算多边形周长。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
剖面统计
ProfileStatistics · 可执行
沿指定线段采样图像灰度剖面并计算统计特征。
签名
var stats = ProfileStatistics(channel: 0, endX: 150, endY: 50, interpolation: "Linear", samplingStepPixels: 1, startX: 50, startY: 50);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
startXdouble- 剖面起点 X。
startYdouble- 剖面起点 Y。
endXdouble- 剖面终点 X。
endYdouble- 剖面终点 Y。
samplingStepPixelsdouble- 采样步长。
channelint- 图像通道索引。
interpolationstring- 采样插值方式。
输出
meandouble- 灰度均值。
sigmadouble- 灰度标准差。
mindouble- 最小灰度值。
maxdouble- 最大灰度值。
mediandouble- 灰度中值。
gradientMagnitudedouble- 平均梯度幅值。
行为
- 沿线段等距采样像素灰度值。
- 计算灰度统计量和平均梯度。
- 使用双线性或最近邻插值。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
矩形面积
RectangleArea · 可执行
计算旋转矩形的面积。
签名
var area = RectangleArea(angleDegrees: 0, centerX: 60, centerY: 40, heightPixels: 80, widthPixels: 120);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
centerXdouble- 矩形中心 X。
centerYdouble- 矩形中心 Y。
widthPixelsdouble- 矩形宽度。
heightPixelsdouble- 矩形高度。
angleDegreesdouble- 矩形旋转角度。
输出
areadouble- 矩形面积。
行为
- 计算 width × height 的矩形面积。
- 与旋转角度无关。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
鲁棒边缘宽度
RobustEdgeWidth · 可执行
在旋转扫描区域中沿多个剖面鲁棒测量物体边缘宽度。
签名
var width = RobustEdgeWidth(angleDegrees: 0, centerX: 60, centerY: 40, maximumWidthPixels: 30, minimumContrast: 30, minimumInlierProfiles: 7, minimumWidthPixels: 5, objectPolarity: "BrightObject", outlierMadScale: 3, profileBandWidth: 7, profileCount: 11, scanSpan: 31, searchLength: 81, smoothingKernel: 3);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
centerXdouble- 扫描区域中心 X 坐标。
centerYdouble- 扫描区域中心 Y 坐标。
searchLengthint- 搜索长度,必须为奇数。
scanSpanint- 扫描跨度,必须为奇数。
angleDegreesdouble- 扫描区域旋转角度。
profileCountint- 剖面数量。
profileBandWidthint- 剖面带宽,必须为奇数。
smoothingKernelint- 平滑核大小,必须为奇数。
objectPolaritystring- 物体极性。
minimumContrastdouble- 边缘最小对比度。
minimumWidthPixelsdouble- 边缘最小宽度。
maximumWidthPixelsdouble- 边缘最大宽度。
outlierMadScaledouble- 离群值 MAD 缩放因子。
minimumInlierProfilesint- 最少内点剖面数。
输出
outputImage- 在扫描区域绘制边缘宽度标记的彩色图像。
measurements量测值集合- 键为 medianWidthPixels/meanWidthPixels/sigmaWidthPixels/inlierCount/outlierCount/found。
行为
- 沿扫描区域生成多个平行剖面。
- 在每个剖面上搜索一对边缘并测量宽度。
- 使用 MAD 鲁棒统计剔除离群值。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
旋转矩形相交区域
RotatedRectangleIntersection · 可执行
计算两个旋转矩形的相交多边形。
签名
var result = RotatedRectangleIntersection(rectangle1AngleDegrees: 0, rectangle1CenterX: 60, rectangle1CenterY: 40, rectangle1HeightPixels: 80, rectangle1WidthPixels: 120, rectangle2AngleDegrees: 45, rectangle2CenterX: 80, rectangle2CenterY: 50, rectangle2HeightPixels: 60, rectangle2WidthPixels: 100);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
rectangle1CenterXdouble- 矩形 1 中心 X。
rectangle1CenterYdouble- 矩形 1 中心 Y。
rectangle1WidthPixelsdouble- 矩形 1 宽度。
rectangle1HeightPixelsdouble- 矩形 1 高度。
rectangle1AngleDegreesdouble- 矩形 1 旋转角度。
rectangle2CenterXdouble- 矩形 2 中心 X。
rectangle2CenterYdouble- 矩形 2 中心 Y。
rectangle2WidthPixelsdouble- 矩形 2 宽度。
rectangle2HeightPixelsdouble- 矩形 2 高度。
rectangle2AngleDegreesdouble- 矩形 2 旋转角度。
输出
intersectionAreadouble- 相交区域面积。
intersectionTypeint- 相交类型 (0=相离, 1=相交, 2=包含)。
行为
- 计算两个旋转矩形的相交多边形面积。
- 使用 Sutherland-Hodgman 裁剪算法。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
种子圆精密测量
SeededCircleMetrology · 可执行
以种子圆参数为初始值,沿径向精密搜索边缘并拟合最优圆。
签名
var circle = SeededCircleMetrology(edgeSelection: "ClosestToSeed", inlierTolerancePixels: 1, maximumCenterShiftPixels: 50, maximumEdgeOffsetPixels: 10, maximumRadiusRelativeChange: 0.2, minimumAngularCoverageDegrees: 180, minimumConditionRatio: 1e-8, minimumContrast: 30, minimumInlierProfiles: 10, minimumTriangleAreaRatio: 0.001, objectPolarity: "BrightObject", profileBandWidth: 7, profileCount: 10, searchLength: 21, seedCenterX: 100, seedCenterY: 100, seedRadiusPixels: 50, smoothingKernel: 3, startAngleDegrees: 0, sweepAngleDegrees: 360);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
seedCenterXdouble- 种子圆中心 X 坐标。
seedCenterYdouble- 种子圆中心 Y 坐标。
seedRadiusPixelsdouble- 种子圆半径。
startAngleDegreesdouble- 起始角度。
sweepAngleDegreesdouble- 有向扫角。
profileCountint- 径向剖面数。
profileBandWidthint- 剖面带宽,必须为奇数。
searchLengthint- 搜索长度,必须为奇数。
smoothingKernelint- 平滑核大小,必须为奇数。
objectPolaritystring- 物体极性。
edgeSelectionstring- 边缘选择策略。
minimumContrastdouble- 边缘最小对比度。
maximumEdgeOffsetPixelsdouble- 边缘偏移上限。
inlierTolerancePixelsdouble- 内点容差。
minimumInlierProfilesint- 最少内点剖面数。
minimumAngularCoverageDegreesdouble- 最小角度覆盖率。
minimumTriangleAreaRatiodouble- 最小三角形面积比率。
minimumConditionRatiodouble- 最小条件数比率。
maximumCenterShiftPixelsdouble- 中心最大偏移。
maximumRadiusRelativeChangedouble- 半径最大相对变化。
输出
outputImage- 在拟合圆上绘制标记的彩色图像。
measurements量测值集合- 键为 centerX/centerY/radiusPixels/meanResidual/sigmaResidual/pointsUsed/found。
行为
- 沿种子圆径向投影并搜索边缘点。
- 使用 RANSAC 迭代拟合最优圆。
- 未找到足够内点时 found=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
种子线段精密测量
SeededLineMetrology · 可执行
以种子线段为初始值,沿法线方向精密搜索边缘并拟合最优线段。
签名
var line = SeededLineMetrology(edgeSelection: "ClosestToSeed", endpointExclusion: 10, inlierTolerance: 1, maxAngleDeviation: 10, maxEdgeOffset: 10, maxNormalShift: 10, maxOrthogonalVarianceRatio: 0.1, minContrast: 30, minCoverage: 0.5, minHypothesisSpanRatio: 0.1, minInlierProfiles: 10, polarity: "DarkToLight", profileBandWidth: 7, profileCount: 10, searchLength: 21, seedEndX: 200, seedEndY: 100, seedStartX: 100, seedStartY: 100, smoothing: 3);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
seedStartXdouble- 种子线段起点 X 坐标。
seedStartYdouble- 种子线段起点 Y 坐标。
seedEndXdouble- 种子线段终点 X 坐标。
seedEndYdouble- 种子线段终点 Y 坐标。
profileCountint- 沿线段方向的采样剖面数。
searchLengthint- 法线方向搜索长度,必须为奇数。
profileBandWidthint- 剖面带宽,必须为奇数。
endpointExclusionint- 端点排除像素数。
smoothingint- 平滑核大小,必须为奇数。
polaritystring- 边缘极性。
edgeSelectionstring- 边缘选择策略。
minContrastdouble- 边缘最小对比度。
maxEdgeOffsetdouble- 边缘偏移上限。
inlierTolerancedouble- 内点容差。
minHypothesisSpanRatiodouble- 假设跨度最小比率。
minInlierProfilesint- 最少内点剖面数。
minCoveragedouble- 线段的最小覆盖率。
maxAngleDeviationdouble- 角度最大偏差。
maxNormalShiftdouble- 法线方向最大偏移。
maxOrthogonalVarianceRatiodouble- 正交方向方差最大比率。
输出
outputImage- 在拟合线段上绘制标记的彩色图像。
measurements量测值集合- 键为 startX/startY/endX/endY/meanResidual/sigmaResidual/pointsUsed/found。
行为
- 沿种子线段法线方向投影并搜索边缘点。
- 使用 RANSAC 迭代拟合最优线段。
- 未找到足够内点时 found=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。
种子矩形精密测量
SeededRectangleMetrology · 可执行
以种子矩形参数为初始值,沿四边精密搜索边缘并迭代拟合最优矩形。
签名
var rect = SeededRectangleMetrology(cornerExclusion: 10, edgeSelection: "ClosestToSeed", inlierTolerance: 1, maxAngleChange: 10, maxCenterShift: 50, maxCornerShift: 50, maxEdgeOffset: 10, maxOppositeParallelError: 5, maxOrthogonalityError: 5, maxSideAngleDeviation: 10, maxSizeRelativeChange: 0.2, minContrast: 30, minHypothesisSpanRatio: 0.1, minInlierProfiles: 10, minSideCoverage: 0.5, polarity: "Bright", profileBandWidth: 7, profilesPerSide: 10, searchLength: 21, seedAngle: 0, seedCenterX: 100, seedCenterY: 100, seedHeight: 80, seedWidth: 120, smoothing: 3);
输入
inputImage- 由视觉图连接提供的输入图像。
参数
seedCenterXdouble- 种子矩形中心 X 坐标。
seedCenterYdouble- 种子矩形中心 Y 坐标。
seedWidthdouble- 种子矩形宽度。
seedHeightdouble- 种子矩形高度。
seedAngledouble- 种子矩形旋转角度。
profilesPerSideint- 每边的采样剖面数。
searchLengthint- 搜索长度,必须为奇数。
profileBandWidthint- 剖面带宽,必须为奇数。
cornerExclusionint- 角部排除像素数。
smoothingint- 平滑核大小,必须为奇数。
polaritystring- 边缘极性。
edgeSelectionstring- 边缘选择策略。
minContrastdouble- 边缘最小对比度。
maxEdgeOffsetdouble- 边缘偏移上限。
inlierTolerancedouble- 内点容差。
minHypothesisSpanRatiodouble- 假设跨度最小比率。
minInlierProfilesint- 最少内点剖面数。
minSideCoveragedouble- 边的最小覆盖率。
maxSideAngleDeviationdouble- 边的最大角度偏差。
maxCenterShiftdouble- 中心最大偏移。
maxSizeRelativeChangedouble- 尺寸最大相对变化。
maxAngleChangedouble- 角度最大变化。
maxCornerShiftdouble- 角点最大偏移。
maxOppositeParallelErrordouble- 对边平行度误差上限。
maxOrthogonalityErrordouble- 正交性误差上限。
输出
outputImage- 在拟合矩形上绘制标记的彩色图像。
measurements量测值集合- 键为 centerX/centerY/width/height/angleDegrees/meanResidual/sigmaResidual/pointsUsed/found。
行为
- 沿种子矩形四边投影并搜索边缘点。
- 使用 RANSAC 迭代拟合最优矩形。
- 未找到足够内点时 found=0。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
示例
本 API 无需额外示例。