www.aleph1.co.uk Git - yaffs-website/blob - vendor/lsolesen/pel/test/image-tests/README

   1 README file for PEL Test Images.
   2
   3 Copyright (C) 2004, 2005, 2006  Martin Geisler.
   4 Licensed under the GNU GPL, see COPYING for details.
   5
   6
   7 PEL Test Images
   8 ***************
   9
  10 The images contained in this directory are test images collected for
  11 use with PEL: PHP Exif Library.  One can download PEL from:
  12
  13   http://github.com/lsolesen/pel/
  14
  15 All images except no-exif.jpg contain Exif information, and the
  16 corresponding PHP files contain SimpleTest (http://simpletest.sf.net/)
  17 unit tests.
  18
  19 To use those files with PEL, first place this directory (the
  20 image-tests directory) under the test directory in an unpacked PEL
  21 source tree.  Install SimpleTest using the instructions found in the
  22 README file in the test directory.
  23
  24 Now run the run-tests.php script in the test directory.  It should
  25 automatically pickup the new tests.
  26
  27 The images can be used by anybody, but may only be redistributed under
  28 the GNU GPL.  See the file COPYING for the details.
  29
  30
  31 Contributing Test Images
  32 ************************
  33
  34 If you own a camera model from which there are no test image, then
  35 please contribute one.  The image should
  36
  37 * contain as much interesting Exif tags as possible.  The camera
  38   should therefore be set to a manual mode, and the settings should be
  39   changed from their defaults,
  40
  41 * have as small a file size as possible, so use a resolution of
  42   640x480 or less, if possible.  Also, use the poorest image quality
  43   (the best compression) to reduce the file size.
  44
  45 * come from the camera unaltered.  Do not resize the image using an
  46   image manipulation program, for then it is this program that will be
  47   tested, not the camera that took the image,
  48
  49 * be of something which wont protest to be widely published on the
  50   net.  Things like a flower, a mountain, or a cat springs to mind,
  51   whereas pictures from a private party are no good,
  52
  53 * be licensed under the GNU GPL as the rest of PEL Test Images, so
  54   that it can be redistributed with it.
  55
  56 Submit your test image(s) by forking the repository found at
  57
  58   http://github.com/lsolesen/pel/
  59
  60 All image contributers will be given full credit in the AUTHORS file
  61 distributed with PEL.