home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 8 / amigaformatcd08.iso / readerstuff / michele_berionne / photocdaga12.lha / doc / PhotoCDAGA.dok < prev    next >
Text File  |  1995-10-18  |  15KB  |  406 lines
  1.                     PhotoCDAGA 1.2 von Günther Röhrich
  2.                     **********************************
  3.  
  4.  
  5. PhotoCDAGA ist ein Anzeigeprogramm/Konverter für Bilder im PhotoCD Format. Es
  6. basiert auf den Quelltexten zu dem Programm "hpcdtoppm" geschrieben von Hadmut
  7. Danisch. Aus disem Grund muß ich auf seinen Copyright-Vermerk aufmerksam
  8. machen:
  9.  
  10.    hpcdtoppm (Hadmut's pcdtoppm) v0.6
  11.    Copyright (c) 1992, 1993, 1994 by Hadmut Danisch (danisch@ira.uka.de).
  12.    Permission to use and distribute this software and its
  13.    documentation for noncommercial use and without fee is hereby granted,
  14.    provided that the above copyright notice appear in all copies and that
  15.    both that copyright notice and this permission notice appear in
  16.    supporting documentation. It is not allowed to sell this software in 
  17.    any way. This software is not public domain.
  18.  
  19. Diese Auflagen gelten also auch für PhotoCDAGA. Aber keine Angst, Du kannst es
  20. nach Belieben weitergeben oder verändern. Lediglich die kommerzielle Nutzung
  21. oder Vertrieb des Programmes ist nicht gestattet. (Gegen eine Verbreitung auf
  22. CD-ROM wie der Aminet CD dürfte ebenfalls niemand etwas dagegen haben.) Im
  23. Zweifelsfall sollte man direkt bei Hadmut Danisch nachfragen. (Adresse siehe
  24. unten.)
  25.  
  26. Wie schon der Name sagt ist zur Nutzung des Programms ein Amiga mit dem AGA-
  27. Chipsatz erforderlich. Außerdem ein 68020 oder höherer Prozessor, reichlich
  28. Speicher, sowie ein CD-ROM Laufwerk, das auch Photo-CDs lesen kann.
  29. Die Farbanzeige erfolgt im HAM8-Modus, die Graustufenanzeige im 256-Farben-
  30. Modus.
  31.  
  32. Die Vorteile von PhotoCDAGA:
  33.  
  34. - es kostet nichts (der wohl größte Vorteil...)
  35. - vollständiger Quelltext ist verfügbar, kann mit allen C-Compilern auf dem
  36.   Amiga übersetzt werden
  37. - hohe Geschwindigkeit (wurde mit gcc 2.7.0 kompiliert, ein Teil ist direkt
  38.   in Assembler geschrieben)
  39. - hohe Bildqualität bei Verwendung von map-Dateien und des overskip-Modus
  40.   (wahrscheinlich besser als mit allen bisherigen Programmen)
  41. - abspeichern im ppm-Format möglich zur anschließenden Konvertierung in
  42.   andere Bildformate
  43.   (z.B ins IFF-ILBM Format mit ppm2AGA oder nach JPEG mit cjpeg)
  44.   Im NETPBM-Paket sind Konverter für (fast) alle Bildformate vorhanden.
  45.   (Aminet: gfx/pbm)
  46.  
  47. Nachteile (leider):
  48.  
  49. - hoher Speicherverbrauch
  50. - schlechter Komfort (nur Shell-Bedienung)
  51. - keine Unterstützung höherer Auflösungen als Base (512x768)
  52.   (hier muß man auf hpcdtoppm, das Original, zurückgreifen)
  53.  
  54. An dieser Stelle noch ein großes Dankeschön an Hadmut Danisch für sein
  55. Programm hpcdtoppm und den zugehörigen Quelltext. Ohne seine Arbeit gäbe
  56. es auch PhotoCDAGA nicht.
  57.  
  58. Vielen Dank noch an alle die an dem GNU C-Compiler mitgewirkt haben.
  59.  
  60. ***********************************************************************
  61.  
  62. So, nun geht es endlich mit der Anleitung los:
  63.  
  64. Systemvoraussetzungen:
  65.  
  66. Ein Amiga mit viel Speicher und:
  67.  
  68. - AGA Chipsatz
  69. - 68020 oder höheren Prozessor
  70. - OS 3.0 oder höher
  71. - ein CD-ROM Laufwerk zum Lesen der Photo-CDs
  72.  
  73. Im Gegensatz zur Version 1.0 ist die ixemul.library nicht mehr erforderlich
  74. und ein Stapelspeicher (Stack) von 4000 Bytes genügt jetzt auch.
  75.  
  76. ACHTUNG: In der Version 1.2 wird unter Umgehung der Systemroutinen direkt in
  77. den Bildspeicher geschrieben, um die Geschwindigkeit zu erhöhen. Um eine
  78. Anzeige auf Grafikkarten zu ermöglichen muß die Option -orig angegeben werden.
  79. Es werden dann die Systemroutinen wie bei den älteren Versionen von PhotoCDAGA
  80. verwendet.
  81.  
  82. Als Eingabe braucht man noch Bilder im Photo-CD Format. Diese haben die Endung
  83. .PCD und sind auf den Photo-CDs im Verzeichnis PHOTO_CD/IMAGES zu finden.
  84. (Gilt auch für fertig bespielte CD's die eventuell noch PC-Programme enthalten.)
  85. Für die Übersicht (Option -0) ist eine sog. Overview-Datei erforderlich.
  86. (üblicher Dateiname: PHOTO_CD/OVERVIEW.PCD)
  87.  
  88.  
  89. Installation:
  90. *************
  91.  
  92. Die Programme aus dem bin-Verzeichnis können in ein beliebiges Verzeichnis
  93. kopiert werden, sie sollten sich aber im Suchpfad der Shell befinden. 
  94.  
  95. Für die Verwendung des Shell-Skripts PhotoMap muß JPEGTMP: mit einem assign-
  96. Befehl an ein Verzeichnis auf einer Festplatte mit ausreichend Speicherplatz
  97. zugewiesen werden. (z.B. assign JPEGTMP: HD:T) Dieses Verzeichnis wird auch
  98. bei der Erzeugung von map-Dateien für jpegAGA verwendet.
  99. Am Besten schreibt man diesen Befehl in die User-Startup Datei, damit er nach
  100. jedem Neustart ausgeführt wird.
  101.  
  102. Das Shell-Skript PhotoMap muß in das S: Verzeichnis kopiert werden. Es setzt
  103. voraus, daß sich die Programme PhotoCDAGA sowie ppm2AGA im Suchpfad der Shell
  104. befinden und daß ein JPEGTMP: Verzeichnis existiert. Eventuell muß man noch die
  105. Umgebungsvariable MAPDIR setzen, siehe später.
  106.  
  107.  
  108. Der Aufruf geschieht wie folgt:
  109. *******************************
  110.  
  111. PhotoCDAGA PhotoCD-Bildname [ppm-Bildname] Optionen
  112.  
  113.  
  114. PhotoCD-Bildname
  115. ****************
  116.  
  117. Das ist der Name einer Datei im PhotoCD-Format. (bzw. Overview-Datei)
  118. (z.B cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  119. Wenn das Format nicht stimmt dann bekommt man nur Müll angezeigt.
  120.  
  121. Achtung: Manche Bilder enthalten nicht alle Auflösungen. (Wenn die Datei-
  122. länge sehr viel kleiner als 3MB ist) Es kann sein, daß man dann die -x
  123. Option bei der Base-Auflösung nicht verwenden kann.
  124.  
  125.  
  126. ppm-Bildname
  127. ************
  128.  
  129. Name der zu erzeugenden ppm/pgm-Datei. (Nur nötig, wenn die Option -pgm oder
  130. -ppm angegeben wurde.)
  131.  
  132.  
  133. Optionen
  134. ********
  135.  
  136. -b Name
  137.    Dieser Option muß ein Name folgen. Damit wird verhindert, daß bei mehreren
  138.    CDs die gleichen map-Dateien für verschiedene Bilder verwendet werden.
  139.    (s. später) Beim Erzeugen der map-Dateien mit dem Shell-Skript PhotoMap ist
  140.    die gleiche Option dann anzugeben. Diese Option ist nur bei Farbanzeige
  141.    sinnvoll.
  142.  
  143. -x
  144.    Es wird der sog. overskip-Modus verwendet, der zu einer besseren Bild-
  145.    qualität führt. (nur bei Farbdarstellung.) Wird hierbei die Base-Auflösung
  146.    verwendet, dann dauert die Bearbeitung viel länger und es ist sehr viel
  147.    Speicher nötig. (Mit 6MB ist es gerade noch möglich.)
  148.  
  149. -s
  150.    Die Schärfe des Bildes wird erhöht. Man sollte das aber nur bei wirklich
  151.    unscharfen Bildern verwenden, damit man mehr Details erkennen kann.
  152.  
  153. -c
  154.    Das Programm versucht eine eventuelle schwarze Berandung aus dem Bild zu
  155.    entfernen.
  156.  
  157. -n 
  158.    Das Bild wird nicht gedreht. Normalerweise versucht PhotoCDAGA die richtige
  159.    Orientierung selber herauszufinden, (Hoch- oder Querformat) um das Bild
  160.    korrekt anzuzeigen.
  161.  
  162. -r
  163.    Das Bild wird im Uhrzeigersinn gedreht (d.h ins Hochformat gebracht)
  164.  
  165. -l 
  166.    Das Bild wird entgegen dem Uhrzeigersinn gedreht (d.h. ins Hochformat
  167.    gebracht)
  168.  
  169. -h 
  170.    Das Bild wird gekippt.
  171.  
  172. -m
  173.    Alle durchgeführten Schritte bei der Dekodierung werden auf dem Bildschirm
  174.    mitgeteilt.
  175.  
  176. -c-
  177.    Das Bild wird etwas dunkler angezeigt.
  178.  
  179. -c+
  180.    Das Bild wird etwas heller angezeigt.
  181.  
  182. -pgm
  183.  
  184.    Es wird eine pgm-Datei erzeugt. (d.h. 8bit-Graustufen-Format) Als zweiten
  185.    Parameter ist der Dateiname anzugeben.
  186.  
  187. -ppm
  188.    Es wird eine ppm-Datei erzeugt. (d.h. 24bit-Farbe) Als zweiten Parameter ist
  189.    der Dateiname anzugeben.
  190.  
  191. -gray
  192.    Die Anzeige erfolgt im Graustufen-Modus.
  193.  
  194. -vga
  195.    Bei der Anzeige wird der VGA-Bildschirmmodus verwendet. (Auch Multiscan
  196.    genannt.)
  197.  
  198. -orig (neu in Version 1.2)
  199.    Es werden ausschließlich Funktionen des Betriebssystems verwendet, um die
  200.    Grafikdaten in den Bildspeicher zu schreiben. Die Grafikausgabe mit dem AGA
  201.    Chipset wird dadurch langsamer. Diese Option ist nötig wenn die Ausgabe auf
  202.    einer Grafikkarte erfolgen soll.
  203.   
  204. -0 n  (neu in Version 1.1)
  205.    Es wird eine Übersicht (16 Bilder) erzeugt, beginnend mit dem n-ten Bild.
  206.    Bei Graustufenanzeige (Option -gray) werden zusätzlich noch die jeweiligen
  207.    Bildnummern angezeigt. Die Eingabedatei muß eine sog. Overview-Datei sein.
  208.    (üblicherweise PHOTO_CD/OVERVIEW.PCD)
  209.  
  210. -1
  211.    Es wird die Base/16-Auflösung (128x192) angezeigt.
  212.  
  213. -2
  214.    Es wird die Base/4-Auflösung (256x348) angezeigt.
  215.  
  216. -3 
  217.    Es wird die Base-Auflösung (512x768) angezeigt.
  218.    (Das ist die Voreinstellung.)
  219.  
  220.  
  221.  
  222. Ein vorzeitiger Abbruch ist mit CTRL-C möglich. Wird bereits ein Bild angezeigt,
  223. dann muß man die rechte Maustaste drücken. Der Bildschirm hat eine (unsichtbare)
  224. Ziehleiste sowie Vordergrund/Hintergrund Schalter, die voll funktionsfähig sind.
  225. Dank der Autoscroll-Eigenschaft wird der Bildschirm automatisch verschoben, wenn
  226. man mit dem Mauszeiger den Rand erreicht.
  227.  
  228. Will man ein PhotoCD-Bild in das normale IFF-ILBM Format umwandeln, dann muß man
  229. als erstes eine ppm-Datei erzeugen und anschließend ppm2AGA aufrufen. Näheres
  230. steht in der zugehörigen Anleitung.
  231.  
  232.  
  233. Erzeugung der map-Dateien
  234. *************************
  235.  
  236. Diese Dateien sind unbedingt erforderlich, damit die Anzeige in der best-
  237. möglichen Qualität erfolgt. Sie werden im Normalfall durch das Shell-Skript
  238. PhotoMap erzeugt, so daß man sich nicht um die Details kümmern muß.
  239. Der Aufruf lautet:
  240.  
  241.  PhotoMap PhotoCD-Datei [-b BaseName]
  242.  
  243. Bei erfolgreicher Ausführung wird eine map-Datei mit korrektem Namen erzeugt.
  244. (auch auf PC-Dateisystemen) Man kann auch mehrere Dateien mit einem Aufruf er-
  245. zeugen. So werden z.B. durch den Befehl
  246.  
  247.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  248.  
  249. alle Bilder auf einer PhotoCD bearbeitet.
  250.  
  251. Falls es nicht möglich ist, die map-Datei an der gleichen Stelle wie das Bild
  252. abzuspeichern, (das ist bei CD-ROMs immer der Fall) dann wird die map-Datei in
  253. dem Verzeichnis abgelegt, auf das die Umgebungsvariable MAPDIR weist. PhotoCDAGA
  254. wird sie dann ebenfalls dort suchen.
  255. Das Setzen der Umgebungsvariablen kann z.B. erfolgen mit dem Befehl:
  256.  
  257.  setenv MAPDIR HD:tempdir
  258.  
  259. Die Variable geht dann allerdings nach einem Zurücksetzen des Rechners verlo-
  260. ren. Man kann sie dauerhaft sichern mit dem Befehl:
  261.  
  262.  copy ENV:MAPDIR ENVARC:
  263.  
  264.  
  265. ACHTUNG: Auf keinen Fall darf man diselbe map-Datei für mehrere verschiedene
  266. Bilder verwenden, das führt zu einer Verschlechterung der Qualität. Wenn man
  267. mehrere PhotoCD's hat, dann sollte man unbedingt mit der Option -b einen ver-
  268. schiedenen Basisnamen für jede CD angeben. Die Option ist für das Skript
  269. PhotoMap und für PhotoCDAGA anzugeben.
  270.  
  271. Wenn man z.B. eine CD mit Bilder aus Australien hat, dann erzeugt man die map-
  272. Dateien mit dem Befehl: 
  273.  
  274.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australien
  275.  
  276. (Die Umgebungsvariable MAPDIR muß auch gesetzt sein!)
  277.  
  278. Anschließend kann man die Bilder anschauen mit:
  279.  
  280.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australien
  281.  
  282. (Wenn genügend Speicher vorhanden ist sollte man noch -x angeben.)
  283.  
  284.  
  285. Nun kommen wie üblich vorab ein paar Fragen und Antworten:
  286. **********************************************************
  287.  
  288. (das erspart mir später die Arbeit)
  289.  
  290. F: Ich habe 6MB Speicher, aber ich kann die Optione -x in der Base-Auflösung
  291.    wegen Speichermangel nicht einsetzen.
  292.  
  293. A: Das ist gut möglich. Es empfiehlt sich, den Rechner ohne die Startup-Sequence
  294.    zu booten (d.h. man kommt direkt in die Shell) und es von dort aus zu
  295.    versuchen. (nur für Freaks...) Einige Tips:
  296.     - setpatch aufrufen
  297.     - das CD-ROM Laufwerk anmelden mit z.B. mount CD:
  298.     - assign ENV: RAM:, setenv MAPDIR xxx eingeben
  299.     - nun müßte es gehen
  300.     (eventuell vorher noch den Multiscan-Monitortreiber starten)
  301.  
  302.  
  303. F: Ich habe ein CD-ROM Laufwerk x, den Kontroller y und das Dateisystem z,
  304.    warum kann ich die Photo-CDs nicht lesen ?
  305.  
  306. A: Das weiß ich leider auch nicht. Es empfiehlt sich auf jeden Fall, es mit
  307.    dem frei erhältlichen AmiCDROM-Dateisystem noch zu versuchen.
  308.  
  309.  
  310. F: Manchmal erfolgt die Anzeige langsamer, als ich es gewohnt bin.
  311.  
  312. A: Wenn das Fast-RAM knapp bzw. zu sehr fragmentiert ist, dann wird für die
  313.    Pufferspeicher das Chip-RAM verwendet, was zu einer Verlangsamung führt. Zum  
  314.    Defragmentieren muß ein Reset durchgeführt werden. (Oder mehr Speicher
  315.    kaufen.)
  316.  
  317.  
  318. Bei sonstigen Fehlern/Wünsche/Verbesserungsvorschläge bitte ich darum, mich
  319. zu benachrichtigen. Und nicht vergessen: Bei Fehlerbeschreibungen immer die
  320. verwendete Konfiguration angeben. (wie unten)
  321.  
  322. Getestete Konfiguration: (meine)
  323.  
  324. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  325. Prozesor: 68EC030/25MHz, Koprozessor: 68882/32MHz
  326.  
  327. CD-ROM Laufwerk: Mitsumi FX 001 D
  328. Kontroller: Tandem CD+IDE
  329. Filesysteme: TandemCacheCDFS 54.1 (12.05.95), AmiCDROM
  330.  
  331.  
  332. Entstehungsgeschichte
  333. *********************
  334.  
  335. 1.0 - 20. November 1994
  336.  
  337.     - erste veröffentlichte Version
  338.  
  339. 1.1 - 11. April 1995
  340.  
  341.     - die ixemul.library wird nicht mehr benötigt
  342.     - ein Stack von 4000 Bytes reicht jetzt aus
  343.     - eine kleine Änderung im HAM-Kodierer bewirkt, daß bei einem seitlichen
  344.       Verschieben des Bildes die Störungen am linken Rand sehr viel kleiner
  345.       werden
  346.     - besseres und schnelleres Öffnen des Bildschirms
  347.     - 16-Bilder-Übersicht hinzugefügt (Option -0 n)
  348.  
  349. 1.2 - 17. Oktober 1995
  350.  
  351.     - kompiliert mit gcc 2.7.0 und libnix 1.0
  352.     - es wird jetzt eine eigene, schnellere "Chunky to Planar" Routine
  353.       verwendet, dadurch wird der Bildaufbau wesentlich schneller
  354.     - mit der Option -orig werden wieder die Funktionen des Betriebssystems
  355.       verwendet werden
  356.     - in der 16-Bilder-Übersicht wird immer der "topaz 8" Zeichensatz
  357.       verwendet (wegen besserer Lesbarkeit)   
  358.  
  359.  
  360. Aufruf
  361. ******
  362.  
  363. Wie Du sicher gemerkt hast bietet das Programm bislang nicht sehr viel, es gibt
  364. noch viel zu tun. Meine Zeit ist leider begrenzt. (Ich studiere derzeit Elektro-
  365. technik an der Uni Stuttgart und habe neben der Computerei noch andere Hobbies.)
  366. Aus diesem Grund suche ich weitere Programmierer die bereit sind, mit mir zu-
  367. sammenzuarbeiten sowie Beta-Tester für die fertigen Programme. Wenn Du mitma-
  368. chen willst dann melde dich bitte. Es würde mich außerdem interessieren, was
  369. sonst noch an Optionen und Verbesserungen des Programms erwünscht ist. Die
  370. Übersichtsfunktion ist ja noch ziehmlich primitiv, da läßt sich noch viel
  371. machen.
  372.  
  373. Alle Zuschriften/Geschenke/Fehlerberichte/Vorschläge usw. sind an die folgenden
  374. Adressen zu schicken:
  375.  
  376.   Elektronische Post:                               Normale Post:
  377.   *******************                               *************
  378.  
  379.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  380.      (Internet EMAIL)                               Lerchenbergstr. 4
  381.                                                     D-73733 Esslingen
  382.  
  383.  
  384. Ich habe jetzt auch eigene WWW-Seiten eingerichtet. Sie sind zu finden unter:
  385.  
  386.  http://rpool1.rus.uni-stuttgart.de/~etk10325
  387.  
  388. Falls Du innerhalb von drei Wochen keine Antwort auf eine EMAIL bekommst
  389. so versuche es über die normale Post noch einmal.
  390.  
  391.  
  392. Hier noch die Adresse von Hadmut Danisch, auf dessen Quelltexten dieses
  393. Programm aufbaut.
  394.  
  395. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  396. E.I.S.S.  (European Institute for System Security)
  397. Universitaet Karlsruhe
  398. Am Fasanengarten 5
  399.  
  400. D-76128 Karlsruhe  
  401.  
  402. Germany
  403.  
  404. FAX: +49 721 696893
  405. Tel./FAX privat: +49 721 607306  (will change in future)
  406.