test/pdiff/README.txt

   1 pdiff - a program that compares two images using
   2 a perceptually based image metric.
   3 Copyright (C) 2006 Yangli Hector Yee
   4 yeehector@users.sourceforge.net
   5 http://pdiff.sourceforge.net/
   6
   7 This program is free software; you can redistribute it and/or modify it
   8 under the terms of the GNU General Public License as published by the
   9 Free Software Foundation; either version 2 of the License,
  10 or (at your option) any later version.
  11
  12 This program is distributed in the hope that it will be useful, but
  13 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  14 or FITNESS FOR A PARTICULAR PURPOSE.
  15 See the GNU General Public License for more details in the file gpl.txt.
  16
  17 Build Instructions
  18 1. Download cross platform make from http://www.cmake.org
  19 2. Download libtiff from http://www.libtiff.org. Download libpng from http://www.libpng.org
  20 3. Edit CMakeLists.txt to tell it where to find your tiff library
  21 4. Type cmake .
  22 5. Type make . (or on Windows systems cmake makes a Visual Studio
  23 Project file)
  24 6. To specify the install directory, use make install DESTDIR="/home/me/mydist"
  25
  26 Usage
  27
  28 pdiff image1.(tif | png) image2.(tif | png) [options]
  29 -verbose : Turns on verbose mode
  30 -fov deg: field of view, deg, in degrees. Usually between 10.0 to 85.0.
  31 This controls how much of the screen the oberserver is seeing. Front row of
  32 a theatre has a field of view of around 25 degrees. Back row has a field of
  33  view of around 60 degrees.
  34 -threshold p : Sets the number of pixels, p, to reject. For example if p is
  35  100, then the test fails if 100 or more pixels are perceptably different.
  36 -gamma g : The gamma to use to convert to RGB linear space. Default is 2.2
  37 -luminance l: The luminance of the display the observer is seeing. Default
  38  is 100 candela per meter squared
  39
  40 Credits
  41
  42 Hector Yee, project administrator and originator - hectorgon.blogspot.com
  43 Scott Corley, for png file IO code
  44 Mick Weiss, Linux build and release & QA
  45 Carl Worth, Rewrite as library, depend on cairo, and port to C