Main Page: Difference between revisions

From EMGU
Jump to navigation Jump to search
 
(212 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<big>'''Emgu CV''' is a cross platform .Net wrapper to the Intel [[OpenCV]] image-processing library. Allowing [[OpenCV]] functions to be called from .NET compatible languages such as C#, VB, VC++, IronPython etc. The wrapper can be compiled in Mono and run on Linux / Solaris / Mac OS X.</big>
<big>'''[[Emgu CV]]''' is a cross platform .Net wrapper to the [[OpenCV]] image processing library. Allowing [[OpenCV]] functions to be called from .NET compatible languages. The wrapper can be compiled by Visual Studio and Unity, it can run on Windows, Linux, Mac OS, iOS and Android.</big>


== Advantage of Emgu CV ==
== Latest News ==
* 2025-07-27 [[Version_History#Emgu.CV-4.11.0|Emgu.CV-4.11.0]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.11.0 github] and nuget. See [[Version_History#Emgu.CV-4.11.0|change log and known issues]].
* 2025-01-21 [[Version_History#Emgu.CV-4.10.0|Emgu.CV-4.10.0]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.10.0 github] and nuget. See [[Version_History#Emgu.CV-4.10.0|change log and known issues]].
* 2024-05-12 [[Version_History#Emgu.CV-4.9.0|Emgu.CV-4.9.0]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.9.0 github] and nuget. See [[Version_History#Emgu.CV-4.9.0|change log and known issues]].
* 2023-09-10 [[Version_History#Emgu.CV-4.8.0|Emgu.CV-4.8.0]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.8.0 github] and nuget. See [[Version_History#Emgu.CV-4.8.0|change log and known issues]].
* 2023-04-23 [[Version_History#Emgu.CV-4.7.0|Emgu.CV-4.7.0]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.7.0 github] and nuget. See [[Version_History#Emgu.CV-4.7.0|change log and known issues]].
* 2022-10-30 [[Version_History#Emgu.CV-4.6.0|Emgu.CV-4.6.0]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.6.0 github] and nuget. See [[Version_History#Emgu.CV-4.6.0|change log and known issues]].
* 2022-01-09 [[Version_History#Emgu.CV-4.5.5|Emgu.CV-4.5.5]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.5.5 github] and nuget. See [[Version_History#Emgu.CV-4.5.5|change log and known issues]].
* 2021-11-07 [[Version_History#Emgu.CV-4.5.4|Emgu.CV-4.5.4]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.5.4 github] and nuget. See [[Version_History#Emgu.CV-4.5.4|change log and known issues]].
* 2021-08-08 [[Version_History#Emgu.CV-4.5.3|Emgu.CV-4.5.3]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.5.3 github] and nuget. See [[Version_History#Emgu.CV-4.5.3|change log and known issues]].
* 2021-07-04 [[Version_History#Emgu.CV-4.5.2|Emgu.CV-4.5.2]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.5.2 github] and nuget. See [[Version_History#Emgu.CV-4.5.2|change log and known issues]].
* 2021-01-24 [[Version_History#Emgu.CV-4.5.1|Emgu.CV-4.5.1]] release is available in [https://github.com/emgucv/emgucv/releases/tag/4.5.1 github] and nuget. See [[Version_History#Emgu.CV-4.5.1|change log and known issues]].
 
* [[Emgu CV News Archive | News Archive]]
 
== Platform Features ==
 
=== Windows ===
{| style="text-align:center" border="1px" cellspacing="0" cellpadding="5"
!Name || Emgu CV (Open Source) || colspan="2" | Emgu CV for Windows ([[Licensing:#Commercial_License|Commercial Optimized]])
|-
!Development tools || Visual Studio 2019 and up || Visual Studio 2019 and up || Visual Studio 2019 and up
|-
! Platform || Windows || Windows || UWP / Windows 8.1 Store app
|-
! Supported CPU Architecture || i386, x86_64, arm64 || i386, x86_64, arm64 || i386, x86_64
|-
! CUDA GPU  Processing || x86_64 || x86_64 || X
|- 
! OpenCL (GPU&CPU) || <math>\checkmark</math> || <math>\checkmark</math> || X 
|-
! [https://github.com/tesseract-ocr Tesseract OCR] || <math>\checkmark</math> || <math>\checkmark</math> || <math>\checkmark</math>
|-
! code dispatch || X || <math>\checkmark</math> || X
|-
! [[Tutorial#Error_Handling | Exception Handling]] || <math>\checkmark</math> || <math>\checkmark</math> || <math>\checkmark</math>
|-
! [[Debugger Visualizer]] || <math>\checkmark</math> || <math>\checkmark</math> || X
|-
! Emgu.CV.UI || <math>\checkmark</math> || <math>\checkmark</math> || X
|-
![[Licensing: | License]] || [[Licensing:#Open_Source_License| GPL]] || colspan="2" | [[Licensing:#Commercial_License| Commercial License]]
|}
 
* <span style="color:#009000">'''Windows UWP version is included in the Windows Commercial release''' </span>
* '''Windows Phone is no longer supported'''
 
=== Mobile Devices ===
{| style="text-align:center" border="1px" cellspacing="0" cellpadding="5"
!Name || [[Emgu CV for iOS| Emgu CV for iOS]] || [[Emgu CV for Android| Emgu CV for Android]]
|-
! Requirement || Visual Studio Code for Mac / build from commandline || Visual Studio 2022 for Windows
|-
! Platform || iOS (iPhone, IPad) || Android
|-
! Supported Device || armv7, armv7a, arm64 || armeabi, armeabi-v7a, arm64-v8a, x86_64
|-
! Supported Simulator || x86_64, arm64-v8a || armeabi, armeabi-v7a, arm64-v8a, x86_64 
|-
! CUDA GPU  Processing || X || X
|-
! OpenCL 1.2 (GPU&CPU) || X || <math>\checkmark</math> ([http://arrayfire.com/opencl-on-mobile-devices/ on supported devices])
|-
! [http://code.google.com/p/tesseract-ocr/ Tesseract OCR] || <math>\checkmark</math> || <math>\checkmark</math>
|-
! [[Tutorial#Error_Handling | Exception Handling]] || <math>\checkmark</math> || <math>\checkmark</math> 
|-
![[Licensing: | License]] || [[Licensing:#Commercial_License| Commercial License]] || [[Licensing:#Commercial_License| Commercial License]]
|}
 
=== Mac OS, Linux, Unix ===
The commercial release include prebuild binary for Mac OS. For Linux and Unix platform, you need to compile the binary from source.
 
{| style="text-align:center" border="1px" cellspacing="0" cellpadding="5"
!Name || Emgu CV (Open Source) ||  Emgu CV for MacOS, Linux & Unix([[Licensing:#Commercial_License|Commercial License]])
|-
! Development Tools || Visual Studio Code, JetBrains Rider || Visual Studio Code, JetBrains Rider
|-
! MacOS || <math>\checkmark</math> || <math>\checkmark</math>
|-
! Linux, Unix || <math>\checkmark</math> || <math>\checkmark</math>
|-
! CUDA GPU  Processing || X || X
|-
! OpenCL (GPU&CPU) || <math>\checkmark</math> || <math>\checkmark</math>
|-
! [http://code.google.com/p/tesseract-ocr/ Tesseract OCR] || <math>\checkmark</math> || <math>\checkmark</math>
|-
! [[Tutorial#Error_Handling | Exception Handling]] || <math>\checkmark</math> || <math>\checkmark</math>
|-
![[Licensing: | License]] || [[Licensing:#Open_Source_License| GPL]] || [[Licensing:#Commercial_License| Commercial License]]
|}
 
== Advantage of [[Emgu CV]] ==
=== Cross Platform ===
=== Cross Platform ===
Unlike other wrappers such as [http://code.google.com/p/opencvdotnet/ OpenCVDotNet] or [http://www.cs.ru.ac.za/research/groups/SharperCV/ SharperCV] which are written in Managed C++, Emgu CV is written entirely in C#. The benifit is that it can be compiled on Mono and therefore is able to run on any platform Mono supports, be it Linux / Solaris or Mac OS X. I have spend a lot more effort to have an implementation in C# since the headers has to be ported, compares with managed C++ such that header files can simply be included. But it is well worth it once I see [[Emgu CV]] running on my Fedora 8! Plus it always give you the comfort knowing that your code is cross-platform.
[[Emgu CV]] is written entirely in C#. It can be run on any platform .net supports, including iOS, Android, Mac OS, Linux and windows. A lot of efforts has been spent to have a pure C# implementation since the headers have to be ported, compared with managed C++ implementation where header files can simply be included. But it is well worth it if you see [[Compiling_with_Monodevelop|Emgu CV running on Fedora 10]]! Plus it always gives you the comfort knowing that your code is cross-platform.
 
=== Cross Language and comes with example code===
[[Emgu CV]] can be used from several different languages, including C#, VB.NET, C++ and IronPython. On this wiki, we provide [[Tutorial#Examples|examples]] for all those languages, which are available from the [[Tutorial#Examples|Examples section on Tutorial page]]. Our [https://github.com/emgucv/emgucv/discussions Discussion Forum] is also available if you have any questions related to your favourite programming language.


=== Other Advantages ===
=== Other Advantages ===
* Image class with [[Tutorial#Generic_Support | Generic Color and Depth]]
* [[Working_with_Images#Depth_and_Color_as_Generic_Parameter | Image class with Generic Color and Depth]]
* [[Tutorial#Automatic_Garbage_Collection | Automatic garbage collection]]
* [[Working_with_Images#Automatic_Garbage_Collection| Automatic garbage collection]]
* [[Tutorial#Generic_operation | Generic operations ]] on image pixels
* [[Working_with_Images#XML_Serialization | XML Serializable Image]]
* [[Tutorial#XML_Serialization | XML Serializable Image]]
* [[Tutorial#Intellisense_in_Visual_Studio | XML Documentation and intellisense support]]
* [[Tutorial#Intellisense_in_Visual_Studio | XML Documentation and intellisense support]]
* The choice to either use the [[Tutorial#Working_with_images | Image class]] or [[Tutorial#Function_Mapping_-_Emgu.CV.CvInvoke | directly invoke functions]] from [[OpenCV]]
* The choice to either use the [[Tutorial#Working_with_images | Image class]] or [[Tutorial#Function_Mapping_-_Emgu.CV.CvInvoke | direct invoke functions]] from [[OpenCV]]
 
* [[Working_with_Images#Generic_Operation | Generic operations ]] on image pixels
== Architecture Overview ==
[[Emgu CV]] has two layers of wrapper as shown below
*The basic layer ('''''layer 1''''') contains [[Tutorial#Function_Mapping_-_Emgu.CV.CvInvoke | function]], [[Tutorial#Structure_Mapping_-_Emgu.CV.Mxxx | structure]] and [[Tutorial#Enumeration_Mapping_-_Emgu.CV.CvEnum | enumeration]] mapping which directly reflect those in [[OpenCV]].
*The second layer ('''''layer 2''''') contains class that mixed in [[Main_Page#Advantage_of_Emgu_CV | advatange]] from the .Net world.
 
[[Image:EmguCVArchitecture.gif ]]
 
== Latest News ==
* 2008-05-5 Emgu.CV-1.2.2.0 is available in [[SVN]], changes in this version includes
** <code>AsBitmap()</code> function added as a high performance alternative to <code>ToBitmap()</code> function
*** Note: <code>AsBitmap()</code> differs from <code>ToBitmap()</code> such that when dealing with Image&lt;Gray, Byte&gt; and Image&lt;Bgr, Byte&gt;, the image data is shared with Bitmap. Take extra caution not to use the Bitmap after the Image object is disposed
** Performance improvement on <code>ToBitmap()</code> function. When converting Grayscale to Bitmap, use Format8bppIndexed and a custome Color Palette instead of Format24bppRgb in 1.1.1.0. In terms of memcopy it only copy one third of data as compares with the old version. Thanks for the tips from Sebastian Kraemer.
** Better performance on the Width and Height properties.
** Example of using [[Emgu CV]] in WCF to implement web service. (Both Server and Client covered).
** Example of Hugh Line and circle detection
** More structure wrapped
** More functions has been covered
** Fix a bug in Circle that prevent it from being properly XML serialized

Latest revision as of 12:49, 29 July 2025

Emgu CV is a cross platform .Net wrapper to the OpenCV image processing library. Allowing OpenCV functions to be called from .NET compatible languages. The wrapper can be compiled by Visual Studio and Unity, it can run on Windows, Linux, Mac OS, iOS and Android.

Latest News

Platform Features

Windows

Name Emgu CV (Open Source) Emgu CV for Windows (Commercial Optimized)
Development tools Visual Studio 2019 and up Visual Studio 2019 and up Visual Studio 2019 and up
Platform Windows Windows UWP / Windows 8.1 Store app
Supported CPU Architecture i386, x86_64, arm64 i386, x86_64, arm64 i386, x86_64
CUDA GPU Processing x86_64 x86_64 X
OpenCL (GPU&CPU) X
Tesseract OCR
code dispatch X X
Exception Handling
Debugger Visualizer X
Emgu.CV.UI X
License GPL Commercial License
  • Windows UWP version is included in the Windows Commercial release
  • Windows Phone is no longer supported

Mobile Devices

Name Emgu CV for iOS Emgu CV for Android
Requirement Visual Studio Code for Mac / build from commandline Visual Studio 2022 for Windows
Platform iOS (iPhone, IPad) Android
Supported Device armv7, armv7a, arm64 armeabi, armeabi-v7a, arm64-v8a, x86_64
Supported Simulator x86_64, arm64-v8a armeabi, armeabi-v7a, arm64-v8a, x86_64
CUDA GPU Processing X X
OpenCL 1.2 (GPU&CPU) X (on supported devices)
Tesseract OCR
Exception Handling
License Commercial License Commercial License

Mac OS, Linux, Unix

The commercial release include prebuild binary for Mac OS. For Linux and Unix platform, you need to compile the binary from source.

Name Emgu CV (Open Source) Emgu CV for MacOS, Linux & Unix(Commercial License)
Development Tools Visual Studio Code, JetBrains Rider Visual Studio Code, JetBrains Rider
MacOS
Linux, Unix
CUDA GPU Processing X X
OpenCL (GPU&CPU)
Tesseract OCR
Exception Handling
License GPL Commercial License

Advantage of Emgu CV

Cross Platform

Emgu CV is written entirely in C#. It can be run on any platform .net supports, including iOS, Android, Mac OS, Linux and windows. A lot of efforts has been spent to have a pure C# implementation since the headers have to be ported, compared with managed C++ implementation where header files can simply be included. But it is well worth it if you see Emgu CV running on Fedora 10! Plus it always gives you the comfort knowing that your code is cross-platform.

Cross Language and comes with example code

Emgu CV can be used from several different languages, including C#, VB.NET, C++ and IronPython. On this wiki, we provide examples for all those languages, which are available from the Examples section on Tutorial page. Our Discussion Forum is also available if you have any questions related to your favourite programming language.

Other Advantages