------------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------------
   ____  _   _  ____     ___  ____  __  __  ___     __    ____  ____  ____    __    ____  _  _ 
  (_  _)( )_( )( ___)   / __)(_  _)(  \/  )/ __)   (  )  (_  _)(  _ \(  _ \  /__\  (  _ \( \/ )
    )(   ) _ (  )__)   ( (__  _)(_  )    (( (_-.    )(__  _)(_  ) _ < )   / /(__)\  )   / \  / 
   (__) (_) (_)(____)   \___)(____)(_/\/\_)\___/   (____)(____)(____/(_)\_)(__)(__)(_)\_) (__) 


                               The C++ Template Image Processing Library

                                   ( http://cimg.sourceforge.net )

                                        pre-release v.1.0.7

------------------------------------------------------------------------------------------------

# Pre-release note :
#-------------------

  This is a pre-release of the CImg Library v.1.0.7. This version is almost final so I
  decided to pre-release it. I've only planed to add detailed documentation on CImg classes
  and functions, but no new features or changes in the library structure will occur.
  As this version corrects a lot of bugs from the previous one (1.0.6), and has more	
  detailled documentation as well, I think it was time to replace the 1.0.6.

# Summary
#---------

  The CImg Library consists in a single header file 'CImg.h' providing a set of C++ classes that
  can be used in your own sources, to load/save, process and display images. Very portable 
  (Unix/X11,Windows, MacOS X, FreeBSD,..), efficient, simple to use, it's a pleasant toolkit
  for coding image processing stuffs in C++.
  
# Author
#--------

  David Tschumperl  ( http://cimg.sourceforge.net/David.Tschumperle )

# Package structure :
#--------------------

  The CImg package is organized as follows :

  - CImg.h         : The only file of the library itself.
  - CHANGES.txt    : A list of changes between successive CImg versions, since the 1.0.5.
  - LICENSE.txt    : A copy of the GPL license which applies to the CImg Library.
  - README.txt     : This file.

  - examples/      : Directory containing a lot of example programs performing various stuffs,
                     based on the CImg library.
    
   * CImg_test.cpp                : A multi-part demo of the CImg capabilities.
                                    Should be tested first.
   * fade_images.cpp              : Perform an oriented fading between two images.
   * hough_transform.cpp          : An implementation of the Hough Transform to detect lines
                                    in images.
   * inpainter.cpp                : An implementation of a multiscale PDE-based inpainting,
                                    as described in Tschumperle-Deriche:CVPR'03.
   * inrcast.cpp                  : Tool used to convert 2D/3D images with command line arguments.
   * odykill.cpp                  : A simple shoot-em-up game, featuring the team of the Odysse Lab.
   * image_registration.cpp       : Register two images and do an automatic morphing between them.
   * pde_heatflow2D.cpp           : An implementation of the Heat Flow PDE applied on a 2D image.
   * pde_TschumperleDeriche2D.cpp : An implementation of the restoration/inpainting PDE, as described 
                                    in Tschumperle-Deriche:CVPR'03 (monoscale).
   * pde_TschumperleDeriche3D.cpp : Same as 'pde_TschumperleDeriche2D.cpp' for 3D volumes of data.
   * pslider.cpp                  : A tool to generate and view presentations from Postscript files.
   * render3d.cpp                 : An example of 3D object rendering using CImg drawing functions.
   * tetris.cpp                   : An implementation of the well-known tetris game in few lines.
   * tutorial.cpp                 : A very simple code to get started with the CImg library.

  - documentation/ : Directory containing a copy of the CImg web page in html format. To generate the 
                     reference documentation, you have to use the tool 'doxygen' 
                     (see http://www.doxygen.org) on the file 'CImg.doxygen'. You can also access the documentation 
		     from the library web page : http://cimg.sourceforge.net.
                     
  - compilation/   : Directory containing several sub-directories that are intended to ease the 
                     compilation of the examples, with various C++ compilers on Unix and Windows.

# Getting started
#-----------------
 
  First, you should try to compile the different examples provided in the 'examples/'
  directory. Look at the 'compilation/' directory to ease this compilation step
  on different plateforms. Then, you can look at the documentation 'documentation/head.html'
  and the complete reference 'documentation/reference/index.html' to learn more about CImg
  functions and classes. In case of problems, you can go to the 'forum' section of the
  CImg web page and ask for help.

------------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------------