KRepton Editor User Manual

The KRepton Editor is a powerful program that can be used for creating new episodes for the KRepton game. It has been tested under the release 1.0 of KDE and should be considered stable.

I release it under an open source code license. If you like this program, send me a postcard from your hometown :-).

Sandro Sigala
Viale De Gasperi, 8
25041 Darfo Boario Terme
Brescia, Italy

Editing the original episodes

You can't direcly edit the original episodes distribuited in the KRepton package, since they are installed in the global read-only directory $KDEDIR/share/apps/krepton/data. You can instead create a modifiable copy of the episode by selecting the New Episode button
at the KRepton Editor start, then selecting the template episode in the combo box at the bottom-right corner of the window.

Editing the sprites

The KRepton Editor includes a simple sprite editor.  For the basic operations this should suffice, but it is possible to edit the sprites
using another editor; the sprites are contained in the sprites.bmp file (in the Windows bitmap format) that can be found in every episode directory.  I suggest using the powerful GIMP GNU Image Manipulation Program, available freely from the www.gimp.org homepage.

The strict check feature

The strict check option is a very useful feature: it checks the levels for the most common editing errors. The following checks are done: Please not that the strict check feature makes no check for verifying that the levels are actually solveable; for example it emits no warning for this level:

How to distribuite your new episodes

By default, the KRepton Editor saves the created episodes in the $HOME/.kde/share/apps/krepton/data directory.
The following table describes how to copy, for example,  the mylevels episode to your friend using the InfoZip tools zip and unzip or tar. The commands (in bold face) should be executed from the shell command-line (you can easily replace the underlined mylevels word with your real episode name).
 
Backup utility Your account Friend account
InfoZip's zip and unzip cd ~ 
zip -9r mylevels.zip .kde/share/apps/krepton/data/mylevels 
copy the mylevel.zip file to your friend's account
cd ~ 
unzip mylevels.zip
tar cd ~ 
tar cvf - .kde/share/apps/krepton/data/mylevels > mylevels.tar 
copy the mylevel.tar file to your friend's account
cd ~ 
tar xvf mylevels.tar

Where to find the sources

The main FTP site is ftp.vix.com, where you can find the latest sources of this program plus the sources of other programs written by me. The other available FTP site is KDE main site ftp.kde.org, or any other mirror.

License

/****************************************************************
Copyright (c) 1998 Sandro Sigala <ssigala@globalnet.it>.
All rights reserved.

Permission to use, copy, modify, and distribute this software
and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all
copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.

The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness.  In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
****************************************************************/

Changes

No changes yet.

To Do



Send comments to Sandro Sigala <ssigala@globalnet.it>