Anleitung zum Archiv "STIMP_noise.lha" ======================================== ZWECK ------- Das Archiv enthält Programme zur Rauschunterdrückung und zur Rauscherzeugung. INHALT -------- Das Archiv sollte folgende Dateien enthalten (Dateilänge am Zeilenende): Verzeichnis 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 Verzeichnis 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 Verzeichnis 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 Sollte eine der Dateien fehlen, holen Sie sich besser eine vollständige Version, am besten gleich von meiner Homepage. Sollten Sie den Quelltext vermissen, so muß ich Sie auf einen späteren Zeit- punkt vertrösten. Aber Sie können mich ja auch noch fragen, falls Sie es nicht mehr abwarten können ... COPYRIGHT ----------- Alle in diesem Archiv enthaltenen Dateien unterliegen dem Copyright, d.h. (c) Stefan Diener. Es ist nicht gestattet, a) dieses Archiv zu verändern und die modifizierte Form in Umlauf zu bringen (Insbesondere ist es nicht gestattet, diese Notiz zu entfernen !), b) die Programme und Quelltexte oder Teile davon zu kommerziellen Zwecken zu nutzen, c) das Archiv oder Teile davon einem kommerziellen Programm(-paket) beizulegen. Ausnahmen von diesen Regelungen bedürfen meiner persönlichen Zustimmung ! Abgesehen von obigen Einschränkungen dürfen das Programm und die Quelltexte jedoch nichkommerziell frei verwendet werden. Sollte ein Quelltext oder ein Teil davon in einem anderen Programm verwendet werden oder ein bestehendes Programm auf diese Weise weiterentwickelt werden, so ist sowohl im neuen Quelltext, als auch im neuen Programm ein Hinweis auf den ursprünglichen Autor zu vermerken. Ich würde mich darüber freuen, in diesen Fällen etwas von den Entwicklungen zu erfahren, d.h. ich bitte darum, mir wenigstens eine kurze E-Mail zu schicken. Der Autor behält sich vor, die Copyright-Bedingungen in späteren Versionen zu ändern. GARANTIE ---------- Ha, ein Scherz ! Keine Garantie ! Es gibt weder eine Garantie darauf, daß das Programm auf Ihrem Rechner läuft, noch darauf, daß das Programm den angege- benen Zweck erfüllt. Und es übernimmt auch niemand irgendeine Haftung für Schäden, die an Ihrem Rechner durch sachgemäße oder unsachgemäße Benutzung des Programms entstehen. Es kann nicht dafür garantiert werden, daß die Bild- schirmausgaben, die das Programm erzeugt, auch korrekt sind. Auch hier keine Haftung. Sollten Sie dieses Programm benutzen, so tun Sie das auf eigenes Risiko. ABER: Es wurde mit Nachdruck daran gearbeitet, das Programm möglichst von allen Fehlern zu befreien und es wurde ein erheblicher Aufwand auf das Testen des Programms verwendet. Die Chance, daß das Programm unentdeckte Fehler ent- hält, besteht jedoch weiterhin. VERSION --------- Diese Anleitung bezieht sich auf die erste veröffentlichte Version des Pro- grammpaketes. Die Versionsnummern der einzelnen Programme entnehmen Sie bitte der entsprechnden Progammdokumentation. Sollten Sie eine neuere Version des gesamten Archivs besitzen, können Sie diese Datei getrost vergessen. AUFRUF -------- Dieses Archiv und alle darin enthaltenen Programme dürfen Sie kostenlos benutzen (siehe abschnitt "Copyright"). Sie sollten aber daran denken, daß viel Zeit in die Erstellung der Programme und der Dokumentation geflossen ist. Ich erwarte für die Benutzung der Programme kein Geld (wie bei Share- ware etwa üblich), würde mich aber über eine kurze Rückmeldung Ihrerseits freuen. Schauen Sie doch auf meiner Homepage vorbei (Adresse ist im Abschnitt "Autor" zu finden) und füllen Sie das Formular auf der Support-Seite aus. Sollten Sie Interesse haben, können Sie auch eine Mailing-Liste abonnieren (nur keine Angst - eine spätere Abbestellung ist problemlos möglich !). Dann werden Sie auch in Zukunft über Weiterentwicklungen und Neuerschei- nungen informiert. INSTALLATION -------------- 1. Richten Sie auf Ihrer Festplatte ein Verzeichnis namens "STIMP" ein, z.B. "DH4:PBM/STIMP". 2. Ein Assign namens "STIMP:" muß auf dieses Verzeichnis eingerichtet werden, z.B. "assign STIMP: DH4:PBM/STIMP". Es ist empfehlenswert, diese Zeile in der User-Startup oder der Startup-Sequence zu fixieren ! In diesem Fall ist ein erneutes Starten des Rechners nötig, um die Zuweisung wirksam werden zu lassen. (Aber bitte erst am Ende der Installation !) 3. Es werden noch die Unterverzeichnisse "bin" und "help" benötigt (even- tuell möchten Sie auch noch "doc" einrichten), z.B. "DH4:PBM/STIMP/bin" (was nun gleichbedeutend mit "STIMP:bin" sein sollte) usw. 4. Kopieren Sie die Programme aus dem Ordner "bin" nach "STIMP:bin", die Ihrer Rechnerausstattung entsprechen. Haben Sie mindestens einen MC68030 und eine FPU vom Typ MC68882, so können Sie die Programme mit der Endung ".030882" verwenden, müssen diese aber nach dem Kopieren noch umbenennen (die Endung muß weg). Haben Sie nicht mindestens einen MC68030 oder keine FPU, dann müssen Sie die normale 68000er Version benutzen. 5. Um die Programme ohne explizite Pfadangabe starten zu können, ist es nötig, den Suchpfad zu erweitern: "path STIMP:bin add". Auch diese Zeile sollten Sie in die Datei User-Startup (oder Startup-Sequence) einfügen. Beachte: Selbstverständlich erst nach der Anweisung "Assign STIMP: ". Gegebenenfalls Reset nicht vergessen ! 6. Kopieren Sie die Dateien aus dem Ordner "help" nach "STIMP:help". 7. Kopieren Sie die Dateien aus dem Ordner "doc" nach "STIMP:doc". Die Installation ist nun beendet. PROGRAMMSTART --------------- Haben Sie die Installation erfolgreich durchgeführt, starten Sie ein Programm Ihrer Wahl mit dem Parameter "-?", z.B. "pgmmedian -?". Jetzt sollte ein Hilfstext erscheinen. Bekommen Sie stattdessen die Meldung "helpfile not found", ist bei der Installation etwas schief gelaufen. (Haben Sie ev. ver- gessen, einen Reset durchzuführen ?) Die Hilfstexte sollten nun zur Benutzung der Programme eigentlich ausreichen. Die Bedeutung der jeweiligen Optionen ist dann in der Dokumentation der ein- zelnen Programme nachzulesen. Noch kurz zu den verwendeten Symbolen in der Syntax-Zeile: - Eckige Klammern bedeuten, daß dieser Parameter optional ist, d.h. auch weggelassen werden kann. - Senkrechte Striche bedeuten ein exklusives ODER, d.h. von allen Parametern, die hintereinander durch senkrechte Striche verbunden sind, kann nur einer gewählt werden. - "default" bedeutet voreingestellter Wert, d.h. wenn Sie diesen optionalen Parameter weglassen, wird automatisch der voreingestellte Wert angenommen. - Zahlenwerte sind unmittelbar hinter dem einleitenden Buchstaben des Para- meters anzugeben, z.B. richtig: "-f32", falsch: "-f 32". - Jeder Parameter muß sein eigenes "-" oder "+" besitzen. Das Zusammenfassen von Parametern ist nicht möglich. - Folgerung: Es können keine Dateinamen verwendet werden, die mit einem "-" oder "+" beginnen. Auch die Verwendung von Anführungszeichen oder Hoch- kommas bringt nichts. Diese Einschränkung sollte aber im allgemeinen nicht allzu gravierend sein. Tip: Verwenden Sie ein Utility, das die Verzeich- nisse "." und ".." nutzbar macht (z.B. UnixDirs) und setzen Sie "./" vor den Dateinamen, der mit "-" oder "+" beginnt. Dann geht's. EINSCHRÄNKUNGEN ----------------- Die Dateien mit den Kennungen P1, P2 und P3 werden nicht unterstützt. Es handelt sich dabei um die Text-Versionen von PBM, PGM und PPM. Aber keine Angst: die binären Versionen von PBM, PGM und PPM (Kennungen P4, P5 und P6) werden unterstützt und sind ohnehin die gängigeren Dateiformate. Die Text- Versionen verschlingen unnötig viel Speicherplatz, d.h. die Dateien sind größer und das Laden/Speichern dauert entsprechend länger. Da alle Programme des NetPBM-Paketes sowieso die binären Versionen erzeugen, wird man in der Praxis wohl nur selten etwas mit den Text-Versionen zu tun haben. Ich habe mich deshalb entschlossen, mir den Aufwand zum Implementieren der Text- Versionen zu sparen. Wer trotzdem darauf Wert legt, kann ja die Quelltexte des NetPBM-Paketes studieren ... WAS IST STIMP ? ----------------- Wenn Sie den Abschnitt zur Installation gelesen haben, werden Sie sich sicher fragen, warum gerade die Abkürzung STIMP verwendet wurde. Nun, STIMP steht für "STefan's IMage Processing". Ich gebe zu, kein wirklich origineller Name. Aber irgendein Name mußte eben her. ENTWICKLUNGSUMGEBUNG ---------------------- Compiler: MaxonC++ 4.0 Light (05.11.96), Maxon Computer GmbH Computer: Amiga 1200, OS 3.0 Blizzard 1230 Mk. II mit SCSI-Kit 68030 und 68882, 50 MHz Chip-RAM: 2 MB, Fast-RAM: 20 MB Graffiti-Videokarte (dazu noch 'n CDROM und ein paar Platten ...) AUTOR ------- Name : Stefan Diener E-Mail : Stefan.Diener@tu-clausthal.de WWW : http://www.math.tu-clausthal.de/~masd/index.html Adresse : Bornrasen 12, D-99762 Osterode