==================================================================

一个跨平台的 .NET 封装库，用于 OpenCV 图像处理库。它允许从任何兼容 .NET 的语言中调用 OpenCV 函数。该封装库可以通过 Visual Studio、Unity 以及 dotnet 命令进行编译，并可在 Windows、Mac OS、Linux、iOS 和 Android 等平台上运行。

更多信息请访问我们的项目主页： http://www.emgu.com/wiki/index.php/Main_Page

构建说明请参见： http://www.emgu.com/wiki/index.php/Download_And_Installation#Building_from_Git

Emgu CV 快速上手指南

Emgu CV 是一个跨平台的 .NET 封装库，允许在 C#、VB.NET 等 .NET 兼容语言中调用 OpenCV 图像处理函数。它支持 Windows、macOS、Linux、iOS 和 Android 平台，并可通过 Visual Studio、Unity 或 dotnet 命令行进行编译。

环境准备

• 操作系统：Windows、macOS、Linux、iOS 或 Android。
• 开发工具：
  • Visual Studio (推荐) 或 Unity
  • .NET SDK (若使用命令行构建)
• 前置依赖：
  • 无需手动安装原生 OpenCV 二进制文件，Emgu CV NuGet 包通常会自动处理依赖。
  • 确保已安装对应的 .NET运行时环境。

安装步骤

推荐使用 NuGet 包管理器进行安装，这是最快捷的方式。

方式一：使用 Visual Studio / Unity 图形界面

1. 右键点击项目，选择 “管理 NuGet 程序包”。
2. 在“浏览”标签页搜索 Emgu.CV。
3. 点击 安装。
   • 注：如需特定功能（如 CUDA 加速），可额外安装 Emgu.CV.cuda 等相关包。

方式二：使用 .NET CLI 命令行

在项目根目录下执行以下命令：

dotnet add package Emgu.CV

若需指定版本（例如最新版本）：

dotnet add package Emgu.CV --version 4.9.0.5456

提示：国内开发者若遇到 NuGet 下载缓慢，可在命令行临时指定源或使用国内镜像（如阿里云镜像）：

dotnet add package Emgu.CV --source https://api.nuget.org/v3/index.json

(注：NuGet 官方源在国内访问通常尚可，若需配置全局镜像，请参考 .NET 官方文档配置 nuget.config)

基本使用

以下是一个最简单的示例，展示如何加载图像并将其转换为灰度图。

using Emgu.CV;
using Emgu.CV.CvEnum;
using Emgu.CV.Structure;

// 加载图像 (请确保路径下存在 test.jpg)
Image<Bgr, byte> image = new Image<Bgr, byte>("test.jpg");

// 转换为灰度图
Image<Gray, byte> grayImage = image.Convert<Gray, byte>();

// 保存结果
grayImage.Save("result_gray.jpg");

// 可选：显示图像 (仅在支持 GUI 的环境如 Windows/Ubuntu Desktop 有效)
CvInvoke.Imshow("Original", image);
CvInvoke.Imshow("Gray", grayImage);
CvInvoke.WaitKey(0);

代码说明：

1. 引入 Emgu.CV 命名空间。
2. 使用 Image<TColor, TDepth> 泛型类加载彩色图像。
3. 调用 Convert 方法轻松实现颜色空间转换。
4. 使用 Save 保存处理后的图片。

更多高级功能和详细 API 文档，请访问项目官网：http://www.emgu.com/wiki/index.php/Main_Page