@DATABASE akPNG_Dokumentation
@WIDTH 80

##
## Zum Lesen dieser Daten kann folgendes benutzt werden:
##
##  Programmname    verfügbar unter
##
##  - AmigaGuide   (Verschiedene Pakete)
##  - MultiView    (Workbench)
##  - PowerGuide   (Aminet CDs)
##

@NODE MAIN "akPNG Dokumentation"

                           akPNG.datatype v45.4

                    Veröffentlichungsdatum: 02.07.2002

                          Benötigt Kickstart V3.x


                     © 2002 by Dipl.-Ing. Andreas Kleinert
                         Alle Rechte vorbehalten.


                   EIN   PerSuaSiVe SoftWorX   PRODUKT.

                               - FREEWARE -

@{i}
     Bitte lassen Sie sich registrieren - weniger als 1% der Benutzer
      eines Programmes lassen sich Registrieren. Das ist nicht viel.
@{ui}

              @{i}<Commercial>@{ui} @{"Was ist SViewIV ?" LINK Commercial_1/Main 0 } @{i}</Commercial>@{ui}


                             @{"Rechtliches"              LINK Rechtliches }
                             @{"Haftung"                  LINK Haftung}
                             @{"Vertrieb"                 LINK Vertrieb}

                             @{"Installation"             LINK Installation}
                             @{"Bedienung"                LINK Bedienung}

                             @{"Datatypes FAQ"            LINK Probs}

                             @{"Kontakt"                  LINK Kontakt}
                             @{"Danksagungen"             LINK Danksagungen}
                             @{"Versionsgeschichte"       LINK Versionsgeschichte}
@{fg highlight}
                             _
                         _  //
                    Only \\X/ Amiga makes it possible.
@{fg text}

     Die CHAOS Theorie:
     @{i}
      "Like finding that bloody butterfly whose flapping
      wings cause all these storms we've been having lately
      and getting it to stop."
     @{ui} (see "Witches Abroad" by Terry Pratchett)


     Ähem... nun ja:

     @{i}... und Danke für den Fisch.@{ui}

@ENDNODE

@NODE "Rechtliches"

Das Programm in dieser Version und auch seine Dokumentationsdateien
unterliegen dem (C)opyright 1996-2002 von Andreas Ralph Kleinert.
Alle Rechte vorbehalten.

Diese Software basiert teilweise auf der PNG-Referenzbibliothek (bestehend aus
libpng und zlib), welche sowohl eine freie als auch kommerzielle Nutzung zulässt.

  libpng:

   libpng 1.2.5
   Copyright (c) 1995 - 1996 Guy Eric Schalnat, Group 42, Inc.
   Copyright (c) 1996 - 1997 Andreas Dilger
   Copyright (c) 1998 - 2002 Glenn Randers-Pehrson

  zlib:

   zlib 1.1.4
   (C) 1995-2002 Jean-loup Gailly and Mark Adler


Der akDT_Installer ist (C)opyright 1996-2001 von Robert C. Reiswig.
Falls Sie irgendeinen Teil dieses Installationsscriptes benutzen möchen, fragen
Sie ihn. Ohne Genehmigung darf es nicht in eine andere Distribution eingebunden,
oder dort genutzt werden! Änderungswünsche, Vorschläge oder Probleme bitte an
folgende EMail-Adresse senden:          akDatatype@vgr.com

Das Oberflächendesign des Voreinstellungsprogrammes wurde von
Georg Rottlaender <Georg.Rottlaender@bonn.netsurf.de> unter Benutzung von 'NewIcons'
Grafiken von Philip Vedovatti <vedovatt@u.washington.edu> verbessert - mit Erlaubnis
des 'Team NewIcons'

Die Patch-Dateien wurde unter Benutzung des Programmes scompare SAS Binary File erstellt.
Compare Program V6.50 which is copyright © 1992-1993 SAS Institute, Inc.
The spatch SAS Binary File Patcher V6.50 is copyright © 1992 SAS Institute, Inc.

Einige der genannten Namen oder Produkte innerhalb diesem oder anderer Dokumente
unterliegen dem Copyright der Hersteller oder der jeweiligen Person.

Sollten einige der aufgezählten Bedingungen und Klauseln innerhalb dieses
Dokumentes in Verbindung mit den Rechtssprechungen einiger Länder nicht gültig sein,
so führt dies nicht zur Ungültigkeit der anderen Klauseln.

@ENDNODE

@NODE "Haftung"

Der Autor übernimmt keine Verantwortung für irgendeine Art von Auswirkungen,
die durch die Nutzung dieses Programmes oder eines Teiles davon entstehen.

Diese Software wird zur Verfügung gestellt "WIE SIE IST" und es wird
keine Garantie irgendeiner Art übernommen, so daß Sie diese Software
auf eigenes Risiko nutzen.

Der Autor behält sich das Recht vor, dieses Programm nicht weiterzuentwickeln.

@ENDNODE

@NODE "Vertrieb"

Diese Version des Programms kann frei vertrieben werden (FREEWARE).
Sie können das Archiv vervielfältigen, solange die Copyright Dokumente
nicht geändert werden und alle anderen Teile dieser Distribution enthalten
sind.

Dieses Progamm darf nur mit meiner schriftlichen Erlaubniss in kommerziellen
Archiven oder kommerziellen Progammen genutzt werden - Fragen Sie einfach danach!

Dieses Programm darf auf Public Domain Disketten oder in Public Domain
Bibliotheken enthalten sein. Für die Verbreitung mittels diesem Weg, darf eine
kleine Spende verlangt werden, welche die Kosten für die Erstellung der Kopien
decken kann. Es ist aber auf die oben beschriebene Einschränkung der kommerziellen
Nutzung zu achten.

Dieses Programm darf auch über EMail vertrieben werden und in Mailboxen enthalten
sein, solange die Weitergabebestimmungen in allen Punkten eingehalten werden.

Bei der Benutzung oder Weitergabe dieses Programmes erklären Sie sich automatisch
mit allen oben aufgeführten Konditionen und Bestimmungen einverstanden.

@ENDNODE

@NODE Installation "Installation und sonstige Hinweise"

 Installation und Benutzung
 --------------------------

 Installieren Sie einfach die Datatype Dateien in ihre jeweiligen
 Verzeichnisse und kopieren Sie das Voreinstellungsprogramm alternativ nach

                        SYS:Prefs/Datatypes

 Bitte stellen Sie außerdem sicher, daß ein Verzeichnis zur Ablage temporärer
 Dateien verfügbar ist. Es muß hierauf ein Assign namens "VMEM:" existieren.
 Wie übrigens auch bei der superview.library und dem akJFIF.datatype .

 Erstellen Sie kein Assign auf "T:", sollte dieses auf die RAM-Disk verweisen
 (dies ist auch der Grund, warum das nicht schon standardmäßig geschieht) -
 nehmen Sie einfach einen sicheren Platz dafür (VMEM: ist gemeint ;).



 Programm Information
 --------------------

 Das akPNG.datatype ist ein PNG-Datatype, welches auf den aktuellsten
 PNG Quellcodes basiert (zlib V1.1.3 und libpng V1.0.2).

 Mit V39-42 des picture.datatype wird eine (bis zu) 256 Farben große Palette
 erzeugt (entweder Ohne, mit Floyd-Steinberg oder mit Geordneter Rasterung),
 oder HAM6/8 Ausgabe.

 Mit dem picture.datatype V43-45 werden auch 24bit unmodifiziert exportiert.

 akPNG benutzt bei Verfügbarkeit Memory Pools und automatisch auch
 die asyncio.library (V39+), sollte diese verfügbar ist.

 Für die besten Einstellungsmöglichkeiten wird empfohlen, das beigefügte
 Voreinstellungsprogramm zu benutzen. Natürlich kann auch ein alternatives
 Programm aus dem Aminet benutzt werden, welches die gleiche Funktionalität
 beinhalten sollte (aber bitte denken Sie daran mir dann keine Fehlerreports zu senden!).

 Das akPNG.Datatype ist @{"FREEWARE" LINK "Rechtliches"}.



 Bekannte Fehler
 ---------------

 Einige Leute berichteten in der Vergangenheit über Probleme mit dem
 Installationsscript. Wenn Sie einen Fehler feststellen können oder
 Probleme damit haben, so senden Sie eine Nachricht direkt an den Autor
 des Scriptes:

                Robert C. Reiswig <akDatatype@vgr.com>

 Bitte benutzen Sie mindestens die wizard.library V41.101. Sie sollten eine
 Kopie davon in den verschiedenen Demoversionen von Programmpaketen des
 Herstellers Haage&Partner finden können:

                           ftp.haage-partner.com


 Die Auswahl des Anzeigemodus ist nicht immer 'perfekt'.



 Tipps und Tricks
 ----------------

 Wenn Sie dieses Datatype in Ihrem WWW Browser benutzen sollten, dann
 erzeugen Sie eine separate Partition (Größe etwa 30-70 MB) um temporäre
 Daten speichern zu können und verweisen (Assign !) Sie mittels VMEM:
 dorthin. Den Cache Ihres Browser's verweisen Sie bitte auch dorthin.

 Versichern Sie sich zusätzlich das Addbuffers größer/gleich 128 ist.
 Beim Partitionieren (ACHTUNG: Sie verlieren dabei die dort stehenden Daten!)
 macht es Sinn, die Blockgröße auf einen höheren Wert als vorgegeben
 zu stellen, z.B. 1024.

 Stellen Sie außerdem sicher, daß Sie die neueste Version des FFS Filesystems
 von www.amiga.de benutzen!

 Bitte beachten Sie, daß Sie das FFS ohne eine Neupartitionierung updaten können.
 Aber Sie sollten sehr aufpassen, wenn Sie dies mit dem Programm HDToolBox machen.

 Noch besser ist es, ein schnelleres Filesystem für Ihre Cache-Partition zu
 benutzen, wie z.B. das kommerzielle PFS2 (ehemals AFS, www.schatztruhe.de),
 oder das frei erhältliche SFS (siehe http://www.xs4all.nl/~hjohn/SFS/ ).

@ENDNODE

@NODE "Kontakt"


Sie können mich wie folgt erreichen:


... per Post/Telefon:


         _________________________________________________________
        |                                                         |
        |          Senden Sie Bug-Report, Geld, etc. an:          |
        |---------------------------------------------------------|
        |        * SuperView Development & Registration *         |
        |          * DRAFU Development & Registration *           |
        |       * Image Engineer Registration Site Europe *       |
        |                                                         |
        |                                                         |
        |                  PerSuaSiVe SoftWorX                    |
        |                                                         |
        |                  Dipl.-Ing.                             |
        |                  Andreas Kleinert                       |
        |                  Rabenflugstrasse 1                     |
        |                  D-57074 Siegen                         |
        |                  Germany, Europe                        |
        |                                                         |
        |                  +49-271-22869                          |
        |                  (auch FAX + AB)                        |
        |                                                         |
        |                  Werktags nach 18.00 Uhr.               |
        |                                                         |
        |         Sie können eine Nachricht hinterlassen, falls   |
        |         ich nicht erreichbar sein sollte - erwarten     |
        |         Sie allerdings keine Rückrufe nach USA,         |
        |         Australien, ... wegen der HOHEN Gebühren.       |
        |_________________________________________________________|

             neue Anschrift ab 1.11.2002:

                  Montanusstrasse 5, 51065 Köln
                  Tel/Fax: 0221-9681999

... per InterNet:


           Allgemeine PerSuaSiVe SoftWorX WWW Support Site ist

                         http://www.ar-kleinert.de



     Binaries bitte nur nach vorherigem Nachfragen und anschließender
     Bestätigung meinerseits verschicken - mein Postfach ist leider
     nicht unendlich groß.

                  - Usenet >>>   info@ar-kleinert.de
                                 Andreas_Kleinert@gmx.de
                                 Andreas_Kleinert@t-online.de

@ENDNODE

@NODE "Danksagungen"

 Ein Dankeschön geht an (Auflistung nach Vorkommen ;-)
 =====================================================

 - Ingo Jürgensmann     - Thomas Boerkel       - Andreas Mixich
 - Robert Wahnsiedler   - André Laemmer        - Edwin H. Bielawski
 - Matteo Tenca         - Jan Skypala          - Adrian Demarais
 - Ludwig Berndt        - Roger Hâgensen       - Dipl.Phys.Carl-Rudolph Naefe
 - Dr. Rainer M. Herold - Thomas Steinbichler  - Jörn Krüger
 - Bodo Thevissen       - Helge Thorsten Kautz - Thomas Nolte
 - Harry W. Turner II   - A. P. Suggitt        - Mat Bettinson
 - @{i}Vulture@{ui}              - Dr. Greg Perry       - Stephen Bridges
 - Philippe Duchenne    - Jure Dolanec         - Tom Lively
 - Alexander Fichtner   - Magnus Holmgren      - @{i}Max Headroom@{ui}
 - Ian Barclay          - Marc-Tell Volkmann   - Christian Beck
 - Torbjörn Aronsson    - Jürgen Haage         - Michael C. Battilana
 - Milco Veljanoski     - Robert S. Puffer     - Jérôme Lovy
 - Dirk Busse           - Armin H. Pöhlmann    - Karl-Heinz Ostertag
 - Joel Alvim           - Per Jonsson          - Les Morgan
 - Roland Mainz         - Robert C. Reiswig    - Dave Sparks
 - Andreas Kramer       - Guillaume DuFour     - A J Price
 - Michael Schulz       - B & D Kubler         - Christer Oldhoff
 - Arndt Bußmann        - Torsten Moll         - Georg Rottländer
 - Phil Vedovatti       - Burkhard Breuer      - Ulrich Falke
 - Martin Pape          - Sanjo Schiffmann     - Slobodan Todorovic
 - Walter Gierholz      - Petra Struck         - Michael Steinke
 - Bernd Mingers        - Wendell Watanabe     - Dr.-Ing. Heiko Pollmeier
 - Ramiro Garcia        - Heiko Kröhnert       - Edward J. Barcik
 - Alvaro Thompson      - Achim Stegemann      - Bert Bosma
 - Ignazzi Carmelo      - Eike Biel            - Heinz Rohner
 - Frank Dietrich       - Kirk Strauser        - Dirk Hallen
 - Tilo Hanich          - Roman Patzner        - Klaus B. Küsche
 - Jörg Handwerg        - Stefan Michel        - Jochen Rhein
 - David Newman         - Bradley Rogers       - Simo Koivukoski
 - Michael Jaccoud      - Jan Uerpmann         - Achim Akkermann
 - David Gill           - Willi Demuth         - Sander Assenbroek Machielsen
 - John Millington      - Jörg Bierwagen       - S.W. de Vries
 - Hans Eiblmeier       - Yann Muller          - Gerrit-kjeld Dusselje
 - Gernod Schomberg     - Gerald Lorang        - Sebastian Becker
 - Mario Kuchel         - Gérard Cornu         - Martin Mittelbach
 - Karl-Heinz Schulz    - Anders Bolager       - Christian Hunyar
 - Ralf Lillemäe        - Andreas C. Schmidt   - Daniel Kasmeroglu
 - Frank Durban         - Gunnar Schuster      - Thomas Körner
 - Malcolm Harnden      - Christoph Kirsch     - Jukka Anttila-Vatjus
 - Thorsten Marquardt   - Rudy van Merkom      - Tristan R. Young
 - Niko Tomatsidis      - Hans Flüss           - Pierre Radestock
 - Michael Thompson     - Dave Fieldman        - Rolf Schuster
 - Andrew Zalotocky     - Mark Carter          - Thomas Steffens
 - Carsten Knodel       - Emmanuel Rey         - Sven Ottemann
 - Matthias Laskowski   - Ralph Ewers          - Thomas Wiedecke
 - John Jackson         - Robin Hüskes         - Vincent Morenas
 - Neil Bothwick        - Javier Marcet        - Michael Merkel
 - Ralph Ewers          - Steve Krueger        - Jim Cooper
 - Clifford Mould       - Jon Steinar Kvaale   - Jon B. Peterson
 - Oliver Molz          - Klaus Müller         - John Aadnoy
 - Sven Bornkessel      - Arvid Schlesinger    - Armin Klippel
 - Wolfgang Krause      - F. Ruthe             - Alexander Niven-Jenkins
 - Gary Goldberg        - Thomas Birk          - Vincenzo Morra
 - Holger Kruse         - Michael Burkhardt    - Keith Blakemore-Noble
 - Alan Surrette        - Vincenzo Morra       - Ross Kirk
 - Michel Verstraeten   - George Elliott       - Kevin Futter
 - Michael Groni        - Markus Grubinger     - Kimme Utsi
 - Andrew Baldwin       - Otto Carvalho        - Andreas Krüger
 - Gerd Schniggenberg   - Luca Ricossa         - Phillip Wright
 - Frédéric Faux        - Elmar Hoffmann       - Jonas Hultén
 - Johann Samlowski     - Philippe Devilard    - Johan Eriksson
 - Antonio Brianese     - Michael John         - Rune Jensen
 - Jürgen Urbanek       - Mikkel Hald          - Hal Samuelson
 - Norman Caetano       - Per Arne Flø         - Rich Robinson
 - Adam Corrano         - Beth Hedrick         - Casper Thygesen
 - Kai Foelster         - Peter Denomy         - Morten Straarup
 - Thomas Karlsen       - Luca Baldelli        - Leonardo Petrucelli
 - Richard Gore         - Tom Duin             - Dominique Deangili
 - Anders Drejer        - Olivier Pertin       - Colin Keefe
 - Roger Curtis         - Sam Gillies          - Linus Silvander
 - Klaus-Peter Simon    - Whitford Bates       - Laurent Moussy
 - Paul Kieffer         - Yves Liebercier      - S. Lichtendahl
 - Alan Guillevic       - Thomas Lorenz        - Chris Barrow
 - Ed Eden              - Keith Schyler        - Trond K. Tveit
 - Janko Köhler         - Andrew Mills         - Howard Toliver
 - Jon Mines            - Magnus Bouvin        - Dan Muldin
 - Mahieux Pascal       - James Luscombe       - Peter Mattson
 - Martin Ruston        - Kapryan Kennedy      - Coeurjoly Fabien
 - William Eaves        - Cameron Snyder       - Johnny Nielsen
 - Jason Birnie         - Michael Osmolski     - Kevin Fairhurst
 - Peter Annuss         - Larry Urquhart       - Philip Yearbury
 - Neil Bowes           - Steve Hodson         - Johan Rönnblom
 - Harald Schulz        - Christian Schröpfer  - Michael Fedrowitz
 - Denis Zwornarz       - Gert Hubers          - Robert Little
 - Christopher Handley  - Stefano Guidetti     - Jürgen Seubert
 - Paul Korhonen        - Frank Müller         - Peter Kaltstein
 - Peter Theuring       - Gunter Kusserow      - Telemar Rosenberger
 - Phillip Degnan       - John Melville        - Alexandre Kairouannais
 - Chris Dallimore      - Paul Sadlik          - Matthew Sawyer
 - Jeffrey Grzanich     - John Hart            - Ian Tyrell
 - Walt Challender      - Martin Sprenger      - Pekka Sippola
 - Brice Terzaghi       - Adrian Cope          - Frank Böhne
 - Petr Voralek         - Antoine Bordier      - Patrice Dumont
 - Manfred Kern         - Francis Klein        - Dominique Harelle
 - Arnljot Arntsen      - Havard Lunde         - Jürgen Ofner
 - Geoff Tovey          - Herve Sonneville     - Winek Zawada
 - Sascha Ploss         - Paul Lang            - David Gerber
 - Michael Domoney      - Carl Read            - Harald Wuensche
 - Eirik Synnes         - James Harrison       - Mark Shaw
 - Frank Wille          - Adam Suwala          - Winfried Krueger
 - Simon J Glover       - Wolfgang W. Wolber   - Don Cox
 - Henrik Jensen        - Matteo Consolati     - Jürgen Wilschke
 - Stephen Webber       - Clive Dennett-Thorpe - Svein Inge Wik
 - Philippe Reux        - Paul Venton          - Bjarke Vangsgaard
 - Rolf Max Rotvel      - Michael Every        - Jason Ruellan
 - Stefan Fischer       - Roberto Muller       - Michael Thompson
 - Alfred Kendall       - John Orwin           - Rolf Kleiber
 - Kari Kortro          - G. Burdett           - Daniel Westerberg
 - Daniel Stripes       - Scott Konowal        - Steinar Pedersen
 - William Seaton       - Brian Riis           - Antonio Maria Sebastiani
 - Dario Soccoli        - Arno Richter         - Chris Appleton
 - Richard Lane         - Manfred Kern         - Marco van der Laan
 - Christian Sauer      - Rasmus Bothe         - Neil Mallet
 - Andreas Ohlsson      - Mark Vallins         - Paul Compton
 - Craig Peterson       - Gontier Laurent      - Simon Jones
 - Mathias Roslund      - John de Boni         - Maria Pelova
 - Jennifer Symancyk    - David Hibbert        - Bruno Caruso
 - Wolfgang Bauer       - Michael R. Wilson    - Arsi Koutaniemi
 - Arthur Moyer         - Thomas Schaefer      - James Miller
 - Karl-Olav Gravdahl   - @{i}Janifer Lopez@{ui}        - James George
 - Eric Muller          - Ian Argaet           - Mats-Olov Rustad
 - Ian Armstrong        - Philip Vedovatti     - Daniel Plant
 - Klaus-Dieter Klang   - Dirk Pohlmann        - Kevin Hupp
 - Dietbert Leusmann    - Markus Schmidt       - Frank Aisenbrey



  Dank geht auch an:

    - Allen Käufer der SView Productivity Suite von Schatztruhe
    - Dem Cloanto Team, namentlich Michael C. Battilana
    - Gerd Frank für die Übersetzung und Nachbearbeitung zahlreicher Guides
    - Die Mitarbeiter von Phase5, namentlich Ralph Schmidt und Claus Herrmann
    - Die Picture Datatypes V43 Programmierer, namentlich Frank Mariak und Olaf Barthel
    - Die anderen Programmierer von Datatypes, für den Informationsaustausch und
         die hilfreichen Anmerkungen
    - Dutzende von Leuten, an welche ich mich hier leider nicht erinnert habe !


@ENDNODE

@NODE Probs "Datatypes FAQ"

 OS 3.5/3.9 Probleme
 -------------------

  Programme welche das picture.datatype V44 benutzen um ein On-Screen Dithering
  durchzuführen, werden mit dem "Problem" konfrontiert, daß 24 Bit Bilder auch
  bei der Anzeige auf 15/16 Bit Bildschirmen gedithert werden. Bezugnehmend auf das
  OS 3.5 Entwicklerteam, sollte dies in einer "bessern Bild Qualität" resultieren.

  Bei der Analyse dieser Aussage werden einige Bemerken, daß die meißten auf
  PC-Chips basierenden Grafikkarten nur 6 Bit Farbfixierungstabelen
  (LUTs = color lookup tables) erlauben (das ist, 6 Bit für Rot, Grün und
  Blau - dies ist nur ein Wertebereich von 0 - 63 anstatt von 0 - 255), welches
  auch nicht viel besser ist als ein 5:5:5 oder 5:6:5 Wertebereich bei 15/16 Bit
  Vielfarbmodi. Wie auch immer, 16 Bit Vielfarbmodi erlauben 65536 unterschiedliche
  Farben auf dem Bildschirm. Dies ist darin begründet, das eine 6 Bit LUT nur
  256 von 262144 Farben erlaubt.

  Wie auch immer, diese neuen V44 Dithering Optionen können mittels der
  Datatypes Voreinstellungen geändert werden - Die Globalen Einstellungen
  werden dann lokal überschrieben.

 Keine Funktion zum Speichern?
 -----------------------------

  Tut mir leid, aber es wird keine Funktion zum Speichern geben (DTM_WRITE Methode).
  Dies liegt darin begründet, daß ich der Meinung bin, das Datatypes hauptsächlich dafür
  da sind zum Austausch von Daten und nicht um die Arbeit von schon existierenden
  Konvertierungsprogrammen zu erfüllen.

  Um es ein bisschen genauer zu erklären:

  Der Datatype Mechanismun stellt hauptsächlich ein Möglichkeit dar um die
  Art der Implementation und des Datenformats und aller Details zu verstecken.
  Wenn ein Datatype zu viele Möglichkeiten für das Dateiformat der Zieldatei
  bietet, so ist dies - meiner Meinung nach - komplett gegen dieses Konzept.
  Der Optimale Weg um das Datatype Konzept sauber zu halten wird sein, alles
  intern im Amiga eigenen IFF Format zu behandeln - welches z.B. für den
  Austausch von Daten über das Clipboard von Essentieller Bedeutung ist.
  Leider ist IFF-ILBM nicht besonders brauchbar für Farbtiefen größer als
  8 Bit. Vielleicht wird hierfür IFF-RGFX eine gute Wahl sein...


 Ramlib Abstürze
 ---------------

  Wenn Sie "ramlib" Gurus innerhalb eines anderen Programmes
  erhalten sollten, dann installieren Sie doch einmal versuchsweise
  Aminet:util/sys/StackAid.lha


 Warum werden "progressive" Bilder nicht progressiv dargestellt ?
 ----------------------------------------------------------------

  Weil die Programmierschnittstelle (API) des picture.datatype bis V45
  komplett darauf aufbaut, daß Datatypes der Unterklasse "picture"
  komplette Bitmaps zurückgeben.

  Dummerweise können Datatypes nicht: (um nur einige mögliche Lösungsvorschläge zu geben)

   - viele kleine Bitmaps (eine für jede Zeile) verwalten
   - während des Lesens einer Bilddatei die Kontrolle an den
     picture.datatype zurückgeben
   - in eine existierende, vorgebene Bitmap schreiben

  Deshalb gibt es momentan keine Möglichkeit Bilder progressiv darzustellen.


 Unbekannte Datatypes (V43-45)
 -----------------------------

  Wenn Ihr Datatype aufhört zu laufen (unbekanntes Dateiformat), dann
  schieben Sie nicht gleich die Schuld auf mich, sondern prüfen als erstes
  ob Sie nicht eine schon längst veraltete Betaversion des
  picture.datatype V43 benutzen...

  Und versichern Sie sich, daß sie nicht das picdtpatch (v39.2), welches
  aus dem Hypertext.Datatype Archiv von Stefan Ruppert stammt, benutzen.

@ENDNODE

@NODE "Versionsgeschichte"

 Bekannte Fehler: - Einige Leute berichteten in der Vergangenheit über
                    Probleme mit dem Installationsscript. Wenn Sie einen
                    Fehler feststellen können oder Probleme damit haben,
                    so senden Sie eine Nachricht direkt an den Author des
                    Scriptes Robert C. Reiswig <akDatatype@vgr.com>

                  - Bitte benutzen Sie min. die V41.101 der wizard.library.
                    Sie sollten eine Kopie davon in den verschiedenen
                    Demoversionen unter ftp.haage-partner.com finden können

                  - Die Auswahl des Anzeigemodus ist nicht immer 'perfekt'

 Versionsgeschichte
 ==================
 V45.4   (10.10.2002): - Upgrade auf libpng 1.2.5

 V45.3   (13.7.2002):  - Upgrade auf libpng 1.2.4

 V45.2   (2.7.2002):   - Upgrade auf libpng 1.2.3 and zlib 1.1.4

 V45.1   (29.6.2002):  - 68k und Amithlon/UAE-Optimierungen hinzugefügt
                       - PPC-Support entfernt

 V44.131 (15.12.2001): - Upgrade auf libpng 1.2.1rc2

 V44.130 (18.11.2001): - Upgrade auf libpng 1.2.0

 V44.123 (1.9.2001):   - Beschleunigung

 V44.122 (21.8.2001):  - Beschleunigung (Verhalten der unreg. Version geändert)

 V44.121 (21.8.2001):  - Beschleunigung

 V44.120 (21.8.2001):  - History gelöscht

@ENDNODE

@NODE "Bedienung"


  akPNGPrefs
  ----------

  akPNGPrefs ist das Voreinstellungsprogramm für das akPNG.datatype.

  Die Oberfläche wurde mit StormWizard v2.0 entwickelt. Dadurch benötigt dieses Programm
  die "wizard.library" V37+ (welche Sie im AMINET unter "biz/haage/WizardLibrary.lha"
  finden können, oder eventuell sogar eine neuere Version unter ftp.haage-partner.com).

  Das Piktogramm stammt von Bert Bosma <lmb@wxs.nl> (basierend auf NewIcons).

  Ein MUI-Ersatz des Voreinstellungsprogrammes von Alvaro Thompson (das Original)
  und Achim Stegemann (die späteren Versionen) ist nun unter util/dtype/akMUIPrefs.lha
  verfügbar - dort sind außerdem noch einige andere Ersatzprogramme zu finden.

  Die globalen Einstellungen werden unter ENV: (außerdem auch noch unter ENVARC:)
  in einer Voreinstellungsdatei namens "Datatypes/akPNG.prefs" gespeichert.

  Task-spezifische Einstellungen können auch erstellt werden - mittels des
  Voreinstellungsprogramm (welches eine Auswahl des jeweiligen Prozesses
  aus einer Liste ermöglicht, solande dieses zur selben Zeit läuft), oder
  per Hand gemäß dem folgenden Aufbau:


                                 OPTIONAL

  ---------------- Task-Spezifische Einstellungsdateien ---------------

  Voreinstellungen für die verschiedenen aufrufendenen Programme können
  durch das Kopieren der globalen Voreinstellungen ("ENV:Datatypes/akPNG.prefs")
  zu einer Task-Spezifischen Voreinstellungsdatei getätigt werden.

                "ENV:Datatypes/akPNG.prefs_Tasks/TaSkNaMe"

  Wobei "TaSkNaMe" den Namen des Programmes darstellt, welches z.B.
  mittels eines System-Monitors ermittelt werden kann. Dies funktioniert
  sehr gut mit Workbench-Programmen, welche keine Namensteile benötigen,
  wie einige CLI Programme. Als Beispiel "CLI(3):Work:Browsers/XWebber".
  Für z.B. AWeb müssen Sie nur Ihre Datei mit den globalen Voreinstellungen
  ändern und wie folgt vorgehen:

    MakeDir ENV:Datatypes/akPNG.prefs_Tasks

    Copy ENV:Datatypes/akPNG.prefs ENV:Datatypes/akPNG.prefs_Tasks/AWebIP"

     [... und das gleiche für ENVARC: ...]


  Danach wird AWeb die globalen Voreinstellungen ignorieren und seine eigenen
  aus der angegebenen Datei benutzen!

  ---------------------------------------------------------------------



  Sie haben die folgenden Einstellungsmöglichkeiten (rechts die Standardvorgaben):

    V43MODE=(256|24BIT)                                         (24BIT)
    V40_24BIT_MODE=(DITHER_ORDERED|HAM_OUTPUT)                  (DITHER_ORDERED)
    V40_DEPTH=(3..8)                                            (8)
    HAM_MODE=(HAM6|HAM8)                                        (HAM6)
    INTERLEAVED_BM8=(ON|OFF)                                    (ON)
    DISPLAYABLE_BM8=(ONF|OFF)                                   (OFF)
    CUSTOM_MODES                                                ---
    NOASPECT                                                    ---
    DEBUG                                                       ---
    V44_DITHER=(0..2)                                           (1)



   Grundsätzliche Erklärung der Optionen
   =====================================

V43_MODE
--------

  NO_DITHERING:  Bei Benutzung der pic-dt V43 wird eine 24 Bit Ausgabe geliefert
  V40_DITHERING: Bei Benutzung der pic-dt V43 wird in den V40 Modus gewechselt

V40_24BIT_MODE (bei Benutzung des picture datatype V40 oder V43 im V40 Modus)
--------------

  DITHER_ORDERED: Führt ein "ordered dithering" der 24 Bit Daten durch
  HAM_OUTPUT:     Konvertiert die 24 Bit Daten nach HAM6/8

V40_DEPTH
---------

  Wenn eine vorhandene Farbpalette benutzt wird (z.B. wenn der V40 Modus
  eingesetzt wird und Ordered Dithering ausgewählt ist), so wird die Anzahl der
  vorhandenen Farben in der Palette reduziert werden (z.B. auf ECS-Systemen),
  wobei 256 Farben der Standard sind. Gültige Farbtiefen sind 3..8 (welche in
  16..256 Farben resultieren, was einfach mittels der Formel 2^Farbtiefe
  errechnet werden kann).

HAM_MODE (nur mit "HAM_OUTPUT")
--------

  HAM6: Erzeugt HAM6 Ausgabe (max. 4096 verschiedene Farben auf dem Bildschirm)
  HAM8: Erzeugt HAM8 Ausgabe (über 262144 verschiedene Farben auf dem Bildschirm)

    Im HAM8 Modus werden Graustufenbilder mit 256 Graustufen exportiert
    (sieht schlimm aus in HAM6 und AGA-Rechner können nur 256 Graustufen verwalten)

    Beachten Sie bitte, das HAM8 nur bei AGA Maschinen verfügbar ist und dadurch
    Schwierigkeiten mit Grafikkarten erzeugen kann und nicht auf OCS/ECS Amigas
    laufen wird.

    Bei HAM6 und Grafikkarten können auch Probleme auftreten.

INTERLEAVED_BM8
---------------

  ON:  Erzeugt Interleaved Bitmaps mit bis zu 256 Farben
  OFF: Erzeugt normale Bitmaps (BMF_CLEAR und eventuell
       BMF_INTERLEAVED) - Sie sollten für einige Programme
       auf ON wechseln, insbesondere dann wenn dies nicht
       mit diesen Bitmaps umgehen können, oder wenn AllocBitmap()
       gepatcht für Chunky Modi z.B. durch die Grafikkartensoftware
       oder EGSPlus.

DISPLAYABLE_BM8
---------------

  ON:  Erzeugt Anzeigbare Bitmaps mit bis zu 256 Farben
  OFF: Erzeugt normale Bitmaps (BMF_CLEAR und eventuell
       BMF_INTERLEAVED) - Sie sollten für einige Programme
       auf ON wechseln, insbesondere dann wenn diese die vom
       Datatype erzeugten Bitmaps direkt als eine Screen Bitmap
       verwenden wollen. Wenn diese Programme diese Möglichkeit
       bieten, so spart dies einiges an Speicher (für andere Bitmaps).
       Dies ist besonders für Systeme ohne Grafikkarte und wenig
       ChipMem zu empfehlen.

CUSTOM_MODES (versteckte Option)
------------

  Wenn das Schlüsselword CUSTOM_MODES benutzt wird, werden nur Anzeigemodi aus
  dem Standardset erzeugt:

    - LowRes            ( 320x200/256)
    - HighRes           ( 640x200/256)
    - SuperHighRes      (1280x200/256)
    - LowRes Lace       ( 320x400/512)
    - HighRes Lace      ( 640x400/512)
    - SuperHighRes Lace (1280x400/512)

  Wenn CUSTOM_MODES=0x######## (z.B. CUSTOM_MODES=0x00000000) gesetzt
  ist, wird immer die angegebene hexadezimale ID des Anzeigemodus benutzt
  - alternativ dazu kann man den Namen des Anzeigemodus angeben,
  z.B. "CUSTOM_MODES=PAL:HighRes".

  Beachten Sie bitte, daß die Schreibweise hier sehr wichtig ist!

  Die Anzeige im HAM Modus ist nur möglich, wenn der benutzte Anzeigemodus auch
  die Möglichkeit bietet HAM-Grafiken anzuzeigen (dies wird durch ein "ODER'n" der
  Modus-ID mit dem HAM_KEY ermittelt). Wenn dies nicht möglich ist, wird ein anderer
  Anzeigemodus erzeugt.

NOASPECT (versteckte Option)
--------

  Wenn das Berechnen des X/Y Aspekts Fehler erzeugen sollte, z.B. bei PictIcon,
  wird empfohlen diese Option zu benutzen um den 1:1 Aspekt zu erzwingen.

DEBUG (versteckte Option)
-----

  Aktiviert die Ausgabe von Debug-Meldungen, z.B. durch Öffnen eines
  Informationsrequesters in welchem detailierte Angaben über die Bildgröße
  und die Kompression enthalten sind.

  Im 68K Modus wird zusätzlich ein Requester geöffnet, wenn beim Umwandeln des
  Bildes Fehler aufgetreten sind.

  DIESE OPTION IST NOCH NICHT IMPLEMENTIERT!

@ENDNODE
