Using the library
In order to use this library with vl you have to install the nuget that is available via nuget.org. For information on how to use nugets with vl, see Managing Nugets in the vl documentation. As described there you go to the commandline and then type:
nuget install VL.OpenCV -prerelease
Once the VL.OpenCV nuget is installed and referenced in your vl document you'll see the category "OpenCV" in the nodebrowser. From there explore the nodes in its main sub-categories:
- Source (VideoIn, ImageReader,...)
- Sink (Renderer, ImageWriter)
- Filter (Blur, Dilate, Sobel,...)
- Detection (Contours, ObjectDetector, MarkerDetector,...)
Demo VL patches can be found here:
And vvvv demo patches are somewhat hidden here:
Contributing to the development
If you want to contribute to this repository, clone it into a directory like:
Build the C# Project
in VisualStudio and build it. This is necessary for a few things that cannot yet be expressed in vl directly, like dynamic enums and static readonly instances of things.
Get Nuget Dependency
This wrapper is depending on two thirdparty nugets: OpenCvSharp4.runtime.win and OpenCvSharp4. When installing the VL.OpenCV nuget as mentioned under "Using the library" above, this dependency will be installed automatically. To install it otherwise, go to your vvvvs
on a commandline and run
nuget.exe install OpenCvSharp4.Windows
Then start vvvv with the commandline parameter:
which will make all packs found in that directory available as dependencies in vl documents. Note that it is possible to have both the nuget (binary) and the sources available. If both are found, the one in the "package-repositories" path is used. Like this you can easily switch between your local development version and the "official" nuget by simply including your local version in that search path or not.
VL.OpenCV will now show up as Nuget among a documents dependencies as shown here.