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