PenguinV is a simple and easy to use C++ image processing library with focus on heterogeneous systems. The library is designed with an idea to have simple common API for CPUs and GPUs simplifying developer's work on context switching between devices. Core features of the library:
- heterogeneous system support (CPUs and GPUs)
- CUDA, OpenCL and SIMD (SSE, AVX, NEON) support
- Python support
- multithreading support
- cross-platform (Windows, Linux, MacOS)
- compactness
- ability to process separate parts of an image (ROI)
- user-defined image types and more.
You can develop a software within minutes of your time to obtain high performance and accuracy. It is up to developer to decide which device (CPU or GPU) would execute the code or give such control to the library.
Example code for below images could look like this:
Image red = ExtractChannel( image, 0 ); // 0 is red channel
Image binary = Threshold( red, // threshold
GetThreshold( // get weighted threshold
Histogram( red ) ) ) ); // get image histogram
BlobDetection detection;
...
detection.find( binary );
...
Image rgb = ConvertToRgb( binary );
rgd = BitwiseAnd( image, rgb );
...
rgd = BitwiseOr( image, rgb );The trick behind the code is that you have a single interface for CPU as well as for GPU!
We welcome and appreciate any help, even if it's a tiny text or code change. Please read contribution page before starting work on a pull request. All contributors are listed in the project's wiki page. Not sure what to start with? Feel free to refer to good first issue or help wanted tags.
To compile the source code your compiler must support at least C++ 11 version.
The library is distributed in the form of source code. To use the library you need to include necessary files into your application project. That's it! No more extra moves!
Open README.md file in any of example directories and follow instructions.
The library contains it's own thread pool which creates multiple tasks to run image processing function for a given image via multiple threads. Such tenchnique gives a big boost on machines with major CPU usage.
All source code and descriptions related to CUDA or OpenCL are located in separate src/cuda and src/opencl directories respectively. Read full description about CUDA or OpenCL support in README file in the directory.
This project is under 3-clause BSD License. Please refer to file LICENSE for more details.
Directory doc contains latest and valid information and description of library's API.