Galosys.Foundation.OpenCvSharp 26.7.13.1

Galosys.Foundation.OpenCvSharp

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

基于 OpenCvSharp 的计算机视觉扩展库，提供人脸检测、图像处理、视频分析等视觉相关的常用功能。

功能概览

1. 人脸检测

using OpenCvSharp;
using OpenCvSharp.Extensions;
using System.Windows.Media.Imaging;

// 加载级联分类器
using var classifier = new CascadeClassifier("haarcascade_frontalface_default.xml");

// 检测人脸
using var gray = new Mat();
Cv2.CvtColor(image, gray, ColorConversionCodes.BGR2GRAY);
var faces = classifier.DetectMultiScale(gray);

foreach (var face in faces)
{
    Cv2.Rectangle(image, face, Scalar.Red, 2);
}

2. 图像处理

using OpenCvSharp;

// 灰度转换
using var gray = new Mat();
Cv2.CvtColor(image, gray, ColorConversionCodes.BGR2GRAY);

// 高斯模糊
using var blurred = new Mat();
Cv2.GaussianBlur(image, blurred, new Size(5, 5), 0);

// 边缘检测
using var edges = new Mat();
Cv2.Canny(gray, edges, 50, 150);

// 二值化
using var binary = new Mat();
Cv2.Threshold(gray, binary, 127, 255, ThresholdTypes.Binary);

3. 形态学操作

using OpenCvSharp;

// 膨胀
using var dilated = new Mat();
var kernel = Cv2.GetStructuringElement(MorphShapes.Rect, new Size(3, 3));
Cv2.Dilate(image, dilated, kernel);

// 腐蚀
using var eroded = new Mat();
Cv2.Erode(image, eroded, kernel);

// 开运算（去噪）
using var opened = new Mat();
Cv2.MorphologyEx(image, opened, MorphTypes.Open, kernel);

// 闭运算（填充）
using var closed = new Mat();
Cv2.MorphologyEx(image, closed, MorphTypes.Close, kernel);

4. 轮廓检测

using OpenCvSharp;

// 查找轮廓
var contours = new Point[][] { };
var hierarchy = new HierarchyIndex[] { };
Cv2.FindContours(binary, out contours, out hierarchy, RetrievalModes.External, ContourApproximationModes.ApproxSimple);

// 绘制轮廓
foreach (var contour in contours)
{
    Cv2.DrawContours(image, new[] { contour }, 0, Scalar.Blue, 2);
}

5. 模板匹配

using OpenCvSharp;

// 模板匹配
using var template = Cv2.ImRead("template.png");
var result = new Mat();
Cv2.MatchTemplate(image, template, result, TemplateMatchModes.CCoeffNormed);

// 找最佳匹配位置
Cv2.MinMaxLoc(result, out _, out _, out var minLoc, out _);
var matchRect = new Rect(minLoc.X, minLoc.Y, template.Width, template.Height);
Cv2.Rectangle(image, matchRect, Scalar.Green, 2);

6. 颜色空间转换

using OpenCvSharp;

// BGR 转 HSV
using var hsv = new Mat();
Cv2.CvtColor(image, hsv, ColorConversionCodes.BGR2HSV);

// 颜色分离（通道提取）
var channels = new Mat[] { };
Cv2.Split(image, out channels);
using var blue = channels[0];
using var green = channels[1];
using var red = channels[2];

7. 图像直方图

using OpenCvSharp;

// 计算直方图
var hist = new Mat();
var channels = new[] { 0 };
var histSize = new[] { 256 };
var ranges = new[] { new RangeF(0, 256) };
Cv2.CalcHist(new[] { gray }, channels, null, hist, 1, histSize, ranges);

// 直方图均衡化
using var equalized = new Mat();
Cv2.EqualizeHist(gray, equalized);

8. 视频流处理

using OpenCvSharp;

// 打开摄像头
using var capture = new VideoCapture(0);
if (!capture.IsOpened()) return;

while (true)
{
    using var frame = new Mat();
    capture.Read(frame);
    if (frame.Empty()) break;
    
    // 处理帧
    Cv2.CvtColor(frame, frame, ColorConversionCodes.BGR2GRAY);
    Cv2.GaussianBlur(frame, frame, new Size(3, 3), 0);
    
    Cv2.imshow("Video", frame);
    if (Cv2.WaitKey(1) == 'q') break;
}

安装

<PackageReference Include="Galosys.Foundation.OpenCvSharp" Version="x.x.x" />

目录结构

Galosys.Foundation.OpenCvSharp/
└── OpenCvSharp\
    └── CascadeClassifierExtensions.cs

依赖

• OpenCvSharp
• OpenCvSharp.Extensions
• OpenCvSharp.WpfExtensions
• Galosys.Foundation.Core