KIPIPLUGINS PROJECT (http://www.digikam.org)

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

See AUTHORS file for details.

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

Libkipi and kipi-plugins allow image applications such as digiKam (http://www.digikam.org)
to use a plugin architecture for additional functionalities.

Notes:

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

Calendar           : A tool to create calendars.
Facebook           : A tool to import/export images to/from a remote Facebook web service (http://www.facebook.com).
Flickr             : A tool to export images to a remote Flickr based web service (http://www.flickr.com). Also compatible with Zooomr and 23HQ 
ImageViewer        : A tool to preview images using OpenGL.
GoogleServices     : A tool to export images to Google web services.
PrintImage         : A tool to print images in various format.
SendImages         : A tool to send images by e-mail.
FlashExport        : A tool to export images to Flash using SimpleViewer (http://www.airtightinteractive.com/simpleviewer).
AdvancedSlideShow  : A tool to Slide images with 2D and 3D effects using OpenGL.
Smug               : A tool to import/export images to/from a remote SmugMug web service (http://www.smugmug.com).
RemoteStorage      : A tool to export images to remote storage using network protocol (FTP, SSH, SAMBA, etc...).
ExpoBlending       : A tool to create pseudo HDR image with a stack of bracketed images.
Piwigo             : A tool to export images to a remote Piwigo (PHPWebGallery) server (http://piwigo.org).
YandexFotki        : A tool to export images to Yandex web service (http://fotki.yandex.ru).
MediaWiki          : A tool to export images to Mediawiki based web service (http://www.mediawiki.org).
RajceExport        : A tool to export images to Rajce web service (http://www.rajce.idnes.cz).
Vkontakte          : A tool to export images to VKontakte web service (http://www.vkontakte.ru)
PhotoLayoutEditor  : A tool to assemble images together.
ImageShack         : A tool to export images to ImageShack web service (http://imageshack.us)
ImgurExport        : A tool to export images to ImgUr web service (http://imgur.com)
Panorama           : A tool to assemble panoramic photo automatically.

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

CMake           >= 3.0.0                        http://www.cmake.org
libqt           >= 5.5.0                        http://www.qtsoftware.com
libkde          >= 5.5.0                        http://www.kde.org
libkipi         >= 5.0.0                        https://projects.kde.org/projects/kde/kdegraphics/libs/libkipi
Hugin           >= 0.8.0 (runtime dependency)   http://hugin.sourceforge.net
Enblend         >= 3.0.0 (runtime dependency)   http://enblend.sourceforge.net

Optional:

libthreadweaver >= 5.0.0                        https://projects.kde.org/projects/frameworks/threadweaver
libkarchive     >= 5.0.0                        https://projects.kde.org/projects/frameworks/karchive
libphonon       >= 5.0.0                        https://projects.kde.org/projects/kdesupport/phonon
libkcalcore     >= 4.81.0                       https://projects.kde.org/projects/kde/pim/kcalcore
libmediawiki    >= 5.0.0                        https://projects.kde.org/projects/extragear/libs/libmediawiki
libkvkontakte   >= 4.70.0                       https://projects.kde.org/projects/extragear/libs/libkvkontakte
libxslt         >= 1.1.0                        http://xmlsoft.org/XSLT
libxml2         >= 2.7.0                        http://xmlsoft.org
libX11          >= 1.1.5                        http://www.x11.org
libqtopengl     >= 4.3.0                        http://www.qtsoftware.com
libmesa         >= 11.0                         http://mesa3d.sourceforge.net
libqtkoauth     >= 0.97                         https://github.com/kypeli/kQOAuth
flex            >= 2.5.0                        http://flex.sourceforge.net
bison           >= 2.5.0                        http://www.gnu.org/software/bison/bison.html

Plugin Specific Dependencies (for compiling and for running) :

AdvancedSlideShow  : libphonon, X11 (Linux Only), Mesa3D, and OpenGL support for libqt
ImageViewer        : X11 (Linux Only), Mesa3D, and OpenGL support for libqt
Calendar           : libkcalcore.
FaceBook           : libqjson.
ExpoBlending       : Hugin command line tools (runtime dependency).
Mediawiki          : libmediawiki.
Vkontakte          : libkvkontakte.
Panorama           : Hugin command line tools, flex, bison (runtime dependency).
Imgur              : libqtkoauth for Imgur.com's authenticated API.

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

If you have questions, comments, suggestions to make send an email to :

kde-imaging@kde.org

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

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 wishes reported to the Kde bugs report can be
seen 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 QT4/Qt5 are installed at the same time,
just use something like that:

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

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 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 at this url: http://techbase.kde.org/Development/Tutorials/CMake#Environment_Variables

Note: To know KDE install path on your computer, use 'kf5-config --prefix' command line like this (with full debug object enabled):

"cmake . -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_INSTALL_PREFIX=`kf5-config --prefix`"
