indii.org/tintii
------------------------------------------------------------------------

tintii takes full colour photos and filters them into black and white
with some select regions highlighted in colour; think Schindler's List's
little girl in red, or the dramatic style of Sin City. The technique is
known as colour popping or selective colouring - tintii makes it easy.

In addition to this distribution for Linux and other Unix-like
platforms, tintii is also available for Windows and Mac as a plugin to
Adobe Photoshop and Corel Paint Shop Pro.

For further information, tips and documentation, see the website at
www.indii.org/tintii.


Licensing
------------------------------------------------------------------------

tintii is copyright 2007-2010 Lawrence Murray, and distributed under a
GPL version 2 license, see LICENSE.txt.

The program uses icons from the Nuvola icon set, see www.icon-king.com.
See the images/nuvola directory for the original icons and their LGPL
license. See the src/nuvola directory for the derived work, licensed
under the GPL version 2 as per the remainder of tintii.


Requirements
------------------------------------------------------------------------

tintii requires:

  * wxWidgets v2.8.0 or later <http://www.wxwidgets.org/>
  * Boost.uBLAS and Boost.Random <http://www.boost.org/>

and for compilation:

  * scons <http://www.scons.org/>

These are commonly installed with Linux distributions or readily
available through package managers. You may need to install both boost
and boost-devel packages, and wxGTK and wxGTK-devel, packages in order
to compile.


Installation
------------------------------------------------------------------------

To compile the program use:

scons

This will check for dependencies and compile all sources. To run the
program after compilation use:

./tintii

For a list of build options use:

scons -h

Any of these options may be set either by editing the config.py file
or by specifying them as NAME=VALUE pairs on the command line. For
example, to build with assertions disabled (recommended) either enter:

NDEBUG='yes'

into config.py, or use:

scons NDEBUG=yes

on the command line.

Options given at the command line override those in config.py, and
those in config.py override the defaults for your system.

