KIPIPLUGINS PROJECT (http://www.kipi-plugins.org)

-- AUTHORS ------------------------------------------------------------

See AUTHORS file for details.

-- ABOUT --------------------------------------------------------------

Libkipi and kipi-plugins allows image applications to use a plugin architecture for additional functionalities.

Note: Most of the KipiPlugins have previously been Digikamplugins.

      kipi-plugins is based in part on the work of the Independent
      JPEG Group.

Currently implemented plugins are:

 1) RawConverter       : A Raw Image Converter for digital cameras 

 2) SlideShow          : Slideshow with effects ripped out from kslideshow and 3D effect using OpenGL 

 3) MpegEncoder        : An images to MPEG flux encoder for build a video file with many images 

 4) PrintWizard        : Print multiple images/index pages in one page

 5) JpegLossLess       : Batch images processing (rotation/flipping) without
 			             losing meta information embedded in the image
                         and without recompression of the jpeg data.

 6) CdArchiving        : Albums CD archiving via K3b cd burning program 

 7) AcquireImages      : Acquire images interface 
                         This plugin include these parts:
                            ScanImages (scanner management using Kooka).
                            ScreenshotImages (Snap Screen based on KSnapshot and adapted to Digikam).

 8) Calendar           : A Calendar construction plugin using Album images 

 9) SendImages         : A plugin to send images by e-mail, allowing resizing and recompressing 
                         before sending.

10) BatchProcessImages : A batch process images plugin.
                         This plugin includes these parts:
                            RenameImages (Image file names renaming).
                            ConvertImages (Image files format converting).
                            BorderImages (Add border to images).
                            FilterImages (Image enhancements using digital filters).
                            ColorImages (Image color enhancement).
                            EffectImages (Image transformation effects).
                            ResizeImages (Basic and Prepare to print images resizing).
                            RecompressImages (Recompress JPEG, TIFF, PNG, and TGA images).

11) TimeAdjust         : Adjust image file Time and Date.

12) WallPaper          : Image to KDE Desktop.

13) FindImages         : Find duplicate images in albums.

14) GalleryExport      : Plugin to export images to a remote Gallery (and Gallery 2) server
                         (http://gallery.sf.net).

15) FlickrExport       : Plugin to export images to a remote Flickr web service (http://www.flickr.com)

16) HTMLExport         : Plugin to export images collections into XHTML page.

17) SimpleViewerExport : Plugin to export images to SimpleViewer
                         (http://www.airtightinteractive.com/simpleviewer).

18) GPSSync            : Plugin to geolocalize pictures.

19) IpodExport (beta)  : Plugin to export pictures with an Ipod device.

20) MetadataEdit       : Plugin to edit EXIF and IPTC pictures metadata.

21) PicasaWebExport    : Plugin to export images to a remote Picasa web service (http://www.picasaweb.com)

-- DEPENDENCIES -------------------------------------------------------

CMake       >= 2.4.5                        http://www.cmake.org
libqt       >= 4.3.x                        http://www.trolltech.com
libkde      >= 4.0.x                        http://www.kde.org
libtiff     >= 3.6.x (>=3.8.2 recommended)  http://www.remotesensing.org/libtiff
libkexiv2   >= 0.2                          http://www.kipi-plugins.org
libkdcraw   >= 0.2                          http://www.kipi-plugins.org
libxslt     >= 1.1                          http://xmlsoft.org/XSLT
libgpod     >= 0.4.2                        http://www.gtkpod.org/libgpod
libkcal     >= 3.4.x                        http://pim.kde.org
ImageMagick >= 5.5.4 (runtime dependency)   http://www.imagemagick.org
MJPEGTools  >= 1.6.0 (runtime dependency)   http://mjpeg.sourceforge.net
K3b         >= 0.11  (runtime dependency)   http://www.k3b.org


Plugin Specific Dependencies (for compiling and for running) :

jpeglossless       : imagemagick (runtime dependency)
slideshow          : OpenGL support for libqt
batchprocessimages : imagemagick (runtime dependency)
cdarchiving        : k3b (runtime dependency)
mpegenconder       : mjpegtools (runtime dependency)
                   : mpg123 (runtime dependency)
                   : vorbis-tools (runtime dependency)
wallpaper          : kdebase (runtime dependency)
rawconverter       : libtiff 
acquireimages      : libtiff
htmlexport         : libxslt
ipodexport         : libgpod
calendar           : libkcal

-- CONTACT ------------------------------------------------------------

If you have questions, comments, suggestions to make do email at :

kde-imaging@kde.org

IRC channel from irc.freenode.org server: #kde-imaging

IMPORTANT : the bugreports and wishlist are hosted by the KDE bugs report 
system who can be contacted by the standard Kde help menu of plugins dialog. 
A mail will be automaticly sent to the Kipi mailing list.
There is no need to contact directly the Kipi mailing list for a bug report 
or a devel wish.

The current Kipi bugs and devel wish reported to the Kde bugs report can be see 
at this url :

http://bugs.kde.org/buglist.cgi?product=kipiplugins&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED

-- INSTALL ------------------------------------------------------------

In order to compile, especially when QT3/Qt4 are installed at the same time, 
just use something like that:

# export VERBOSE=1
# export QTDIR=/usr/lib/qt4/  
# export PATH=$QTDIR/bin:$PATH 
# cmake .
# make

Usual CMake options :

-DCMAKE_INSTALL_PREFIX : decide where the program will be install on your computer.
-DCMAKE_BUILD_TYPE     : decide which type of build you want. You can chose between "debugfull", "debug", "profile", "relwithdebinfo" and "release". The default is "relwithdebinfo" (-O2 -g).

Compared to old KDE3 autoconf options:

"cmake . -DCMAKE_BUILD_TYPE=debugfull" is equivalent to "./configure --enable-debug=full"
"cmake . -DCMAKE_INSTALL_PREFIX=/usr"  is equivalent to "./configure --prefix=/usr"

More details can be found ata this url: http://techbase.kde.org/Development/Tutorials/CMake#Environment_Variables

