deutsch

STIMP_noise: MANUAL




PURPOSE


The archive contains several programs for noise reduction und noise creation.

ARCHIVE CONTENTS


The archive should enclude the following files:

main directory

directory bin/

directory bin.030882/

directory bin.ppc/

directory doc/

directory doc/gfx/

directory help/

directory Ultraconv/

directory Ultraconv/Catalogs/

directory Ultraconv/Catalogs/Deutsch/

directory Ultraconv/ReqDesc/

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.

Note: This archive (or an older verion of it) can be found on the UConv4-CDROM produced by RBM Computertechnik Bernd Rudolf. Felix Schwarz (the author of Ultraconv) has the permission to publish the archive together with UConv version 4.

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. Nobody 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 release 1.04 of this package. 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 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.

Note: Future STIMP packages will be shareware !


INSTALLATION


  1. Use the Installer-script "Install" !

  2. You may install STIMP_noise by hand too, but on your own risk !
    I'm sorry, but I cannot give detailed instructions anymore.


USAGE OF THE PROGRAMS


You can get the usage of one of the programs by starting it without any options: 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 ?)

Note: The option "-?" is no longer available.

I think that the programs help texts should be enough for a short explanation of all options. If you need more information you have to take a look at the programs documentation.

Some hints for the "Syntax" line:

FOR PPC-USER ONLY: If you are using a PowerPC-CPU some things are different. At first you have to use the executeables with the suffix ".elf" and you have to run all these programs using the "runelf" command, for instance: "runelf pgmmedian.elf <...parameters...>".


REDIRECTIONS


A new feature is the possibility to use input- and output-redirection. The only thing you have to do is replacing the (now useless) file name by a "-". Some examples:
  1. normal form:
    "pgmmedian lena.pgm result.pgm"
    (where lena.pgm is the input file and result.pgm the output file)
  2. output-redirection:
    "pgmmedian lena.pgm - >result.pgm"
  3. input-redirection:
    "pgmmedian - result.pgm <lena.pgm"
  4. input- and output-redirection:
    "pgmmedian - - <lena.pgm >result.pgm"
  5. using pipes (greets from UNIX):
    "pgmmedian lena.pgm - | pnmmargin -a0 -m5 - result.pgm"
  6. or more complicated with 2 pipes:
    "pnmaddnoise -w0.8 -p20.0 lena.pgm - | pgmmedian - - | pnmview -"
    (Note: You need a newer version than 0.01ß of the program pnmview to use the input-redirection ...)

I added this feature mainly for use with Ultraconv, but it is useful for running the programs on UNIX too.

Note: You need additional software to use pipes on AmigaOS.

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.

Note: The source code is not included anymore. If you register for any future STIMP package you'll get the developer documentation and the source code from this package too. Cause: Future packages will be SHAREWARE !


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:

Computer:

AUTHOR


name : Stefan Diener
e-mail : stefan.diener@freepage.de
WWW : http://private.freepage.de/stefan.diener/index.html
address : Wilhelmstr. 7, D-73433 Aalen, Germany