轮廓处理
用于轮廓生成、筛选、拟合、变换和几何属性计算。
Canny 边缘检测
Canny · 可执行
使用 Canny 算法检测图像边缘。
签名
Image canny = Canny(threshold1: 50, threshold2: 150, apertureSize: 3, l2Gradient: false);
输入
inputImage- 8-bit 单通道灰度输入图像,由视觉图连接提供。
参数
threshold1double- 滞后阈值下限。
threshold2double- 滞后阈值上限。
apertureSizeint- Sobel 算子孔径大小。
l2Gradientbool- 是否使用 L2 范数计算梯度幅值。
返回值
returnImage- 返回 8-bit 单通道边缘图像(255 表示边缘)。
行为
- 使用 Canny 多阶段边缘检测算法,包括高斯平滑、梯度计算、非极大值抑制和双阈值滞后追踪。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
Canny 边缘检测
Image canny = Canny(threshold1: 50, threshold2: 150, apertureSize: 3, l2Gradient: false);
列均值剖面
ColumnMeanProfile · 可执行
计算每列像素均值形成列剖面。
签名
Image column_mean_profile = ColumnMeanProfile();
输入
inputImage- 输入图像,由视觉图连接提供。
参数
无参数。
返回值
returnImage- 返回 BGR8 列剖面可视化图像;每列均值通过量测值 输出。
行为
- 计算输入图像每列的像素均值,输出列剖面曲线。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
列均值剖面
Image column_mean_profile = ColumnMeanProfile();
轮廓固定公差逼近
ContourApprox · 可执行
使用道格拉斯-普克折线逼近以像素绝对值公差简化轮廓。
签名
Image contour_approx = ContourApprox(minimumContourArea: 0, maximumPoints: 8192, epsilonPixels: 2, maximumVertices: 256, closed: true);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与逼近的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
epsilonPixelsdouble- 以像素绝对值为单位的逼近公差。
maximumVerticesint- 逼近结果允许的顶点数上限。
closedbool- 轮廓是否为闭合曲线。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 使用像素绝对公差执行道格拉斯-普克折线逼近。
- maximumPoints 当前仅完成参数校验,不参与点数限制。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓凸包
ContourConvexHull · 可执行
输入轮廓点集,输出凸包包络。
签名
Image contour_hull = ContourConvexHull(minimumContourArea: 0, maximumPoints: 8192, returnPoints: true, clockwise: false);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与凸包计算的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
returnPointsbool- 是否返回凸包点(TRUE 返回点集,FALSE 返回索引)。
clockwisebool- 凸包点是否按顺时针方向排列。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 计算每条达标轮廓的凸包,并输出 BGR8 可视化图像。
- maximumPoints 当前仅完成参数校验,不参与点数限制。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓重叠点
ContourCrossing · 可执行
标出第一条轮廓落在第二条轮廓凸包内的采样点;不计算线段几何交点。
签名
Image overlap_points = ContourCrossing(minimumContourArea: 0, maximumPoints: 8192, maximumIntersections: 256);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与重叠点检测的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
maximumIntersectionsint- 最多标记的重叠采样点数量。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 从面积达标的前两条轮廓中,计算第二条轮廓的凸包。
- 标出第一条轮廓落在该凸包内或边界上的采样点;结果不是线段交点集合。
- maximumPoints 当前仅完成参数校验,不参与采样点数量限制。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓周长过滤
ContourLengthFilter · 可执行
按周长(弧长)过滤轮廓,输出保留集合的可视化图。
签名
Image length_filtered = ContourLengthFilter(minLength: 0, maxLength: double.MaxValue, closed: true, maximumContours: 4096);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minLengthdouble- 保留轮廓的最小周长(弧长)。
maxLengthdouble- 保留轮廓的最大周长(弧长)。
closedbool- 轮廓是否为闭合曲线。
maximumContoursint- 最多保留的轮廓数。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 按弧长范围过滤轮廓。
- 输出保留轮廓的彩色可视化图像。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓规则几何拟合
ContourPolyFit · 可执行
把轮廓拟合到规则几何(圆形/椭圆/直线/矩形),并输出可视化图像和量测值。
签名
Image fitted = ContourPolyFit(minimumContourArea: 0, maximumPoints: 8192, model: "Circle", maximumIterations: 100);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与拟合的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
modelstring- 拟合的规则几何模型类型。
maximumIterationsint- 拟合最大迭代次数。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 将面积最大的达标轮廓拟合到指定几何模型,并输出叠加图和量测值。
- maximumPoints 和 maximumIterations 当前仅完成参数校验,不参与拟合结果;不要用它们作为工作量限制。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓筛选
ContourSelect · 可执行
按面积/周长/圆度范围筛选输入轮廓集,输出彩色叠加图。
签名
Image selected = ContourSelect(minArea: 0, maxArea: 1000000000000, minPerimeter: 0, maxPerimeter: double.MaxValue, minCircularity: 0, maxCircularity: 1, maximumContours: 4096);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minAreadouble- 保留轮廓的最小面积。
maxAreadouble- 保留轮廓的最大面积。
minPerimeterdouble- 保留轮廓的最小周长。
maxPerimeterdouble- 保留轮廓的最大周长。
minCircularitydouble- 保留轮廓的最小圆形度。
maxCircularitydouble- 保留轮廓的最大圆形度。
maximumContoursint- 最多保留的轮廓数。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 按面积、周长和圆度范围筛选轮廓。
- 输出筛选后的轮廓彩色叠加图。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓平滑
ContourSmooth · 可执行
使用道格拉斯-普克折线逼近对轮廓点序列做平滑/简化。
签名
Image smoothed = ContourSmooth(minimumContourArea: 0, maximumPoints: 8192, epsilonRatio: 0.02, maximumVertices: 256, closed: true);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与平滑的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
epsilonRatiodouble- 相对于轮廓周长的逼近公差比例。
maximumVerticesint- 逼近结果允许的顶点数上限。
closedbool- 轮廓是否为闭合曲线。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 按轮廓周长比例执行道格拉斯-普克折线逼近。
- maximumPoints 当前仅完成参数校验,不参与点数限制。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
轮廓合并
ContourUnion · 可执行
把多个轮廓合并为二值掩膜或彩色叠加图。
签名
Image union = ContourUnion(maximumContours: 4096, maximumPoints: 8192, minimumContourArea: 0, outputMask: true, fill: "Filled");
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
maximumContoursint- 最多合并的轮廓数。
maximumPointsint- 允许处理的轮廓点总数上限。
minimumContourAreadouble- 参与合并的最小轮廓面积。
outputMaskbool- 是否输出二值掩膜(TRUE 输出二值图,FALSE 输出彩色叠加图)。
fillstring- 轮廓填充方式。
返回值
returnImage- outputMask=true 时返回 GRAY8 掩膜,否则返回 BGR8 叠加图。
行为
- 把面积达标的轮廓合并到同一画布,fill 支持填充或描边。
- maximumPoints 当前仅完成参数校验,不参与合并限制。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
凸包提取
ConvexHull · 可执行
从二值图像轮廓生成凸包,并输出凸包可视化图像。
签名
Image hull = ConvexHull(maximumPoints: 4096, minimumContourArea: 1);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与凸包计算的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
返回值
returnImage- 返回 BGR8 凸包可视化图像。
行为
- 计算凸包,并输出点数、面积和周长量测值。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
凸包提取
Image hull = ConvexHull(maximumPoints: 4096, minimumContourArea: 1);
轮廓查找
FindContours · 可执行
从二值图像提取轮廓并按面积、周长和圆形度过滤。
签名
Image find_contours = FindContours(minArea: 0, maxArea: double.MaxValue, minPerimeter: 0, maxPerimeter: double.MaxValue, minCircularity: 0, maxCircularity: 1);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minAreadouble- 最小轮廓面积。
maxAreadouble- 最大轮廓面积。
minPerimeterdouble- 最小轮廓周长。
maxPerimeterdouble- 最大轮廓周长。
minCircularitydouble- 最小圆形度。
maxCircularitydouble- 最大圆形度。
返回值
returnImage- 返回 BGR8 轮廓可视化图像。
行为
- 从二值图像提取轮廓并应用面积、周长和圆形度过滤器。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
轮廓查找
Image find_contours = FindContours(minArea: 0, maxArea: double.MaxValue, minPerimeter: 0, maxPerimeter: double.MaxValue, minCircularity: 0, maxCircularity: 1);
强度剖面
IntensityProfile · 可执行
沿指定线段采样图像强度值。
签名
Image intensity_profile = IntensityProfile(x1: 0, y1: 0, x2: 100, y2: 100, samplingStride: 1);
输入
inputImage- 输入图像,由视觉图连接提供。
参数
x1double- 线段起点横坐标。
y1double- 线段起点纵坐标。
x2double- 线段终点横坐标。
y2double- 线段终点纵坐标。
samplingStrideint- 采样步长。
返回值
returnImage- 返回 BGR8 强度剖面可视化图像;剖面数据通过量测值 输出。
行为
- 沿线段采样图像强度值,输出剖面曲线。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
强度剖面
Image intensity_profile = IntensityProfile(x1: 0, y1: 0, x2: 100, y2: 100, samplingStride: 1);
多边形逼近
PolygonApproximation · 可执行
将二值轮廓按相对周长公差逼近为多边形。
签名
Image polygon = PolygonApproximation(epsilonRatio: 0.01, maximumPoints: 4096, maximumVertices: 128, minimumContourArea: 1);
输入
inputImage- 8-bit 单通道二值输入图像,由视觉图连接提供。
参数
minimumContourAreadouble- 参与逼近的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
epsilonRatiodouble- 相对于轮廓周长的逼近公差比例。
maximumVerticesint- 逼近结果允许的顶点数上限。
返回值
returnImage- 返回 BGR8 多边形轮廓可视化图像。
行为
- 执行多边形逼近,并输出源点数、顶点数、面积和周长量测值。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
多边形逼近
Image polygon = PolygonApproximation(epsilonRatio: 0.01, maximumPoints: 4096, maximumVertices: 128, minimumContourArea: 1);
行均值剖面
RowMeanProfile · 可执行
计算每行像素均值形成行剖面。
签名
Image row_mean_profile = RowMeanProfile();
输入
inputImage- 输入图像,由视觉图连接提供。
参数
无参数。
返回值
returnImage- 返回 BGR8 行剖面可视化图像;每行均值通过量测值 输出。
行为
- 计算输入图像每行的像素均值,输出行剖面曲线。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
行均值剖面
Image row_mean_profile = RowMeanProfile();
亚像素图像块
SubpixelPatch · 可执行
以亚像素中心坐标提取指定宽高的图像块。
签名
Image patch = SubpixelPatch(centerX: 47.25, centerY: 39.75, height: 25, width: 31);
输入
inputImage- 输入图像,由视觉图连接提供。
参数
centerXdouble- 图像块中心的横坐标。
centerYdouble- 图像块中心的纵坐标。
widthint- 输出图像块宽度。
heightint- 输出图像块高度。
返回值
returnImage- 返回 width × height 的图像块,通道数继承输入。
行为
- 算子按亚像素中心提取图像块,并输出中心坐标与输出尺寸量测值。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:任一数值参数超出参数合同范围。VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入图像类型不受支持。
示例
亚像素图像块
Image patch = SubpixelPatch(centerX: 47.25, centerY: 39.75, height: 25, width: 31);