CVD Projects

libCVD - computer vision library

libCVD is a very portable and high performance C++ library for computer vision, image, and video processing. The emphasis is on providing simple and efficient image and video handling and high quality implementations of common low-level image processing function. The library is designed in a loosely-coupled manner, so that parts can be used easily in isolation if the whole library is not required. The video grabbing module provides a simple, uniform interface for videos from a variety of sources (live and recorded) and allows easy access to the raw pixel data. Likewise, the image loading/saving module provides simple, uniform interfaces for loading and saving images from bitmaps to 64 bit per channel RGBA images. The image processing routines can be applied easily to images and video, and accelerated versions exist for platforms supporting SSE.

Versions

Platforms have stabilised a lot in recent years, so libCVD has switched back to versioned releases.

News

Version 2.4.1 (11 Apr 2022)
- Fix a very silly bug in the img_load function prototype.
Version 2.4.0 (11 Mar 2022)
- img_load now takes an optional typelist specifying which images it should support at compile time. This allows you to compile libCVD with support for all image types, but not use them in places where they may be size or security implications. See here for more details.
- Image can now be created from a SubImage (by copying).
- Reasonably efficient image transpose
- Finally rename image_convert.h to convert_image.h so the header file matches the function name, after only 17 years.
- Use memcpy where possible for copying images, so it's fast in all build configurations
- Remove all dependencies on config.h. The file is still provided for users to be able to do compile time tests.
- Update to clang-format 10
Version 2.3.1 (11 Dec 2020)
- Consistent formatting
- Fix compile errors in some configurations
Version 2.3 (22 Oct 2020)
- Better glVertex wrappers
- Exceptions now derived from std::exception
- RGBA 2/3 sample
- Move CI to github actions
- Werror Wconversion clean
Version 2.2 (15 Aug 2019)
- Cleanups and bug fixes
Version 2.1 (21 May 2019)
- Cleanups and bug fixes
Version 2.2 (15 Sug 2019)
- Cleanups and bug fixes
Version 2.1 (21 May 2019)
- Cleanups and bug fixes
- Many bugfixes
- Version 2.0
- CMake support
- Clean up build system
- libUVC support for alternative webcam support (especially on OSX)
- More tests
- Many bugfixes
19/07/2017
libCVD has been undergoing some internal rewrites. Most of your code should work with no modifications but some changes may be needed.
- libCVD now depends on C++14 and won't compile on older versions.
- Images now have value semantics (like std::vector) and are not reference counted.
- Lots of system compatibility stuff has been obsoleted by C++11/14 and has been removed. The new facilities of C++ are better than the old hacks in libCVD.
- Some stuff was moved from libCVD into TooN over a decade ago. The compatibility headers have finally been removed.
- Greatly simplified configuration system. Most of the files no longer include one of the two config.h headers. This makes including CVD sources in part of a larger projecte easier and it makes rebuilds after a reconfigure much faster.
- Improved video buffer support (FFMPEG can now open streams and libUVC is uspported).
- Drone.io no longer available, so we've moved to CircleCI
07/04/2015: Release of CVD 20150407:
New Features:
- Switch to 2 clause BSD license.
- Efficient distance transforms (inlcuding Euclidean)
- Canny edge detection
- Improved OpenCV interoperability
- Add colourmaps for visualising images
Bug fixes:
- Much better compression for bool TIFFS (40x improvement for many masks)
- Lots of platform compatibility and compiler fixes
- Fixes to configure script for some unusual configurations
- Fix bad timestamps on deinterlaced videos
- Bug fix in tensor voting kernel creation. Results will change, but should be better
Internals
- Big cleanup removing obsolete code
- Added a regression testing framework and some tests
- Try yet again to correctly include array/tr1::array on all the various platforms.
14/02/2013: Integrated with drone.io
22/11/2012: Moved to Github
10/25/2012: Release of libCVD 20121025:
New features:
- New interface to FFMPEG with proper support for seeking
Important bug fixes:
- Fix for 3.x kernels
- Fix for C++11 compilers
- Fix for CLANG++
- Fix for Visual Studio
- Fix for Cygwin
Internals:
- Support newer autoconfs without heaps of warnings
- Removed a umber of long obsolete files, with associated code and configurations
- Shuffled source tree around to put files in single tree
- Squash a number of C++ warnings.
02/02/2012: Release of libCVD 20120202:
New features:
- Added arctan camera
- Added GLES heplers
- Allow Zero sized images.
- Make Images more STL like
- NEON optimizations for halfSample and rgb_to_grey
- Sample iOS application
- System for generating VCPROJ build files
- Efficient Second-order Minimization.
- Chainable deinterlacebuffer in open_video_source
Important bug fixes:
- Many misc bug fixes.
- Bug fix in Bayer conversion
- Keep up to date with libraries, platforms and compilers.
- Thread safety for threading constructs
- Removed timer constructs which reduced precision
Internals:
- Cleanup of image I/O code.
- Cleanup of build system to remove many #ifdefs
- Moved from CVS to git
07/10/2011: Switched the source repository to git
11/05/2010: Released libCVD 20100511
26/01/2005: Move over from tar files to CVS. I started using it in September 2003, and it had already existed for a few years by then.
?/?/1999: This is believed to be the start date. History has been lost.

Also, there is an Atom feed on freshmeat

Downloading

The use of git or a release is recommended. The tip of master should be in a stable state.

Current release (2.4.1):
- libcvd-2.4.1.tar.gz [586KB]
- libcvd-2.4.1.tar.bz2 [479KB]
- libcvd-2.4.1.tar.xz [450KB]
- libcvd-2.4.1.zip [717KB]
- ChangeLog [705KB]
Current development snapshot of main branch (may be broken): ZIP TAR.GZ
git: To get the latest version, use the following command:
```
git clone git://github.com/edrosten/libcvd.git
		
```
Or, get it from Github
Older releases
Older releases on github

Documentation

CVD Documentation .
CVD Tutorial .
Mailing list. This list covers everything (commits, general questions, etc...)
Mailing list archives

Dependencies

Build

unix:
- GNU make and a modern C++ compiler (gcc version >= 3.1)
- Works on Linux, ucLinux, FreeBSD, OpenBSD, OSX, Solaris, IRIX, Cygwin, MingW
- Cross and native compilation supported.
- Runs on x86, x86-64, ARM, Blackfin, MIPS, SPARC, PPC.
Windows:
- MinGW and Cygwin
- Visual Studio 2008 with the feature pack
- VS2008 build file builds under VS2010
Other:
- The library is very modular and significant parts have been compiled on other systems such as Symbian.
Doxygen (if you want to build the documentation)

Options

Note, on unix systems there are no required dependencies, but support for advanced features requires external libraries. Features which come as standard on certain platforms are not listed.

All platforms

X11 and OpenGL - required for cheap and cheerful GUI, and for useful GL bindings.
TooN
- TooN - numerics support ( TooN needs LAPACK and BLAS for some operations).
- BLAS and LAPACK are available under the vecLib framework on OSX.
libjpeg - loading and saving of JPEG images.
libpng - loading and saving of PNG images.
libTIFF - loading of TIFF images
ffmpeg - reading of AVI and MPG files (version >= 0.4.9 required).
libuvc for direct control over USB Video Class cameras on platforms with limited support (works, but unnecessary on Linux)

Linux

libdc1394 and libraw1394 - IIDC firewire camera support.
libdc1394v2 and libraw1394 - IIDC firewire camera and IIDC over USB support.

OSX

libdc1394v2 and libraw1394 - IIDC firewire camera and IIDC over USB support. Note, this provides better control over the cameras than the Quicktime API (which is also supported).

AMD

ACML - BLAS and LAPACK optimized for AMD processors.

Other pages

Savannah page: http://savannah.nongnu.org/projects/libcvd/
Freshmeat page: http://freshmeat.net/projects/libcvd/?branch_id=76733&release_id=289166

Other useful libraries

TooN: a numerics library used by libCVD.
TaG: Extra algorithms for TooN, some of which are useful for computer vision tasks.
GVars3: A configuration library which integrates well with TooN.

Updated April 11^th 2022, 03:25