PTdecode/CImg-1.3.0/README.txt

changeset 5
1204ebf9340d
     1.1 diff -r 5edfbd3e7a46 -r 1204ebf9340d PTdecode/CImg-1.3.0/README.txt
     1.2 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.3 +++ b/PTdecode/CImg-1.3.0/README.txt	Mon Aug 03 14:09:20 2009 +0100
     1.4 @@ -0,0 +1,255 @@
     1.5 +--------------------------------------------------------------------------------
     1.6 +--------------------------------------------------------------------------------
     1.7 +                            ____  _   _  ____
     1.8 +                           (_  _)( )_( )( ___)
     1.9 +                             )(   ) _ (  )__)
    1.10 +                            (__) (_) (_)(____)
    1.11 +    ___  ____  __  __  ___     __    ____  ____  ____    __    ____  _  _
    1.12 +   / __)(_  _)(  \/  )/ __)   (  )  (_  _)(  _ \(  _ \  /__\  (  _ \( \/ )
    1.13 +  ( (__  _)(_  )    (( (_-.    )(__  _)(_  ) _ < )   / /(__)\  )   / \  /
    1.14 +   \___)(____)(_/\/\_)\___/   (____)(____)(____/(_)\_)(__)(__)(_)\_) (__)
    1.15 +
    1.16 +
    1.17 +                    C++ Template Image Processing Library
    1.18 +
    1.19 +                       ( http://cimg.sourceforge.net )
    1.20 +
    1.21 +                                   v.1.3.0
    1.22 +
    1.23 +--------------------------------------------------------------------------------
    1.24 +
    1.25 +# Summary
    1.26 +#---------
    1.27 +
    1.28 +  The CImg Library is an open-source C++ toolkit for image processing.
    1.29 +  It consists in a single header file 'CImg.h' providing a minimal set of C++
    1.30 +  classes and methods that can be used in your own sources, to load/save,
    1.31 +  process and display images. Very portable (Unix/X11,Windows, MacOS X, FreeBSD, .. ),
    1.32 +  efficient, easy to use, it's a pleasant library for developping image processing
    1.33 +  algorithms in C++.
    1.34 +
    1.35 +# Authors and contributors :
    1.36 +#----------------------------
    1.37 +
    1.38 +  - David Tschumperle (project manager) ( http://www.greyc.ensicaen.fr/~dtschump/ )
    1.39 +
    1.40 +  - Haz-Edine Assemlal
    1.41 +  - Vincent Barra
    1.42 +  - Romain Blei
    1.43 +  - Yohan Bentolila
    1.44 +  - Jerome Boulanger
    1.45 +  - Frederic Devernay
    1.46 +  - Francois-Xavier Dupe
    1.47 +  - Eric Fausett
    1.48 +  - Jean-Marie Favreau
    1.49 +  - Sebastien Fourey
    1.50 +  - Alexandre Fournier
    1.51 +  - Vincent Garcia
    1.52 +  - Jinwei Gu
    1.53 +  - Jean-Daniel Guyot
    1.54 +  - Matt Hanson
    1.55 +  - Sebastien Hanel
    1.56 +  - Christoph Hormann
    1.57 +  - Werner Jainek
    1.58 +  - Daniel Kondermann
    1.59 +  - Pierre Kornprobst
    1.60 +  - Orges Leka
    1.61 +  - Francois Lauze
    1.62 +  - Xie Long
    1.63 +  - Thomas Martin
    1.64 +  - Cesar Martinez
    1.65 +  - Jean Martinot
    1.66 +  - Nikita Melnichenko
    1.67 +  - Baptiste Mougel
    1.68 +  - Renaud Peteri
    1.69 +  - Martin Petricek
    1.70 +  - Paolo Prete
    1.71 +  - Adrien Reboisson
    1.72 +  - Klaus Schneider
    1.73 +  - Konstantin Spirin
    1.74 +  - David G. Starkweather
    1.75 +  - Rainer Steffens
    1.76 +  - Grzegorz Szwoch
    1.77 +  - Thierry Thomas
    1.78 +  - Yu-En-Yun
    1.79 +  - Vo Duc Khanh
    1.80 +  - Phillip Wood
    1.81 +  - Bug Zhao
    1.82 +  - Haibo Zheng
    1.83 +
    1.84 +# Institution
    1.85 +#-------------
    1.86 +
    1.87 + GREYC Image / CNRS UMR 6072 / FRANCE
    1.88 +
    1.89 + The CImg Library project started in 2000, at the INRIA-Sophia
    1.90 + Antipolis/France ( http://www-sop.inria.fr/ ), in the ROBOTVIS / ODYSSEE Team.
    1.91 + Since October 2004, it is maintained and developed in the Image team of
    1.92 + the GREYC Lab (CNRS, UMR 6072), in Caen/France.
    1.93 + Team web page : http://www.greyc.ensicaen.fr/EquipeImage/
    1.94 +
    1.95 +# Licenses
    1.96 +#----------
    1.97 +
    1.98 + The source code of the CImg Library is distributed under
    1.99 + two distinct licenses :
   1.100 +
   1.101 + - The main library file 'CImg.h' is *dual-licensed* :
   1.102 +   It can be either distributed under the CeCILL-C or CeCILL license.
   1.103 +   (see files 'Licence_CeCILL-C_V1-en.txt' and 'Licence_CeCILL_V2-en.txt').
   1.104 +   Both are Free-Software licenses :
   1.105 +
   1.106 +     * CeCILL-C is adapted to the distribution of
   1.107 +       library components, and is close in its terms to the well known GNU LGPL license
   1.108 +       (the 'CImg.h' file can thus be used in closed-source products under certain
   1.109 +       conditions, please read carefully the license file).
   1.110 +
   1.111 +     * CeCILL is close to (and even compatible with) the GNU GPL license.
   1.112 +
   1.113 + - Most of the other files are distributed under the CeCiLL license
   1.114 +   (file 'Licence_CeCILL_V2-en.txt'). See the file header to see what license applies.
   1.115 +
   1.116 + These two CeCiLL licenses ( http://www.cecill.info/index.en.html ) have been
   1.117 + created under the supervision of the three biggest research institutions on
   1.118 + computer sciences in France :
   1.119 +
   1.120 +   - CNRS  ( http://www.cnrs.fr/ )
   1.121 +   - CEA   ( http://www.cea.fr/ )
   1.122 +   - INRIA ( http://www.inria.fr/ )
   1.123 +
   1.124 + You have to RESPECT these licenses. More particularly, please carefully read
   1.125 + the license terms before using the CImg library in commercial products.
   1.126 +
   1.127 +# Package structure :
   1.128 +#--------------------
   1.129 +
   1.130 +  The main package directory CImg/ is organized as follows :
   1.131 +
   1.132 +  - README.txt                 : This file.
   1.133 +  - CHANGES.txt                : A list of changes between consecutive CImg versions.
   1.134 +  - Licence_CeCILL-C_V1-en.txt : A copy of the CeCiLL-C license file.
   1.135 +  - Licence_CeCILL_V2-en.txt   : A copy of the CeCiLL license.
   1.136 +  - CImg.h                     : The single header file that constitutes the library itself.
   1.137 +  - examples/                  : A directory containing lot of example programs performing
   1.138 +                                 various things, based on the CImg library.
   1.139 +  - html/                      : A directory containing a copy of the CImg web page in html
   1.140 +                                 format. The reference documentation is generated
   1.141 +              		         automatically with the tool 'doxygen' (http://www.doxygen.org).
   1.142 +  - resources/                 : A directory containing some resources files for compiling
   1.143 +                                 CImg examples or packages with various C++ compilers and OS.
   1.144 +  - plugins/                   : A directory containing CImg plug-ins files that can be used to
   1.145 +                                 add specific extra functionalities to the CImg library.
   1.146 +
   1.147 +# Getting started
   1.148 +#-----------------
   1.149 +
   1.150 +  If you are new to CImg, you should first try to compile the different examples
   1.151 +  provided in the 'examples/' directory, to see what CImg is capable of
   1.152 +  (as CImg is a template library, no compilation is mandatory of course).
   1.153 +  Look at the 'resources/' directory to ease this see how to compile these examples
   1.154 +  on different plateforms.
   1.155 +
   1.156 +  Then, you can look at the documentation 'html/reference/' to learn more about CImg
   1.157 +  functions and classes. Finally, you can participate to the 'Forum' or 'Chat' sections
   1.158 +  of the CImg web page and ask for help if needed.
   1.159 +
   1.160 +# Current list of available CImg plug-ins
   1.161 +#-----------------------------------------
   1.162 +
   1.163 +  --------------------------------------------------------------------------------
   1.164 +  - CImg IPL ('plugins/cimgIPL.h') (November 2008).
   1.165 +
   1.166 +    This plug-in allows the conversion between CImg and IplImage structures
   1.167 +    (used in openCV).
   1.168 +
   1.169 +    by Haibo Zheng (haibo.zheng - at - gmail.com)
   1.170 +
   1.171 +  --------------------------------------------------------------------------------
   1.172 +  - Draw gradient ('plugins/draw_gradient.h') (November 2008).
   1.173 +
   1.174 +    This plug-in can be used to draw color gradient in images.
   1.175 +
   1.176 +    by Jerome Boulanger (http://www.irisa.fr/vista/Equipe/People/Jerome.Boulanger.html),
   1.177 +
   1.178 +  --------------------------------------------------------------------------------
   1.179 +  - Add file format ('plugins/add_fileformat.h') (September 2007).
   1.180 +
   1.181 +    This plug-in shows how to easily add support for your own file format in
   1.182 +    CImg. This can be interesting, since the additional format will be recognized
   1.183 +    in functions 'CImg<T>::save()' and 'CImg<T>::load()' functions.
   1.184 +
   1.185 +    by David Tschumperle (http://www.greyc.ensicaen.fr/~dtschump/).
   1.186 +       IMAGE Team / GREYC (CNRS UMR 6072), Caen / FRANCE.
   1.187 +       Home page of the team :  http://www.greyc.ensicaen.fr/EquipeImage/
   1.188 +
   1.189 +  --------------------------------------------------------------------------------
   1.190 +  - JPEG Buffer ('plugins/jpeg_buffer.h') (July 2007).
   1.191 +
   1.192 +    This plug-in provides functions to read/write images stored in jpeg format
   1.193 +    directly in memory buffers. Interesting when dealing for instance with
   1.194 +    images coming from webcams and stored in memory.
   1.195 +
   1.196 +    by Paolo Prete.
   1.197 +
   1.198 +  --------------------------------------------------------------------------------
   1.199 +  - Integral Line ('plugins/integral_line.h') (March 2007).
   1.200 +
   1.201 +    Implementation of functions that retrieve integral lines from vector fields
   1.202 +    using different types of interpolation.
   1.203 +
   1.204 +    by David Tschumperle (http://www.greyc.ensicaen.fr/~dtschump/).
   1.205 +       IMAGE Team / GREYC (CNRS UMR 6072), Caen / FRANCE
   1.206 +       Home page of the team :  http://www.greyc.ensicaen.fr/EquipeImage/
   1.207 +
   1.208 +  --------------------------------------------------------------------------------
   1.209 +  - GREYCstoration ('plugins/greycstoration.h') (May 2006).
   1.210 +
   1.211 +    Implementation of the GREYCstoration algorithm for image denoising.
   1.212 +    This version is adapted for an easy integration in third parties
   1.213 +    software, since it is non-blocking and returns a progression indice
   1.214 +    that can be used in progress bars.
   1.215 +
   1.216 +    by David Tschumperle (http://www.greyc.ensicaen.fr/~dtschump/).
   1.217 +       IMAGE Team / GREYC (CNRS UMR 6072), Caen / FRANCE
   1.218 +       Home page of the team :  http://www.greyc.ensicaen.fr/EquipeImage/
   1.219 +
   1.220 +  --------------------------------------------------------------------------------
   1.221 +  - NL Means and Noise Analysis ('plugins/nlmeans.h' and
   1.222 +                                 'plugins/noise_analysis.h') (May 2006).
   1.223 +
   1.224 +    Implementation of the Non-Local Means algorithm as described in [1] and [2].
   1.225 +    The variance of the noise can be automatically estimated using the method
   1.226 +    inspired from [3].
   1.227 +
   1.228 +    [1] Buades, A.; Coll, B.; Morel, J.-M.: A non-local algorithm for image
   1.229 +        denoising. IEEE Computer Society Conference on Computer Vision and Pattern
   1.230 +        Recognition, 2005. CVPR 2005. Vol 2,  20-25 June 2005 Page(s):60 - 65
   1.231 +
   1.232 +    [2] Buades, A. Coll, B. and Morel, J.: A review of image denoising algorithms,
   1.233 +        with a new one. Multiscale Modeling and Simulation: A SIAM
   1.234 +        Interdisciplinary Journal 4 (2004) 490-530
   1.235 +
   1.236 +    [3] Gasser, T. Sroka,L. Jennen Steinmetz,C. Residual variance and residual
   1.237 +        pattern nonlinear regression. Biometrika 73 (1986) 625-659
   1.238 +
   1.239 +    by Jerome Boulanger (http://www.irisa.fr/vista/Equipe/People/Jerome.Boulanger.html),
   1.240 +       Charles Kervrann and Patrick Bouthemy thanks to ACI IMPBio (MODYNCELL5D Project).
   1.241 +       VISTA / IRISA-INRIA, Rennes / FRANCE
   1.242 +       Home page of the team :  http://www.irisa.fr/vista/
   1.243 +       MIA / INRA, Unite de Jouy-en-Josas / FRANCE.
   1.244 +
   1.245 +  --------------------------------------------------------------------------------
   1.246 +  - Plug in for Matlab mex files ('plugins/cimgmatlab.h') (May 2006).
   1.247 +
   1.248 +    Implement a CImg<T> constructor from a matlab array, a CImg<T> assignment
   1.249 +    operator from a matlab array and a method that exports a CImg<T> object to
   1.250 +    a Matlab array.
   1.251 +    For a bit more, http://www.itu.dk/people/francois/cimgmatlab.html
   1.252 +
   1.253 +    by Francois Lauze (http://www.itu.dk/people/francois/index.html)
   1.254 +       The IT University of Copenhagen, Image Group.
   1.255 +
   1.256 +  --------------------------------------------------------------------------------
   1.257 +
   1.258 +# End of file
   1.259 +#------------