OpenCvSharp 项目教程

1. 项目的目录结构及介绍

OpenCvSharp 是一个基于 OpenCV 的 .NET 封装库，提供了与 OpenCV 相似的 API 接口。项目的目录结构如下：

opencvsharp/
├── src/
│   ├── OpenCvSharp/
│   ├── OpenCvSharp.Blob/
│   ├── OpenCvSharp.Extensions/
│   ├── OpenCvSharp.UserInterface/
│   ├── OpenCvSharpExtern/
│   └── OpenCvSharp.Tests/
├── samples/
│   ├── CppStyleSamplesCS/
│   ├── WPFSamples/
│   └── WinFormsSamples/
├── build/
├── docs/
├── scripts/
└── README.md

目录介绍

• src/: 包含 OpenCvSharp 的核心代码和扩展代码。
  • OpenCvSharp/: 核心库，提供了与 OpenCV 相似的 API。
  • OpenCvSharp.Blob/: 用于图像处理的 Blob 分析库。
  • OpenCvSharp.Extensions/: 提供了一些扩展功能，如图像转换。
  • OpenCvSharp.UserInterface/: 用户界面相关的代码。
  • OpenCvSharpExtern/: 外部依赖库。
  • OpenCvSharp.Tests/: 单元测试代码。
• samples/: 包含各种示例代码，展示了如何使用 OpenCvSharp。
  • CppStyleSamplesCS/: C# 风格的示例。
  • WPFSamples/: WPF 应用程序的示例。
  • WinFormsSamples/: WinForms 应用程序的示例。
• build/: 构建脚本和配置文件。
• docs/: 文档文件。
• scripts/: 一些辅助脚本。
• README.md: 项目介绍和使用说明。

2. 项目的启动文件介绍

OpenCvSharp 的启动文件通常是示例代码中的 Program.cs 文件。以下是一个典型的启动文件示例：

using System;
using OpenCvSharp;

namespace OpenCvSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 读取图片
            Mat img = Cv2.ImRead("test.jpg", ImreadModes.Unchanged);
            Cv2.NamedWindow("demo", WindowFlags.Normal);
            Cv2.ImShow("demo", img);
            Cv2.WaitKey(0);
        }
    }
}

启动文件介绍

• using OpenCvSharp;: 引入 OpenCvSharp 命名空间。
• Mat img = Cv2.ImRead("test.jpg", ImreadModes.Unchanged);: 读取图片文件。
• Cv2.NamedWindow("demo", WindowFlags.Normal);: 创建一个名为 "demo" 的窗口。
• Cv2.ImShow("demo", img);: 在窗口中显示图片。
• Cv2.WaitKey(0);: 等待用户按键。

3. 项目的配置文件介绍

OpenCvSharp 的配置文件通常是项目的 .csproj 文件和 NuGet 包配置文件。以下是一个典型的 .csproj 文件示例：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="OpenCvSharp4" Version="4.5.5.20211231" />
    <PackageReference Include="OpenCvSharp4.runtime.win" Version="4.5.5.20211231" />
  </ItemGroup>

</Project>

配置文件介绍

• OutputType: 指定输出类型为可执行文件。
• TargetFramework: 指定目标框架为 .NET 6.0。
• PackageReference: 引用 OpenCvSharp4 和 OpenCvSharp4.runtime.win