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


 CHANGES.txt : List the changes made between consecutive versions of The CImg Library


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

*-----------------------------
*-----------------------------
* Changes from 1.1.9 to 1.2.0
*-----------------------------
*-----------------------------

* New features :
     - Added function 'CImg<T>::draw_grid()' that draws a grid on the instance image
     (useful when combined with CImg<T>::draw_axis and CImg<T>::draw_graph).
     - Added multi-threading support in GREYCstoration plugin and command line version.
     - Added support for GraphicsMagick conversion tools (http://www.graphicsmagick.org).
     - Added plugin 'integral_line.h' that define functions to track integral lines in images.
     - Added CTRL+key combinations in 'CImg<T>::display_object3d' and 'CImg<T>::feature_selection()' :
        - CTRL+S : Save snapshot.
        - CTRL+D : Double window resolution.
        - CTRL+C : Divide window resolution.
        - CTRL+F : Fullscreen mode.
     - Added new normalization mode=3, now set by default when using CImgDisplay. Try to adapt
     the display normalization to the image type.
     - Added new example 'edge_explorer.cpp' (thanks to Orges Leka).
     - Added new example 'greycstoration4gimp.cpp' (which is a GREYCstoration plugin for the Gimp, thanks
     to Grzegorz Szwoch)
     - Added functions 'CImg<T>::[get]_round()' that round values of an image.
     - Added function 'CImg<T>::draw_line()' able to draw joined set of segments.
     - Added interpolation_type=-1 for 'CImg<T>::resize()' corresponding to raw memory resizing, without
     interpolation.
     - Added function 'CImg<T>::permute_axes()' that can be used to swap order of image axes
     (useful for converting ...RRRRRRGGGGGBBBBB... to ...RGBRGBRGBRGB....)
     - Added support for NIFTI files (extension '.nii') added in 'CImg<T>::load_analyze()'.
     - Added function 'CImg<T>::[get_]displacement_field()' that can estimate displacement field between two images.
     - Added default constructor for the 'CImgDisplay' class, which creates a window initially in the 'closed' state.
     - Added directory 'compilation/unix_debian_package' for easy construction of .deb package for CImg.
     - Added new search parth to find 'medcon' on Windows.
     - Added Debian package configuration files to generate .deb file from the CImg directory
     (a .deb file is now available from the CImg website).

* Optimizations / Modifications :
     - Renamed all '*_convert' functions to '*_imagemagick'.
     - Fonction CImg<T>::draw_object3d() has been slightly optimized (light computation for
     outside primitives is not done anymore).
     - Small changes in cimg:: traits.
     - Removed 'precision' arguments in 'CImg<T>::draw_axis()'.
     - The use of non in-place arithmetical operators is now possible in plug-ins.

* Bug corrections :
     - Versions of 'CImg<T>::load_tiff()' and 'CImg<T>::save_tiff()' that use libtiff has been
     debugged and improved.
     - fread() and fwrite() has been recoded to handle the Windows file size limit of 64Mb over network
     (this is a Windows bug !).
     - GREYCstoration plugin has been modified to better deal with 16 and 32bits images.
     - And many other small bug corrections....

*-----------------------------
*-----------------------------
* Changes from 1.1.8 to 1.1.9
*-----------------------------
*-----------------------------

* New features :
     - Added Rice noise distribution in 'CImg<T>::noise()' (thanks to H.E Assemlal).
     - Added functions 'CImg<T>::sharpen()' and 'CImg<T>::get_sharpen()' that can enhance contrast in images,
     using nonlinear 2D/3D multi-valued shock filters.
     - Added function 'CImgStats::is_empty()' to check is a stat object has been initialized or not.
     - Added function 'CImg<T>::contains()' and 'CImgList<T>::contains()' that can test if a pixel is
     present in an image.
     - Added new demo 'CImg-breakout' in 'examples/CImg_demo.cpp' (Arkanoid-style game in 64 lines of code!).
     - Functions 'CImgDisplay::hide_mouse()' and 'CImgDisplay::show_mouse()' have been added, allowing to
       hide/show the cursor when it is over a display window.
     - Functions 'CImg<T>::[get_]structure_tensorXY[Z]()' have been added, allowing to compute the 2D or
     3D structure tensor field from an image.
     - Function 'CImgDisplay::set_mouse()' is now working on Windows.
     - Added load/save functions to deal directly with std::FILE structures.
     - Added members 'CImgDisplay::keys[256]' and 'CImgDisplay::buttons[256]' allowing to get the latest 256 keys
     or mouse buttons modifications done on the display window.
     - Added function 'CImgDisplay::is_typed()' to test if a certain combination of key has been typed
     on the display window.
     - Added keyboard shortcut 'CTRL+S' in 'CImg<T>::display_object3d()' to be able to save snapshot of current 3d view.

* Optimizations / Modifications :
     - Recoded the greycstoration plug-in as the file 'plugins/greycstoration.h'. The command line version
     'examples/greycstoration.cpp' has been greatly improved, including tiled-mode and less memory consumption.
      The use of GREYCstoration is now more easy, the code is more factorized.
     - File extension '.txt' is now considered as '.dlm' (ascii file).

* Bug corrections :
     - Plugin 'plugins/cimgmatlab.h' has been corrected.

*-----------------------------
*-----------------------------
* Changes from 1.1.7 to 1.1.8
*-----------------------------
*-----------------------------

* New features :
    - Added conditional use of the FFTW3 library (http://www.fftw.org) allowing more flexibility and speed
      on DFT computation, when used.
    - Added new macro 'cimg_help()', displays arbitrary user-defined messages when program is invoked
    with the option '-h' or '--help'.
    - Added new macro 'cimglist_apply()' allowing to apply a single function to all members of a list :
    Ex: cimglist_apply(list,blur)(3.0f);
    - Added functions 'CImg<T>::resize_object3d()', 'CImgList<T>::resize_object3d()',
    'CImg<T>::get_resize_object3d()' and 'CImgList<T>::get_resize_object3d()' to ease resizing and
    centering 3d objects.
    - Added function 'CImgDisplay::set_mouse()' to set the mouse pointer coordinates (X11 only).
    - Added functions 'CImg<T>::atan()', 'CImg<T>::acos()', 'CImg<T>::asin()' and their get_* counterparts.

* Optimizations / Modifications :
    - 'cimg_debug' has new value signification. Can now choose between displaying error message on the console
    or on modal windows, even when 'cimg_display_type' is not 0.
    - Updated CImg presentation slides in 'documentation/slides_cimg.pdf', more complete now.
    - Added new directories in path search for 'convert' and 'medcon' and 'temporary path'.
    'convert' or 'medcon' found in the current directory './' now override the default ones.
    - Added safer support for Windows 64bits.
    - Improved version of 'cimg::info()' for debugging facilities. Now displays almost every
    important library variables and parameters.
    - Static version of CImg<T>::sequence() now return a column vector instead of a line.
    - Slightly changed the tracking algorithm and few other things in 'examples/dtmri_view.cpp',
      allowing more precision in the fiber computation.
    - Modified the 'CImg<T>::feature_selection()' function : replaced the moving hatch by a static
    one, less fun but also less time consuming. One small selection bug for 3D volumes has been
    also corrected.
    - Corrected line routine for 64bits architectures.
    - Replaced 'CImg<T>::scroll()' by 'CImg<T>::translate()'.
    - Replaced all 'cimg_map' by more coherent names based on 'cimg_for_*'. Same for 'cimglist_map'.
      Compatibility with previous versions of CImg is ensured if 'cimg_strict' is not defined.
    - Recoded functions to retrieve parts of the images : get_channel(), get_slice(), ...
    - Improved the cimg::system() function.
    - Added some tests and display extra warnings when saving images with wrong formats.

* Bug corrections :
    - Corrected small bug in 'CImg<>::blur_anisotropic()', 'examples/greycstoration.cpp' and 'plugins/greycstoration4integration.h'.
    - And lot of minor bug corrections and optimizations .....

*-----------------------------
*-----------------------------
* Changes from 1.1.6 to 1.1.7
*-----------------------------
*-----------------------------

* New features :
    - Added 'operator<<()' and 'operator>>()' for bit shift operations on all images pixels.
    - Added most of mathematical operators in the 'CImgList' class.
    - Added new demo 'Image Waves' in 'examples/CImg_demo.cpp'.
    - Added mouse wheel support on Windows (incomplete!)

* Optimizations / Modifications :
    - Renamed class 'CImgl' into 'CImgList', also renamed macro 'cimgl_map' to 'cimglist_map'.
      Backward compatibility is assured in 1.1.7 version, but think about replacing the old names
      by the new ones for future CImg versions.
    - Removed 'operator<<()' which appended an image to another one
    - Recoded lot of non in-place mathematical operators to avoid numerical truncations.
    It may have a great influence on your code. For instance writting '0.5+img' will result in a CImg<double>
    image, even if 'img' was a CImg<float>.
    - Recoded most of 'CImg<T>::get_resize()' function : linear interpolation performs now really faster, and
    an additional parameter allows to select between different conditions for border values.
    - Recoded 'CImg<T>::draw_line()' so that it now uses a classical Bresenham algorithm, avoiding rounding errors.
    - Renamed 'CImg<T>::draw_axe' as 'CImg<T>::draw_axis'.

* Bug corrections :
    - Corrected some functions that did not performed correctly on shared images.
    - Corrected small bug in 'plugins/primitives3d.h' in function 'CImg<T>::sphere()'.
    - Corrected 'CImg<T>::feature_selection()' when displaying 'CImg<bool>' images.
    - Corrected 'CImg<T>::load_cimg()' : is now able to load bool images.
    - And lot of minor bug corrections and optimizations .....

*-----------------------------
*-----------------------------
* Changes from 1.1.5 to 1.1.6
*-----------------------------
*-----------------------------

* New features :
    - Added DTMRI volumetric file viewer, in 'examples/dtmri_view.cpp'.
    - Added 3D sprite display support in 'CImg<T>::draw_object3d()'.

* Optimizations / Modifications :
    - Rewritten a lot of constructor/assignments functions for CImg<T> and CImgl<T>.
     Removed shared capabilities of CImgl<T>, but improved these ones for CImg<T>.

* Bug corrections :
    - And lot of minor bug corrections and optimizations .....

*-----------------------------
*-----------------------------
* Changes from 1.1.4 to 1.1.5
*-----------------------------
*-----------------------------

* New features :
    - Added plugin 'CImg/primitives3d.h', adding functions that can generate
      basic 3D triangulated primitives.
    - Added Poisson noise capability in CImg<T>::noise() (This patch has been proposed by Jerome Boulanger)
    - Added wheel mouse support in 'CImgDisplay', now used in 'CImg<>::feature_selection()' to go through slices of
      3D volumes (unfortunately for X11 systems only).
    - Added function 'CImgDisplay::toggle_fullscreen()' to allow easy and dynamic fullscreen switching of a display.
    - Added screen resolution switching capabilities when using the Xrandr extension, under X11 (#define cimg_use_xrandr).
    - Added support for ImageMagick++ built-in library (parts of the patch proposed by Christoph Hormann).
    - And lot of small functions to ease the life...

* Optimizations / Modifications :
    - CeCiLL-C license now applies for the file 'CImg.h'. This license (close to the LGPL one) is more adapted
      for library components as CImg. The examples stay in previous CeCiLL license (close to the GPL one).
    - Recoded 'CImg<T>::draw_axe?()' (where ? can be 'X','Y' or 'XY') so that it can now be used to draw non-linear values along axes
      (for instance logarithmic-varying labels).
    - Attribute 'force' have been removed in 'CImgDisplay::resize()'.
    - Recoded most constructors and assign functions in CImg<T> and CImgl<T>.
    - Recoded most of the CImgDisplay class to allow more flexibility and refreshing speed.
    - Renamed 'CImgDisplay::title()' to 'CImgDisplay::set_title()'. 'CImgDisplay::title' is now a class variable
      that stores the current title of the display window.
    - 'CImgDisplay::closed', 'CImgDisplay::resized', 'CImgDisplay::fullscreen' and 'CImgDisplay::moved' have been
      renamed to 'CImgDisplay::is_closed', 'CImgDisplay::is_resized', 'CImgDisplay::is_fullscreen' and
      'CImgDisplay::is_moved', for more coherent variable names.
    - 'CImg<T>::display_object3d()' : can now specify an input pose matrix, as well as get the output pose matrix,
      after the user rotated the object. Also, this function has been optimized.

* Bug corrections :
    - Corrected sorting bug in 'CImg<T>::symmetric_eigen()' and 'CImg<T>::SVD()'
    - When using shared memory images, some 'CImg<T>::get_*()' methods returned a shared memory image too.
    - And lot of minor bug corrections and optimizations .....

*-----------------------------
*-----------------------------
* Changes from 1.1.3 to 1.1.4
*-----------------------------
*-----------------------------

* New features :
    - Added fullscreen mode support on X11-based systems.
    - Added CImg<>::save_dicom(), allowing to save DICOM files, via XMedcon.
    - Added phong-like rendering capabilities in 'CImg<T>::draw_triangle()' and 'CImg<T>::draw_object3d()'.
    - Added a directory 'plugins/' that contains some useful CImg plugins, developed by third parties.
    - Added bicubic interpolation option in functions 'CImg<T>::get_rotate()'
    - Added new example 'Fireworks' in 'examples/CImg_demo.cpp'.
    - Added new fonts with increasing sizes that can be used in 'CImg<T>::draw_text()'.
      Also simplified function 'CImg<T>::get_font()', and added size parameter in 'CImg<T>::draw_text()'.

* Optimizations / Modifications :
    - Optimized 'CImg<T>::get_resize()'.
    - Allows the use of the MIT-XSHM extension for X11-based display, allowing to speed up CImgDisplay rendering
    (roughly a factor of 3 when using this extension).
    - Optimized CImgDisplay::render() for X11-based systems. Image display is now faster (roughly a factor of 2.5).
    - Modified CImg<>::display_object3d() : keyboard is now not handled, added translation using 3rd mouse button.
      Added small axes at the bottom left to see object orientation.
    - Removed some unuseful 'const' keywords in some function return values, removing warnings
      when compiling with icc or icl.
    - Renamed 'CImg<T>::RGBtoYCbCr8()' to 'CImg<T>::RGBtoYCbCr()' (and derived functions).
    - Gathered 'CImg<T>::dirichlet_pix?d()' and 'CImg<T>::neumann_pix?d()' in a single function 'CImg<T>::pix?d()'.
    - Renamed 'CImg_test.cpp' to 'CImg_demo.cpp'

* Bug corrections :
    - Corrected bug with X11 displays : sometimes, black images were displayed, needing an explicit refresh.
    - Corrected bug with X11 displays related to ClientMessage. Windows are not closed when other applications are opened.
    - Corrected 'CImgl<T>::remove()' : Wrong memory deallocation could happen sometimes.
    - And lot of minor bug corrections and optimizations .....

*-----------------------------
*-----------------------------
* Changes from 1.1.2 to 1.1.3
*-----------------------------
*-----------------------------

* New features :
    - Added a new example source file 'examples/image_surface.cpp', that renders an image as a surface in a 3D space.
    - Added a new example source file 'examples/mcf_levelsets3D.cpp', that performs Mean Curvature Flow of a 2D surface, using level sets.
    - Added a version of 'CImg<T>::draw_triangle()' that can draw Gouraud-shaded triangles (flat and textured versions).
    - Added 'CImg<T>::get_rotation_matrix()' that returns a 3x3 rotation matrix from a quaternion or a rotation vector.
    - Added 'CImg<T>::draw_object3d()' that can draw a colored/textured 3d object on images.
    - Added 'CImgDisplay::display_object3d()' and 'CImg<T>::display_object3d()' which run a high-level interface that
      can view a user-defined 3d object.
    - Added two 3D rendering examples in 'examples/CImg_test.cpp', that shows how to use 3D rendering capabilities of CImg in few lines.
    - Added 'CImg<T>::marching_cubes()' and 'CImg<T>::marching_squares' that can be used to triangularize an implicit 2D or 3D
      curve or surface from an image or a function.
    - Added 'CImg<T>::get_load_off()' and 'CImg<T>::save_off()' that manages OFF files
      (files describing 3D object, GeomView format, see 'http://www.geomview.org/').

* Optimizations / Modifications :
    - Removed the 'multiplexed' variable in one of the CImg constructor. This feature as not generic enough to be integrated
      in a constructor, and is so simple to code (one line).. This has been replaced by the new 'shared' capabilities of CImg.
    - Added a 'shared' variable in CImg<T> and CImgl<T>. This allows to completely remove CImgSubset<T> and CImglSubset<T>, and
      allows more flexibility for using shared memory. A lot of functions relative to shared-memory images have been added also.
      Please look closely to the online reference.
    - Added a fast approximation method in 'examples/greycstoration.cpp' (set by default) allowing to speed up the
      restoration process almost by a factor x3.
    - Recoded 'CImg<T>::get_dilate()' and 'CImg<T>::get_erode()' : it is now possible to specify a structuring element.
    - Due to high difficulty in maintaing all project files in the 'compilation/' directory, I removed most of them except one
      template file for each different C++ IDE. Just replace the default source file 'CImg_test.cpp' in the project file by the one
      you want, to compile you desired example.
    - Renamed 'CImg<T>::get_2dprojections()' to 'CImg<T>::get_projections2d()'.
    - Removed 'examples/render3d.cpp'. As CImg has now built-in functions for 3D rendering, this example was obsolete.
      Look at the new example appearing in 'examples/CImg_test.cpp' to see how to do easy 3D rendering with CImg.

* Bug corrections :
    - Corrected 'CImg<T>::cubic_pix1d()' and 'CImg<T>::cubic_pix2d()', used for cubic and bicubic interpolations.
    - Corrected 'cimg_map2x2()' and 'cimg_map4x4()' to avoid warning when compiling with g++.
    - Added a simple trick to ease the use of libjpeg and libpng on Windows (thanks to bugzhao).
    - Corrected 'CImg<T>::load_jpeg()' and 'CImg<T>::save_jpeg()' to handle all possible color spaces used in JPEG files.
    - Corrected 'CImg<T>::get_split()' to avoid bug with very large images.
    - Corrected 'CImg<T>::load_dicom()' and 'cimg::medcon_path()' to ease the loading of medcon files on Windows.
    - And lot of minor bug corrections....

*-----------------------------
*-----------------------------
* Changes from 1.1.1 to 1.1.2
*-----------------------------
*-----------------------------

* Bug corrections :
    - Bug corrected in 'CImg<T>::load_ppm()' and 'CImg<T>::save_ppm()' : 16 bits PPM images were not correctly stored.
    - (Stupid) bug corrected in 'CImg<T>::get_sort()' : Return value was a reference to a temporary object.
    - Bug corrected in 'CImg<T>::resize_halfXY()' that caused a possible segmentation fault.
    - Bug corrected in 'CImg<T>::move()' : Moving an hidden window (on X11) is now working.
    - Handling pixel access to const images : writing pixel values in const images is now forbidden.
    - 'CImg<T>::det()' : Determinant of general matrices can now be computed.
    - 'CImgDisplay' : Added some changes in Microsoft-specific function call to be able to compile with Visual Studio 2005. This compiler seems to be 'buggy', I had very strange behaviors at run-time with it (changing an 'int' to 'const int' declaration solves a 'problem' in CImg<>::draw_ellipse() that was present only with this compiler...)
    - 'CImg<>::load_dlm()' : small bug corrected. Can now read DLM files with no CR at the last line.
    - And other small corrections....

* Optimizations / Modifications :
    - In 'CImg<T>::save_convert()', the temporary file is now saved in PNM format, instead of RGBA as before. This has been done
      because of a strange bug in ImageMagick's convert, refusing to read some RGBA files.
    - CImgDisplay::move() now shows automatically the display when it is in a closed state.
    - Moved the trait cimg_library::largest<T,t> in cimg_library::cimg::largest<T,t>.
    - Renamed 'CImg<T>::quicksort()' to 'CImg<T>::sort()'.
    - Renamed 'CImg<T>::create()' and 'CImg<T>::copy()' to 'CImg<T>::assign()'.
    - 'CImg<T>::inverse()' can now uses the LU matrix decomposition (or the SVD one as before).
    - Optimized memory handling when playing with lists of images CImgl<>.
    - Optimized some CImg<T> constructors.

* New features :
    - Added a new demo : 'Blobs Editor' in CImg_test.cpp.
    - Added types 'CImg<T>::iterator', 'CImg<T>::const_iterator', 'CImgl<T>::iterator' and 'CImgl<T>::const_iterator' to allow
      the easy use of STL algorithms on CImg and CImgl structures.
    - Added several functions that acts like in STL vectors and lists in CImg<T> and CImgl<T> :
      CImg<T>::assign(), CImg<T>::clear(), CImg<T>::at(), CImg<T>::back(), CImg<T>::front(), CImg<T>::begin(), CImg<T>::end(),
      CImgl<T>::assign(), CImgl<T>::clear(), CImgl<T>::at(), CImgl<T>::back(), CImgl<T>::front(),
      CImgl<T>::begin(), CImgl<T>::end(), CImgl<T>::push_back(), CImgl<T>::push_front(), CImgl<T>::pop_back(), CImgl<T>::pop_front().
    - Added 'CImg<T>::MSE()' and 'CImg<T>::PSNR()' that compute the MSE (Mean Squared Error) and PSNR
      (Peak Signal to Noise Ratio) between two images.
    - Added 'CImg<T>::solve()' and 'CImg<T>::get_solve()', allowing to solve linear systems.
    - Added 'CImg<T>::pseudoinverse()' and 'CImg<T>::get_pseudoinverse()' allowing to compute the Moore-Penrose
      matrix inverse (useful for computing solutions to the least-square problem).

*-----------------------------
*-----------------------------
* Changes from 1.1.0 to 1.1.1
*-----------------------------
*-----------------------------

* Bug corrections :
    - in 'CImgl<T>::insert()' : Insertion at non-last position was bugged.
    - in 'greycstoration.cpp' : Corrected some bugs in the algorithm and improved user interface.
    - in 'CImg<T>::blur_anisotropic()' : Abusive vector normalization was done before. Now it is corrected.
    - And many other bugs...

* Optimizations / Modifications :
    - Removed macros 'cimg_test*()' and modified argument checking in most of the functions, so that trying to act
    on an empty image does nothing instead of an error.
    - Renamed all static methods CImg<T>::load*() into CImg<T>::get_load*(). This has been done to be coherent with
    the naming convention of other CImg methods. Also, added new functions CImg<T>::load*() (non static) that corresponds
    to in-place image loading.
    - Renamed CImg RAW extension from .raw to .cimg. .raw files are not considered as real raw data without
    header. New functions 'CImg<T>::load_get_raw()' and 'CImg<T>::save_raw()' have been added to load and save .raw files.
    - In 'greycstoration.cpp' : improved algorithm and parameters. Also add improved visualization tool at the end
      of the image regularization.
    - Replaced some cimg:: static functions to inlined one, to prevent compiler bug on VS7.1, when trying
      to link multiple CImg-based modules.
    - Replaced parameter 'linear' to 'scheme' in 'CImg<T>::blur_anisotropic()', allowing the use of 2nd order
      Runge-Kutta integration, instead of just nearest-neighbor or linear ones.

* New features :
    - Introduced a trait 'cimg::largest' that allows to find the largest data type between two types. CImg functions
    use it for instance to return a CImg<float>, when trying to compute the gradient of an CImg<unsigned char>.
    It was not the case before, needing an explicit case, as in 'CImg<float>(img).get_gradientXY()'.
    - Added 'CImg<T>::operator<<', 'CImgl<T>::operator<<' and 'CImgl<T>::operator>>' that allows to
    insert images in list or append an image to another one.
    - New project file for using with X-Code (on Mac OS X) has been added to the 'compilation/' directory.
     Thanks to Werner Jainek who made it possible.

*-----------------------------
*-----------------------------
* Changes from 1.0.9 to 1.1.0
*-----------------------------
*-----------------------------

* Bug corrections :
    - in 'CImg<T>::load_raw()' : possible buffer overflow corrected.
    - in 'CImg<T>::load_dlm()' : the use of std::rewind() didn't work when reading the standart input. Function has been
      recoded so it reads the file in one pass.
    - Corrected 'CImg<T>::anisotropic_blur()'.
    - Corrected 'CImg<T>::symeigen()' : corrected computation bugs.
    - Corrected 'CImg<T>::get_resize()' : linear and bicubic interpolations were not correctly handled (minor).
    - Corrected 'CImgDisplay' to avoid malloc/dealloc problem with newer versions of X11.
    - Corrected 'CImgDisplay' to handle better thread termination under X11 (Unix and MacOSX).
    - Corrected 'greycstoration.cpp' (small bug in inpainting and non-curvature scheme).

* Optimizations / Modifications :
    - Updated documentation.
    - Modified Makefile for direct compilation of executables under Linux (ex : make CImg_test).
    - Modified Exceptions error messages for more simplicity and clarity.
    - Removed parameter 'alpha' in 'CImg<T>::get_gradientXY()' and 'CImg<T>::get_gradientXYZ()'.
    - Renamed 'CImg<T>::flip()' to 'CImg<T>::mirror()'.
    - Renamed 'CImg<T>::get_3dplanes()' to 'CImg<T>::get_2dprojections()'.
    - Renamed 'CImgROI<T>' to 'CImgSubset<T>'. Also removed functions 'CImg<T>::ref_*' and replaced it by
    'CImg<T>::pointset()', 'CImg<T>::lineset', 'CImg<T>::planeset' and 'CImg<T>::channelset'.

* New features :
    - Added 'CImg<T>::RGBtoLUT()' and 'CImg<T>::LUTtoRGB()' that convert an RGB image to an indexed image (using a palette).
    - Added 8 bits display mode support in CImgDisplay.
    - Added 'CImg<T>::RGBtoHSV()' and 'CImg<T>::HSVtoRGB()' that handle the conversion from and to HSV color space.
    - Added 'CImg<T>::kth_smallest()' and 'CImg<T>::median()' that find respectively the kth smallest
      element and the median of values in a CImg<T> instance.
    - Added 'CImg<T>::blur_median()' and 'CImg<T>::get_blur_median()' that apply a median filter on an image.
    - Added 'CImg<T>::load_parrec()' able to read PAR-REC (Philips) image file formats.
    - Added 'CImgDisplay::title()' that can be used to change the display window title.
    - Added 'CImg<T>::RGBtoYUV()' and 'CImg<T>::YUVtoRGB()' that convert between RGB and YUV color spaces.
    - Added 'CImg<T>::RGBtoYCbCr8()' and 'CImg<T>::YCbCr8toRGB()' that convert between RGB and YCbCr color spaces (for unsigned char
    pixels).
    - Added 'CImg<T>::has_same*()' where * can be 'X','Y','Z','XY','XYZ','XYZV' to compare image dimensions.
    - Added 'CImg<T>::is_empty()' that returns 'true' is the image is empty.
    - Added 'CImg<T>::load_dicom()' that loads an image in Dicom file format. This function uses the tool 'medcon' that
    has to be installed (http://xmedcon.sourceforge.net/).
    - Added 'CImg<T>::load_yuv()', 'CImgl<T>::load_yuv()' and 'CImg<T>::save_yuv()', 'CImgk<T>::save_yuv()'
     that load and save respectively one frame or the entire movie from a .yuv file.
    - Added 'CImglSubset<T>' which is a class that sub-references an image list 'CImgl<T>'.

*-----------------------------
*-----------------------------
* Changes from 1.0.8 to 1.0.9
*-----------------------------
*-----------------------------

* Bug corrections :
    - Memory leak corrected in 'CImg<T>::load_bmp()'.
    - CImg now supports the MIPS compiler on SGI (Thanks to Matt Hanson who made it possible).
    - Corrected non-global X11 variables in multi-module projects using CImg.h (thanks also to Matt Hanson for
    his precise bug report).
    - In CImg<T>::load_convert() and save_convert(), random filenames are now tested before read/write.
    - Removed unuseful template in 1D CImg<T>::draw_gaussian() function.
    - Recoded CImgDisplay::render() with XPutPixel() again for maximum compability between X11-based architectures.
    - In CImgStats, the variance field was computed actually as the standart deviation. This is now corrected, and the variance
    is really the variance !

* Optimizations / Modifications :
    - CImgDisplay fields mousex and mousey changed to fields mouse_x and mouse_y. This is done to be more coherent
    with other CImgDisplay fields. The inconvenience should be minor, just replace the fields by the right names.
    - CImgDisplay functions window_posx() and window_posy() changed to fields window_x and window_y.
    - Eigenvalue computation with CImg<T>::eigen() and symeigen() sorts the eigenvalues in inverse order from now on.
    The eigenvector matrix is also transposed, to be more close to the standart functions in eigenvalue computation.
    - Renamed macro variable 'cimg_lapack' in 'cimg_use_lapack'.
    - CImg<T>::save() can now handle alpha channel in PNG images (with 4-channels images).
    - Recoded CImg<T>::noise() to handle numerical limits in template types (esp. for unsigned char and char).
    - Recoded CImg<T>::pow() to be faster with usual int powers (0,1,2,3,4).
    - Added conversions functions for all color spaces (R,G,B), (X,Y,Z), (x,y,Y) and (L,a,b).
    - Added a 'pattern' parameter in 'CImg<T>::draw_ellipse()' and 'CImg<T>::draw_circle()', so that
    only the outline of the ellipse/circle can be drawn.
    - Added an ellipse-based selection in CImg<T>::feature_selection(), when parameter 'feature_type' is set to 3.

* New features/functions :
    - Added an 'Image Zoomer' demo in 'CImg_test.cpp'.
    - Added 'CImg<T>::load_jpeg()' and 'CImg<T>::save_jpeg()' to deal natively with JPEG files, through
      the libjpeg library. You don't need ImageMagick's convert anymore to read and save JPEG files.
      Just define the macro 'cimg_use_jpeg before including 'CImg.h', and link your code with the 'jpeg' lib,
       and it should work fine.
    - Added 'CImg<T>::quicksort()' allowing to sort values inside vectors, and getting corresponding permutations.
    - CImgDisplay::move() is now working well on Windows and Unix.
    - Added 'CImg<T>::SVD()' to compute the SVD of general matrices. The inverse function as well
    as the eigenvalue computation (of symmetric matrices) now uses the SVD. It means that LAPACK is
    not necessary anymore in CImg !
    - Added 'CImgDisplay::screen_dimx()' and 'CImgDisplay::screen_dimy()' to get the resolution of the
    current (full) screen.
    - Added a new 10x13 font, and recoded the functions 'CImgl<T>::get_font();'
    - Added 'cimg::dialog()' that allows to open a simple dialog box with a maximum of 6 choices.
    - Added CImgROI<T>::operator=(), so that one can now affect a channel or plane to an image :
    img.ref_plane(2) = img_plane; Very useful !
    - Added CImg<T>::load_png() and save_png() to deal natively with PNG files, through
     the zlib and libpng libraries. You don't need ImageMagick's convert anymore
      to read and save PNG files. Just define the macro 'cimg_use_png' before including
      'CImg.h', and link your code with the 'zlib' and the 'png' lib, and it should work fine.
       Many thanks to Eric Fausett, for this nice piece of code.
    - Added CImg<T>::load_rgb(), load_rgba(), save_rgb() and save_rgba() that can load and save
      Raw color image data (w/ or wo/ alpha channel).
    - Added CImg<T>::blur_anisotropic() that allows to denoise image by anisotropic filtering.
      Smoothing behavior can be even user-defined.
       Look at  " http://www.greyc.ensicaen.fr/~dtschump/greycstoration/ "
      to learn more about the image regularization technique implemented by this function.

   - ... an tons of minor corrections !

*-----------------------------
*-----------------------------
* Changes from 1.0.7 to 1.0.8
*-----------------------------
*-----------------------------

 * Bug corrections :
    - Removed useless button/keyboard reinitialization in CImgDisplay events
    - Corrected bug in CImg<T>::load_dlm() and load_ascii() functions.
    - Corrected compile bug in CImg<T>::resize_halfXY() and CImg<T>::get_resize_halfXY().
    - Corrected and optimized CImg<T>::get_resize().

 * Optimizations / Modifications :
    - Recoded CImg<T>::fill() for faster value filling.
    - Recoded CImg<T>::draw_graph(). IMPORTANT NOTE : ymin and ymax are now directed up to down, instead
      of down to up, in order to be more coherent with the draw_axeXY() function. This means you will
      probably have to swap the values of these two parameters in the function call, to get similar results
      to CImg 1.0.7 !!
    - Recoded CImg<T>::draw_gaussian() using tensors (parameters changed).
    - CImg is now successfully compiled using the option '-pedantic' with g++. Makefile has been modified.
    - CImg compiles with the DJGPP compiler (tested without display capabilities).
    - Added load/save support for 16bits PNM binary images.
    - Added interleaved mode support and template in constructor :
      template<typename t> CImg(const t *const data_buffer,dx,dy,dz,dv,bool interlaced)
    - Recoded parts of CImg<T>::eigen().
    - Optimized buffer copy in XImage, for faster image display under X11 (minor improvements).
    - Added fields in CImgStats, allowing to get the coordinates of the min/max pixels.

 * New features/functions :
    - Added CImg<T>::load_bmp() and save_bmp() to deal with uncompressed BMP formats, without using ImageMagick.
    - Added CImg<T>::vector(), CImg<T>::matrix() and CImg<T>::tensor().
    - Added CImg<T>::scroll() and CImg<T>::get_scroll to be able to scroll images.
    - Added functions CImg<T>::get_FFT() and CImgl<T>::FFT() for Fast Fourier Transform.
    - Added CImgDisplay::move() to be able to move display windows at specific locations.
    - Added several region split in CImg<T>::get_split().
    - Added 'examples/mcf_levelsets.cpp' : Mean curvature flow of a 2D curve, using level sets.
    - Added 'examples/greycstoration.cpp' : New algorithm for image denoising, inpainting and resizing.
      (see http://www.greyc.ensicaen.fr/~dtschump/greycstoration)
    - Added 'examples/wavelet_atrous.cpp' (by R. Peteri) : Wavelet decomposition of a image.
    - Added a Fourier-based filtering demo in 'CImg_test.cpp', allowing interactive frequency filter creation.
    - Added an Image to ASCII converter, based on simple correlation measure. File : 'examples/image2ascii.cpp'.

 * Abandonned features :
    - Removed bump mapped version of the CImg<T>::draw_triangle() function.
    - Removed 'examples/inpainter.cpp' which is a little bit buggy (problem with multiscale).
    - Removed 'CImg<T>::new_display()' and 'CImgl<T>::new_display', which are confusing and useless. Use
      'new CImgDisplay(img)' and 'new CImgDisplay(list)' instead.
    - Removed 'CImg<T>::get_stats()' and 'CImgl<T>::get_stats', which are useless. Use 'CImgStats(img)'
      and 'CImgStats(list)'.

*-----------------------------
*-----------------------------
* Changes from 1.0.6 to 1.0.7
*-----------------------------
*-----------------------------

 - New License : CImg is now distributed under the CeCiLL License, a free software GPL-like, more adapted
   to French laws. Don't be disturbed by this new License, CImg is still an open source free software !
 - Encapsulation of all CImg classes and functions in the 'cimg_library::' namespace. It avoids eventual
   class names collisions with other libraries. For compatility with your old code, you should
   insert 'using namespace cimg_library;', just after the '#include "CImg.h"' line, in your source code.
 - Removed global typedefs for uchar,uint,ushort,ulong. If you used them before, you'll have to redefine them :
   typedef unsigned char uchar;
   typedef unsigned short ushort;
   typedef unsigned int uint;
   typedef unsigned long ulong;
 - Corrected window resize bug on X11 displays.
 - Added PANDORE-4 file format support, with functions 'CImg::load_pandore()' and 'CImg::save_pandore()' (file extension : .pan)
   (PANDORE is a C++ toolkit for image processing, see http://www.greyc.ensicaen.fr/~regis/Pandore (in French))
 - Added macros CImg_3x3_ref(), CImg_5x5_ref(), .. allowing to use special loops cimg_map3x3,.. with references to C arrays and images.
 - Removed 'normalize' parameter in 'CImg::save()'. Saving normalized images can be still performed
   with 'img.normalize(0,255).save("normalized_image.jpg");'. This clarifies the code and doesn't add so much work at all.
 - Renamed 'CImg::get_sprite()' and 'CImg::sprite()' to 'CImg::get_crop()' and 'CImg::crop()'.
 - Changed 'draw_triangle' function with two textures, so that it corresponds to displacement mapping
   (aka 'bump mapping'), instead of two textures drawn with transparencies
   (which can be still made by two successive calls to single-textured 'draw_triangle' functions,
   with correct opacities).
 - Negative opacity parameter in drawing functions is now supported. It allows to ADD shapes colors to the current
   image pixels (see the new 'ShadeBobs demo in the CImg_test.cpp file to see the concept).
 - Added functions 'CImg::draw_axeX', 'CImg::draw_axeY' and 'CImg::draw_axeXY', allowing to trace labelled axes on images.
 - Slightly changes in CImgDisplay : field 'attributes' has been removed, and replaced by more
   comprehensive field names : events, normalize, fullscreen. Resizing capabilities is now removed
   since all windows can be resized by default.
 - 'CImg<>::load_convert()' and 'CImg<>::save_convert()' do not popup a console window anymore on Windows-based OS,
   when creating code with a WinMain() entry.
 - RGB<->BGR Color inversion problem on some old Unix displays has been corrected.
 - Makefile for compilation on Solaris has been updated.
 - Package structure has been slightly modified for more clarity. Renamed also the CVS module to 'CImg' instead of 'CImg_'
 - Added different compilers projects to ease the compilation of the CImg examples, including
   Visual C++ 6.0, Visual.NET2003, Borland Bcc 5.6, Digital Mars Compiler, Dev-Cpp, Intel ICL.
 - Removed the use of TrackMouseEvent mechanism on Windows, removing compilation bugs with VC++6.0 when trying to create an MDI application.
 - Improved keycode detection under X11. Keycodes should now work for any X11-based system.
 - Support for FreeBSD added (thanks to Thierry Thomas).
 - Corrected bug in matrix multiplication.
 - Corrected bugs in CImg<T>::erode() and CImg<T>::dilate() functions (name inversion).
 - Corrected bug in 'CImg<T>::load_convert()' and 'CImg<T>::save_convert()' when trying to load/save images with pathnames containing spaces.
 - Recoded 'inrcast.cpp', and suppressed 'inrcrop.cpp' in the 'examples/' directory (functionnalities of 'inrcrop' are now included in 'inrcast').
 - And some corrections of minor bugs to improve library stability...
 - Improved error messages to ease program debug.
 - Documentation of the API is much more complete and detailled (still in progress...)

*------------------------------
*------------------------------
* Changes from 1.0.5 to 1.0.6 :
*------------------------------
*------------------------------

 - Drawing functions improved and optimized : Added transparency level to all drawing functions.
 - Added function 'draw_arrow()'
 - Added missing boolean operators.
 - Added CImgDisplay resize event, allowing to create flexible resizing windows.
 - Added 'CImg::draw_gaussian()' functions allowing to draw 1d,2d or 3d gaussians on images.
 - Added 'Oriented convolutions' demos in CImg_test.cpp
 - Recoded pde_TschumperleDeriche2D and 3D.
 - Bugs corrected in arithmetics operators.
 - Optimized image display.
 - Recoded 'CImg::feature_selection()'.
 - Recoded 'CImg::get_rotate()'
 - Renamed 'draw_plot()' to 'draw_graph()', and added cubic drawing style.
 - Renamed 'wait_sync()' to 'wait()'.
 - Renamed 'get_correl' to 'get_correlate' (idem for 'convolve')
 - Removed 'get_correl3x3,5x5,...'. Optimization is now a part of the 'get_correlate' function. (idem for 'convolve').
 - Removed 'get_rotate90,180,270'. Optimization is now a part of the 'get_rotate' function.
 - Compilation supported by gcc.3.4.1 (released july 2004).
