Macduff: the Macbeth ColorChecker finder
C++ Makefile
Latest commit e414fb3 Feb 22, 2016 @ryanfb Merge branch 'up4-master'
Permalink
Failed to load latest commit information.
.gitignore
LICENSE.txt
Makefile
README.md
macduff.cpp

README.md

Macduff

Macduff is a tool for finding the Macbeth ColorChecker chart in an image.

SYNOPSIS

Macduff depends on OpenCV, and the default Makefile uses pkg-config to set the correct compilation flags. Tweak as needed.

$ make
$ ./macduff input.tif result.png > result.csv

DESCRIPTION

Macduff result

Macduff will try its best to find your ColorChecker. If you specify an output image, it will be written with the "found" ColorChecker overlaid on the input image with circles on each patch (the outer circle is the "reference" value, the inner circle is the average value from the actual image). Macduff outputs various useless debug info on stderr, and useful information in CSV-style on stdout. The first 24 lines will be the ColorChecker patch locations and average values:

x,y,r,g,b

The last two lines contain the patch square size (i.e. you can feed another program this and the location and safely use a square of size with the top left corner at x-size/2,y-size/2 for each patch) and error against the reference chart. The patches are output in row order from the typical ColorChecker orientation ("dark skin" top left, "black" bottom right):

ColorChecker layout

See also: Automatic ColorChecker Detection, a Survey

LICENSE

Macduff is 3-clause BSD and includes some code taken from OpenCV. See LICENSE.TXT.