Main Page: Difference between revisions

From EMGU
Jump to navigation Jump to search
← Older edit
 
(224 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 ==
=== Cross Platform ===
* 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]].
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.
* 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]]


=== Other Advantages ===
== Platform Features ==
* Image class with [[Tutorial#Generic_Support | Generic Color and Depth]]
* [[Tutorial#Automatic_Garbage_Collection | Automatic garbage collection]]
* [[Tutorial#Generic_operation | Generic operations ]] on image pixels
* [[Tutorial#XML_Serialization | XML Serializable Image]]
* [[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]]


== Architecture Overview ==
=== Windows ===
[[Emgu CV]] has two layers of wrapper as shown below
{| style="text-align:center" border="1px" cellspacing="0" cellpadding="5"
*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]].
!Name || Emgu CV (Open Source) || colspan="2" | Emgu CV for Windows ([[Licensing:#Commercial_License|Commercial Optimized]])
*The second layer ('''''layer 2''''') contains class that mixed in [[Main_Page#Advantage_of_Emgu_CV | advatange]] from the .Net world.
|-
!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]]  
|}


[[Image:EmguCVArchitecture.gif ]]
* <span style="color:#009000">'''Windows UWP version is included in the Windows Commercial release''' </span>
* '''Windows Phone is no longer supported'''


== Latest News ==
=== Mobile Devices ===
* 2008-03-18 [[Nightly Build]] of Emgu.CV-1.2.2.0 is available, changes in this version includes
{| style="text-align:center" border="1px" cellspacing="0" cellpadding="5"
** <code>ToBitmap()</code> is much faster when converting Grayscale to Bitmap. Format8bppIndexed with a custome Color Palette is used instead of Format24bppRgb . In terms of memcopy it only copy one third of data as compares with the old version. Thanks for the tips from Sebastian Kraemer.
!Name || [[Emgu CV for iOS| Emgu CV for iOS]] || [[Emgu CV for Android| Emgu CV for Android]]
** More structures has been covered:
|-  
*** In Emgu.CV namespace: MCvHuMoments
! Requirement || Visual Studio Code for Mac / build from commandline || Visual Studio 2022 for Windows
** More functions has been covered:
|-
*** In CvInvoke class: cvSobel, cvLaplace, cvCmpS, cvGetSpatialMoment, cvGetCentralMoment, cvGetHuMoments, cvFindFundamentalMat, cvComputeCorrespondEpilines, cvConvertPointsHomogenius
! Platform || iOS (iPhone, IPad) || Android
*** In Image class: Sobel, Laplace, Cmp function that accepts scalar
|-
*** In Moment class: GetSpatialMoment, GetCentralMoment, CvHuMoment
! Supported Device || armv7, armv7a, arm64 || armeabi, armeabi-v7a, arm64-v8a, x86_64
** Example of using [[Emgu CV]] in WCF to implement web service. (Both Server and Client covered).
|-
! 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]]
|}


* 2008-03-11 [[Emgu CV]] 1.1.1.0 is released on [https://sourceforge.net/project/showfiles.php?group_id=216500| SourceForge], changes in this version includes:
== Advantage of [[Emgu CV]] ==
** Added support for HLS, LAB, LUV, XYZ and YCrCb color types
=== Cross Platform ===
** Better documentation. Older Version (1.0.0.1 contains) 400+ missing xml documentation while newer version (1.1.1.0) has less than 40 missing xml documentation
[[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.
** Image class now has <code>Equals</code> function, which returns true if the two images has the same depth, color and pixel values
** More functions exposed from [[OpenCV]] in <code>Image</code> and <code>CvInvoke</code> class
** Various bug fixes


* 2008-02-22 The Emgu.CV-1.0.0.1 is released on [https://sourceforge.net/project/showfiles.php?group_id=216500| SourceForge]
=== 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.


* 2008-02-05 Registration of [[Emgu CV]] project on SourceForge under [https://sourceforge.net/projects/emgucv/| this page]
=== Other Advantages ===
* [[Working_with_Images#Depth_and_Color_as_Generic_Parameter | Image class with Generic Color and Depth]]
* [[Working_with_Images#Automatic_Garbage_Collection| Automatic garbage collection]]
* [[Working_with_Images#XML_Serialization | XML Serializable Image]]
* [[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 | direct invoke functions]] from [[OpenCV]]
* [[Working_with_Images#Generic_Operation | Generic operations ]] on image pixels

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

Retrieved from "https://www.emgu.com/wiki/index.php?title=Main_Page&oldid=3362"