跳到主要内容

形态学

用于二值区域的膨胀、腐蚀、开闭运算和连通结构处理。

自适应阈值​

AdaptiveThreshold · 可执行

按局部均值或高斯加权邻域计算每个像素的二值化阈值。

签名​

Image adaptive_threshold = AdaptiveThreshold(blockSize: 7, constant: 2, maxValue: 255, method: "Gaussian", type: "Binary");

输入​

inputImage
  • 输入
  • 必填
  • 约束 只接受 8-bit 输入。
由视觉图连接提供的 8-bit 输入图像;彩色输入在执行前转为灰度。

参数​

maxValuedouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 1-65535。
二值化最大输出值。
blockSizeint
  • 输入
  • 可选
  • 默认 11
  • 约束 范围为 3-255。必须为奇数。
局部阈值邻域边长。
constantdouble
  • 输入
  • 可选
  • 默认 2
  • 约束 范围为 -65535-65535。
从局部统计量中减去的常数。
methodstring
  • 输入
  • 可选
  • 默认 Gaussian
  • 约束 可选 Mean、Gaussian。
局部统计方法。
typestring
  • 输入
  • 可选
  • 默认 Binary
  • 约束 可选 Binary、BinaryInv。
二值输出方向。

返回值​

returnImage
返回与输入宽高相同的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子先转灰度,再调用 视觉引擎 AdaptiveThreshold。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:blockSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:数值参数超出范围。
  • VISION_PIPELINE_PARAMETER_ENUM:method 或 type 不在 允许值 枚举中。

示例​

使用高斯加权邻域的自适应阈值示例。

Image adaptive_threshold = AdaptiveThreshold(blockSize: 7, constant: 2, maxValue: 255, method: "Gaussian", type: "Binary");

清除边界连通域​

ClearBorderComponents · 可执行

清除与图像边界接触的连通域,仅保留完全在内部的区域。

签名​

Image clear_border_components = ClearBorderComponents(connectivity: 8, maximumComponents: 4096);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

connectivityint
  • 输入
  • 可选
  • 默认 8
  • 约束 只能为 4 或 8。
连通邻域。
maximumComponentsint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围为 1-4096。
最大允许分析的连通域数量。

返回值​

returnImage
返回清除边界连通域后的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子执行连通域标注,并移除触碰任一图像边界的连通域。
  • 同时输出量测:componentCount、removedComponentCount、removedPixelCount 与 remainingPixelCount。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图,或包含 0/255 之外的灰度值。
  • VISION_PIPELINE_PARAMETER_ENUM:connectivity 不是 4 或 8。

示例​

清除所有接触图像边界的 8 连通域。

Image clear_border_components = ClearBorderComponents(connectivity: 8, maximumComponents: 4096);

连通域标注​

ConnectedComponents · 可执行

对 Otsu 二值化结果执行 4/8 连通域分析,并在彩色输出图上标出满足面积下限的外接矩形。

签名​

Image connected_components = ConnectedComponents(connectivity: 8, minArea: 4);

输入​

inputImage
  • 输入
  • 必填
  • 约束 算子会先转灰度并用 Otsu 生成二值图。
由视觉图连接提供的 8-bit 输入图像。

参数​

connectivityint
  • 输入
  • 可选
  • 默认 8
  • 约束 只能为 4 或 8。
连通邻域。
minAreadouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1-Double.MaxValue。
保留并标注的最小连通域面积。

返回值​

returnImage
返回 BGR8 图像;满足面积条件的连通域以红色外接矩形标出。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 背景标签 0 不计入结果。
  • 输出量测:count 与 totalArea 两个 量测值。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:connectivity 不是 4 或 8。
  • VISION_PIPELINE_PARAMETER_RANGE:minArea 小于 1。

示例​

执行 8 连通域分析,仅保留面积 >= 4 像素的连通域。

Image connected_components = ConnectedComponents(connectivity: 8, minArea: 4);

轮廓掩膜​

ContourMask · 可执行

从严格二值图提取外轮廓,并按填充或描边模式生成单通道掩膜。

签名​

Image contour_mask = ContourMask(maximumContours: 256, maximumPoints: 8192, minimumContourArea: 0, render: "Filled", thickness: 1);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道严格二值输入图像。

参数​

minimumContourAreadouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-1e12。
参与渲染的最小轮廓面积。
maximumPointsint
  • 输入
  • 可选
  • 默认 8192
  • 约束 范围为 1-65536。
允许处理的轮廓点总数上限。
maximumContoursint
  • 输入
  • 可选
  • 默认 256
  • 约束 范围为 1-4096。
允许处理的轮廓数量上限。
renderstring
  • 输入
  • 可选
  • 默认 Filled
  • 约束 可选 Filled、Outline。
渲染模式。
thicknessint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1-255。
Outline 模式的轮廓线宽。

返回值​

returnImage
返回 GRAY8 单通道掩膜图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 同时输出量测:contourCount、pointCount 与 totalArea。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:没有满足 minimumContourArea 的外轮廓。
  • VISION_CORE_POINT_LIMIT_EXCEEDED:轮廓点总数超过 maximumPoints。
  • VISION_CORE_CONTOUR_LIMIT_EXCEEDED:轮廓数量超过 maximumContours。

示例​

从二值图提取外轮廓并生成填充掩膜。

Image contour_mask = ContourMask(maximumContours: 256, maximumPoints: 8192, minimumContourArea: 0, render: "Filled", thickness: 1);

凸包填充掩膜​

ConvexHullImage · 可执行

对二值图像的轮廓计算凸包,生成凸包填充的二值掩膜图像。

签名​

Image convex_hull_image = ConvexHullImage(maximumContours: 256, minimumContourArea: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

minimumContourAreadouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-1e12。
参与凸包计算的最小轮廓面积。
maximumContoursint
  • 输入
  • 可选
  • 默认 256
  • 约束 范围为 1-4096。
允许处理的轮廓数量上限。

返回值​

returnImage
返回 GRAY8 凸包填充掩膜图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子提取满足面积条件的外轮廓,为至少含 3 点的轮廓计算凸包并填充。
  • 同时输出量测:sourceForegroundPixelCount、sourceContourCount、hullCount、hullPixelCount 与 totalHullArea。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_CORE_CONTOUR_LIMIT_EXCEEDED:接受的凸包数量超过 maximumContours。

示例​

从二值图生成凸包填充掩膜。

Image convex_hull_image = ConvexHullImage(maximumContours: 256, minimumContourArea: 0);

距离变换​

DistanceTransform · 可执行

计算二值前景像素到最近背景像素的距离,并按显式最大距离缩放为 8-bit 图像。

签名​

Image distance_transform = DistanceTransform(distanceType: "L2", maskSize: 3, maximumDistancePixels: 32);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。必须同时包含前景像素和至少一个背景像素。
8-bit 单通道二值输入图像。

参数​

distanceTypestring
  • 输入
  • 可选
  • 默认 L2
  • 约束 可选 L1、L2、C。
距离度量。
maskSizestring
  • 输入
  • 可选
  • 默认 3
  • 约束 可选 3、5、Precise。L1/C 固定使用 3;只有 L2 可选 3、5、Precise。
距离变换掩码。
maximumDistancePixelsdouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 0.001-1000000。
映射到 8-bit 255 的距离像素值。

返回值​

returnImage
返回 GRAY8 距离强度图。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 输出量测:maximumObservedPixels、meanDistancePixels 与 pixelsPerLevel 量测值。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RELATION:distanceType 为 L1/C 但 maskSize 不是 3。
  • VISION_CORE_BINARY_INPUT_REQUIRED:输入包含 0/255 之外的灰度值。
  • VISION_CORE_BACKGROUND_REQUIRED:输入全部为前景。

示例​

将最大 32 像素距离映射到 255 的距离变换。

Image distance_transform = DistanceTransform(distanceType: "L2", maskSize: 3, maximumDistancePixels: 32);

轮廓填充​

FillContour · 可执行

使用 CComp 轮廓集合生成填充掩膜,并保留实现定义的孔洞挖空规则。

签名​

Image fill_contour = FillContour(maximumContours: 256, minimumContourArea: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

minimumContourAreadouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-1e12。
参与填充的最小轮廓面积。
maximumContoursint
  • 输入
  • 可选
  • 默认 256
  • 约束 范围为 1-4096。
允许处理的轮廓数量上限。

返回值​

returnImage
返回 GRAY8 轮廓填充掩膜图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子提取包含孔洞层级的轮廓,并按轮廓层级填充前景或保留孔洞。
  • 同时输出量测:sourceForegroundPixelCount、sourceContourCount、filledContourCount、filledPixelCount 与 filledRatio。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_CORE_CONTOUR_LIMIT_EXCEEDED:参与填充的轮廓数量超过 maximumContours。

示例​

按当前 CComp 轮廓填充规则生成二值掩膜。

Image fill_contour = FillContour(maximumContours: 256, minimumContourArea: 0);

孔洞填充​

FillHoles · 可执行

从带 1 像素边框的背景执行洪泛填充,并把二值前景内部孔洞填满。

签名​

Image fill_holes = FillHoles(connectivity: 8, maximumFilledPixels: 4096);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255 并且必须包含前景。宽、高均不得超过 32766。
8-bit 单通道二值输入图像。

参数​

connectivityint
  • 输入
  • 可选
  • 默认 8
  • 约束 只能为 4 或 8。
背景洪泛填充的连通邻域。
maximumFilledPixelsint
  • 输入
  • 可选
  • 默认 16777216
  • 约束 范围为 1-16777216。
本次允许新增的最大前景像素数。

返回值​

returnImage
返回与输入宽高相同的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 输出量测:filledPixelCount 与 foregroundPixelCount 量测值。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入包含 0/255 之外的灰度值。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含前景像素。
  • VISION_CORE_FILLED_PIXEL_LIMIT_EXCEEDED:新增前景像素数超过 maximumFilledPixels。

示例​

使用 8 连通填充内部孔洞,上限 4096 像素。

Image fill_holes = FillHoles(connectivity: 8, maximumFilledPixels: 4096);

种子区域填充​

FloodFill · 可执行

从指定图像坐标出发,按 4/8 连通和差值范围填充二值区域。

签名​

Image flood_fill = FloodFill(connectivity: 8, fixedRange: true, lowerDifference: 0, maximumFilledPixels: 4096, newValue: 255, seedX: 0, seedY: 0, upperDifference: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

seedXint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-输入宽度减 1。
种子点横坐标。
seedYint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-输入高度减 1。
种子点纵坐标。
newValueint
  • 输入
  • 可选
  • 默认 255
  • 约束 只能为 0 或 255。
填充后的二值像素值。
connectivityint
  • 输入
  • 可选
  • 默认 4
  • 约束 只能为 4 或 8。
连通邻域。
lowerDifferenceint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-255。
允许的下差值。
upperDifferenceint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-255。
允许的上差值。
fixedRangebool
  • 输入
  • 可选
  • 默认 TRUE
是否相对种子像素使用固定差值范围。
maximumFilledPixelsint
  • 输入
  • 可选
  • 默认 16777216
  • 约束 范围为 1-16777216。
允许填充的最大区域像素数。

返回值​

returnImage
返回填充后的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子复制输入后调用 视觉引擎 FloodFill,并输出量测:filledPixelCount 与填充外接框 量测值。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入包含 0/255 之外的灰度值。
  • VISION_CORE_FILLED_PIXEL_LIMIT_EXCEEDED:填充区域像素数超过 maximumFilledPixels。

示例​

使用 8 连通从原点开始填充,上限 4096 像素。

Image flood_fill = FloodFill(connectivity: 8, fixedRange: true, lowerDifference: 0, maximumFilledPixels: 4096, newValue: 255, seedX: 0, seedY: 0, upperDifference: 0);

GrabCut 分割​

GrabCutSegmentation · 可执行

使用矩形 ROI 初始化 GrabCut 图割,把 8-bit BGR 图像分离为前景掩膜或黑底前景图。

签名​

Image grabcut_segmentation = GrabCutSegmentation(x: 10, y: 10, width: 200, height: 200, iterations: 5, output: "BinaryMask");

输入​

inputImage
  • 输入
  • 必填
  • 约束 必须为非空 8-bit、3 通道图像。输入像素数不得超过 4194304。
8-bit 三通道 BGR 输入图像。

参数​

xint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-输入宽度减 1。
ROI 左上角横坐标。
yint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-输入高度减 1。
ROI 左上角纵坐标。
widthint
  • 输入
  • 可选
  • 默认 (input.Width - x)
  • 约束 范围为 1-输入宽度。ROI 不超出输入图像边界。宽高至少为 2。
ROI 宽度。
heightint
  • 输入
  • 可选
  • 默认 (input.Height - y)
  • 约束 范围为 1-输入高度。ROI 不超出输入图像边界。宽高至少为 2。
ROI 高度。
iterationsint
  • 输入
  • 可选
  • 默认 5
  • 约束 范围为 1-20。
图割迭代次数。
outputstring
  • 输入
  • 可选
  • 默认 MaskedImage
  • 约束 可选 MaskedImage、BinaryMask。
输出模式。

返回值​

returnImage
output=MaskedImage 时返回黑色背景上的 BGR8 前景图;output=BinaryMask 时返回 GRAY8 二值掩膜。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子使用固定随机种子执行矩形初始化的 GrabCut,相同输入和参数可得到一致结果。
  • ROI 不得覆盖整幅图,必须至少保留一个明确背景像素。
  • 同时输出量测:foregroundPixelCount、foregroundRatio、rectX、rectY、rectWidth 与 rectHeight。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RELATION:ROI 越界或宽、高小于 2。
  • VISION_PIPELINE_PARAMETER_ENUM:output 不是 MaskedImage 或 BinaryMask。

示例​

从 (10,10) 开始定义 200x200 ROI 执行 5 迭代图割。

Image grabcut_segmentation = GrabCutSegmentation(x: 10, y: 10, width: 200, height: 200, iterations: 5, output: "BinaryMask");

击中击不中变换​

HitMiss · 可执行

执行形态学击中击不中变换,检测符合特定结构元素模式的像素。

签名​

Image hit_miss = HitMiss(iterations: 1, kernelSize: 3, shape: "Rect");

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

shapestring
  • 输入
  • 可选
  • 默认 Rect
  • 约束 可选 Rect、Ellipse、Cross。
结构元素形状。
kernelSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围为 1-255。必须为奇数。
结构元素边长。
iterationsint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1-100。
变换迭代次数。

返回值​

returnImage
返回 GRAY8 击中击不中结果图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子使用指定形状和尺寸的结构元素执行击中击不中变换。
  • 同时输出量测:sourceForegroundPixelCount、hitMissPixelCount 与 hitMissPixelRatio。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_PIPELINE_PARAMETER_ODD:kernelSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:kernelSize 或 iterations 超出 允许值 范围。
  • VISION_PIPELINE_PARAMETER_ENUM:shape 不在 Rect、Ellipse、Cross 中。

示例​

使用 3x3 矩形结构元素执行击中击不中变换。

Image hit_miss = HitMiss(iterations: 1, kernelSize: 3, shape: "Rect");

形态学重建​

MorphReconstruct · 可执行

先由输入掩膜腐蚀生成 marker,再在原输入约束下执行测地膨胀直至收敛或达到迭代上限。

签名​

Image morph_reconstruct = MorphReconstruct(kernelSize: 3, maximumIterations: 256, shape: "Rect");

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。必须包含 255 前景像素。该算子没有第二张外部 marker 或 mask 图像端口。
用于同时派生 marker 与约束掩膜的 8-bit 单通道严格二值输入图像。

参数​

shapestring
  • 输入
  • 可选
  • 默认 Rect
  • 约束 可选 Rect、Ellipse、Cross、Octagon。
结构元素形状。
kernelSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围为 1-255。必须为奇数。
结构元素边长。
maximumIterationsint
  • 输入
  • 可选
  • 默认 256
  • 约束 范围为 1-4096。
最大膨胀迭代次数。

返回值​

returnImage
返回重建后的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子先对 input 腐蚀一次生成 marker,再反复执行 dilate(marker) AND input。
  • 到像素不再变化或达到 maximumIterations 时停止。
  • 同时输出量测:sourceForegroundPixelCount、markerPixelCount、reconstructedPixelCount、iterationsExecuted 与 reconstructRatio。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_PIPELINE_PARAMETER_ODD:kernelSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:kernelSize 或 maximumIterations 超出 允许值 范围。

示例​

使用 3x3 矩形结构元素执行形态学重建。

Image morph_reconstruct = MorphReconstruct(kernelSize: 3, maximumIterations: 256, shape: "Rect");

形态学变换​

Morphology · 可执行

使用矩形、椭圆或十字结构元素执行腐蚀、膨胀、开闭运算及常用形态学差分。

签名​

Image morphology = Morphology(iterations: 2, kernelSize: 5, operation: "Close", shape: "Ellipse");

输入​

inputImage
  • 输入
  • 必填
  • 约束 输出宽高、通道数和单通道字节数继承输入。
由视觉图连接提供的输入图像。

参数​

operationstring
  • 输入
  • 可选
  • 默认 Open
  • 约束 可选 Erode、Dilate、Open、Close、Gradient、TopHat、BlackHat。
形态学操作。
shapestring
  • 输入
  • 可选
  • 默认 Rect
  • 约束 可选 Rect、Ellipse、Cross、Octagon。
结构元素形状。
kernelSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围为 1-255。必须为奇数。
结构元素边长。
iterationsint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1-100。
迭代次数。

返回值​

returnImage
返回与输入形状一致的形态学处理图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子使用指定形状和尺寸的结构元素执行所选形态学操作。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:operation 或 shape 不在 允许值 枚举中。
  • VISION_PIPELINE_PARAMETER_ODD:kernelSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:kernelSize 或 iterations 超出范围。

示例​

使用椭圆结构元素执行两次闭运算。

Image morphology = Morphology(iterations: 2, kernelSize: 5, operation: "Close", shape: "Ellipse");

Niblack 二值化​

NiblackBinarize · 可执行

使用 Niblack、Sauvola、Wolf 或 Nick 局部算法对灰度图进行自适应二值化。

签名​

Image niblack_binarize = NiblackBinarize(blockSize: 15, dynamicRange: 128, k: -0.2, maxValue: 255, method: "Sauvola", type: "Binary");

输入​

inputImage
  • 输入
  • 必填
  • 约束 算子不做隐式灰度转换。blockSize 不得超过输入宽度或高度。输入像素数不得超过 16777216。
8-bit 单通道灰度输入图像。

参数​

maxValuedouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 1-255。
二值化最大输出值。
blockSizeint
  • 输入
  • 可选
  • 默认 15
  • 约束 范围为 3-255。必须为奇数。
局部邻域边长。
kdouble
  • 输入
  • 可选
  • 默认 -0.2
  • 约束 范围为 -10-10。
用户定义的 Niblack 类型敏感系数。
methodstring
  • 输入
  • 可选
  • 默认 Niblack
  • 约束 可选 Niblack、Sauvola、Wolf、Nick。
局部二值化算法。
dynamicRangedouble
  • 输入
  • 可选
  • 默认 128
  • 约束 范围为 0.000001-65535。
Wolf/Nick 模式的标准差动态范围。
typestring
  • 输入
  • 可选
  • 默认 Binary
  • 约束 可选 Binary、BinaryInv。
二值输出方向。

返回值​

returnImage
返回与输入宽高相同的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子直接对 8-bit 单通道输入执行局部阈值计算。
  • 同时输出量测:foregroundPixelCount 与 foregroundRatio。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:blockSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:数值参数超出 允许值 范围。
  • VISION_PIPELINE_PARAMETER_ENUM:method 或 type 不在 允许值 枚举中。

示例​

使用 Sauvola 局部二值化。

Image niblack_binarize = NiblackBinarize(blockSize: 15, dynamicRange: 128, k: -0.2, maxValue: 255, method: "Sauvola", type: "Binary");

区域面积统计​

RegionArea · 可执行

对二值图像执行连通域分析,输出每个连通域的面积统计(不修改像素)。

签名​

Image region_area = RegionArea(connectivity: 8, maximumComponents: 4096);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

connectivityint
  • 输入
  • 可选
  • 默认 8
  • 约束 只能为 4 或 8。
连通邻域。
maximumComponentsint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围为 1-4096。
最大分析连通域数量。

返回值​

returnImage
返回原始输入图像(不修改像素);面积统计通过 量测值 输出。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 纯统计算子,不修改像素,返回输入图像的独立副本。
  • 同时输出量测:sourceForegroundPixelCount、componentCount、totalArea、boundingBoxX、boundingBoxY、boundingBoxWidth、boundingBoxHeight、boundingBoxArea、fillRatio 与 meanComponentArea。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:连通域数量超过 maximumComponents,或输出资源超过受控上限。
  • VISION_PIPELINE_PARAMETER_ENUM:connectivity 不是 4 或 8。

示例​

对二值图执行 8 连通域面积统计。

Image region_area = RegionArea(connectivity: 8, maximumComponents: 4096);

区域取反​

RegionComplement · 可执行

对二值图像的前景和背景取反(255 变 0,0 变 255)。

签名​

Image region_complement = RegionComplement();

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

无参数。

返回值​

returnImage
返回取反后的 GRAY8 二值图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 同时输出量测:sourceForegroundPixelCount、sourceBackgroundPixelCount、complementPixelCount 与 complementRatio。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。

示例​

对二值图像前景背景取反。

Image region_complement = RegionComplement();

区域差集​

RegionDifference · 可执行

从凸包中减去前景区域,输出凹陷区域(凹缺陷)的二值掩膜。

签名​

Image region_difference = RegionDifference(maximumContours: 256, minimumContourArea: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

minimumContourAreadouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0-1e12。
参与计算的最小轮廓面积。
maximumContoursint
  • 输入
  • 可选
  • 默认 256
  • 约束 范围为 1-4096。
允许处理的轮廓数量上限。

返回值​

returnImage
返回 GRAY8 凹陷区域掩膜图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子对达标外轮廓计算并填充凸包,再执行 hullMask - input。
  • 同时输出量测:sourceForegroundPixelCount、sourceContourCount、hullCount、differencePixelCount 与 differenceRatio。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_CORE_CONTOUR_LIMIT_EXCEEDED:接受的凸包数量超过 maximumContours。

示例​

计算凸包与前景的差集,输出凹陷区域。

Image region_difference = RegionDifference(maximumContours: 256, minimumContourArea: 0);

区域交集​

RegionIntersection · 可执行

计算前景区域与平移副本之间的交集,输出二值掩膜。

签名​

Image region_intersection = RegionIntersection(shiftX: 10, shiftY: 10);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

shiftXint
  • 输入
  • 可选
  • 默认 0
  • 约束 允许值 静态范围为 -65535–65535。执行时还必须落在 -input.Width–input.Width。
前景平移副本的 X 偏移。
shiftYint
  • 输入
  • 可选
  • 默认 0
  • 约束 允许值 静态范围为 -65535–65535。执行时还必须落在 -input.Height–input.Height。
前景平移副本的 Y 偏移。

返回值​

returnImage
返回 GRAY8 交集掩膜图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子生成平移副本,再与原图执行按位与。
  • 同时输出量测:sourceForegroundPixelCount、shiftX、shiftY、intersectionPixelCount 与 intersectionRatio。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_CORE_RESULT_OUT_OF_BOUNDS:shiftX 或 shiftY 超过当前输入宽高允许的动态范围。

示例​

计算前景与其右下平移 (10,10) 副本的交集。

Image region_intersection = RegionIntersection(shiftX: 10, shiftY: 10);

区域并集​

RegionUnion · 可执行

连通域分析后过滤面积,输出满足面积条件的连通域并集掩膜。

签名​

Image region_union = RegionUnion(connectivity: 8, maximumComponents: 4096, minimumArea: 10);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。
8-bit 单通道二值输入图像。

参数​

connectivityint
  • 输入
  • 可选
  • 默认 8
  • 约束 只能为 4 或 8。
连通邻域。
minimumAreadouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0-1e12。
保留连通域的最小面积。
maximumComponentsint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围为 1-4096。
最大分析连通域数量。

返回值​

returnImage
返回 GRAY8 并集掩膜图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子分析严格二值输入,并将面积不小于 minimumArea 的连通域合并为输出掩膜。
  • 同时输出量测:sourceForegroundPixelCount、componentCount、acceptedComponentCount 与 unionPixelCount。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:连通域数量超过 maximumComponents。
  • VISION_PIPELINE_PARAMETER_ENUM:connectivity 不是 4 或 8。

示例​

保留面积 >= 10 的 8 连通域并集。

Image region_union = RegionUnion(connectivity: 8, maximumComponents: 4096, minimumArea: 10);

骨架化​

Skeletonize · 可执行

对二值图像执行 Zhang-Suen 或 Guo-Hall 细化算法,提取前景区域的单像素骨架。

签名​

Image skeletonize = Skeletonize(algorithm: "GuoHall");

输入​

inputImage
  • 输入
  • 必填
  • 约束 必须为 8-bit 单通道,像素只能为 0 或 255。允许全背景输入;此时输出为空骨架。输入像素数不得超过 16777216。
8-bit 单通道二值输入图像。

参数​

algorithmstring
  • 输入
  • 可选
  • 默认 ZhangSuen
  • 约束 可选 ZhangSuen、GuoHall。
细化算法。

返回值​

returnImage
返回与输入宽高相同的 GRAY8 骨架图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 同时输出量测:sourceForegroundPixelCount 与 skeletonPixelCount。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_PIPELINE_PARAMETER_ENUM:algorithm 不是 ZhangSuen 或 GuoHall。

示例​

使用 Guo-Hall 算法执行骨架化。

Image skeletonize = Skeletonize(algorithm: "GuoHall");

骨架剪枝​

ThinningRemoval · 可执行

先执行 Zhang-Suen 或 Guo-Hall 细化,再按指定轮数移除 8 邻域中仅有一个相邻前景像素的端点。

签名​

Image thinning_removal = ThinningRemoval(algorithm: "ZhangSuen", pruneIterations: 5);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。必须包含 255 前景像素;输入不要求预先是单像素骨架。
8-bit 单通道严格二值输入图像。

参数​

algorithmstring
  • 输入
  • 可选
  • 默认 ZhangSuen
  • 约束 可选 ZhangSuen、GuoHall。
细化算法(用于端点检测逻辑)。
pruneIterationsint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围为 0-32。
剪枝迭代次数。

返回值​

returnImage
返回剪枝后的 GRAY8 骨架图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子先执行骨架化,再逐轮移除检测到的端点;没有端点时提前停止。
  • 同时输出量测:sourceForegroundPixelCount、skeletonPixelCount、prunedPixelCount、removedBranchPixelCount 与 pruneIterations。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_PIPELINE_PARAMETER_RANGE:pruneIterations 不在 0–32。
  • VISION_PIPELINE_PARAMETER_ENUM:algorithm 不是 ZhangSuen 或 GuoHall。

示例​

对骨架执行 5 轮端点剪枝。

Image thinning_removal = ThinningRemoval(algorithm: "ZhangSuen", pruneIterations: 5);

阈值处理​

Threshold · 可执行

将输入图像转为灰度后执行固定阈值、Otsu 或 Triangle 阈值处理。

签名​

Image threshold = Threshold(maxValue: 255, threshold: 127, type: "Binary");

输入​

inputImage
  • 输入
  • 必填
  • 约束 自动阈值模式 Otsu/OtsuInv/Triangle/TriangleInv 只接受 8-bit 输入。
由视觉图连接提供的输入图像。

参数​

thresholddouble
  • 输入
  • 可选
  • 默认 127
  • 约束 范围为 0-65535。
固定阈值。
maxValuedouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 0-65535。
最大输出值。
typestring
  • 输入
  • 可选
  • 默认 Binary
  • 约束 可选 Binary、BinaryInv、Trunc、ToZero、ToZeroInv、Otsu、OtsuInv、Triangle、TriangleInv。
阈值模式。

返回值​

returnImage
返回与输入宽高相同的单通道图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子先把 3/4 通道输入转为灰度。
  • Otsu 与 Triangle 模式忽略 threshold 传入 0。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:threshold 或 maxValue 超出范围。
  • VISION_PIPELINE_PARAMETER_ENUM:type 不在 允许值 枚举中。

示例​

固定阈值 127 二值化。

Image threshold = Threshold(maxValue: 255, threshold: 127, type: "Binary");

分水岭分割​

Watershed · 可执行

从严格二值输入的距离变换派生前景 marker,并执行标记控制的分水岭分割。

签名​

Image watershed = Watershed(connectivity: 4, foregroundThresholdRatio: 0.5, maximumRegions: 1024);

输入​

inputImage
  • 输入
  • 必填
  • 约束 像素只能为 0 或 255。必须包含 255 前景像素。
8-bit 单通道严格二值输入图像。

参数​

connectivityint
  • 输入
  • 可选
  • 默认 8
  • 约束 只能为 4 或 8。
前景 marker 连通域分析使用的邻域。
foregroundThresholdRatiodouble
  • 输入
  • 可选
  • 默认 0.5
  • 约束 范围为 0.000001-0.999999。必须严格在 (0, 1) 开区间。
前景阈值比例。
maximumRegionsint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围为 1-65535。
最大分割区域数。

返回值​

returnImage
返回 BGR8 区域边界可视化图像。

行为​

  • 输入图像由上游节点连接,调用只填写本算子的参数。
  • 算子对严格二值输入计算 L2/Mask3 距离变换,以 distanceMaximum × foregroundThresholdRatio 生成 sure-foreground marker。
  • 背景 marker 由 3×3 膨胀派生;分水岭边界以红色、区域像素以白色写入 BGR8 输出。
  • 同时输出量测:sourceForegroundPixelCount、regionCount、regionPixelCount 与 boundaryPixelCount。

错误与限制​

  • VISION_CORE_BINARY_INPUT_REQUIRED:输入不是 8-bit 单通道严格二值图。
  • VISION_CORE_FOREGROUND_REQUIRED:输入不包含 255 前景像素。
  • VISION_PIPELINE_PARAMETER_RELATION:foregroundThresholdRatio 不在 (0, 1) 开区间。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:前景 marker 区域数超过 maximumRegions。
  • VISION_PIPELINE_PARAMETER_ENUM:connectivity 不是 4 或 8。

示例​

执行标记控制的分水岭分割。

Image watershed = Watershed(connectivity: 4, foregroundThresholdRatio: 0.5, maximumRegions: 1024);