Skip to content

轮廓提取 V1 ​

当前发布边界 ​

此算法为 Experimental,默认不展示或执行;门禁和错误码见统一平台发布清单。

轮廓提取使用 OpenCvSharp,提供独立的参数、ROI 和结构化结果契约。亚像素边缘、直线和圆拟合由各自算法提供。

稳定身份和宿主能力 ​

  • AlgorithmId:colorvision.analysis.contours
  • 算法版本:1.0.0
  • 参数 schema:1
  • provider:colorvision.contours.cpu,CPU / Local / deterministic
  • 输入:一个 Gray8、Gray16、Gray32Float、Bgr/Bgra 8/16/float 中立帧
  • ROI:整图、矩形、圆或多边形;物理坐标按输入 DPI 统一换算
  • 宿主:ImageView、结构化 Batch、本地 Flow/headless
  • 输出:无图像输出;格式转换不是本算法职责

Copilot 当前获批的批处理工具只接收图像输出。轮廓 descriptor 因而不声明 Copilot,也不进入自动白名单;不能把结构化结果伪装成图像以绕过该边界。

参数与二值化规则 ​

ContourAnalysisParameters 是 ImageView、Batch 和本地 Flow 共用的唯一参数模型:

  • Threshold 使用 0..255 标称刻度,16 位映射到 0..65535,float 映射到 0..1;
  • ForegroundPolarity 选择 Bright(大于等于阈值)或 Dark(小于等于阈值);
  • 彩色输入按 0.114B + 0.587G + 0.299R 计算亮度,alpha 不参与;NaN/Infinity 计为无效像素且不进入前景;
  • Blob 与轮廓 provider 共用 BinaryAnalysisMaskBuilder,避免相同格式/阈值语义形成两套实现;
  • RetrievalMode 支持 External、List、Tree;ApproximationMode 支持 None、Simple;
  • SimplificationEpsilon > 0 时,在提取结果上执行闭合 Douglas–Peucker 简化,面积、周长和质心描述简化后实际输出的几何;
  • 可按面积、周长、点数、圆度、实心度和是否接触图像边界筛选;上限为 0 的最大值参数表示不限。

MaximumCandidates、MaximumTotalPoints 和 MaximumOverlayContours 分别限制候选数、全部结构化几何点数和仅用于显示的 overlay 数。前两项超限返回 contour_limit_exceeded 或 contour_point_limit_exceeded 结构化失败,不返回截断后易误用的数据;overlay 超限只产生诊断,Table 和 Geometry 仍完整。

Result artifact ​

成功结果包含:

  • contour-summary:ROI/前景/无效像素、候选/接受/拒绝数、结构化点数、接受轮廓总面积和总周长;
  • contours:每个候选的 next/previous/child/parent 层级、接受状态、稳定过滤原因、面积、有向面积、周长、点数、边界框、质心、圆度、实心度、填充率和图像边界状态;
  • contour-geometry:ROI 与每条轮廓的 Point/Line/Polygon;坐标是全图像素坐标,轮廓闭合是隐含语义;
  • contour-overlay:transient ROI 和通过筛选的轮廓;关闭结果窗口、切图、Clear 或提交新图时由统一 overlay 管理器移除实际 Visual;
  • contour-provenance:schema colorvision.analysis.contours/v1、输入格式/DPI、ROI、参数、阈值规则、坐标和层级语义。

Geometry 的 Confidence 使用实心度(轮廓面积/凸包面积),它是确定性的几何质量量,不是分类概率。拒绝原因使用稳定代码,例如 area_below_minimum、perimeter_above_maximum、point_count_below_minimum、circularity_below_minimum、solidity_below_minimum 和 touches_image_border。

保留的 ImageView、Batch 与 Flow 适配(默认禁用) ​

下述入口和结果窗代码保留用于验证;默认产品运行时仍受 Experimental 门禁阻止,不表示当前菜单可执行。

ImageView 的“算法调用 → 轮廓提取”提供整图、矩形、圆和多边形入口。结果窗口显示完整 Table,可导出 CSV/JSON,并用统一 ImageAlgorithmAnalysisSession 和 invocation coordinator 遵守 document/revision/latest-wins;窗口关闭会释放 Result 和 transient Visual。

结构化 Batch 使用 BatchAlgorithmAnalysisProcessor 导出相同 Invocation 的 JSON/CSV;本地 Flow 使用 LocalFlowImageAlgorithmAdapter 返回同一 Result artifact。旧 MQTT/设备 AlgorithmNode 保持独立 execution plane,不受影响。

数值、性能与所有权门禁 ​

依据已知几何核对面积、周长、质心与孔洞层级。输入帧始终只读。

执行只分配一个 Gray8 二值 mask,OpenCV 直接借用该工作缓冲区提取轮廓;随后只保存最终点集和结构化 artifact。取消在 mask 扫描和候选测量循环中轮询,并在 native findContours 前后检查;正在进行的单次 native 调用不能被中途打断,这是当前明确的 provider 边界。

彩色 4K 输入的原生工作集可能明显高于灰度。复杂前景的点集和层级会随轮廓数增长,现场按目标分辨率、位深和实际内容复核峰值内存,保留候选与总点数上限。

基于 MIT License 发布。