GrafTool

INSTRUCTIONS

Was ist GrafTool?
=================

GrafTool ist in erster Linie ein Programm zum Darstellen von 
Pixelgrafik-Dateien und Animationen (neudeutsch Viewer). Außerdem
bietet es einige Möglichkeiten zur Bildbearbeitung (Filtern, Rastern,
Konvertieren) und zur Bildverwaltung (Übersichtsbilder, Stichwortsuche)

Warum noch ein Viewer?
======================

GrafTool habe ich geschrieben, damit ich ein Programm habe, daß 
genau das tut, was *ich* möchte (wenn ich's denn hinbekomme).

Dazu ein bischen Geschichte:

Als ich mit DFÜ begann, kamen natürlich auch die ersten GIF's
auf mich zu. Etwa zur gleichen Zeit muß es gewesen sein, als
GemView das Licht der Welt erblickte. Ich hatte mir gerade das
(inzwischen in Graftool-Kreisen legendäre) BAGGER.GIF gesaugt
(482kb=>1024x768x256) und wollte es mir anschauen. Nunja, GemView
brauchte eine geschlagene Minute um dann festzustellen, daß der
Speicher nicht ausreicht (Damals hatte ich ca 3MB frei) :-( Also 
wollte ich es besser machen. Und ich machte es besser, damals hies
das 10 Sekunden bis zur Anzeige. Inzwischen hat sich GemView 
natürlich weiterentwickelt und kann auch den Bagger anzeigen.
Schneller bin ich trotzdem ;-) Ein kleiner Vergleich

   TTLow XVGA-256  32k-Farben
GrafTool      8,8     7,0        15,7
GemView      14,8    14,9        14,5

Alle Zeiten jeweils vom Return in der FileselectBox bis zum Display
auf einem TT. Zu den 32k-Farben Zeiten ist anzumerken, daß GemView 
bei jedem Scrollen wieder rechnet.

(Um eines klarzustellen: Ich halte GemView für ein inzwischen *sehr*
gutes Programm und D.F. wird mir wohl immer fünf Schritte voraus sein.
Er kann mehr Formate und er kann vor allen Dingen vieles *speichern*,
was ich (noch) nicht kann.)

Wie stehts?
===========

Die nun vorliegende Version erhebt nicht den Anspruch fertig zu sein,
das wird sie wohl nie. Dennoch kann man damit arbeiten. Soweit es meine
Zeit zuläßt, werde ich auch weiterhin kleine Verbesserungen in dieses 
Programm einbringen. Größere Änderungen wird es wohl nicht mehr geben,
dafür ist meine Zeit im Moment zu knapp, und unsere beiden Kinder (z.Z.
2 Jahre bzw 3 Monate alt) verlangen das ihre. Aber ich werde sehen,
was sich machen läßt.

Wie gehts?
==========

GrafTool.App in einen beliebigen Ordner kopieren (vorzugsweise in einen
leeren namens Graftool, aber das ist kein muß). Den Module und Doc-Ordner
dazu, das war's. GrafTool starten, mit ^O eine Datei laden ... Ahhh ;-)
Oder vom Desktop einen Ordner auf's Graftool.App schieben => die erste
Datei wird angezeigt. Mit [SPACE] werden die weiteren Dateien angezeigt.

Hat man GrafTool mit einem Ordner gestartet, so kann man mit [ALT][L] eine
Liste der Dateien anzeigen lassen. Diese kann noch vielfältig bearbeitet 
werden. Mit F5 kann man dann ein Übersichtsbild berechnen lassen. In diesem
kann man (mit RechtsDoppelklick) zu jedem Bild einen Kommentar eingeben.
Mit F6 kann man in den gespeicherten Kommentaren suchen.

Für weitere Hilfestellungen empfehle ich das Archiv GFTHYPnn.LZH, in dem
die Hilfetexte zu GrafTool von Georg Schwarz zu finden sind und demnächst
auch entsprechende Tutorials.

Warum  kostenlos?
=================

Da ich es schade finde, so ein Programm nur für mich zu schreiben, 
lasse ich es auch anderen zukommen. Würde ich dafür jetzt Geld 
verlangen, könnten andere (zu Recht oder nicht) von mir dafür 
auch eine weitergehende Leistung (BugFixing, Updates, etc) 
verlangen. Genau das möchte ich aber nicht. Abgesehen davon wären
dann auch Lizenzgebühren an UNISYS+) fällig. Wenn jemand eine 
Idee hat oder Doku zu einem nicht unterstütztem Format, immer 
her damit. Aber ob ich Lust (und Zeit) habe, dieses dann auch zu 
realisieren, bleibt _meine_ Entscheidung. 

Warum dann eine Registrierung?
===============================

Einfach aus dem Interesse daran, wieviele Leute mein Programm benutzen.
(inzwischen sind es ca 220 E-Mail und ca 30 S-Mail Registrierungen)

Wie kann ich mich registrieren?
===============================

Die Registrierung erfolgt grundsätzlich kostenlos. (Auch wenn einige
mir trotzdem Geld schicken, dieses wird grundsätzlich gespendet.)

Man schickt mir per E-Mail ') seinen vollständigen Namen und 
die E-Mail-Addresse, an die der Freigabecode geschickt werden 
soll. Oder per S-Mail ') eine an sich selbst addressierte und 
*ausreichend frankierte* Postkarte.

Bitte schreibt mir auch, welche Version von GrafTool Ihr benutzt
und woher Ihr GrafTool bekommen habt. 

Am besten füllt man einfach REGISTER.TXT aus.



Zur Registrierung ruft man dann den Registrierdialog auf mit [ALT][R]
und trägt die vorgegebenen Daten in die entsprechenden Felder ein.

Bei Registrierung per E-Mail kann man auch alternativ die drei
Zeilen

R_NAM:Theo Beispiel
R_REF:thbsp@e.mail.server.com
R_COD:neindasistkeincode

ins Clipboard copieren und dann mit der Paste-Taste im 
Registrierdialog übernehmen.

*Bei einem fehlerhaften Code wird keine Fehlermeldung ausgegeben*
(Das würde das Hacken nur erleichtern)

Hat die Registrierung funktioniert?
===================================

Lade ein Bild und versuche es zweimal in dem selben Format zu 
sichern. Wenn das geht, ist die Registrierung ok.

Was passiert, wenn ich mich nicht registrieren lasse?
=====================================================

Graftool ist in der nicht registrierten Version *minimal*
eingeschränkt. Jedes Grafikformat (GIF, IMG, ...) kann pro
Programmstart _einmal_ abgespeichert werden. Somit lassen sich
sämtliche Möglichkeiten des Programms ausprobieren.

Wo bekomme ich eine neue Version her?
=====================================

Neue Versionen von GrafTool sind zu finden in der

* DBOX-Hamburg Tel                 +49 40 72910042 
  (Download nur mit PointSoftware)    
* Maus HH                          +49 40 53897013
  (Gastdownload 23:00-2:00)

Vermutlich binnem kurzen auch in anderen Maus-Boxen.

Das Archiv hat den Namen GTyymmdd.LZH, wobei yymmdd der
Versionsnummer entspricht. In den selben Boxen sollte 
auch die Hypertext-Hilfe liegen (Archiv GFTHYPnn.LZH)

Was man mit GrafTool machen darf:
=================================

* Man darf das Programm auf beliebig vielen eigenen Rechnern zu 
  _privaten_ Zwecken installieren. Ob man sich registrieren läßt,
  bleibt jedem selbst überlassen, aber bei einer kostenlosen 
  Registrierung wüsste ich nicht, was dagegen spricht.

* Man darf das unveränderte Archiv ~) in Mailboxen legen, wenn diese 
  für den Usereintrag und Download keine Gebühren erheben (Freiwillige 
  Spenden der User sind zulässig) und kein Upload/Download-Ratio haben.
  Ich bitte um eine E/S-Mail ') mit dem Boxnamen und der Telefonnummer.
  Außerdem sollte das dazugehörige GFTHYPnn.LZH auch geupped werden.

* Man darf das unveränderte Archiv ~) auf ftp-server legen, die einen 
  uneingeschränkten Zugang über anonymous erlauben.
  Ich bitte um eine E/S-Mail ') mit der Netz-Addresse des Servers und
  dem Verzeichnis, in dem das Archiv zu finden ist.
  Außerdem sollte das dazugehörige GFTHYPnn.LZH auch geupped werden.

Was man mit GrafTool nicht machen darf:
=======================================

* Man darf GrafTool und die dazugehörigen Module nicht disassemblieren,
  modifizieren, oder in irgendeiner anderen Weise mißbrauchen "). Sollte 
  jemand Interesse an den von mir verwendeten Methoden haben, kann er
  sich per E/S-Mail ') an mich wenden. 

* Man darf das GRAFTOOL.INF einer registrierten Version anderen Personen 
  nicht zugänglich machen ").

* Man darf GrafTool nicht ohne meine Zustimmung in Software-Sammlungen
  vertreiben, sei es auf Diskette, CD-Rom oder jedweder anderen Form. 
  (Siehe auch Raubcopy.Txt)
  Vorsorglich weise ich darauf hin, daß bei kommerziellem Vertrieb
  eine Lizenzgebühr an die Firma UNISYS+) fällig wird.

Disclaimer
==========

Ich habe GrafTool mit großer Sorgfalt programmiert. Dennoch kann 
ich nicht garantieren, daß dieses Programm in jeder Situation fehlerfrei 
läuft. Deswegen muß ich eine Haftung für etwaige Schäden, die aus der
Benutzung von GrafTool entstehen, ablehnen.

Bug-Reports
===========

Sollte es bei der Benutzung von GrafTool zu Problemen (Abstürzen, 
Ladefehler etc) kommen, bitte ich um eine entsprechende E/S-Mail')

Diese sollte eine Auflistung enthalten von:

Hardware          (z.B. TT030/4+16, Spectrum1TC)
Betriebssystem    (z.B. Magic 3.0 vom 27.11.94)
VDI               (z.B. NVDI 3.01)
Shell             (z.B. Gemini 1.a 29.Jan.1995)
Autoordner-Prg's  (...)
ACC's             (...)
Aktuelle Auflösung (z.B. 256x1024x768)
Vorgehen zum Erzeugen des Fehlers.
Name und Größe der Datei (damit ich sehen kann, ob 
ich sie zufälligerweise auch habe).

Inhalt des Log-Fensters
Inhalt der INF-Datei
Inhalt des [ALT][A] Fensters (ggf. PGP-Keys u.ä. löschen)
Die Datei, die mit [SHIFT][ALT][R] gespeichert wird.

Bitte *keine größeren Dateien* (16kByte) an meine Maus-Addresse senden!
Gegebenenfalls gebe ich eine E-Mail Adresse bekannt,
unter der ein größeres Attachment möglich ist.

Danksagung
==========

Zuallererst muß ich (in chronologischer Reihenfolge) 
meiner Freundin, meiner Verlobten, meiner Frau, der 
Mutter unserer Tochter und neuerdings auch unseres
Sohnes für die jahrelange Geduld danken, die sie mir
als programmierenden ATARI-Fan entgegengebracht hat.

Dann METALLICUS, der mir in seiner Mailbox die Gelegenheit 
gab, eine BetaGruppe aufzubauen.

Dann ganz besonders GEORG, ohne dessen zahlreichen Anmerkungen,
Bugreports, Ideen und Verbesserungsvorschlägen GrafTool nicht soweit
wäre, wie es ist. Nicht zu vergessen seine (manchmal nötige) Drängelei
("wann gip's die nächste Version?", "Hast Du schon...?"). Und natürlich
seine Hilfetexte GrafTool.hyp und GrafForm.hyp, ohne die GrafTool wohl
nur für eingeweihte bedienbar wäre.

VOLKER, in dessen DBOX nunmehr die BetaGruppe läuft, da die Mil 
dahingeschieden ist.

Und natürlich den BetaTestern, insbesondere CACTUS, SOS, PETER C. und 
MICHAEL Z., aber auch den anderen nicht genannten.

~) Als unverändert betrachte ich ein Archiv, in dem die gleichen Dateien
   wie in der Originaldistribution in der gleichen Directorystruktur vorliegen.
   Ein Umpacken in .ZIP, .TAR, .TGZ etc ist demnach erlaubt, ein Hinzufügen
   oder Entfernen von Dateien dagegen *nicht*. Wer Änderungvorschläge hat, 
   kann sie mir per E/S-Mail ') mitteilen.

') Ich bin erreichbar per
   MausNet: Joergen von Bargen@HH         (Mails <16kB only)
   E-Mail:  joergen_von_bargen@hh.maus.de (Mails <16kB only)
            In Hamburg lokal auch JJvB@DBOX
          
   S-Mail: Jørgen von Bargen        (Anmerkung:Systemzeichensatz ;-)
        Rentzelstraße 14
        20146 Hamburg

") Sollte ich Kenntnis von solchen Vorgängen erhalten, werde ich den 
   Registriermechanismus ändern oder die öffentliche Pflege von GrafTool
   sofort einstellen.

+) Laut Grafikformate.FAQ, genaueres zu den Lizenzbedingungen von UNISYS 
   kann man bei http://www.unisys.com erfahren.