Yoltia README


Yoltia is a graphical picture editor that provides the functionality to do simple changes to a large number of files quickly and very comfortable and exactly. Some of the features are:
- Resizing
- Rotating
- RGB- and HSV-manipulation
- JPEG and PNG compression preview
- Clipboard interaction
- Many zoom-modes
- Browsing through directories or custom file lists
- Slideshow

You can get the source code and translation sources from Yoltia's web page <http://people.freenet.de/yoltia>.

To build Yoltia, you need the Qt3 library by Trolltech, the GNU make utility and a C++ compiler. The build process runs like this:
   
   Unpack - if not already done - the whole package to a directory of your choice (i.e. /usr/src/, from now on called $UNPACKDIR)
   Change to $UNPACKDIR/yoltia-0.20.1/src/
$> $QTDIR/bin/qmake				// Creates the "Makefile" out of the project file "yoltia.pro"
$> make						// Starts compiling using the created "Makefile", creates an executable binary "yoltia"
$> $QTDIR/bin/lrelease yoltia.pro		// Creates the translation files ("yoltia_*.qm") out of the translation sources ("yoltia_*.ts")

After this, you will get an executable named "yoltia" and some "yoltia_*.qm" translation files in the source code directory.
If you want, run the install script to integrate Yoltia into the system, or copy the binary and translation files to a destination of your choice yourself.

$> $UNPACKDIR/yoltia-0.20.1/install.sh		// Integrates Yoltia into the system, root-login necessary

This will create the following files/directories:

/usr/X11/bin/yoltia 				// Executable binary
/usr/share/pixmaps/yoltia.xpm			// Yoltias ugly icon
/usr/share/doc/packages/yoltia/			// Directory where the doc files will be copyed into
/usr/share/yoltia/				// Directory for the translation files

The translation files have to be integrated in Yoltia via the settings dialog (Edit => Settings => Internationalization => Select). Note that you have to restart Yoltia to use the set translation files.

Yoltia uses another 2 files while running:
~/.qt/yoltiarc				// Settings file
/tmp/kvs				// Temporary file for testing compression of JPEG an PNG pictures

If you want to run Yoltia on different platforms than Linux, you may have to change the paths in the code. If you can't find the right place in the code, just send me an e-mail.

Finally, I hope you enjoy to use Yoltia!


--Stefan Bauer <yoltia-maintain@freenet.de>

Last modified 2006-02-23