= Extensions & Patches for GIL =
<!> Warning -- This code is being ripped from a larger research project. Suggestions on how to improve the quality of the code and documentation are welcome. <!>

== Overview ==
This project is based on the [http://opensource.adobe.com/wiki/display/gil/Generic+Image+Library Generic Image Library (GIL)] from boost/Adobe.

The GIL provides a generic representation of images so that code can be written to process an image regardless of the pixel format, and whether the image is planar or interleaved.  The GIL provides a great starting point for programmers interested in generic image processing.  This site is my personal extensions to GIL that adds support for some of the features I find useful.

In particular, I am working on:

 * GilPatch ([attachment:gil.patch]) -- A patch file against the boost HEAD revision of GIL so that I can have a raster of any type, not just GIL pixels. For instance, an image of integers would be: gil::image<int>::view_t [[BR]]<!>''That was supposed to be true already, but I found some issues with this in their last release.'' [[BR]]<!>''The patch file has a lot of diffs caused by white space changes introduced by my editor. I will remove these when I get a chance. ''
 * [wiki:TransformView transform_view]-- A function, which is similar to the 'add_deref' function GIL already provides, except that I use boost tools and some assumptions to infer the extra types required by the 'add_deref' function.
 * [wiki:MakePixelbased make_pixelbased]-- A function, to turn an image that is not !PixelBased into a grayscale image (a.k.a. make_grayscale).
 * [wiki:RemovePixelbased remove_pixelbased] -- A  function, to turn a grayscale image that is !PixelBased into a non-!PixelBased image.
 * [wiki:MakePaletteView make_palette_view] -- A function, which uses any iterator as a palette.

== License ==
This project is under the boost license (http://www.boost.org/LICENSE_1_0.txt). However, I have not *yet* added the proper disclaimer to all files.

== Header Install ==
This project is header only -- you don't need to build anything unless you want to run the tests. If you just want the headers, use

{{{
  svn co http://bugx.i3dea.asu.edu/svn/gilx/gilx/trunk/include 
}}}
and then apply [attachment:gil.patch] to the HEAD revision of Boost.Gil.

== Test Install ==
=== Windows ===
This project uses SCons for build-scripting, so you need to install Python to build it.  I use some of my own python scripts (http://bugx.i3dea.asu.edu/projects/build ) to  automate some tasks.

 1. Install python from http://www.python.org
 1. Install the MinGW tools (compiler, make, debugger, etc.)
 1. Install boost from [http://www.boost.org http://www.boost.org.]  You will want the HEAD revision of GIL. You may need to rename the '.lib' files to '.a' files so that mingw can find them properly.
 1. Apply [attachment:gil.patch] against the boost HEAD revision of GIL.
 1. Install the jpeg, tiff, png, and zlib libraries.
 1. Use subversion to checkout the sources from http://bugx.i3dea.asu.edu/svn/gilx/trunk
 1. Run
{{{
         build.bat test
}}}
   To compile and run the test cases.

=== Linux ===
<!> These steps are not tested. Please let me know if they don't work. <!>[[BR]]
 1. Install python from http://www.python.org
 1. Install the GNU GCC tools (compiler, make, debugger, etc.)
 1. Install boost from [http://www.boost.org http://www.boost.org.] You will want the HEAD revision of GIL. 
 1. Apply [attachment:gil.patch] against the boost HEAD revision of GIL.
 1. Install the jpeg, tiff, png, and zlib libraries.
 1. Use subversion to checkout the sources from http://bugx.i3dea.asu.edu/svn/gilx/trunk
 1. Run
{{{
         python ./scons/scons.py test
}}}
   To compile and run the test cases.

[[BR]]
----
For a complete list of local wiki pages, see TitleIndex.