OpenCvSharp

A cross-platform .NET wrapper for OpenCV, providing image processing and computer vision functionality.

Supported Platforms

Target OpenCV version: 4.13.0 (with opencv_contrib)

Quick Start

Windows

dotnet add package OpenCvSharp4.Windows

Linux / Ubuntu

dotnet add package OpenCvSharp4
dotnet add package OpenCvSharp4.official.runtime.linux-x64

For more installation options, see Installation on GitHub.

Requirements

Windows

• Visual C++ 2022 Redistributable
• (Windows Server only) Media Foundation:

  Install-WindowsFeature Server-Media-Foundation
  

Linux (Ubuntu and other distributions)

Pre-install the dependency packages needed for OpenCV. Many packages such as libjpeg must be present for OpenCV to work.
See: OpenCV Linux install guide

Slim Profile

The slim runtime packages (OpenCvSharp4.Windows.Slim, OpenCvSharp4.official.runtime.linux-x64.slim, etc.) bundle a smaller native library:

Usage

Always release Mat and other IDisposable resources using the using statement:

using OpenCvSharp;

// Edge detection using Canny algorithm
using var src = new Mat("lenna.png", ImreadModes.Grayscale);
using var dst = new Mat();

Cv2.Canny(src, dst, 50, 200);
using (new Window("src image", src))
using (new Window("dst image", dst))
{
    Cv2.WaitKey();
}

For complex pipelines, use ResourcesTracker to manage multiple resources automatically:

using var t = new ResourcesTracker();

var src = t.T(new Mat("lenna.png", ImreadModes.Grayscale));
var dst = t.NewMat();
Cv2.Canny(src, dst, 50, 200);
var blurred = t.T(dst.Blur(new Size(3, 3)));
t.T(new Window("src image", src));
t.T(new Window("dst image", blurred));
Cv2.WaitKey();

Note: OpenCvSharp does not support Unity, Xamarin, CUDA or UWP.

Resources

• GitHub Repository
• Code Samples
• API Documentation
• Issue Tracker