14-OpenCVSharp--Mat 类详细使用方法（矩阵Mat）

专栏地址：

《 OpenCV功能使用详解200篇 》

《 OpenCV算子使用详解300篇 》

《 Halcon算子使用详解300篇 》

内容持续更新 ，欢迎点击订阅

OpenCVSharp Mat 类详细剖析

OpenCVSharp 是 OpenCV 的 .NET 封装，提供了一系列强大的计算机视觉功能。在 OpenCVSharp 中，Mat 类是处理图像和矩阵的核心类之一。理解 Mat 类的原理、如何创建、它的参数、常用属性和方法，以及与其他数据类型之间的转换，对于高效使用 OpenCVSharp 至关重要。以下将从多个维度深入剖析 Mat 类。

一、Mat 类的原理

Mat 是 OpenCV 中用于表示图像、矩阵以及各种数据结构的基础数据类型。它不仅仅代表图像本身，还能处理其他类型的多维矩阵（如一维数组、二维数组等）。在 OpenCV 中，图像通常表示为一个多维矩阵，其中每个元素表示图像中的一个像素值。Mat 类是 OpenCV 中实现这一概念的基础。

Mat 内部工作机制

内存管理：Mat 通过引用计数来管理内存，这意味着当多个 Mat 对象指向同一块内存时，只有当最后一个引用被销毁时，内存才会被释放。Mat 对象通过 clone() 方法来创建一个新的内存副本。

数据存储：Mat 内部存储数据是以单通道或多通道的方式表示的。例如，对于一个 RGB 图像，Mat 存储的是三个通道的数据。OpenCV 提供了不同的 MatType 来描述这些数据类型。

引用计数：Mat 使用引用计数来优化内存使用。当你将一个 Mat 对象赋值给另一个 Mat 时，实际上并没有复制数据，而是增加了引用计数。只有当引用计数为零时，内存才会被释放。

Mat 结构的基本组成

行数（rows）：图像的高度，表示图像的行数。列数（cols）：图像的宽度，表示图像的列数。通道数（channels）：每个像素点的颜色通道数（例如，RGB 图像有 3 个通道）。数据类型（depth）：表示每个像素数据的类型，可能是 CV_8U, CV_32F 等。数据指针（data）：指向矩阵数据的内存位置。

二、Mat 类的常见参数与类型

2.1 Mat 的构造函数

Mat 类有多个构造函数，允许你通过不同方式创建 Mat 对象。

空 Mat：

Mat mat = new Mat();

指定尺寸和类型的 Mat：

Mat mat = new Mat(3, 3, MatType.CV_8UC1); // 创建一个 3x3 大小，单通道（灰度图），8 位无符号整数类型的矩阵

通过已有图像创建 Mat：

Mat mat = Cv2.ImRead("image.jpg"); // 从文件读取图像到 Mat

通过矩阵数据创建 Mat：

Mat mat = new Mat(3, 3, MatType.CV_8UC1, new Scalar(255)); // 创建一个 3x3 大小的矩阵，并初始化为 255

通过指针创建 Mat：

IntPtr dataPointer = IntPtr.Zero; // 数据指针

Mat mat = new Mat(3, 3, MatType.CV_8UC1, dataPointer);

2.2 MatType 枚举

MatType 枚举表示了矩阵的数据类型和通道数。在 OpenCV 中，数据类型和通道数通常是以 CV_ 开头的常量表示。常见的类型包括：

CV_8U: 8 位无符号整数CV_32F: 32 位浮点数CV_64F: 64 位浮点数CV_8UC3: 8 位无符号整数，3 个通道（例如，RGB 图像）CV_32FC1: 32 位浮点数，单通道

MatType 定义了矩阵的元素类型、通道数和存储深度。例如，MatType.CV_8UC3 表示每个像素点为 8 位无符号整数，具有 3 个通道（通常用于彩色图像）。

2.3 Scalar 和 Mat 初始化

Scalar 是一个四元素的向量，用于表示单通道和多通道数据类型的颜色或者像素值。例如，可以用 Scalar 初始化单通道或者多通道的 Mat：

Mat mat = new Mat(2, 2, MatType.CV_8UC3, new Scalar(255, 0, 0)); // 创建一个 2x2 的 RGB 图像，所有像素初始化为红色

三、Mat 类的常用属性与方法

3.1 常用属性

rows 和 cols：获取矩阵的行数和列数。

int rows = mat.Rows;

int cols = mat.Cols;

channels()：获取矩阵的通道数。

int channels = mat.Channels();

type()：获取矩阵的数据类型。

int type = mat.Type();

depth()：获取矩阵的深度（数据类型的基础类型）。

int depth = mat.Depth();

dims：获取矩阵的维度数（例如，2D 图像的维度是 2）。

int dims = mat.Dims;

3.2 常用方法

clone()：创建一个与当前 Mat 相同的副本，深拷贝。

Mat cloneMat = mat.Clone();

reshape()：改变 Mat 的尺寸（例如，改变为单行或单列）。

Mat reshapedMat = mat.Reshape(1, 1); // 将矩阵重塑为一维

convertTo()：转换矩阵的类型和深度。

Mat floatMat = mat.ConvertTo(MatType.CV_32F);

empty()：检查矩阵是否为空。

bool isEmpty = mat.Empty();

at()：获取指定位置的元素值，T 是数据类型（如 byte、float 等）。

byte pixelValue = mat.At(0, 0); // 获取 (0, 0) 位置的像素值

set()：设置指定位置的元素值。

mat.Set(0, 0, new Scalar(255)); // 设置 (0, 0) 位置的像素值为 255

四、Mat 与其他数据类型的转换

4.1 Mat 与 UMat 之间的转换

UMat 是 OpenCV 为了 GPU 加速而设计的数据结构，与 Mat 类似，但数据存储在 GPU 内存中。如果你需要在 GPU 上处理图像，可以将 Mat 转换为 UMat，或者将 UMat 转换回 Mat：

Mat 转 UMat：

UMat umat = mat.ToUMat();

UMat 转 Mat：

Mat matFromUmat = umat.ToMat();

继续探讨 Mat 和 MatOf* 之间的转换，以及其他常见的 Mat 与不同数据类型之间的转换方式。

4.2 Mat 与 MatOf* 之间的转换（续）

OpenCVSharp 中的 MatOf* 是一种特殊的矩阵类型，用于表示某些特定的数据结构，如点、矩形、轮廓等。它们是从 Mat 派生出来的，但更具结构化。常见的 MatOf* 类型有：

MatOfPoint：表示二维点集（例如，图像轮廓的点集）。MatOfPoint2f：表示二维浮点点集。MatOfFloat：表示浮点数类型的矩阵。MatOfInt：表示整数类型的矩阵。

通过 ToMatOf* 方法，可以将一个 Mat 对象转换为这些结构化类型，而反向转换则可以使用 ToMat() 方法。

示例：Mat 转 MatOfPoint

Mat mat = new Mat(1, 4, MatType.CV_32FC2); // 创建一个包含 4 个二维点的 Mat

mat.Set(0, 0, new Point(10, 20)); // 设置矩阵的第一行第一列为 Point(10, 20)

mat.Set(0, 1, new Point(30, 40));

mat.Set(0, 2, new Point(50, 60));

mat.Set(0, 3, new Point(70, 80));

MatOfPoint matOfPoint = mat.ToMatOfPoint(); // 转换为 MatOfPoint

// 访问 MatOfPoint 中的元素

Point pt = matOfPoint.ToArray()[0]; // 获取第一个点

Console.WriteLine(pt); // 输出 Point(10, 20)

示例：MatOfPoint 转 Mat

MatOfPoint matOfPoint = new MatOfPoint(new Point(10, 20), new Point(30, 40), new Point(50, 60));

Mat mat = matOfPoint.ToMat(); // 将 MatOfPoint 转换回 Mat

Console.WriteLine(mat); // 输出 Mat 对象的内容

通过这些转换，MatOf* 类使得对特定类型数据的操作变得更加方便，尤其是在处理像素集、轮廓、特征点等数据时。

4.3 Mat 与原生 C# 数组之间的转换

由于 Mat 内部的数据是存储在连续的内存块中，可以很容易地将 Mat 与 C# 中的原生数组进行转换。通常我们使用 Mat 的 ToArray() 方法将其转换为 C# 数组，或者使用 SetTo() 方法将数组赋值给 Mat。

示例：Mat 转换为 C# 数组

假设我们有一个 Mat 对象，它是一个灰度图像，我们可以使用 ToArray() 方法将它转换为一个二维的 byte 数组：

Mat mat = new Mat("image.jpg", ImreadModes.GrayScale);

byte[,] byteArray = mat.ToArray(); // 将 Mat 转换为 C# 数组

Console.WriteLine(byteArray[0, 0]); // 输出数组中某个元素的值

示例：C# 数组转换为 Mat

如果你有一个 C# 数组，并希望将它转换成 Mat，可以通过 Mat 构造函数实现：

byte[,] byteArray = new byte[2, 2] { { 100, 150 }, { 200, 250 } };

Mat mat = new Mat(2, 2, MatType.CV_8UC1, byteArray); // 将 C# 数组转为 Mat

注意：在转换时要确保数据类型和 Mat 类型匹配，否则会发生类型不匹配错误。

4.4 Mat 与 Bitmap 之间的转换

在 .NET 中，Bitmap 是一个常用的图像类型，而 OpenCVSharp 中使用的是 Mat 来表示图像。有时我们可能需要将 OpenCV 中的 Mat 转换为 Bitmap，或者将 Bitmap 转换为 Mat。

Mat 转 Bitmap

你可以使用 Cv2.ImEncode 将 Mat 编码为一个字节数组，然后通过 MemoryStream 将其转换为 Bitmap：

Mat mat = Cv2.ImRead("image.jpg");

byte[] imgBytes = Cv2.ImEncode(".bmp", mat); // 将 Mat 编码为 BMP 格式的字节数组

using (MemoryStream ms = new MemoryStream(imgBytes))

{

Bitmap bitmap = new Bitmap(ms);

// 现在可以使用 bitmap 了

}

Bitmap 转 Mat

将 Bitmap 转换为 Mat 可以使用 Bitmap 类提供的 ToMat() 扩展方法：

Bitmap bitmap = new Bitmap("image.jpg");

Mat mat = BitmapConverter.ToMat(bitmap); // 将 Bitmap 转换为 Mat

这个转换在图像处理过程中非常常见，尤其是当你需要在 Windows Forms 或 WPF 应用程序中显示图像时。

五、Mat 的内存管理

Mat 类采用了引用计数和内存共享的设计，使得内存管理更高效。我们在操作图像时，特别是在创建新的 Mat 对象时，通常会遇到引用计数和内存管理相关的问题。理解如何管理 Mat 对象的内存是非常重要的。

5.1 引用计数和内存管理

在 OpenCV 中，每个 Mat 对象都包含一个引用计数（reference count）。当你创建一个新的 Mat 对象并赋值给另一个 Mat 对象时，实际上并不会复制图像数据，而是将内存的引用计数加一。只有当引用计数为零时，内存才会被真正释放。

这意味着你可以在多个 Mat 对象之间共享同一块数据，而不必进行冗余的内存复制。

示例：

Mat mat1 = Cv2.ImRead("image.jpg");

Mat mat2 = mat1; // mat2 与 mat1 指向同一块内存

但是，如果你希望创建一个完全独立的数据副本，可以使用 clone() 方法：

Mat mat1 = Cv2.ImRead("image.jpg");

Mat mat2 = mat1.Clone(); // 创建一个 mat1 的深拷贝，mat2 和 mat1 不再共享内存

5.2 Mat 的释放与销毁

虽然 OpenCV 使用引用计数来管理内存，但在某些情况下，手动释放 Mat 对象的内存是有必要的，特别是在处理大量图像数据时。通过 Dispose() 方法可以显式释放 Mat 对象占用的资源：

mat1.Dispose(); // 显式释放 Mat 的内存

这对于避免内存泄漏和提高性能非常重要。

六、总结

OpenCVSharp 中的 Mat 类是处理图像、矩阵和各种数据结构的核心工具，它提供了丰富的功能，包括矩阵的创建、类型转换、内存管理、数据访问等。通过理解 Mat 类的原理、常用属性、方法，以及与其他数据类型（如 UMat、MatOf*、C# 数组、Bitmap）的转换，你可以更加高效地进行图像处理和计算机视觉任务。

关键点总结：

Mat 是 OpenCV 中用于表示图像和矩阵的核心数据结构，支持引用计数和高效的内存管理。使用不同的构造函数，可以根据需求创建各种类型和尺寸的 Mat。Mat 类有丰富的属性和方法，如 rows、cols、type()、clone()、convertTo() 等，帮助你处理图像数据。Mat 与其他数据类型（如 C# 数组、MatOf*、Bitmap）之间的转换非常方便，可以满足不同应用场景的需求。在进行内存密集型操作时，务必注意 Mat 的内存管理，及时释放不再使用的 Mat 对象。

通过深入理解 Mat 类及其相关操作，你可以更灵活、有效地在 OpenCVSharp 中处理各种图像和矩阵数据。

专栏地址：

《 OpenCV功能使用详解200篇 》

《 OpenCV算子使用详解300篇 》

《 Halcon算子使用详解300篇 》

内容持续更新 ，欢迎点击订阅