PICFIB Dokumentation V1.1 1995.08.07 fr PICFIB V1.1 vom 1995.08.07


                     P I C F I B

                         von

                  A. Rosenberg (AR)

GEWHRLEISTUNG: Ich (AR) bernehme keinerlei Haftung fr Schden die
whrend oder durch die Benutzung dieses Programmes entstehen. Ich habe
versucht alle Fehler zu beseitigen und einige Bekannte haben in einer
Betatestphase versucht die Restlichen zu finden.

VERTRIEB: Dieses Programm ist SHAREWARE. Sie drfen es ber einen Zeitraum
von 30 Tagen testen. Wenn Sie es ntzlich finden und es weiter benutzen
wollen mssen Sie sich registrieren lassen. Wenn Sie dies unterlassen
benutzen Sie eine Raubkopie. Es darf (und soll) kopiert werden und ber
Mailboxen verteilt werden, solange dafr keine Gebhren verlangt werden
und das Paket komplett weitergegeben wird. Es darf zu Speicherzwecken oder
fr bertragungen komprimiert und/oder kodiert werden. Komerzielle
PD/Shareware Distributoren drfen nicht mehr als 5 DM als Kopiergebhr
verlangen.

REGISTRIERUNG: SHAREWARE heisst, man kann die Software kostenlos erwerben
und testen ob sie seinen Bedrfnissen entspricht. Wenn diesen Programm Ihren
Vorstellungen entspricht und Sie es weiter benutzen wollen mssen Sie sich
registrieren lassen.
Ich glaube ein Zeitraum von 30 Tagen reicht aus um sich zu entscheiden, ob
man das Programm benutzen will oder nicht. Wenn Sie sich registrieren lassen
erhalten Sie einen Code, der das Maximum von 10 Dateien aufhebt und den
About Dialog beim Verlassen des Programmes nicht mehr erscheinen lsst.
Weitere Informationen ber die Registrierung entnehmen Sie bitte der Datei
REGIST_G.TXT.

1. bersicht

1.1 Was ist PICFIB?

PICFIB ist ein Akronym fr "PICture FIle Browser" und ist ein kleines Hilfs-
programm, das es erleichtert eine grere Menge an Bildern anzusehen. Die
Idee dazu hatte ich nachdem ich mir die ATARI GEMINI CD-ROM gekauft hatte.
Darauf befinden sich unter anderem Ordner mit mehreren Dutzend Bildern
(ungefhr 450). Ich schaute mir einige davon an und schon am nchsten Tag
wusste ich nicht mehr genau, was ich schon gesehen hatte und was noch nicht.
Ausserdem war es immer sehr umstndlich mittels 'Datei|ffnen...' durch die
Dateiliste zu blttern um eine Datei auszuwhlen. Um dieses Problem zu
lsen schrieb ich dieses Programm.

1.2 Was macht PICFIB

Mit PICFIB knnen Sie sich eine Liste mit Bild-Dateien erstellen lassen indem
Sie einfach einen Ordner auswhlen. Jeder Datei werden 4 'tags' zugeordnet.
('tag'(englisch) = Etikett, Anhnger. Man sagt etwas ist 'tagged' wenn es
irgendwie markiert, ausgewhlt wurde. Ich kenne kein vernnftiges deutsches
Wort das man dafr einsetzen knnte deshalb verwende ich das englische Wort
'tag' weiter.) Tag 1 wird vom Programm verwaltet und zeigt an, ob das
entsprechende Bild schon angezeigt wurde. Die restliche 3 Tags stehen dem
Benutzer zur Verfgung. Sie knnen damit ihre Lieblings-Bilder kennzeichnen
und mit der Filter-Funktion nur diese ansehen. Natrlich knnen Sie diese
Tags zusammen mit der Liste speichern und laden. PICFIB untersttzt die
folgenden Bilder: 2,4,16,256 Farben/Graustufen. Sie knnen jedes Bild in
jeder Auflsung ansehen, aber wenn Ihre Auflsung weniger Farben bietet
als das Bild zur Anzeige bentigt, werden nur die wichtigsten Farb-Ebenen
(Planes) angezeigt. Um die Anzeige von Farb/Graustufen Bildern im Mono-
Chrom-Modus zu verbessern knnen Sie Dithering mittels Floyd/Steinberg
einschalten. (Dithering ist ein Verfahren, das es erlaubt Farbbilder
in Schwarz/Wei darzustellen).


1.3 Hardware-Anforderungen

PICFIB sollte auf jedem ST-Kompatiblen Computer in jeder Paletten
basierten Auflsung funktionieren (keine True-Color Untersttzung).


1.4 Die Grenzen von PICFIB

Wenn man Bilder mit mehr Farben als die gewhlte Auflsung bietet ansehen
will, so wird das Bild auf die Farbzahl der gewhlten Auflsung
konvertiert. Dabei ist es von der Video-Hardware abhngig ob das Bild
nach der Konvertierung ansehnlich bleibt. Fr photorealistische
Bilder sollte man 256 Farben zur Verfgung haben. Auf einem Standard
ST sehen solche Bilder in der niedrigen Auflsung hufig nicht gut aus.
Whlen Sie in solchen Fllen die Monochrom-Auflsung, da
hier die Darstellung von 256 Farb-Bildern besser ist, als in einer
Auflsung mit 16 Farben. Sie knnen nur Bilder laden, die kleiner als
4096x4096 Pixel sind und fr die Sie ausreichend Speicher besitzen um
die Bilder zu laden.


1.5 Untersttzte Graphik-Formate

Extension   Beschreibung

IMG         GEM IMG Format (inklusive XIMG)
PC1,PC2,PC3 DEGAS Format fr alle ST Auflsungen (komprimiert/unkomprimiert)
PCX         PC-Paintbrush Format der Firma ZSoft
GIF         CompuServe's Graphics Interchange Format
TIF         Tagged Image File Format 

Anmerkung zum TIFF Format:
Das TIFF Format wurde von den Firmen Aldus und Microsoft definiert und
mehrfach erweitert. Es ist sehr flexibel und es knnen neben dem 
eigentlichen Bild(ern) diverse andere Informationen abgelegt werden.
Diese Flexibilitt hat nun dazu gefhrt, da viele Bilder nicht 100% 
dem TIFF Standard entsprechen, weil sich die Programmierer (aus 
welchen Grnden auch immer) nicht an den Standard gehalten haben. So 
soll es schon vorgekommen sein, da ein Programm seine eigenen TIFF
Dateien nicht mehr lesen konnte.
Die von mir benutzte TIFF Library ist in dieser Hinsicht sehr exakt und 
weigert sich z.B. TIFF-Dateien zu laden, wenn optionale Daten (die
das Bild nicht betreffen) fehlerhaft sind. So sind mir whrend des
Test einige solche Dateien untergekommen. Wenn Sie also auf eine Datei
stossen, bei der sich PICFIB mit einer Fehlermeldung weigert eine TIFF
Datei zu laden, dann bleibt Ihnen nur die Mglichkeit die TIFF-Datei
mit einem dritten Programm in der Hoffnung abzuspeichern, das dieses
Programm eine korrekte Datei erzeugt.
Die TIFF-Bibliothek die ich benutzt habe wurde von Sam Leffler 
geschrieben und wurde von Dieter Linde auf die Atari Platform 
portiert. Weitere Details entnehmen Sie bitten der Datei TIFFCPRT.TXT.


2. Die Menuleiste von PICFIB

2.1 Das File Men

2.1.1. Create List.. (Erstelle Liste)

ber diesen Menpunkt erstellen Sie eine neue Datei-Liste. Es erscheint
ein File-Selektor in dem Sie den Ordner auswhlen in dem sich die Bild-
Dateien aufhalten. Die Liste wird dann alle Dateien enthalten, die der
eingegebenen Extension entsprechen. Abhngig von der Option 'Scan
through subdirs' wird entweder nur das gewhlte Verzeichnis oder der
gesamte Verzeichnisbaum durchsucht. Fr jedes Bild der Liste wird Tag 1
gesetzt und der Tool-Dialog wird geffnet.

2.1.2. Load List.. (Lade Liste)

Whlen Sie diesen Menpunkt um eine gespeicherte Liste zu laden. Die
Standard Extension fr Listen ist TXT, da sie nur einfachen Text enthalten.
Der Inhalt der Listen-Datei wird zeilenweise gelesen. Der Tool-Dialog wird 
geffnet. Seit der Version 1.0a werden Text-Dateien geprft, ob sie gltige
PICFIB-Dateien sind. Das soll verhindern, da irrtmlich andere TXT-Dateien
geladen werden.
Wenn Sie Listen laden, die von der Version 1.0 erzeugt wurden, erscheint die
Abfrage "PICFIB signature not found. Continue?" (PICFIB Kennung nicht 
gefunden). Antworten Sie mit "YES" um das Laden fortzusetzen. Speichern Sie 
die Liste wieder ab, so wird die Kennung erzeugt. 

2.1.3. Save List.. (Speichere Liste)

Whlen Sie diesen Menpunkt um eine Liste zu speichern. Die Standard
Extension fr Listen ist TXT. Die 'Tags' zu den Bildern werden natrlich
auch gespeichert.

2.1.4 Export List.. (Exportiere Liste)

Mit dieser Funktionen knnen Sie die Liste in einem Format 
abspeichern, so da sie von anderen Programmen genutzt werden kann. 
Zuerst folgt die Beschreibung des zugehrigen Dialoges, dann folgen 
einige Beispiele, was man damit anfangen kann.
Der Export-Dialog enthlt eine Checkbox, mit der Sie den PICFIB-Header
in die Export Datei aufnehmen knnen (Include PICFIB header). 
Dies sollten Sie dann ankreuzen, wenn die neue Datei wieder von PICFIB 
benutzt werden soll. In einem solchen Fall mssen sie als Zeilen-Prefix 
genau 4 Zeichen eintragen und den Zeilen Suffix leer lassen. Tun Sie dies 
nicht wird PICFIB Probleme haben die Liste richtig auszuwerten. Falls 
eine sptere Version von PICFIB mehr als 4 Tags verwalten kann, ist 
hier eine entsprechende Anzahl von Zeichen einzutragen.
Mit der nchsten Checkbox entscheiden Sie, ob die Filter-Optionen beim 
Erzeugen der Liste benutzt werden sollen (Use filter option). Nur wenn 
diese Checkbox angekreuzt ist, haben die beiden Radio-Buttons eine 
Bedeutung. Wenn Sie die normale Filter-Funktion benutzen (Normal 
filter) werden genau diese Bilder als Liste gespeichert, die der 
Filter Maske im Optionen Dialog (siehe 2.1.5) entsprechen. Mit der 
Funktion negierter Filter (Negated filter) knnen Sie genau die Menge 
an Bilder als Liste abspeichern, die der Filter Maske NICHT 
entspricht. 
In die beiden Eingabe-Felder knnen Sie jeweils einen Text schreiben, 
der jeweils vor/nach dem Dateinamen des Bildes steht.

Beispiele: 
	(X) steht fr eine Checkbox, (*) fr einen Radio-Button, 
	( ) heisst die entsprechende Option nicht auswhlen

1.) Erzeugen einer neuen PICFIB Liste, in der alle Bilder enthalten 
sein sollen, die Tag 2 UND TAG 3 gesetzt haben. Diese Bilder sollen 
in der neuen Liste alle Tag 4 gesetzt haben. 
	-Kreuzen Sie im Optionen-Dialog die Tags 2 und 3 an und setzen Sie 
	die Tag Verknpfung auf AND.
	-Whlen Sie Export List.. an und stellen Sie folgende Optionen ein:
	 (X) Include PICFIB header
	 (X) Use filter option
	 (*) Normal filter ( ) Negated filter
	-Schlielich tragen Sie als Zeilen Prfix ein: "   +" (drei 
	Leerzeichen, ein Plus-Zeichen)
	-Drcken Sie OK und whlen Sie im folgenden Dialog einen 
	Dateinamen.
	
2.) Erzeugen einer Batch Datei, mit der alle Bilder die Tag 2 oder Tag 
4 gesetzt haben von einer CD ins Verzeichnis C:\BILDER kopiert werden 
sollen.
	-Kreuzen Sie im Optionen-Dialog die Tags 2 und 4 an und setzen Sie 
	die Tag Verknpfung auf OR.
	-Whlen Sie Export List.. an und stellen Sie folgende Optionen ein:
	 ( ) Include PICFIB header
	 (X) Use filter option
	 (*) Normal filter ( ) Negated filter
	-Tragen sie als Zeilen Prfix "copy " und als Suffix 
	"C:\BILDER" ein.
	-Drcken Sie OK und whlen Sie im folgenden Dialog einen 
	Dateinamen, der die Extension BAT trgt.
	-Nun knnen Sie diese BAT Datei in einer COMMAND Shell 
	aufrufen und die entsprechenden Dateien werden kopiert.
	
3.) Erzeugen einer Batch Datei, mit der alle Bilder die Tag 2 oder Tag 
4 NICHT gesetzt haben aus dem Verzeichnis C:\BILDER gelscht werden 
sollen. (Die Liste mu fr das Verzeichnis C:\BILDER erstellt worden 
sein!)
	-Kreuzen Sie im Optionen-Dialog die Tags 2 und 4 an und setzen Sie 
	die Tag Verknpfung auf OR.
	-Whlen Sie Export List.. an und stellen Sie folgende Optionen ein:
	 ( ) Include PICFIB header
	 (X) Use filter option
	 ( ) Normal filter (*) Negated filter
	-Tragen sie als Zeilen Prfix "del " ein
	-Drcken Sie OK und whlen Sie im folgenden Dialog einen 
	Dateinamen, der die Datei BAT trgt.
	-Nun knnen Sie diese BAT Datei in einer COMMAND Shell 
	aufrufen und die entsprechenden Dateien werden gelscht.

Falls Sie eine UNIX kompatible Shell benutzen mssen sie statt "copy" 
und "del" die entsprechenden Kommandos eintragen (z.B. "cp" und "rm").

2.1.5. Options.. (Optionen)

Es erscheint ein Dialog mit mehreren Checkboxes. Die ersten 4 Checkboxes
entsprechen den 4 'Tags'. Wenn Sie hier eine entsprechende Nummer
ankreuzen sehen Sie nur noch solche Bilder bei denen die entsprechenden
Tags angekreuzt sind. 'Match all tags' bedeutet, da bei einem Bild
alle Tags mit den Angekreuzten bereinstimmen men, damit das Bild
angezeigt wird. 'Match 1 tag' bedeutet, da bei einem Bild wenigstens
ein Kreuz mit den hier angekreuzten bereinstimmen mu, damit es angezeigt
wird. Wenn Sie nur Bild sehen wollen, die Sie noch nicht gesehen
haben, kreuzen Sie einfach Tag 1 an.
Darunter befinden sich zwei weitere Checkboxes. 'Scan through
subdirs' beeinflut das Erstellen neuer Listen. Entsprechend wird beim
Aufbau einer Liste nur das ausgewhlte Verzeichnis oder der gesamte
Verzeichnisbaum durchsucht. 'Dither pics if mono res' bewirkt, da in
monochromen Auflsung Farb- u. Graustufenbilder gedithered werden. Das
nimmt natrlich Zeit in Anspruch, so seien Sie nicht beunruhigt wenn
das Laufwerkslicht bereits aus, aber das System noch beschftigt ist.
Wenn Sie das Dithering ausgeschaltet haben und Farb/Graustufenbilder
in monochrom ansehen so wird Ihnen die hchstwertige Plane angezeigt.
Manchmal kann man so bereits einen ersten Eindruck von diesem Bild
bekommen, aber meistens sieht es so nicht besonders gut aus.


2.2 Das View Men

2.2.1 First pic (Erstes Bild)

Wenn Sie diesen Punkt auswhlen wird das erste Bild aus der Liste geladen
und in einem Fenster angezeigt. Dieser Punkt ist nur verfgbar wenn Sie
eine Liste erstellt oder geladen haben. Bitte beachten Sie, da die
Bilder entsprechend den Tags im Optionen-Dialog gewhlt werden. Es kann
also sein, da Sie die Meldung 'Ende der Liste' erhalten wenn keine
Bilder den Filter-Optionen entsprechen.

2.2.2 Next pic (Nchstes Bild)

Whlen Sie diesen Punkt um das nchste Bild aus der Liste zu laden und
anzuzeigen. Die Filter-Optionen werden benutzt.

2.2.3 Prev pic (Vorheriges Bild)

Whlen Sie diesen Punkt um das vorherige Bild aus der Liste zu laden und
anzuzeigen. Die Filter-Optionen werden benutzt.

2.2.4 Jump to pic (Springe zum Bild)

Whlen Sie diesen Punkt um bei einem bestimmten Bild zu beginnen. Die
Filter-Optionen werden benutzt.

2.2.5 Single pic (Einzelnes Bild)

ber diesen Punkt knnen Sie ein einzelnes Bild laden. Die Liste oder
andere angezeigte Bilder werden dadurch nicht beeinflut.

2.2.6 Tool dialog

Whlen Sie diesen Punkt um ein zustzliches Fenster zu ffnen mit dem
Sie komfortabel durch die Liste blttern knnen. Auerdem knnen Sie
damit die Tags fr jedes Bild verndern. Der rechte Button ldt das
nchste Bild, der linke Button das vorherige. Darunter sehen Sie vier
Checkboxes die den Zustand der Tags fr dieses Bild entsprechen.  Sie
knnen die Tags entsprechend Ihren Wnschen setzen und lschen.
Beachten Sie da Tag 1 nach jedem Ansehen des Bildes automatisch
gelscht wird. Wenn Sie mehr ber die Filter-Optionen wissen wollen
lesen Sie im Abschnitt 2.1.4 weiter. Sie knnen das Tool-Fenster
wieder schlieen, wenn Sie den Punkt erneut anwhlen. Wenn das Fenster
sichtbar ist, wird der Meneintrag mit einem Hkchen versehen.


3. Tastatur-Funktionen

Einige Funktionen knnen zustzlich mit der Tastatur durchgefhrt 
werden oder sind nur mit der Tastatur verfgbar.

-Die Tasten 1-4 ndern den Zustand des jeweiligen Tags
-Die Taste UNDO schaltet zwischen der Standard Palette und der Palette 
des Bildes hin und her. Dies kann dann ntzlich sein, wenn ein Bild 
sehr viele hnliche Farbtne enthlt, so da man nicht mehr sieht wo 
sich die Maus befindet oder welchen Menu-Eintrg man vor sich hat.


4. Verschiedenes

PICFIB wurde mit Turbo-C 2.0 auf einem Atari 260ST der auf 4MB
aufgerstet wurde und einem Falcon030 in einem Zeitraum von ca. 8
Wochen entwickelt. Die gesamten C Sourcen belegen ca.150KB.  PICFIB
wurde mit TOS 1.04, TOS 2.06, TOS 4.04, MagiC! getestet. Ebenfalls getestet
wurden allen Auflsungen die ein Falcon bietet (ohne die 16-Bit Modi).

Bekannte Bugs: Bisher keine.

Wenn Sie mehr darber wissen wollen, welche Fehler in der aktuellen
Version behoben wurden, lesen Sie die Datei HISTORY.TXT.

4.1 Die Zukunft von PICFIB

Wenn entsprechende Resonanz bei den Anwendern vorhanden ist, werde
ich PICFIB sicherlich weiterentwickeln und pflegen. Geplant sind etwa
weitere Bildformate (z.B. BMP, JPEG...) und eine Funktion, die aus
einer Liste von Bildern ein Bild mit verkleinerten Bildern errechnet
(Thumbnail-Format). In absehbarer Zeit wird es wahrscheinlich auch
eine Windows Version geben (ist gerade in Arbeit).

4.2 Bugs und Features

Anregungen und Error-Reports sind natrlich willkommen und erwnscht.
Fehlermeldungen sollten folgende Angaben enthalten:
- Rechnertyp ST/STE/TT/Falcon + Hardware (Memory,Grafikkarten,CPU-Upgrades..)
- TOS Version
- Residente Programme (TOSFIX,NVDI,GDOS,....)
- geladene Accessories
- Auflsung in der das Programm den Fehler produziert (Pixel (x*y),Farben)
- Blitter aktiviert?
- Tritt der Fehler reproduzierbar auf?
- Mglichst detailierte Angaben ber die letzten Benutzeraktionen vor
  Auftreten des Fehlers
- Die Fehlersymptome (Nachzeichenfehler, Bus-Error,...)

Sollte ein Bild beim Laden eine Programm-Absturz erzeugen, so sollte
man versuchen, das Bild mit einem anderen Programm (z.B. GemView) zu
laden. Sollte das Bild ok sein, aber mit meinem Programm nicht ladbar
sein, so wre mir sehr daran gelegen, wenn man mir das Bild zukommen
lassen knnte. Meine Adresse finden Sie in REGIST_G.TXT.
