===============================================
PIL(Pillow) build on Windows (32bit)
===============================================

If you want to build PIL on Windows, you need to prepare few external libraries. Although some libraries did not provide static library for windows 32/64 bits then you need to build these libraries by your hand too. Also, PIL will load by python at last then you are recommended to use same compiler with python to build libraries.

Target PIL and versions
=================================

:PIL: 1.1.7 for Python 2.4 (or Pillow-1.7.8)
:PIL: 1.1.7 for Python 2.5 (or Pillow-1.7.8)
:PIL: 1.1.7 for Python 2.6 (or Pillow-1.7.8)
:PIL: 1.1.7 for Python 2.7 (or Pillow-1.7.8)

Required compilers
====================

:Python-2.4(32bit): VisualStudio 7.1 (1310) (or VisualStudio 2003 Toolkit + Windows SDK)
:Python-2.5(32bit): VisualStudio 7.1 (1310) (or VisualStudio 2003 Toolkit + Windows SDK) 
:Python-2.6(32bit): VisualStudio 2008 (1500) (or VisualC++ 2008 Express)
:Python-2.7(32bit): VisualStudio 2008 (1500) (or VisualC++ 2008 Express)

You can choise production version or free version of VisualStudio.

Required libraries and versions
====================================

:freetype2: 2.4.6 `src (for VC7, VC2008) <http://sourceforge.net/projects/freetype/files/freetype2/2.4.6/ft246.zip>`_
:jpeg6b: 6b 27-Mar-1998 `lib (for VC7) <http://www.hdfgroup.org/ftp/lib-external/jpeg/bin/windows/jpeg6-vnet.zip>`_, `lib (for VC2008) <http://www.hdfgroup.org/ftp/lib-external/jpeg/bin/windows/jpeg6b-vs2008.zip>`_
:LittleCMS: 1.19 `src <https://sourceforge.net/projects/lcms/files/lcms/1.19/lcms-1.19.tar.gz/download>`_
:tcl: 8.5.10 `src <http://en.sourceforge.jp/projects/sfnet_tcl/downloads/Tcl/8.5.10/tcl8.5.10-src.tar.gz/>`_
:tk: 8.5.10 `src <http://en.sourceforge.jp/projects/sfnet_tcl/downloads/Tcl/8.5.10/tk8.5.10-src.tar.gz/>`_
:zlib: 1.2.4 `src <http://en.sourceforge.jp/projects/sfnet_libpng/downloads/zlib/1.2.4/zlib124.zip/>`_


Build process for Python-2.7
============================

build freetype
------------------
1. extract ft246.zip into ``C:\lib\freetype-2.4.6``
2. open ``builds\win32\vc2008\freetype.sln`` by VC2008
3. do build with ``LIB Release`` + ``Win32``
4. done! You got ``objs\win32\vc2008\freetype246.lib``.
5. rename ``freetype246.lib`` to ``freetype.lib``

Note: You can use freetype246.lib file for VC2008 and VC7.


build jpeg6b
-------------------
1. You can get built-static-lib from jpeg6b-vs2008.zip (for VS2008).
2. extract lib and headers as bellow::

    C:\Lib\jpeg6-vs2008
       +-- lib\libjpeg.lib
       +-- include\*.h


build LittleCMS
-------------------
1. extract ``lcmls-1.19.tar.gz`` into ``C:\lib\lcms-1.19``
2. open ``Projects\VC2008\lcms.sln`` by VC2008
3. do build with ``LIB Release`` + ``Win32``
4. done! You got ``Lib\MS\lcms.lib``.

.. note:: You need to choice 1.x series of Little CMS for PIL.

.. todo:: validate this section.

build tcl/tk
----------------
1. extract tcl8.5.10-src.tar.gz and tk8.5.10-src.tar.gz
2. oepn ``Visual Studio 2008 Command prompt`` from start menu.
3. cd ``C:\lib\tcl8.5.10\win``
4. nmake -f makefile.vc
5. cd ``C:\lib\tk8.5.10\win``
6. set ``TCLDIR=C:\lib\tcl8.5.10``
7. nmake -f makefile.vc
8. done! you got ``C:\lib\tcl8.5.10\win\Release_VC9\tcl85.lib`` and ``C:\lib\tk8.5.10\win\Release_VC9\tk850.lib``


build zlib
--------------
1. extract ``zlib124.zip`` into ``C:\lib\zlib-1.2.4``
2. open ``projects\visualc6\zlib.vcproj`` by VC2008
3. do build
4. done! You got ``projects\visualc6\zlib.vcproj\Win32_LIB_Release``.

.. todo:: validate this section.



build PIL
-------------
1. extract PIL source
2. write setup.cfg::

    [build_ext]
    library_dirs = C:\lib\freetype-2.4.6\lib;C:\lib\jpeg6b-vs2008\lib;C:\lib\lcms-1.19\Lib\MS;C:\lib\tcl8.5.10\win\Release_VC9;C:\lib\tk8.5.10\win\Release_VC9;C:\lib\zlib-1.2.4\projects\visualc6\zlib.vcproj\Win32_LIB_Release;
    include_dirs = C:\lib\freetype-2.4.6\include;C:\lib\jpeg6b-vs2008\include;C:\lib\lcms-1.19\include;C:\lib\tcl8.5.10\generic;C:\lib\tk8.5.10\generic;C:\lib\tk8.5.10\xlib;C:\lib\zlib-1.2.4;

3. build (with inplace option for selftest)::

    python-2.7 -S setup.py build_ext -i build

4. self test::

    python-2.7 -S selftest

5. make windows installer::

    python-2.7 -S setup.py bdist_wininst