
                       alvi - Alkor JPEG-Viewer

                             Dokumentation

                           Version: 0.05beta
                        Stand: 11. September 1996

                   Copyright (c) 1996 by Uwe Haase.

-----------------------------------------------------------------------
     The english version of this document is named README_E.TXT.
-----------------------------------------------------------------------


 Inhaltsverzeichnis
====================


1.   Allgemeines
1.1.   Copyright
1.2.   Haftung
1.3.   Danksagung
1.4.   Registrierung
1.5.   Bugreports
1.6.   Updates

2.   Installation
2.1.   Aufruf

3.   Die Funktionsweise von alvi
3.1.   Allgemeine Hintergrnde
3.2.   Die Bedienung des Programms
3.2.1.   Info
3.2.2.   Laden
3.2.3.   Optionen
3.2.4.   Setup

4.   FAQ


 1. Allgemeines
================


 1.1. Copyright
================

alvi darf nicht gegen Entgeld vervielfltigt und/oder verkauft werden. Dies
schliet ausdrcklich den Vertrieb auf CD-ROM oder Disketten gegen Entgeld
aus. Unentgeltliche Weitergabe ist statthaft.

alvi is not to be copied and/or sold for money.  This specifically (but not
exclusively) includes distribution on CD-ROM or floppies for any kind of a
fee. Free distribution without any fees is allowable.


 1.2. Haftung
==============

alvi befindet sich in einem sehr frhen Stadium der Entwicklung.
Fehler im Programm sind also nicht auszuschliessen.
Das Benutzen von alvi geschieht auf eigene Gefahr.
Ich bernehme keinerlei Haftung fr direkte oder indirekte Schden, welche
in irgendeinem Zusammenhang durch die Benutzung von alvi verursacht wurden.


 1.3. Danksagung
=================

In alvi werden die

- JPEG-Bibliothek der Independent JPEG Group (IDG)
  (Release 5 vom 24-Sep-94)

sowie die

- XGEM2-Bibliothek (08-Sep-96) von Matthias Hentschel
  (http://rcs.urz.tu-dresden.de/~mhentsch)

verwendet.

Ohne diese beiden Bibliotheken htte ich alvi niemals so einfach
realisieren knnen.


 1.4. Registrierung
====================


 Warum ist alvi kostenlos?
---------------------------

Eigentlich habe ich alvi nur fr mich programmiert. Einige Leute baten
mich, alvi zu verffentlichen. Wrde ich dafr jetzt Geld verlangen,
knnten andere (zu Recht oder nicht) von mir dafr weitergehende Leistungen
(Bugfixing, Updates) verlangen. Genau das mchte ich aber nicht. Ob ich
Lust und Zeit habe, in alvi neue Funktionen einzubauen, bleibt meine ganz
eigene Entscheidung.


 Warum sollte man sich dann trotzdem registrieren lassen?
----------------------------------------------------------

Weil es mich interessiert, wer bzw. wieviele Personen alvi benutzen, und
was sie von alvi halten.


 Wie kann man sich registrieren lassen?
----------------------------------------

Die Registrierung ist kostenlos.
Ich wrde mich freuen, wenn man mir eine Postkarte der Heimatstadt oder
mit einem schnen Motiv aus der nheren Umgebung schickt.

Meine Adresse:

   Uwe Haase
   Wiesenstr. 29
   D-01277 Dresden
   GERMANY


 Was hat der Anwender von der Registrierung?
---------------------------------------------

Er wird von mir per eMail von Updates informiert, sofern mir seine eMail-
Adresse bekannt ist. Auerdem spreche ich registrierten Anwendern ein
deutlich greres Mitspracherecht bei neuen Funktionen zu, als es
unregistrierte Anwender haben.


 1.5. Bugreports
=================

Bugreports bitte an meine eMail-Adresse haase@alkor.sax.de


 1.6. Updates
==============

Die Verffentlichung weiterer Versionen von alvi hngt von zwei
Faktoren ab:

- Der Freizeit- und Lustfaktor meinerseits,
- Der Responsefaktor andererseits.

Wenn einer der beiden Faktoren nahezu Null ist, gibt es keine Updates.
Zumindest auf den Responsefaktor haben alle Anwender von alvi einen
direkten Einflu.

Updates werden fr registrierte Anwender per eMail angekndigt.
Alle ffentlichen Versionen sind auf meiner Homepage verfgbar.

   http://www.sax.de/~haase/atari.html


 2. Installation
=================

Das Archiv entpacken.
Es wird ein Ordner mit dem Namen ALVI<Version> angelegt, z.B. ALVI005B


 2.1. Aufruf von alvi
======================

- ALVI.APP starten.
  Button "Laden" bettigen, JPEG-Datei auswhlen.

- ALVI.PRG auf dem Desktop ablegen. (Ab TOS 2.06)
  JPEG-Datei(en) auf ALVI.PRG ziehen.

- ALVI.APP kann als Viewer fr JPEG-Dateien angemeldet werden.
  (Desktop-Menpunkt Extras/Anwendung anmelden)
  JPEG-Datei mit Doppelklick ffnen.


 3. Die Funktionsweise von alvi
================================


 3.1. Allgemeine Hintergrnde
==============================


 Was ist alvi?
---------------

alvi ist die Abkrzung fr Alkor JPEG-Viewer. Damit ist die Aufgabe von
alvi schon beschrieben: Das Anzeigen von JPEG-Bildern.


 Warum noch ein Viewer?
------------------------

Die meisten JPEG-Viewer verlangen bei greren Bildern nach zum Teil un-
ntig viel RAM. Die wenigsten JPEG-Viewer fr den ST sind wirklich auf
Geschwindigkeit optimiert. (Es gibt Spezialversionen fr den DSP des
FALCON, jedoch sind diese Programme auf "normalen" ATARIs nicht verwend-
bar.) Ich kenne keinen JPEG-Viewer fr den ST, der schnell mehrere groe
JPEGs GEM-kombatibel darstellen kann.


 Einschrnkungen
-----------------
Zur Zeit wird nur das Laden von JPEG-Dateien untersttzt.
(Eventuell werden in ferner Zukunft weitere Formate eingebunden.)

Die Anzeige erfolgt gegenwrtig nur in schwarz/wei, auch in Farb-
auflsungen. Die z.Z. verwendete Dithermethode ist Floyd-Steinberg.

Es knnen nahezu beliebig groe JPEG-Dateien geladen werden.
Sollte es an Speicher mangeln, sollte die Option "Bildgre" auf einen
hheren Verkleinerungswert gesetzt werden.
(Siehe Kapitel 3.2.3)

RAM-Bedarf:

        max. 192 KB fr das Programm inkl. Buffer plus RAM-Bedarf der
        geladenen Bilder.

        Bildgre  x * y / verkl.faktor^2 / 8 Byte RAM pro Bild
                      (fr verkl.faktor 1, 2, 4, 8)

  z.B.:      Ein im Original 1280 x 1024 Pixel groes Bild bei einem
             Verkleinerungsfaktor 8:

             1280 * 1024 / 64 / 8 = 2560 Byte

Anmerkung: Die Ladezeit wird durch einen hheren Verkleinerungswert
           deutlich verringert!


 3.2. Die Bedienung von alvi
=============================

Im Hauptfenster von alvi befinden sich vier Buttons:

Info / Laden / Optionen / Setup

Deren Funktion wird im folgenden nher beschrieben.


 3.2.1. Info
=============

Anzeige einer kurzen Info zum Programm, diese enthlt u.a. die
Versionsnummer und das Datum/Uhrzeit der Kompilierung.


 3.2.2. Laden
==============

JPEG-Datei zum laden auswhlen.


 3.2.3. Optionen
=================

Momentan stehen nur sehr wenige Optionen zur Auswahl.


 Bildgre
-----------

Mit "Bildgre" kann der Verkleinerungsfaktor Originalgre, 2, 4 oder
8 ausgewhlt werden. Faktor 8 verkleinert ein Bild der Gre 640 x 480
zu 80 x 60.

Die Einstellung ist vor dem Laden der Bilder vorzunehmen.
Defaultwert ist 2.


 3.2.4. Setup
==============

Momentan noch ohne Funktion.


 4. FAQ
========

Q01:  Wie wird alvi beendet?

      Closer des Hauptfensters bettigen!

