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:
-
The password should be specified for each level
-
The passwords should be unique in each episode
-
A valid time limit should be specified
-
A repton should be placed, but only one
-
At least one end level object should be placed
-
The blips should be more or equal that the cages
-
At least one key should be placed if strongboxes are placed
-
The transporters placed should have a specified destination, but only one
-
The transporters origin should be a transporter sprite
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
-
Comment the source code with kdoc.
-
Rewrite this documentation with the KDE SGML tools.
-
Internationalization.
Send comments to Sandro Sigala <ssigala@globalnet.it>