home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gfx / jpegaga-1.0.lha / jpegAGA-1.0 / doc / ppm2AGA.dok < prev   
Text File  |  1994-06-04  |  20KB  |  498 lines
  1.  
  2.                          ppm2AGA 1.3 von Günther Röhrich
  3.                          *******************************
  4.  
  5. ACHTUNG: Am Schluß dieser Datei ist diesmal meine korrekte EMAIL-Adresse zu
  6. finden. (Die Adresse aus der 1.0 - Version war leider falsch.)
  7.  
  8. ppm2AGA ist ein Programm zur qualitativ hochwertigen Umwandlung des ppm-Bild-
  9. formats (sowie auch pgm und pbm) in das IFF-ILBM-Format. Besitzer eines
  10. AGA-Amigas können nun hochwertige Bilder für ihren Rechner erzeugen ohne viel
  11. Geld für ein kommerzielles Bildbearbeitungsprogramm ausgeben zu müssen. Zusammen
  12. mit dem NETPBM-Paket ist die Umwandlung (fast) jedes beliebigen Bildformats
  13. möglich sowie einige elementaren Bildbearbeitungen.
  14.  
  15. Die Vorteile von ppm2AGA:
  16. - sehr gute Bildqualität im HAM8-Modus 
  17.   (besser als bei einigen kommerziellen Programmen)
  18. - Bearbeitung beliebig großer Bilder auch mit wenig Arbeitsspeicher möglich
  19.   (das Bild darf sogar größer sein als der Arbeitsspeicher des Amiga)
  20. - Abspeichern ins Klemmbrett (Clipboard) möglich
  21. - Unterstützung von Farbpaletten mit voller 24 Bit Farbinformation
  22. - Quelltext ist dabei
  23. - läuft auf allen Amiga-Modellen mit allen Prozessoren (auch KS 1.2/1.3
  24.   sofern die iffparse.library V37 vorhanden ist)
  25. - Anzeige des Bildes während der Berechnung möglich
  26.  
  27. Bevor ich mit der Anleitung anfange muß ich aber noch folgendes loswerden;
  28.  
  29. Dieses Programm ist Freeware (d.h. man braucht nichts zu bezahlen), bei seiner
  30. Verbreitung bitte ich die folgenden Hinweise zu beachten:
  31.  
  32. Einige Programmteile entstammen dem NETPBM-Paket und sind somit
  33. Copyright (C) 1989, 1991 by Jef Poskanzer. Sie wurden zum Teil stark geändert.
  34.  
  35. Dies ist jedoch im Sinne des Autors. Zur Erfüllung all seiner Forderungen
  36. habe ich noch seinen Urheberrechts-Hinweis in die Anleitung mit aufgenommen: 
  37.  
  38. Permission to use, copy, modify, and distribute this software and its
  39. documentation for any purpose and without fee is hereby granted, provided
  40. that the above copyright notice appear in all copies and that both that
  41. copyright notice and this permission notice appear in supporting
  42. documentation.  This software is provided "as is" without express or
  43. implied warranty.
  44.  
  45. Selbstverständlich ist jegliche Veränderung oder Weiterverbreitung von ppm2AGA
  46. sowie des Quelltextes nur unter der oben aufgeführten Bedingung zulässig.
  47. Die Dateien im Verzeichnis "Developer" unterliegen nicht dieser Auflage da sie
  48. vollständig von mir entwickelt wurden, es gibt daher keinerlei Einschränkungen
  49. für ihre Nutzung.
  50.  
  51. Bedanken möchte ich mich noch bei folgenden Personen:
  52. (In Klammer ist die Internet-EMAIL Adresse angegeben, wo die betreffende
  53. Person (hoffentlich) zu erreichen ist.)
  54.  
  55. Jef Poskanzer (jef@well.sf.ca.us)
  56.  für die Entwicklung des PPM-Formats und der zugehörigen Software
  57.  
  58. Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de):
  59.  für die AMIGA-spezifischen Sachen von NETPBM und "ppmtoilbm.c"
  60.  
  61. Johan Widen (jw@jwdata.se):
  62.  für die chunky->planar Umwandlungsroutine aus "ppmtoilbm.c"
  63.  
  64. Paul Heckbert:
  65.  auf dessen Artikel in "SIGGRAPH '82 Proceedings", S. 297 die
  66.  Farbauswahl-Routine aus "ppmquant.c" beruht
  67.  
  68. The Independent JPEG Group (jpeg-info@uunet.uu.net):
  69.  für den Quelltext zum Umwandeln des JPEG-Bildformats
  70.  
  71. ***********************************************************************
  72.  
  73. So, nun sollte ich mal zum Wesentlichen kommen.
  74.  
  75. Das Programm liegt in zwei Versionen vor:
  76.  
  77. ppm2AGA.000 für 68000 und 68010 Prozessor, läuft auch auf allen anderen
  78. ppm2AGA.020 für 68020 oder höhere Prozessoren
  79.  
  80. Da ich keinen Rechner mit 68000-Prozessor habe weiß ich nicht ob das 
  81. Programm dort läuft. Als Betriebssystem genügt OS 1.3, es wird jedoch die
  82. iffparse.library V36 oder höher benötigt. (Die Version 37 ist auf der
  83. Workbench 2.0 Diskette vorhanden und läuft auch unter KS 1.2/1.3)
  84.  
  85. Die Programme mit der Endung .gcc wurden mit GNU-C 2.5.8 übersetzt und
  86. sind daher sehr viel schneller. Man benötigt aber die ixemul.library im
  87. LIBS: Verzeichnis.
  88.  
  89.  
  90.  
  91. Der Aufruf von ppm2AGA geschieht wie folgt:
  92.  
  93.   ppm2AGA Eingabedatei Ausgabedatei Optionen
  94.  
  95.  
  96. Eingabedatei:
  97. *************
  98.  
  99. Die Datei, die gelesen werden soll. Unterstützt werden die Dateiformate:
  100. PPM - volle Farbinformation, jeder Bildpunkt kann eine von ca. 16 Millionen
  101.       Farben annehmen, 24 Bit pro Pixel 
  102. PGM - nur Graustufen, 8 Bit pro Pixel 
  103. PBM - nur Schwarz-Weiß, 1 Bit pro Pixel
  104. Es werden sowohl das Binär- als auch das Textformat akzeptiert. Nähere 
  105. Informationen sind im NETPBM-Paket zu finden.
  106. Wenn die Datei nicht komplett in den Speicher geladen wird dann darf sie
  107. sich nicht auf einem PIPE-Device befinden da sie dann mehrfach gelesen werden
  108. muß.
  109.  
  110.  
  111. Ausgabedatei:
  112. *************
  113.  
  114. Die Datei, die erzeugt werden soll. Es wird stets eine Datei im IFF-ILBM-Format
  115. erzeugt. Der zu verwendende Modus wird über die Optionen eingestellt.
  116. Wenn kein Modus angegeben ist dann wird stets der HAM8-Modus verwendet, da 
  117. dieser in den meisten Fällen die beste Bildqualität ergibt.
  118. Das Setzen der HIRES- und LACE-Optionen geschieht automatisch je nach der Größe
  119. des Bildes.
  120. Wenn als Name der Ausgabedatei -cn angegeben wird dann wird die Datei im Klemm-
  121. brett (Clipboard) mit der Unit-Nummer n abgelegt. Für n sollte man normalerweise
  122. eine 0 angeben. Mit dem Befehl "MultiView CLIPBOARD" kann man z.B. das Bild dann
  123. anzeigen. Bei anderen Programmen muß in der Regel die "Paste"- bzw. "Einfügen"-
  124. Funktion in der Menüleiste angewählt werden um das Bild zu laden.
  125.  
  126.  
  127. Optionen:
  128. *********
  129.  
  130. Die Optionen dürfen in beliebiger Reihenfolge stehen, die Groß- und Klein-
  131. schreibung ist beliebig. Werden Optionen weggelassen dann werden interne
  132. Vorgabewerte angenommen. 
  133.  
  134.  
  135.  
  136. -HAM8:
  137.  
  138. Es wird der HAM8-Modus verwendet. Das erzeugte Bild kann daher max. 262144 ver-
  139. schiedene Farben haben. Mit der Option -2 werden zwei Durchgänge verwendet um
  140. die Qualität etwas zu steigern. Eine Anzeige des Bildes ist nur auf AGA-Rech-
  141. nern möglich.
  142.  
  143.  
  144. -HAM6:
  145.  
  146. Es wird der HAM6-Modus verwendet. Dieser Modus ist jedoch nur der Voll-
  147. ständigkeit halber enthalten, entsprechend sind dann auch die Ergebnisse.
  148. Dieser Modus kann mit der Option -FS kombiniert werden. Mit der Option -2
  149. werden zwei Durchgänge verwendet um die Qualität etwas zu steigern.
  150.  
  151.  
  152. -CMAPn
  153.  
  154. Es wird der Farbpalettenmodus mit n Bitebenen verwendet. Dies bedeutet daß
  155. im umgewandelten Bild nur höchstens 2^n verschiedene Farben auftreten können.
  156. Die Auswahl dieser Farben geschieht jedoch aus einer Anzahl von ca. 16 Millionen
  157. und orientiert sich nach der Häufigkeit des Auftretens im Originalbild.
  158.  
  159. Bei der Anzeige der Bilder auf einem ECS/OCS-Rechner wird das Bild daher
  160. verfälscht da diese nur eine Auswahl aus 4096 Farben erlauben. 
  161.  
  162. Eine Verfälschung auf einem AGA-Rechner ist auch möglich wenn ein zu alter
  163. IFF-Anzeiger verwendet wird.
  164.  
  165. Hier nun die Zuordnung zwischen n und der Zahl der Farben der Palette:
  166.  
  167. Bitebenen   Farben
  168. ---------   ------
  169.    1           2
  170.    2           4
  171.    3           8
  172.    4          16
  173.    5          32
  174.    6          64 (Anzeige nur auf AGA-Rechner oder mit Grafikkarten möglich)
  175.    7         128 (Anzeige nur auf AGA-Rechner oder mit Grafikkarten möglich)
  176.    8         256 (Anzeige nur auf AGA-Rechner oder mit Grafikkarten möglich)
  177.  
  178. Die Kombination mit der Option -FS ist möglich.
  179.  
  180.  
  181. -E
  182.  
  183. (Nur sinnvoll in Zusammenhang mit der Option -CMAPn)
  184. Diese Option ist anzugeben wenn bekannt ist daß die ppm-Datei nur wenige Farben
  185. enthält und bei der Bildung der Häufigkeitsverteilung keine Probleme zu erwarten
  186. sind. (dies ist z.B. der Fall wenn die ppm-Datei aus einem GIF-Bild herrührt,
  187. das bekanntlich höchstens 256 Farben haben kann.) Werden mehr als 10000 Farben
  188. gefunden so beginnt die Rechenarbeit von vorne, es werden dann mehrere Farben
  189. zu einer einzigen zusammengefaßt. (Für eine Häufigkeitsverteilung ohne Ver-
  190. minderung des Farbraums wären theoretisch bis zu 32 Megabyte an Arbeitsspeicher
  191. erforderlich!) 
  192. Bei Bildern im pgm-Format ist diese Option automatisch aktiviert, da diese
  193. höchstens 256 Graustufen enthalten können.
  194.  
  195.  
  196. -FS
  197.  
  198. Es wird ein sog. Dithern nach Floyd-Steinberg durchgeführt. Hierbei werden
  199. absichtlich Wandlungsfehler in das Bild eingebaut, die aber von weitem
  200. betrachtet eine Verbesserung des Bildes ergeben. Verbessert werden insbesonders
  201. Farbverläufe, die im HAM6 und im Farbpalet