形态学
用于二值区域的膨胀、腐蚀、开闭运算和连通结构处理。
自适应阈值
AdaptiveThreshold · 可执行
按局部均值或高斯加权邻域计算每个像素的二值化阈值。
签名
Image adaptive_threshold = AdaptiveThreshold(blockSize: 7, constant: 2, maxValue: 255, method: "Gaussian", type: "Binary");
输入
inputImage- 由视觉图连接提供的 8-bit 输入图像;彩色输入在执行前转为灰度。
参数
maxValuedouble- 二值化最大输出值。
blockSizeint- 局部阈值邻域边长。
constantdouble- 从局部统计量中减去的常数。
methodstring- 局部统计方法。
typestring- 二值输出方向。
返回值
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- 8-bit 单通道二值输入图像。
参数
connectivityint- 连通邻域。
maximumComponentsint- 最大允许分析的连通域数量。
返回值
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- 由视觉图连接提供的 8-bit 输入图像。
参数
connectivityint- 连通邻域。
minAreadouble- 保留并标注的最小连通域面积。
返回值
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- 8-bit 单通道严格二值输入图像。
参数
minimumContourAreadouble- 参与渲染的最小轮廓面积。
maximumPointsint- 允许处理的轮廓点总数上限。
maximumContoursint- 允许处理的轮廓数量上限。
renderstring- 渲染模式。
thicknessint- 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- 8-bit 单通道二值输入图像。
参数
minimumContourAreadouble- 参与凸包计算的最小轮廓面积。
maximumContoursint- 允许处理的轮廓数量上限。
返回值
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- 8-bit 单通道二值输入图像。
参数
distanceTypestring- 距离度量。
maskSizestring- 距离变换掩码。
maximumDistancePixelsdouble- 映射到 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- 8-bit 单通道二值输入图像。
参数
minimumContourAreadouble- 参与填充的最小轮廓面积。
maximumContoursint- 允许处理的轮廓数量上限。
返回值
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- 8-bit 单通道二值输入图像。
参数
connectivityint- 背景洪泛填充的连通邻域。
maximumFilledPixelsint- 本次允许新增的最大前景像素数。
返回值
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- 8-bit 单通道二值输入图像。
参数
seedXint- 种子点横坐标。
seedYint- 种子点纵坐标。
newValueint- 填充后的二值像素值。
connectivityint- 连通邻域。
lowerDifferenceint- 允许的下差值。
upperDifferenceint- 允许的上差值。
fixedRangebool- 是否相对种子像素使用固定差值范围。
maximumFilledPixelsint- 允许填充的最大区域像素数。
返回值
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 三通道 BGR 输入图像。
参数
xint- ROI 左上角横坐标。
yint- ROI 左上角纵坐标。
widthint- ROI 宽度。
heightint- ROI 高度。
iterationsint- 图割迭代次数。
outputstring- 输出模式。
返回值
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- 8-bit 单通道二值输入图像。
参数
shapestring- 结构元素形状。
kernelSizeint- 结构元素边长。
iterationsint- 变换迭代次数。
返回值
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- 用于同时派生 marker 与约束掩膜的 8-bit 单通道严格二值输入图像。
参数
shapestring- 结构元素形状。
kernelSizeint- 结构元素边长。
maximumIterationsint- 最大膨胀迭代次数。
返回值
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- 形态学操作。
shapestring- 结构元素形状。
kernelSizeint- 结构元素边长。
iterationsint- 迭代次数。
返回值
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- 8-bit 单通道灰度输入图像。
参数
maxValuedouble- 二值化最大输出值。
blockSizeint- 局部邻域边长。
kdouble- 用户定义的 Niblack 类型敏感系数。
methodstring- 局部二值化算法。
dynamicRangedouble- Wolf/Nick 模式的标准差动态范围。
typestring- 二值输出方向。
返回值
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- 8-bit 单通道二值输入图像。
参数
connectivityint- 连通邻域。
maximumComponentsint- 最大分析连通域数量。
返回值
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- 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- 8-bit 单通道二值输入图像。
参数
minimumContourAreadouble- 参与计算的最小轮廓面积。
maximumContoursint- 允许处理的轮廓数量上限。
返回值
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- 8-bit 单通道二值输入图像。
参数
shiftXint- 前景平移副本的 X 偏移。
shiftYint- 前景平移副本的 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- 8-bit 单通道二值输入图像。
参数
connectivityint- 连通邻域。
minimumAreadouble- 保留连通域的最小面积。
maximumComponentsint- 最大分析连通域数量。
返回值
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 单通道二值输入图像。
参数
algorithmstring- 细化算法。
返回值
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- 8-bit 单通道严格二值输入图像。
参数
algorithmstring- 细化算法(用于端点检测逻辑)。
pruneIterationsint- 剪枝迭代次数。
返回值
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- 由视觉图连接提供的输入图像。
参数
thresholddouble- 固定阈值。
maxValuedouble- 最大输出值。
typestring- 阈值模式。
返回值
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- 8-bit 单通道严格二值输入图像。
参数
connectivityint- 前景 marker 连通域分析使用的邻域。
foregroundThresholdRatiodouble- 前景阈值比例。
maximumRegionsint- 最大分割区域数。
返回值
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);