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

                        _____   _   __  __ _____ _____
                       / ____| | | |  \/  |_   _/ ____|
                      | |  __  |_| | \  / | | || |
                      | | |_ |     | |\/| | | || |
                      | |__| |     | |  | |_| || |____
                       \_____|     |_|  |_|_____\_____|

                        GREYC's Magic Image Converter

                       ( http://gmic.sourceforge.net/ )

                                    v.0.8.0

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

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

  G'MIC is a console-based image processing tool whose goal is to convert,
  manipulate and visualize generic 1D/2D/3D multi-spectral image files.
  This includes classical color images, but also more complex data
  as image sequences or 3D volumetric images. It has been designed with
  portability in mind, and thus should run on a wide variety of different
  plateforms. It has been developed in the IMAGE Team of the GREYC
  laboratory, in Caen/France.

# Author
#--------

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

# Contributors
#-------------

  Claude Bulin       ( http://www.xcfa.tuxfamily.org/ )          (packaging)
  Angelo Lama        ( historical developper of EKD : http://ekd.tuxfamily.org,
                       post-prod software for videos and images) (testing)
# Institution
#-------------

 GREYC Image / CNRS UMR 6072 / FRANCE

 Team web page : http://www.greyc.ensicaen.fr/EquipeImage/

# Installation
#--------------

 These different procedures can be considered in order to install G'MIC
 on your computer :

 [1] Using the packaging systems of Linux distributions :

     A repository of G'MIC packages for different Linux distributions are
     available at : http://download.tuxfamily.org/xcfaudio/gmic/

     For instance, on Debian/Ubuntu, you can add the following line to your
     '/etc/apt/sources.list' file :

          deb http://download.tuxfamily.org/xcfaudio/gmic dev contrib

     Then, type :

          wget http://download.tuxfamily.org/xcfaudio/download/xcfaudio.key.asc -O - | sudo apt-key add -
          sudo apt-get update
          sudo apt-get install gmic

 [2] Getting the pre-compiled binaries :

     The Download section on the G'MIC website ( http://gmic.sourceforge.net )
     provides pre-compiled binaries for different architectures. G'MIC consists
     of only one single executable file, so it is rather simple to use. Anyway,
     G'MIC relies on the use of external libraries, and you will need to
     install them on your system. Those libraries are :

          libx11 libxext libxrandr2 libpng12-0 libjpeg-62 libtiff4
          libavcodec1d libavformat1d zlib1g libmagick++9c2a

 [3] Compiling from the sources :

     The Download section on the G'MIC website ( http://gmic.sourceforge.net )
     provides a source archive that can be used to compile the G'MIC executable
     directly from the C++ source code. G'MIC can be compiled and used on
     different architectures, including Unix,Windows and MacOSX.
     A 'configure' script (autotools) is provided to help the compilation
     process. The dependencies needed by the compilation process are
     customizable (see the compilation options in the provided Makefile).
     Due to its high template structure and the number of types G'MIC is
     capable of handling, the compilation of G'MIC requires a lot of CPU time
     and memory (you have been warned, be patient :) ).
     The compilation requires the header files of the libraries listed in [2].
     On Debian, they can be installed with the following packages :

          libx11-dev libxext-dev libxrandr-dev libpng12-dev libjpeg62-dev
          libtiff4-dev libavcodec-dev libavformat-dev zlib1g-dev
          libmagick++9-dev

# Custom commands
#----------------

 A macro file 'gmic_def.raw' is distributed in the G'MIC package and allows to add
 user-defined commands to G'MIC. A macro is simply defined as a command name that
 is substituted by a set of native G'MIC commands. You could be interested by
 a constantly updated version of the macro file, available at :

     http://cimg.cvs.sourceforge.net/*checkout*/cimg/CImg/examples/gmic_def.raw

 If you have interesting macros to share, please post them on the G'MIC forum,
 so they could be added to the official G'MIC macro file.

# Licenses
#----------

 The source code of G'MIC is distributed under
 the CECILL v.2.0 license (file 'Licence_CeCILL_V2-en.txt').
 This License is a Free-Software license, compatible with the GPL license
 (so using those files in closed-source project is not allowed).

 The CeCiLL v.2.0 license ( http://www.cecill.info/index.en.html ) have been
 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/ )

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