跳到主要内容

二维测量

用于卡尺、拟合、交点和几何量测,输出亚像素位置与尺寸。

圆弧卡尺边缘​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆弧中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆弧中心 Y 坐标。
nominalRadiusPixelsdouble
  • 输入
  • 必填
  • 约束 必须使最小采样半径严格大于零。
标称半径像素值。
searchLengthint
  • 输入
  • 可选
  • 默认 15
  • 约束 范围 3–4095,必须为奇数。
径向搜索长度,必须为奇数。
startAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
起始角度。
endAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。与 startAngleDegrees 的差绝对值不得超过 360,且非零。
结束角度。
angularSampleCountint
  • 输入
  • 可选
  • 默认 9
  • 约束 范围 3–8191,必须为奇数。
角度方向采样数,必须为奇数。
maximumTangentialStepPixelsdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.25–4。
最大半径处切向采样步长上限。
smoothingKernelint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。
平滑核大小,必须为奇数。
polaritystring
  • 输入
  • 可选
  • 默认 Any
  • 约束 可选 Any、Rising、Falling。
边缘极性筛选。
selectionstring
  • 输入
  • 可选
  • 默认 Strongest
  • 约束 可选 Strongest、First、Last。
边缘选择策略。
minimumContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 0.000001–255。
边缘最小对比度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆弧中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆弧中心 Y 坐标。
nominalRadiusPixelsdouble
  • 输入
  • 必填
  • 约束 必须使最小径向采样半径严格大于零。
标称半径像素值。
startAngleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 -360–360。
起始角度。
sweepAngleDegreesdouble
  • 输入
  • 可选
  • 默认 360
  • 约束 范围 -360–360,不得为零。
有向扫角。
radialSearchLengthint
  • 输入
  • 可选
  • 默认 15
  • 约束 范围 7–4095,必须为奇数。
径向搜索长度,必须为奇数。
angularSamplesint
  • 输入
  • 可选
  • 默认 9
  • 约束 范围 3–1024。
角度采样数。
smoothingKernelint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。
平滑核大小,必须为奇数。
objectPolaritystring
  • 输入
  • 可选
  • 默认 BrightObject
  • 约束 可选 BrightObject、DarkObject。
物体极性。
minimumContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–255。
边缘最小对比度。
minimumSeparationPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–4093。
边缘对最小间距。
maximumSeparationPixelsdouble
  • 输入
  • 可选
  • 默认 20
  • 约束 范围 0.5–4093。不得小于 minimumSeparationPixels。
边缘对最大间距。
selectionstring
  • 输入
  • 可选
  • 默认 First
  • 约束 可选 First、Last、Strongest。
边缘选择策略。

输出​

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
  • 输入
  • 必填
  • 约束 可选 2–16。
折线顶点数枚举。
closedbool
  • 输入
  • 可选
  • 默认 FALSE
是否为闭合折线(末点连回起点)。

输出​

arcLengthdouble
折线总弧长。

行为​

  • 计算折线所有相邻顶点的欧几里得距离之和。
  • closed=true 时包含末点到起点的距离。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。
  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。

示例​

本 API 无需额外示例。

连通轮廓面积筛选​

Blob · 可执行

从二值化结果的外轮廓中按面积范围筛选目标,并汇总数量和面积。

签名​

var blobs = Blob(maxArea: 5000, minArea: 25);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的输入图像。

参数​

minAreadouble
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–double.MaxValue。
保留轮廓的最小面积。
maxAreadouble
  • 输入
  • 可选
  • 默认 double.MaxValue
  • 单位 px²
  • 约束 范围 0–double.MaxValue。不得小于 minArea。
保留轮廓的最大面积。

输出​

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
  • 输入
  • 必填
  • 约束 可选 3–16。
多边形顶点数枚举。

输出​

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
  • 输入
  • 可选
  • 默认 (input.Width-1)/2
  • 约束 范围 0–(input.Width-1)。
卡尺中心 X 坐标。
centerYdouble
  • 输入
  • 可选
  • 默认 (input.Height-1)/2
  • 约束 范围 0–(input.Height-1)。
卡尺中心 Y 坐标。
lengthint
  • 输入
  • 可选
  • 默认 31
  • 约束 范围 3–4095,必须为奇数。卡尺区域必须完全位于输入图像内。
卡尺沿边缘方向的长度,必须为奇数。
widthint
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 1–255,必须为奇数。
卡尺垂直边缘方向的宽度,必须为奇数。
angleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 单位 deg
  • 约束 范围 -360–360。
卡尺旋转角度。
polaritystring
  • 输入
  • 可选
  • 默认 Any
  • 约束 可选 Any、Rising、Falling。
边缘极性筛选。
minimumContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 0–255。
边缘最小对比度。
smoothingKernelint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。
平滑核大小,必须为奇数。

输出​

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
  • 输入
  • 可选
  • 默认 (input.Width-1)/2
  • 约束 范围 0–(input.Width-1)。
卡尺中心 X 坐标。
centerYdouble
  • 输入
  • 可选
  • 默认 (input.Height-1)/2
  • 约束 范围 0–(input.Height-1)。
卡尺中心 Y 坐标。
lengthint
  • 输入
  • 可选
  • 默认 31
  • 约束 范围 3–4095,必须为奇数。
卡尺沿边缘方向的长度,必须为奇数。
widthint
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 1–255,必须为奇数。
卡尺垂直边缘方向的宽度,必须为奇数。
angleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 单位 deg
  • 约束 范围 -360–360。
卡尺旋转角度。
polaritystring
  • 输入
  • 可选
  • 默认 Any
  • 约束 可选 Any、DarkToLight、LightToDark。
边缘极性。
minimumContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 0–255。
边缘最小对比度。
minimumSeparationPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.000001–4095。必须小于卡尺长度。
边缘对最小间距。
smoothingKernelint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。
平滑核大小,必须为奇数。

输出​

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
  • 输入
  • 必填
  • 约束 可选 3–16。
多边形顶点数枚举。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆 1 中心 X。
circle1CenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆 1 中心 Y。
circle1RadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆 1 半径。
circle2CenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆 2 中心 X。
circle2CenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆 2 中心 Y。
circle2RadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆 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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆 1 中心 X。
circle1CenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆 1 中心 Y。
circle1RadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆 1 半径。
circle2CenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆 2 中心 X。
circle2CenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆 2 中心 Y。
circle2RadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆 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
  • 输入
  • 必填
  • 约束 可选 3–16。
多边形 1 顶点数枚举。
polygon2VertexCountstring
  • 输入
  • 必填
  • 约束 可选 3–16。
多边形 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
  • 输入
  • 可选
  • 默认 L2
  • 约束 可选 L1、L2、C、L12、Fair、Welsch、Huber。
距离类型。
maskSizestring
  • 输入
  • 可选
  • 默认 PRECISE
  • 约束 可选 3、5、PRECISE。
距离变换掩码大小。
thresholdPixelsdouble
  • 输入
  • 可选
  • 默认 128
  • 约束 范围 0–65535。
二值化阈值。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
椭圆中心 X。
ellipseCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
椭圆中心 Y。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。必须大于等于 semiMinorAxisPixels。
椭圆半长轴。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
椭圆半短轴。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
椭圆旋转角度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线起点 X。
lineStartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线起点 Y。
lineEndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线终点 X。
lineEndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线终点 Y。
ellipseCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
椭圆中心 X 坐标。
ellipseCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。必须大于等于 semiMinorAxisPixels。
椭圆半长轴。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
椭圆半短轴。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
椭圆旋转角度。
minimumLineLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
直线最小长度。

输出​

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
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 3–最大点数。
从最大有效轮廓提取的最大点数。

输出​

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
  • 输入
  • 必填
  • 约束 可选 KasaAlgebraic。
圆拟合方法。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 3–65536。
从最大有效轮廓提取的最大点数。
minimumContourAreadouble
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
minimumConditionRatiodouble
  • 输入
  • 可选
  • 默认 1e-12
  • 约束 范围 1e-12–1。
最小条件数比率,用于剔除退化点集。
minimumRadiusPixelsdouble
  • 输入
  • 可选
  • 默认 0.5
  • 约束 范围 0.000001–1e9。
有效拟合的最小半径。
maximumRadiusPixelsdouble
  • 输入
  • 可选
  • 默认 5000
  • 约束 范围 0.000001–1e9。不得小于 minimumRadiusPixels。
有效拟合的最大半径。
requireCenterInsideImagebool
  • 输入
  • 可选
  • 默认 FALSE
要求拟合圆心位于图像边界内。

输出​

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
  • 输入
  • 可选
  • 默认 Standard
  • 约束 可选 Standard、AMS、Direct。
椭圆拟合方法。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 5–65536。
从最大有效轮廓提取的最大点数。
minimumContourAreadouble
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
minimumConditionRatiodouble
  • 输入
  • 可选
  • 默认 1e-12
  • 约束 范围 1e-12–1。
最小条件数比率,用于剔除退化点集。
minimumAxisPixelsdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.000001–1e9。
有效拟合的最小轴长。
maximumAxisPixelsdouble
  • 输入
  • 可选
  • 默认 5000
  • 约束 范围 0.000001–1e9。不得小于 minimumAxisPixels。
有效拟合的最大轴长。
requireCenterInsideImagebool
  • 输入
  • 可选
  • 默认 FALSE
要求拟合椭圆中心位于图像边界内。

输出​

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
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 2–65536。
从最大有效轮廓提取的最大点数。
minimumContourAreadouble
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
minimumSpanPixelsdouble
  • 输入
  • 可选
  • 默认 0.000001
  • 约束 范围 0.000001–1e9。
有效轮廓的最小跨度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线起点 X。
lineStartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线起点 Y。
lineEndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线终点 X。
lineEndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线终点 Y。
circleCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆心 X 坐标。
circleCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆心 Y 坐标。
radiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆的半径。
minimumLineLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
直线最小长度。

输出​

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
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 4–65536。
每个轮廓提取的最大点数。
minimumContourAreadouble
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
minimumSpanPixelsdouble
  • 输入
  • 可选
  • 默认 0.000001
  • 约束 范围 0.000001–1e9。
有效轮廓的最小跨度。
parallelToleranceDegreesdouble
  • 输入
  • 可选
  • 默认 1
  • 单位 deg
  • 约束 范围 0.001–45。
判定两线平行时的容差角度。
requireIntersectionInsideImagebool
  • 输入
  • 可选
  • 默认 FALSE
要求交点位于图像边界内。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线 1 起点 X。
line1StartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线 1 起点 Y。
line1EndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线 1 终点 X。
line1EndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线 1 终点 Y。
line2StartXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线 2 起点 X。
line2StartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线 2 起点 Y。
line2EndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线 2 终点 X。
line2EndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线 2 终点 Y。
minimumLineLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.000001–1e9。
直线最小长度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段起点 X。
startYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段起点 Y。
endXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段终点 X。
endYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段终点 Y。
referenceAxisDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 -360–360。
参考轴角度。
minimumSegmentLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.000001–1e9。
线段最小长度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段起点 X。
segmentStartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段起点 Y。
segmentEndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段终点 X。
segmentEndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段终点 Y。
circleCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆心 X 坐标。
circleCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆心 Y 坐标。
circleRadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆的半径。
minimumSegmentLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
线段最小长度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 1 起点 X。
segment1StartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 1 起点 Y。
segment1EndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 1 终点 X。
segment1EndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 1 终点 Y。
segment2StartXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 2 起点 X。
segment2StartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 2 起点 Y。
segment2EndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 2 终点 X。
segment2EndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 2 终点 Y。
minimumSegmentLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
线段最小长度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段起点 X。
startYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段起点 Y。
endXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段终点 X。
endYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段终点 Y。
ellipseCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
椭圆中心 X 坐标。
ellipseCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
椭圆半长轴。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
椭圆半短轴。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
椭圆旋转角度。
minimumSegmentLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
线段最小长度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 1 起点 X。
segment1StartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 1 起点 Y。
segment1EndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 1 终点 X。
segment1EndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 1 终点 Y。
segment2StartXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 2 起点 X。
segment2StartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 2 起点 Y。
segment2EndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段 2 终点 X。
segment2EndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段 2 终点 Y。
minimumSegmentLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
线段最小长度。

输出​

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
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Width-1)。
顶点的 X 坐标。
vertexYdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Height-1)。
顶点的 Y 坐标。
ray1Xdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Width-1)。
射线 1 上任意点的 X 坐标。
ray1Ydouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Height-1)。
射线 1 上任意点的 Y 坐标。
ray2Xdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Width-1)。
射线 2 上任意点的 X 坐标。
ray2Ydouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Height-1)。
射线 2 上任意点的 Y 坐标。
minimumRayLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.000001–1e9。
从顶点到射线点的最小距离,用于防止退化。
minimumSineMagnitudedouble
  • 输入
  • 可选
  • 默认 0.001
  • 约束 范围 0–1。
两射线方向向量叉积幅值下限,用于防止接近平行或退化。

输出​

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
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Width-1)。
第一个点的 X 坐标。
y1double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Height-1)。
第一个点的 Y 坐标。
x2double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Width-1)。
第二个点的 X 坐标。
y2double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Height-1)。
第二个点的 Y 坐标。
scaledouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.000001–double.MaxValue。
像素到真实物理单位的换算系数。

输出​

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
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 3–65536。
从最大有效轮廓提取的最大点数。

输出​

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
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 2–65536。
从最大有效轮廓提取的最大点数。

输出​

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
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 3–最大点数。
从最大有效轮廓提取的最大点数。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
circleCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆心 X 坐标。
circleCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆心 Y 坐标。
radiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆的半径。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
circleCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
圆心 X 坐标。
circleCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
圆心 Y 坐标。
radiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
圆的半径。

输出​

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
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
signedDistancebool
  • 输入
  • 可选
  • 默认 TRUE
是否返回有符号距离(内正外负)。
minimumContourAreadouble
  • 输入
  • 可选
  • 默认 25
  • 单位 px²
  • 约束 范围 0–1e12。
有效轮廓的最小面积。
maximumPointsint
  • 输入
  • 可选
  • 默认 2000
  • 约束 范围 3–最大点数。
从最大有效轮廓提取的最大点数。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
ellipseCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
椭圆中心 X。
ellipseCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
椭圆中心 Y。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。必须大于等于 semiMinorAxisPixels。
椭圆半长轴。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
椭圆半短轴。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
椭圆旋转角度。
convergenceTolerancePixelsdouble
  • 输入
  • 可选
  • 默认 0.01
  • 约束 范围 1e-12–1e12。
迭代收敛容差。
maximumIterationsint
  • 输入
  • 可选
  • 默认 100
  • 约束 范围 1–65535。
最大迭代次数。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
ellipseCenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
椭圆中心 X。
ellipseCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
椭圆中心 Y。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。必须大于等于 semiMinorAxisPixels。
椭圆半长轴。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
椭圆半短轴。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
椭圆旋转角度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
lineStartXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线起点的 X 坐标。
lineStartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线起点的 Y 坐标。
lineEndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
直线终点的 X 坐标。
lineEndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
直线终点的 Y 坐标。
minimumLineLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
直线最小长度,防止退化。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
点的 Y 坐标。
startXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段起点 X 坐标。
startYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段起点 Y 坐标。
endXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
线段终点 X 坐标。
endYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
线段终点 Y 坐标。
minimumSegmentLengthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.5–1e9。
线段最小长度。

输出​

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
  • 输入
  • 必填
  • 约束 可选 3–16。
多边形顶点数枚举。

输出​

resultdouble
计算结果。

行为​

  • 按顶点坐标计算多边形面积。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。
  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。

示例​

本 API 无需额外示例。

多边形周长​

PolygonPerimeter · 可执行

计算由顶点序列定义的多边形周长。

签名​

var result = PolygonPerimeter(polygonVertexCount: 4);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的输入图像。

参数​

polygonVertexCountstring
  • 输入
  • 必填
  • 约束 可选 3–16。
多边形顶点数枚举。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
剖面起点 X。
startYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
剖面起点 Y。
endXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
剖面终点 X。
endYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
剖面终点 Y。
samplingStepPixelsdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.1–64。
采样步长。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0–3。
图像通道索引。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear。
采样插值方式。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
矩形中心 X。
centerYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
矩形中心 Y。
widthPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。必须为正数。
矩形宽度。
heightPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。必须为正数。
矩形高度。
angleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
矩形旋转角度。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
扫描区域中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
扫描区域中心 Y 坐标。
searchLengthint
  • 输入
  • 可选
  • 默认 81
  • 约束 范围 7–4095,必须为奇数。
搜索长度,必须为奇数。
scanSpanint
  • 输入
  • 可选
  • 默认 31
  • 约束 范围 5–255,必须为奇数。
扫描跨度,必须为奇数。
angleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 单位 deg
  • 约束 范围 -360–360。
扫描区域旋转角度。
profileCountint
  • 输入
  • 可选
  • 默认 11
  • 约束 范围 5–最大剖面数。
剖面数量。
profileBandWidthint
  • 输入
  • 可选
  • 默认 7
  • 约束 范围 1–31,必须为奇数。不得超过 scanSpan。
剖面带宽,必须为奇数。
smoothingKernelint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。不得超过 searchLength。
平滑核大小,必须为奇数。
objectPolaritystring
  • 输入
  • 可选
  • 默认 BrightObject
  • 约束 可选 BrightObject、DarkObject。
物体极性。
minimumContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–255。
边缘最小对比度。
minimumWidthPixelsdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 1–4095。
边缘最小宽度。
maximumWidthPixelsdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–4095。必须大于 minimumWidthPixels。
边缘最大宽度。
outlierMadScaledouble
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–10。
离群值 MAD 缩放因子。
minimumInlierProfilesint
  • 输入
  • 可选
  • 默认 7
  • 约束 范围 3–最大剖面数。不得超过 profileCount。
最少内点剖面数。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
矩形 1 中心 X。
rectangle1CenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
矩形 1 中心 Y。
rectangle1WidthPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
矩形 1 宽度。
rectangle1HeightPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
矩形 1 高度。
rectangle1AngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
矩形 1 旋转角度。
rectangle2CenterXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
矩形 2 中心 X。
rectangle2CenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
矩形 2 中心 Y。
rectangle2WidthPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
矩形 2 宽度。
rectangle2HeightPixelsdouble
  • 输入
  • 必填
  • 约束 范围 0.5–32768。
矩形 2 高度。
rectangle2AngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围 -360–360。
矩形 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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
种子圆中心 X 坐标。
seedCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
种子圆中心 Y 坐标。
seedRadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围 1–32768。必须严格大于 (searchLength-1)/2。
种子圆半径。
startAngleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 -360–360。
起始角度。
sweepAngleDegreesdouble
  • 输入
  • 可选
  • 默认 360
  • 约束 范围 -360–360,不得为零。
有向扫角。
profileCountint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 8–64。
径向剖面数。
profileBandWidthint
  • 输入
  • 可选
  • 默认 7
  • 约束 范围 1–31,必须为奇数。
剖面带宽,必须为奇数。
searchLengthint
  • 输入
  • 可选
  • 默认 21
  • 约束 范围 7–511,必须为奇数。
搜索长度,必须为奇数。
smoothingKernelint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。不得超过 searchLength-2。
平滑核大小,必须为奇数。
objectPolaritystring
  • 输入
  • 可选
  • 默认 BrightObject
  • 约束 可选 BrightObject、DarkObject。
物体极性。
edgeSelectionstring
  • 输入
  • 可选
  • 默认 ClosestToSeed
  • 约束 可选 ClosestToSeed、Strongest。
边缘选择策略。
minimumContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–255。
边缘最小对比度。
maximumEdgeOffsetPixelsdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 0.5–255。不得超过 (searchLength-2)/2。
边缘偏移上限。
inlierTolerancePixelsdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.1–10。
内点容差。
minimumInlierProfilesint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 3–64。不得超过 profileCount。
最少内点剖面数。
minimumAngularCoverageDegreesdouble
  • 输入
  • 可选
  • 默认 180
  • 约束 范围 10–360。不得超过绝对 sweep。
最小角度覆盖率。
minimumTriangleAreaRatiodouble
  • 输入
  • 可选
  • 默认 0.001
  • 约束 范围 0.000001–1。
最小三角形面积比率。
minimumConditionRatiodouble
  • 输入
  • 可选
  • 默认 1e-8
  • 约束 范围 0.00000001–1。
最小条件数比率。
maximumCenterShiftPixelsdouble
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0.5–511。
中心最大偏移。
maximumRadiusRelativeChangedouble
  • 输入
  • 可选
  • 默认 0.2
  • 约束 范围 0.001–1。
半径最大相对变化。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
种子线段起点 X 坐标。
seedStartYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
种子线段起点 Y 坐标。
seedEndXdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
种子线段终点 X 坐标。
seedEndYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
种子线段终点 Y 坐标。
profileCountint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 5–64。
沿线段方向的采样剖面数。
searchLengthint
  • 输入
  • 可选
  • 默认 21
  • 约束 范围 7–511,必须为奇数。
法线方向搜索长度,必须为奇数。
profileBandWidthint
  • 输入
  • 可选
  • 默认 7
  • 约束 范围 1–31,必须为奇数。
剖面带宽,必须为奇数。
endpointExclusionint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 1–4096。必须至少为 halfBand+1。两倍值必须小于种子长度。
端点排除像素数。
smoothingint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。不得超过 searchLength。
平滑核大小,必须为奇数。
polaritystring
  • 输入
  • 可选
  • 默认 DarkToLight
  • 约束 可选 DarkToLight、LightToDark。
边缘极性。
edgeSelectionstring
  • 输入
  • 可选
  • 默认 ClosestToSeed
  • 约束 可选 ClosestToSeed、Strongest。
边缘选择策略。
minContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–255。
边缘最小对比度。
maxEdgeOffsetdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 0.5–255。不得超过 (searchLength-2)/2。
边缘偏移上限。
inlierTolerancedouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.1–10。
内点容差。
minHypothesisSpanRatiodouble
  • 输入
  • 可选
  • 默认 0.1
  • 约束 范围 0.05–1。
假设跨度最小比率。
minInlierProfilesint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 3–64。不得超过 profileCount。
最少内点剖面数。
minCoveragedouble
  • 输入
  • 可选
  • 默认 0.5
  • 约束 范围 0.2–1。
线段的最小覆盖率。
maxAngleDeviationdouble
  • 输入
  • 可选
  • 默认 10
  • 单位 deg
  • 约束 范围 0.1–45。
角度最大偏差。
maxNormalShiftdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 0.5–511。
法线方向最大偏移。
maxOrthogonalVarianceRatiodouble
  • 输入
  • 可选
  • 默认 0.1
  • 约束 范围 0.000001–0.5。
正交方向方差最大比率。

输出​

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
  • 输入
  • 必填
  • 约束 范围 0–(input.Width-1)。
种子矩形中心 X 坐标。
seedCenterYdouble
  • 输入
  • 必填
  • 约束 范围 0–(input.Height-1)。
种子矩形中心 Y 坐标。
seedWidthdouble
  • 输入
  • 必填
  • 约束 范围 4–32768。
种子矩形宽度。
seedHeightdouble
  • 输入
  • 必填
  • 约束 范围 4–32768。
种子矩形高度。
seedAngledouble
  • 输入
  • 可选
  • 默认 0
  • 单位 deg
  • 约束 范围 -360–360。
种子矩形旋转角度。
profilesPerSideint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 5–64。
每边的采样剖面数。
searchLengthint
  • 输入
  • 可选
  • 默认 21
  • 约束 范围 7–511,必须为奇数。必须严格小于 seedWidth 和 seedHeight。
搜索长度,必须为奇数。
profileBandWidthint
  • 输入
  • 可选
  • 默认 7
  • 约束 范围 1–31,必须为奇数。
剖面带宽,必须为奇数。
cornerExclusionint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 1–4096。必须至少为 halfBand+1。两倍值必须小于 seedWidth 和 seedHeight。
角部排除像素数。
smoothingint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31,必须为奇数。不得超过 searchLength。
平滑核大小,必须为奇数。
polaritystring
  • 输入
  • 可选
  • 默认 Bright
  • 约束 可选 Bright、Dark。
边缘极性。
edgeSelectionstring
  • 输入
  • 可选
  • 默认 ClosestToSeed
  • 约束 可选 ClosestToSeed、Strongest。
边缘选择策略。
minContrastdouble
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–255。
边缘最小对比度。
maxEdgeOffsetdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 0.5–255。不得超过 (searchLength-2)/2。
边缘偏移上限。
inlierTolerancedouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 0.1–10。
内点容差。
minHypothesisSpanRatiodouble
  • 输入
  • 可选
  • 默认 0.1
  • 约束 范围 0.05–1。
假设跨度最小比率。
minInlierProfilesint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围 3–64。不得超过 profilesPerSide。
最少内点剖面数。
minSideCoveragedouble
  • 输入
  • 可选
  • 默认 0.5
  • 约束 范围 0.2–1。
边的最小覆盖率。
maxSideAngleDeviationdouble
  • 输入
  • 可选
  • 默认 10
  • 单位 deg
  • 约束 范围 0.1–45。
边的最大角度偏差。
maxCenterShiftdouble
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0.5–511。
中心最大偏移。
maxSizeRelativeChangedouble
  • 输入
  • 可选
  • 默认 0.2
  • 约束 范围 0.001–1。
尺寸最大相对变化。
maxAngleChangedouble
  • 输入
  • 可选
  • 默认 10
  • 单位 deg
  • 约束 范围 0–90。
角度最大变化。
maxCornerShiftdouble
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0.5–1022。
角点最大偏移。
maxOppositeParallelErrordouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.01–20。
对边平行度误差上限。
maxOrthogonalityErrordouble
  • 输入
  • 可选
  • 默认 5
  • 约束 范围 0.01–20。
正交性误差上限。

输出​

outputImage
在拟合矩形上绘制标记的彩色图像。
measurements量测值集合
键为 centerX/centerY/width/height/angleDegrees/meanResidual/sigmaResidual/pointsUsed/found。

行为​

  • 沿种子矩形四边投影并搜索边缘点。
  • 使用 RANSAC 迭代拟合最优矩形。
  • 未找到足够内点时 found=0。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。
  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。

示例​

本 API 无需额外示例。