PBM/PGM-Kit: SHORT MANUAL




PURPOSE


The archive contains 2 new savers for Ultraconv: PBM and PGM.

ARCHIVE CONTENTS


The archive should enclude the following files (file lenght at the end of the line):

main directory

directory Commands/

directory Commands.68030/

directory Commands.ppc/

directory Savers/

directory Savers.ppc/

directory source/

directory source/include/

directory source/include/STIMP/

directory source/ppm2pbm/

directory source/ppm2pgm/

If one of this files is missing, it would be better to get a full version of the archive, best you get it directly from my homepage.


COPYRIGHT


All files in this archive are copyrighted, that means (c) Stefan Diener. It is not allowed to
Any exception requires my personal agreement.

It is allowed (accepting the restrictions above) to use the program and the source code for non-commercial purposes for free. If the source code (or a part of it) is used in another application or a given program will be developed further the developer has to ensure that both in program and new source codes full credits to the original author are given. I would be very happy getting a notice about the new developments. That means that I´m expecting a short message, for instance a quite short e-mail.

The author may change this copyright notice in further releases.

GUARANTEE


Just a joke ! No guarantee given ! There´s no guarantee whether the program runs on your computer or that it will do the job you thought it should. No- body gives any liability for damages caused by proper or inproper use of the program. There´s no guarantee that the program´s output will be correct. No liability too. You are using the program at your own risk.

BUT: I was heavily working to debug the program and I spent a lot of time for testing it. The chance of undiscovered bugs is still greater than zero.


VERSION


This guide was made for the first release of this package. If you have a newer version of the whole archive just forget this file.

RESTRICTIONS


Only the binary versions of PBM/PGM/PPM-files are supported. That means that you can not use file with the markers P1, P2 and P3 (text versions). I decided to do so because all programs of the NetPBM package write binary files and the text versions have the big fault to produce unneccessary big files. In practice this is no real restriction.

SOURCE CODE


Well, I tried to comment the source code and the include files as good as possible. I don´t want to explain the whole source, because I think that the comments will give enough help to you. Anyway, I will release a description of the include files in the next future. This will be a so called "developer release" for all of you who want to code something with STIMP. As you may noticed you don´t have to take care of file operations, so you only have to code the algorithm for transforming the picture(s) ... I suggest to take a look at my homepage and joining the STIMP mailing list.


WHAT MEANS STIMP ?


You might be wondered by the name "STIMP". It´s quite simple: "STefan´s IMage Processing". Not surprising, isn´t it ?

ENVIRONMENT


Compiler:

Computer:

The PPC-executeables are compiled by Felix Schwarz (bs168@fen.baynet.de) on an Amiga 4000 (68060/50 MHz, PPC 604e/180 MHz) using SAS/C, PowerUP- Version Beta10. Thanx a lot, Felix !


AUTHOR


name : Stefan Diener
e-mail : Stefan.Diener@tu-clausthal.de
WWW : http://www.math.tu-clausthal.de/~masd/index.html
address : Bornrasen 12, D-99762 Osterode, Germany