-----------------------------------------------------------------------------------
-----------------------------------------------------------------------------------
       ____ ____  _______   ______     _                  _   _
      / ___|  _ \| ____\ \ / / ___|___| |_ ___  _ __ __ _| |_(_) ___  _ __
     | |  _| |_) |  _|  \ V / |   / __| __/ _ \| '__/ _` | __| |/ _ \| '_ \
     | |_| |  _ <| |___  | || |___\__ \ || (_) | | | (_| | |_| | (_) | | | |
      \____|_| \_\_____| |_| \____|___/\__\___/|_|  \__,_|\__|_|\___/|_| |_|


                Fast Anisotropic Smoothing of Multi-Valued Images
                          by Curvature-Preserving PDE's.

           ( http://www.greyc.ensicaen.fr/~dtschump/greycstoration/ )

		                      v.2.5

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

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

GREYCstoration is an image regularization algorithm which processes an image by locally
removing small variations of pixel intensities while preserving significant global image features,
such as sharp edges and corners. The most direct application of image regularization is denoising.
By extension, it can also be used to inpaint or resize images.
GREYCstoration is based on state-of-the-art methods using nonlinear multi-valued diffusion PDE's
(Partial Differential Equations) for image regularization. This kind of method generally outperforms
basic image filtering techniques (such as convolution, median filtering, etc.), classically encountered
in painting programs. Other image denoising plugins are available (for instance, Noise Ninja, Neat Image )
but are not free, and the corresponding algorithms are kept secret.
On the contrary, GREYCstoration is distributed as an open source software, submitted to the CeCILL License
(compatible with the well-known GPL license).
It gives similar results (not to say better) to existing denoising filters.


# Author
#--------

  David Tschumperle  ( http://www.greyc.ensicaen.fr/~dtschump/ )


# Institution
#-------------

 GREYCstoration has been developed in the Image group of the GREYC Lab (CNRS, UMR 6072),
 in Caen/France ( http://www.greyc.ensicaen.fr/EquipeImage/ ).


# License
#---------

 GREYCstoration is distributed under the CeCiLL license (http://www.cecill.info/index.en.html).
 The CeCiLL license is a free-software license, created under the supervision of the three biggest
 research institutions on computer sciences in France :

   - CNRS  ( http://www.cnrs.fr/ )
   - CEA   ( http://www.cea.fr/ )
   - INRIA ( http://www.inria.fr/ )

 The CeCiLL license is COMPATIBLE WITH THE GNU GPL : you can legally redistribute programs using GREYCstoration in GPL.
 You have to RESPECT this license. Please carefully read the license terms before use. In particular,
 if you are interested to distribute programs using GREYCstoration in closed-source products,
 you are invited to contact David Tschumperle (mail on his web page) to negociate a specific license.

# Getting the GREYCstoration source code
#----------------------------------------

 The GREYCstoration source code is directly distributed within this package (directory 'src').
 But you have to know that GREYCstoration is a part of the CImg Library (http://cimg.sourceforge.net),
 it is then mainly distributed and maintained inside the CImg Library package.
 I recommend you get the CVS DEVELOPMENT VERSION of the CImg Library, to be sure to get the LATEST
 version of GREYCstoration (see http://cimg.sourceforge.net/download.shtml for details about CVS commands)

# Integrating GREYCstoration into an open-source source code :
#--------------------------------------------------------------

 The GREYCstoration has now a simple API that provides easy integration of the algorithm into
 open source softwares. Please look at the 'src/greycstoration4integration.cpp' file, it will tell
 you almost all you have to know to get GREYCstoration working in your own code.
 This simply require you include the CImg Library + the GREYCstoration plug-in, and call a single
 function...

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

  The directory GREYCstoration/ is organized as follows :

  - GREYCstoration_win32.exe : The compiled executable for Window (32 bits).
  - GREYCstoration_linux     : The compiled executable for Linux (32 bits).
  - GREYCstoration_macosx    : The compiled executable for MacOS X (PPC only!)
  - src/                     : The sources of the GREYCstoration algorithm.

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