Guide to the archive "STIMP_noise.lha" ======================================== PURPOSE --------- The archive contains several programs for noise reduction und noise creation. CONTENTS ---------- The archive should enclude the following files (file lenght at the end of the line): directory bin/ pgmbinomial 14776 pgmbinomial.030882 14748 pgmlulu 15180 pgmlulu.030882 15136 pgmmaximin 15404 pgmmaximin.030882 15360 pgmmean 14264 pgmmean.030882 14220 pgmmedian 15236 pgmmedian.030882 15188 pgmminimax 15408 pgmminimax.030882 15364 pgmpseudomedian 15604 pgmpseudomedian.030882 15552 pnmaddnoise 21148 pnmaddnoise.030882 20204 pnmimpnoise 21136 pnmimpnoise.030882 20608 pnmwhitenoise 21704 pnmwhitenoise.030882 20352 ppmadapmedian 21788 ppmadapmedian.030882 19752 ppmcolmedian 18588 ppmcolmedian.030882 17392 ppmvecmedian 16144 ppmvecmedian.030882 16144 directory doc/ noise.deutsch.txt 12067 noise.english.txt 10215 pgmbinomial.txt 1428 pgmlulu.txt 1384 pgmmaximin.txt 1573 pgmmean.txt 1452 pgmmedian.txt 1665 pgmminimax.txt 1635 pgmpseudomedian.txt 1599 pnmaddnoise.txt 1560 pnmimpnoise.txt 1982 pnmwhitenoise.txt 1606 ppmadapmedian.txt 1489 ppmcolmedian.txt 1476 ppmvecmedian.txt 1477 directory help/ pgmbinomial.syntax 379 pgmlulu.syntax 367 pgmmaximin.syntax 587 pgmmean.syntax 443 pgmmedian.syntax 621 pgmminimax.syntax 587 pgmpseudomedian.syntax 626 pnmaddnoise.syntax 521 pnmimpnoise.syntax 940 pnmwhitenoise.syntax 559 ppmadapmedian.syntax 476 ppmcolmedian.syntax 464 ppmvecmedian.syntax 464 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. If you're missing the source code, I have to tell you that it will be released in the future. But if you can't wait, you have the choice to contact me ... COPYRIGHT ----------- All files in this archive are copyrighted, that means (c) Stefan Diener. It is not allowed to a) modify the archive and to distibute the modified form (It's especially not allowed to remove this notice !), b) use the program and the source code or parts of it for commercial purposes, c) distribute the archive or parts of it as part of a commercial product. 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 packege. You have to take a look at the program's documentations for the current version mubers. If you have a newer version of the whole archive just forget this file. APPEAL -------- You may use this archive and all included programs for free (see chapter "copyright"). But you have to remember that I spent a lot of time for coding the programs and writing this file. I don't expect any money from you (as shareware usually requires), but I would be very glad getting support from you. Best you take a look at my homepage (address below, chapter "author") and fill out the form at the support page. If you are interested in you may take part in a mailing list (no fears - quiting this list is easy !). So you will be informed about any news and updates. INSTALLATION -------------- 1. Create a new directory on your harddisc called "STIMP", for example "DH4:PBM/STIMP". 2. You have to add an assign for the volume "STIMP:" to the new directory, for example "assign STIMP: DH4:PBM/STIMP". I suggest to add this line to your User-Startup file or to your Startup-Sequence. Please note that it is neccessary to reset your Amiga before the assign becomes working. (But please wait until the end of this installation !) 3. Now you have to create subdirectories "bin" and "help" (you may create "doc" too), for instance "DH4:PBM/STIMP/bin" (the same as "STIMP:bin"). 4. Copy the programs from the "bin"-directory to "STIMP:bin" according to your computer's CPU. If you own at least a MC68030 and a FPU MC68882 you have to copy the programs with the ".030882" extension AND rename it after the copy (remove the extensions !). If you don't have at least a MC68030 or you own no FPU you have to use the blank 68000 versions. 5. To execute the programs without explicit typing in the whole path you have to add the directory "STIMP:bin" to the system's search path, for example "path STIMP:bin add". I suggest to add this line to your User-Startup or Startup-Sequence too. Note: Add it after the "assign STIMP: " line ! (Don't forget the reset at the end of the installation.) 6. Copy all files from the directory "help" to "STIMP:help". 7. Copy all files from the directory "doc" to "STIMP:doc". Installation finished ! START THE PROGRAM ------------------- You can get the usage of one of the programs by starting it with the "-?" option: for instance "pgmmedian -?". If no usage appers, it is possible that the installation was not succesfull or any other error appeared ... (Maybe you forgot the reset ?) Sorry, but an automatic installation is not avail- able yet. Maybe this will change in future versions. I think that the programs help texts should be enough for a short expla- nation of all options. If you need more information you have to take a look at the programs documentation. Some hints for the "Syntax" line: - [parameter] means that this is an optional prameter. - | means excusive or, that means that you can only choose one option out of all parameters concatenated by |'s. - "default" means default value if you leave the optional parameter ;-) - Any values are to be placed directly after the introducing char, for instance: "-f32" is okay, but "-f 32" is wrong. - Every parameter has to be introduced by a "-" or "+". It is not possible to combine parameters after only one "-" or "+". - Conclusion: It's not possible to use file names beginning with a "-" or "+". Hint: Try software that makes "." and ".." useable (like "UnixDirs"). It makes it possible to write "./-file" instead of "-file-". That's it. 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. WHAT MEANS STIMP ? -------------------- If you read the installation part, you might be wondered by "STIMP". It's quite simple: "STefan's IMage Processing". Not surprising, isn't it ? ENVIRONMENT ------------- Compiler: MaxonC++ 4.0 Light (05.11.96), Maxon Computer GmbH Computer: Amiga 1200, OS 3.0 Blizzard 1230 Mk. II with SCSI-Kit 68030 and 68882, 50 MHz Chip-RAM: 2 MB, Fast-RAM: 20 MB Graffiti video card (besides a CDROM and some harddisks ...) 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