图像处理

二值化

把每帧转成 8 位灰度后按固定阈值、OTSU、TRIANGLE、自适应或 Sauvola 方法生成二值图
Binarization · v1.0 · by system

输入参数 10

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待二值化的图像帧列表，逐帧独立处理；空帧或空矩阵原样透传，通道数非 1/3/4 的帧因无法转灰度也原样透传
方法	`method`	enum	0	否	二值化方法索引 0~5，面板默认 0 为固定阈值；取范围外的值会命中默认分支输出灰度图副本
阈值	`threshold`	int	128	否	固定阈值分支的判定门限，默认 128；仅 method 为固定阈值时生效，OTSU 与 TRIANGLE 会忽略它
最大值	`maxVal`	int	255	否	前景像素被赋予的灰度值，默认 255；固定阈值、OTSU、TRIANGLE 与两种自适应方法都读取，Sauvola 固定用 255
自适应方法	`adaptiveMethod`	enum	0	否	自适应方法索引 0~1 对应均值、高斯，默认 0；仅 method 为自适应均值时决定局部阈值算法，自适应高斯固定用高斯
块大小	`blockSize`	int	11	否	自适应与 Sauvola 的局部窗口边长，默认 11；取值会自动调整为不小于 3 的奇数
偏移C	`c`	double	2	否	传入 adaptiveThreshold 的常数偏移量，默认 2.0；仅两种自适应方法读取，Sauvola 分支不使用它
取反	`invert`	bool	false	否	是否反转前景方向，默认 false；为真时阈值类型改用 THRESH_BINARY_INV，Sauvola 分支据它决定前景取亮区还是暗区
Sauvola K	`sauvolaK`	double	0.5	否	Sauvola 局部阈值公式中的系数 k，默认 0.5；仅在 method 选 Sauvola 时参与阈值计算，控制对标准差的敏感度
Sauvola R	`sauvolaR`	double	128	否	Sauvola 的动态范围参数 r，默认 128.0；取值自动保持不小于 1e-6 的正下限以避免除零，仅在 Sauvola 方法下生效

输出参数 3

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，逐帧输出二值图；-1=输入帧容器缺失或处理抛错（OpenCV 异常、内存不足、处理失败），此时不产出图像
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时携带具体原因，如输入图像为空、OpenCV 处理异常或处理失败，用于定位参数配置
图像	`images`	vec_img	—	否	逐帧输出单通道 8 位二值图，帧数与输入一致；空帧或无法转灰度的帧原样透传，前景值为 maxVal 或 255

接入方式

在 FlowDesigner 中将「二值化」节点加入流程画布，把上游图像或数据连接至「图像」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← 图像滤波返回图像处理形态学 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈