REQUIREMENTS:

* KDE 3.1. 

* ImageMagick 5.5.0 or above. 
PixiePlus has been tested on ImageMagick 5.5.0 and 5.5.1. Earlier versions 
will not work! Even if it compiles there WILL be errors.

*A 16bpp, (thousands of colors), or above X server.
PixiePlus supports 16bpp (thousands of colors), 24bpp, and 32bpp (millions
of colors), X servers. 16 and 256 color modes are not supported. PixiePlus
will display a error dialog and exit on these systems.

REQUIREMENTS TO COMPILE PIXIEPLUS:

* A C++ compiler. 
I know it sounds obvious that you'd need to have the C++ compiler installed 
to compile C++ applications but you'd be suprised how many emails I get when 
configure fails because GCC isn't installed.

* KDE and Qt development packages. 
If you installed KDE and Qt from packages you need to make sure you also have 
the development packages installed. These include the C++ headers needed to 
compile any KDE/Qt application.

* X11/XFree development package. 
If you installed X11/XFree from packages you need the development package 
installed so you can compile X applications.

* ImageMagick development package. 
If you installed ImageMagick from packages you need the development package 
for this installed as well.

* Various image format development packages. 
You need the C headers for various image formats so will need to make sure 
these are installed. This includes the development packages for libtiff, 
libjpeg, libpng, and giflib. On many systems they are installed by default. 

COMPILING PIXIEPLUS:

On most systems you will be able to simply unpack the archive and run the
following commands:

cd pixieplus-0.5.0/
./configure --enable-final
make
make install

The --enable-final flag creates smaller and more efficent KDE applications
and is now supported. It's been tested with PixiePlus using GCC 3.2. If you
get a strange compile error you may want to try it with the flag removed.

The Magick-config utility must be in your path! The easiest way to determine
this is just try to run it on the command line.

DISTRIBUTION SPECIFIC NOTES FOR COMPILING KDE APPLICATIONS:

RED HAT BREAKAGE:
Red Hat systems are not supported by any Mosfet software including PixiePlus
and Liquid. Go to http://www.mosfet.org/noredhat.html for more information and
to see why Red Hat systems are not supportable.

MANDRAKE BREAKAGE:
Mandrake uses a non-standard directory structure that breaks KDE software
installation when compiling from source. Specifically, it uses a non-standard
directory for the configuration files that control what shows up in the
KDE Control Center, in the menus, and mimetypes. That means that not only my software,
but any third party KDE software you install from source will be missing their 
entries in the menu, file associations, and any Control Center modules they 
may install.

This problem has existed for several Mandrake versions and they seem not to
care about fixing it despite the fact that by default no software compiled 
from source will have menu or Control Center entries. They
seem to think you should only use the RPMs they provide ;-) Okay, but then
when I asked them to provide RPMs for my software they said they didn't 
have the time >:/

Some of my stuff has appeared in Mandrake Cooker, and other stuff is available
as unofficial packages. Otherwise you may be able to use their menu tool
to reset the menu structure to the correct standard structure, (I don't
know about this - I don't use Mandrake). Make sure to let Mandrake know that
you want to be able to compile KDE apps from source and have everything
work out of the box - including menus entries and the Control Center!

Otherwise PixiePlus will compile and run although it may not be able to use
some image types because it was unable to properly install all the mimetypes,
you won't get a menu entry for it, and you won't get entries in the Konqueror
menu to open folders in PixiePlus.
