Face Detection on Unity using Emgu CV and ONNX

Report Bug · Request Feature

Table of Contents

1. About The Project
2. Getting Started
3. Contributing
4. License
5. Contact
6. Acknowledgements

About The Project

The project integrates an ONNX-based Face Detection CNN Model into a Windows-based Unity application by using Emgu CV Dnn module for inference.

The purpose of the project is to mainly show how to integrate Emgu CV (latest version) into an Unity application for FREE in 3 steps without buying Emgu CV v4.x in Unity Asset Store and how to interact with image data from a PC webcam.

The inference implementation of the ONNX model using Emgu CV was actually done in my previous project Face Detection on UWP using ONNX.

Project is built with

• Emgu.CV v4.5.1.4349
• Emgu.CV.Bitmap v4.5.1.4349
• Emgu.CV.runtime.windows v4.5.1.4349
• Unity v2020.3.12f1

Getting Started

1. Clone the repository and open project folder in Unity (Just click Ignore when it shows error)

2. Install NuGet Package Manager

• Download and install NuGet for Unity here
• Close and reopen your Unity project

3. Install Emgu CV in Unity

• In the menu of Unity, select NuGet > Manage NuGet Packages
• Search for emgu, install Emgu.CV, Emgu.CV.runtime.windows, and Emgu.CV.Bitmap by Emgu Corporation

4. Install cvextern.dll

• Download Emgu CV here. Make sure the version is matched with Emgu CV in the previous step.
• After installing, go to folder libs\x64, i.e. C:\Emgu\emgucv-windesktop 4.5.1.4349\libs\x64, copy file cvextern.dll to the Assets\Plugins folder in your Unity project

5. Open Assets\Scenes\SampleScene and play app in Unity

Contributing

Contributions make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/FeatureName)
3. Commit your Changes (git commit -m 'Add some FeatureName')
4. Push to the Branch (git push origin feature/FeatureName)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Tung Dao - LinkedIn

Project Link: https://github.com/dao-duc-tung/face-detection-unity-emgucv-onnx

Acknowledgements

• Ultra-lightweight face detection model