一文彻底看懂OpenCV的setTo()函数

Posted 2021-09-04 哈哈哈哈哈嗝哈哈哈

Index 目录索引

• 写在前面
• 函数介绍
• 函数功能演示
• 参考文章

---

写在前面

本文主要介绍OpenCV中的setTo()函数。

函数介绍

可以直接在 OpenCV参考文档 中查阅：

---

函数功能演示

通过查阅源码，我们可以看到setTo()函数的原型如下：

 /** @brief Sets all or some of the array elements to the specified value.

    This is an advanced variant of the Mat::operator=(const Scalar& s) operator.
    @param value Assigned scalar converted to the actual array type.
    @param mask Operation mask of the same size as \\*this. Its non-zero elements indicate which matrix
    elements need to be copied. The mask has to be of type CV_8U and can have 1 or multiple channels
     */
    Mat& setTo(InputArray value, InputArray mask=noArray());

用法如下：

src.setTo(0, mask);

该函数的功能，是针对图像矩阵src，在矩阵src中，把矩阵mask中元素不为0的相应像素点位置的像素值全部变为value值¹，举例说明如下：

#include<stdio.h>
#include<opencv2/opencv.hpp>

int main() {

	cv::Mat src = (Mat_<uchar>(3, 3) << 0, 100, 0, 0, 205, 160, 0, 0, 0);

	cv::Mat mask = (Mat_<uchar>(3, 3) << 0, 120, 0, 150, 0, 130, 0, 0, 0);

	src.setTo(0, mask);


	std::cout << src << std::endl;

	return 0;
}

通过Image Watch这个插件，我们可以看到经过setTo()函数前后，图像src像素值的变化：

---

setTo()函数处理前：

---

setTo()函数处理后：

通过这个案例可以发现，setTo()函数相当于是给图像src加了一个mask蒙版，mask中不为0的像素点位置，在图像src中的相应位置都要置为0或其他自定义的value值。

---

至此，想必各位已经对setTo()函数有了一个相当清晰的了解，写到这里，差不多本文也就要结束了，之所以会选择写这篇文章，是因为本人在学习setTo()这个函数时，发现网上的讲解并不是很清晰，对于小白并不是很友好，后来自己动手实践了后，才将其差不多搞明白，遂将其记录之，以助后人。如果我的这篇文章帮助到了你，那我也会感到很高兴，一个人能走多远，在于与谁同行。

---

参考文章

---

1. 007-Opencv基础： Mat类里setTo函数详解 ↩︎