pnmview_grf: Anleitung

bin (Dir)
doc (Dir)
help (Dir)
libs (Dir)
Assign.Skript (42)
doc.info (628)
Install (4247)
Install.info (4746)
pnmview_grf.readme (1633)

Verzeichnis bin/

pnmview (85052)

Verzeichnis doc/

gfx (Dir)
pnmview.deutsch.html (20257)
pnmview.deutsch.html.info (833)
pnmview.english.html (17424)
pnmview.english.html.info (833)

Verzeichnis doc/gfx/

d.gif (73)
gb.gif (145)

Verzeichnis help/

pnmview.syntax (1447)

Verzeichnis libs/

graffiti.library (3064)

Sollte eine der Dateien fehlen, holen Sie sich besser eine vollständige Version, am besten gleich von meiner Homepage.

SHAREWARE VERSION

Alle in diesem Archiv enthaltenen Dateien (außer "graffiti.library") unterliegen dem Copyright, d.h. (c) Stefan Diener. Es ist gestattet, dieses Archiv frei weiterzuverteilen, aber es ist verboten, dieses Archiv zu verändern und die modifizierte Form in Umlauf zu bringen. (Insbesondere ist es nicht gestattet, diese Notiz zu entfernen !),

Ausnahmen von diesen Regelungen bedürfen meiner persönlichen Zustimmung !

Dieses Paket enthält:

einen unschönen "Shareware-Effekt" auf allen Ziel-Bildern,
eine unoptimierte 68000er Programmversion,
keine Quelltexte,
nicht alle Optionen (nicht hier, aber in anderen Paketen).

REGISTRIERTE VERSION

Sollten Sie Teile dieses Paketes regelmäßig benutzen, so ist es Ihre Pflicht, sich registrieren zu lassen. Ihre Vorteile:

kein häßlicher "Shareware-Effekt" auf den Ziel-Bildern,
optimierte Programmversionen für 68000, 68020, 68030+68882 und 68040,
(Eine PowerPC-Version ist ebenfalls möglich, aber dazu muß ich erst eine PowerUP-Karte anschaffen. Und das hängt allein davon ab, wieviele Leute sich registrieren lassen ...)
volle Ultraconv-Unterstützung (sofern sinnvoll),
alle Optionen verfügbar (falls in Shareware-Version eingeschränkt),
C/C++ Quelltexte (nicht von allen Programmen, aber meist),
detailierte Entwickler-Dokumentation,
freie Updates.

Denken Sie daüber nach und Sie werden sehen, daß es sich lohnt.

Preise:

Erstes STIMP-Paket - Deutschland
bar ODER Euro-Scheck Nachnahme Überweisung

via E-Mail 10 DM - 10 DM

Post 15 DM 23 DM 15 DM

Zweites++ STIMP-Paket - Deutschland
bar ODER Euro-Scheck Nachnahme Überweisung

via E-Mail 6 DM - 6 DM

Post 11 DM 19 DM 11 DM

Nur in Deutschland: Sie haben die Möglichkeit, das Geld direkt auf mein Konto zu überweisen. Schicken Sie mir bitte eine E-Mail oder einen Brief, für welche(s) Paket(e) Sie sich registrieren lassen möchten.

Erstes STIMP-Paket - Deutschland
	bar ODER Euro-Scheck	Nachnahme	Überweisung
via E-Mail	10 DM	-	10 DM
Post	15 DM	23 DM	15 DM

Zweites++ STIMP-Paket - Deutschland
	bar ODER Euro-Scheck	Nachnahme	Überweisung
via E-Mail	6 DM	-	6 DM
Post	11 DM	19 DM	11 DM

Kontonummer: 107 328 478
bei: Sparkasse im Kreis Osterode
BLZ: 263 510 15
Zweck: "Ihr Name"

Meine Adresse: Stefan Diener, Bornrasen 12, D-99762 Osterode.

Erstes STIMP-Paket - Europa, Welt
bar ODER Euro-Scheck

via E-Mail 10 DM/6 US$

Post 15 DM/9 US$

Luftpost 17 DM/11 US$

Zweites++ STIMP-Paket - Europa, Welt
bar ODER Euro-Scheck

via E-Mail 6 DM/4 US$

Post 11 DM/7 US$

Luftpost 13 DM/8 US$

Meine Adresse: Stefan Diener, Bornrasen 12, D-99762 Osterode.

Erstes STIMP-Paket - Europa, Welt
	bar ODER Euro-Scheck
via E-Mail	10 DM/6 US$
Post	15 DM/9 US$
Luftpost	17 DM/11 US$

Zweites++ STIMP-Paket - Europa, Welt
	bar ODER Euro-Scheck
via E-Mail	6 DM/4 US$
Post	11 DM/7 US$
Luftpost	13 DM/8 US$

Für registrierte Programmversionen gelten andere Copyright-Bedingungen:

Das gesamte Paket (außer "graffiti.library") ist (c) Stefan Diener.
Es ist nicht gestattet, das Paket oder Teile davon in irgendeiner Form weiterzuverteilen.
Sie können eine Sicherheitskopie des Programms erstellen. Diese darf aber nicht bei einem guten Freund "gelagert" werden.
Sie können Teile der Quelltexte und der Entwickler-Quellen in eigenen Programmen verwenden, solange bei einer Veröffentlichung keinerlei Geld verdient wird. Folgerung: Es ist nicht gestattet, (Teile der) Quelltexte in kommerzieller Software oder Shareware zu verwenden.

Ausnahmen von diesen Regelungen bedürfen meiner persönlichen Zustimmung !

VERSION UND PLÄNE

Diese Anleitung bezieht sich auf die zweite veröffentlichte Version des Programmpaketes. Sollten Sie eine neuere Version des gesamten Archivs besitzen, können Sie diese Datei getrost vergessen.

Pläne:
- Dateirequester hinzufügen für einfache Dateiauswahl
- Start von der Workbench ermöglichen
- Speichern von Bildern ermöglichen (nützlich z.B. bei farbreduzierten PPM-Bildern)
- Textausgabe direkt auf den Graffiti-Screen, z.B. während des Ladens des nächsten Bildes und beim Dithern
- ??? Vorschläge der Benutzer ... Hinweise sind willkommen !

Zweites Release: Version 1.16, 21.04.98
- Floyd-Steinberg-Dithering hinzugefügt
- Änderung der Helligkeit hinzugefügt
- verschiedene Bugs entfernt
- Dateioperationen optimiert und debugged
- Eingabe- und Ausgabe-Umleitungen hinzugefügt
- verschiedene Teile des Programm optimiert (NUR REGISTRIERTE VERSION)

Erstes Release: Version 0.01ß, 27.09.97
- Beta-Version

GARANTIE

Es kann keinerlei Garantie gegeben werden. Es gibt weder eine Garantie darauf, daß das Programm auf Ihrem Rechner läuft, noch darauf, daß das Programm den angegebenen 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 Bildschirmausgaben, 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 enthält, besteht jedoch weiterhin.

ANFORDERUNGEN

pnmview_grf benötigt folgende Dinge:

Graffiti-Videokarte (überraschend, stimmt´s ?)
mindestens Kickstart 2.0 (das ist Version 37.175)
mathieeedoubbas.library (Version egal) in LIBS:
mathieeedoubtrans.library (Version egal) in LIBS:
graffiti.library (mindestens Version 1.0) in LIBS:
mindestens 310 kByte freien Speicher, um (kleine) Bilder anzuzeigen,
[90 kByte Chip-RAM und 220 kByte Fast-RAM, falls vorhanden]

INSTALLATION

Benutzen Sie einfach das Installer-Skript "Install", um das Programmpaket automatisch installieren zu lassen.
Selbstverständlich können Sie die Installation auch per Hand vornehmen. Sie tun dies aber auf eigenes Risiko ! Ich habe leider keine Zeit, alle Installationsschritte einzeln zu erklären, da die Installation dazu zu umfangreich geworden ist, leider.

PROGRAMMSTART

Haben Sie die Installation erfolgreich durchgeführt, starten Sie das Programm OHNE die Angabe von Parametern: "pnmview". Jetzt sollte ein Hilfstext erscheinen. Bekommen Sie stattdessen die Meldung "helpfile not found", ist bei der Installation etwas schief gelaufen.

Hinweis: Die Option "-?" wird nicht mehr unterstützt.

Syntax: pnmview [-v|+v] [[+o] [-n|-o|-l|-e|-f] | [+t [-cFarben]]]
                [-1|-2|-3] Datei1 [Datei2 ...]

Optionen:

+v : benutze Verbose-Modus (default)
-v : kein Verbose-Modus
-1 : Bildschirmauflösung: 160x256
-2 : Bildschirmauflösung: 320x256
-3 : Bildschirmauflösung: 640x256 (benötigt OS 3.0 und AGA)
Notiz: Wird keine Bildschirmauflösung angegeben, öffnet das Programm einen (hoffentlich) passenden Bildschirm für jedes einzelne Bild.
+o : Ordered Farbreduktion (default)
-n : Dithering: keins (default)
-o : Dithering: Ordered Dither
-l : Dithering: Line Diffusion
-e : Dithering: Error Diffusion
-f : Dithering: Floyd-Steinberg (Notiz: sehr langsam !)
+t : Octree-Farbreduktion (Notiz: gute Ergebnisse, aber langsam !)
-c : max. Farbanzahl für Octree-Farbreduktion, 16 .. 256 (default: 256)
DateiX : PBM/PGM/PPM-Datei

Während der Bildanzeige können Sie

übergroße Bilder mit der Maus bewegen,
die Bildschirmauflösung durch Drücken von F1, F2 und F3 ändern,
die Helligkeit des Bildes ändern, indem Sie + und - drücken,
das Bild verlassen, indem Sie die Mausknöpfe, ESCAPE, RETURN oder ENTER drücken.

Notiz: PPM-Dateien werden auf 256 farben reduziert. Nur dann sind die Optionen +o, +t, -c, -n, -o, -l, -e und -f verfügbar.

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 Parameters 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 Hochkommas bringt nichts. Diese Einschränkung sollte aber im allgemeinen nicht allzu gravierend sein. Tip: Verwenden Sie ein Utility, das die Verzeichnisse "." und ".." nutzbar macht (z.B. UnixDirs) und setzen Sie "./" vor den Dateinamen, der mit "-" oder "+" beginnt. Dann geht´s.

Werfen Sie auch einen Blick auf den folgenden Abschnitt "Umleitungen" !

UMLEITUNGEN

Ein neues Feature ist die Möglichkeit der Eingabe- und Ausgabeumleitung. Zu beachten ist nur, daß der (nun nicht mehr benötigte) Dateiname durch einen "-" zu ersetzen ist. Einige Beispiele:

normalerweise:
"pgmmedian lena.pgm result.pgm"
(wobei lena.pgm Eingabedatei und result.pgm Ausgabedatei ist)
Ausgabe-Umleitung:
"pgmmedian lena.pgm - >result.pgm"
Eingabe-Umleitung:
"pgmmedian - result.pgm <lena.pgm"
Eingabe- und Ausgabe-Umleitung:
"pgmmedian - - <lena.pgm >result.pgm"
Benutzung von Pipes (Grüße von UNIX):
"pgmmedian lena.pgm - | pnmmargin -a0 -m5 - result.pgm"
oder noch komplizierter mit 2 Pipes:
"pnmaddnoise -w0.8 -p20.0 lena.pgm - | pgmmedian - - | pnmview -"
(Beachte: Um die Eingabe-Umleitung des Programms pnmview benutzen zu können, benötigen Sie eine neuere Version als 0.01ß ...)

Dieses Feature wurde hauptsächlich für die Benutzung von Ultraconv zur Verfügung gestellt, ist aber bei der Programmbenutzung in UNIX ebenfalls sehr nützlich.

Beachte: Man benötigt zusätzliche Software für Pipes beim AmigaOS.

ULTRACONV 3

Sie können pnmview_grf als Preview-Programm in Ultraconv3 verwenden. Dazu müssen Sie folgende Zeile in die Datei "UConv:Ultraconv.info" einfügen:

PREVVIEWER=STIMP:bin/pnmview -2 %f

Sie können auch andere Optionen von pnmview_grf verwenden, z.B. ".../pnmview -2 +o -l %f". Das hängt nur von Ihrem persönlichen Geschmack und der Leistung Ihrer CPU ab.

Erinnerung: Sollte Ihnen diese SHAREWARE-Version ein wenig zu langsam vorkommen, lassen Sie sich registrieren und Sie erhalten eine optimierte Version für Ihren 680x0-Prozessor. (PowerPC-Benutzer sollten nachfragen, ob eine spezielle Version bereits verfügbar ist, da ich erst eine PowerUP-Karte kaufen muß ...)

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 ...

QUELLTEXT

Der Quelltext zu diesem Paket ist im Moment nicht verfügbar, da noch unzählige Dinge verändert werden sollen. Falls Sie den Quelltext aber trotzdem schon haben möchten, schreiben Sie mir ...

WAS IST STIMP ?

Wenn Sie den Abschnitt "Registrierte Version" 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:

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, Deutschland