home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CDRom / fotocd11.lha / doc / PhotoCDAGA.dok < prev    next >
Encoding:
Text File  |  1995-04-12  |  12.9 KB  |  372 lines
  1.                     PhotoCDAGA 1.1 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.6.3 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. Als Eingabe braucht man noch Bilder im Photo-CD Format. Diese haben die Endung
  77. .PCD und sind auf den Photo-CDs im Verzeichnis PHOTO_CD/IMAGES zu finden.
  78. (Gilt auch für fertig bespielte CDs die eventuell noch PC-Programme enthalten.)
  79. Für die Übersicht (Option -0) ist eine sog. Overview-Datei erforderlich.
  80. (üblicher Dateiname: PHOTO_CD/OVERVIEW.PCD)
  81.  
  82.  
  83. Installation:
  84. *************
  85.  
  86. Die Programme aus dem bin-Verzeichnis können in ein beliebiges Verzeichnis
  87. kopiert werden, sie sollten sich aber im Suchpfad der Shell befinden. 
  88.  
  89. Für die Verwendung des Shell-Skripts PhotoMap muß JPEGTMP: mit einem assign-
  90. Befehl an ein Verzeichnis auf einer Festplatte mit ausreichend Speicherplatz
  91. zugewiesen werden. (z.B. assign JPEGTMP: HD:T) Dieses Verzeichnis wird auch
  92. bei der Erzeugung von map-Dateien für jpegAGA verwendet.
  93. Am Besten schreibt man diesen Befehl in die User-Startup Datei damit er nach
  94. jedem Neustart ausgeführt wird.
  95.  
  96. Das Shell-Skript PhotoMap muß in das S: Verzeichnis kopiert werden. Es setzt
  97. voraus daß sich die Programme PhotoCDAGA sowie ppm2AGA im Suchpfad der Shell
  98. befinden und daß ein JPEGTMP: Verzeichnis existiert. Eventuell muß man noch die
  99. Umgebungsvariable MAPDIR setzen, siehe später.
  100.  
  101.  
  102. Der Aufruf geschieht wie folgt:
  103. *******************************
  104.  
  105. PhotoCDAGA PhotoCD-Bildname [ppm-Bildname] Optionen
  106.  
  107.  
  108. PhotoCD-Bildname
  109. ****************
  110.  
  111. Das ist der Name einer Datei im PhotoCD-Format. (bzw. Overview-Datei)
  112. (z.B cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  113. Wenn das Format nicht stimmt dann bekommt man nur Müll angezeigt.
  114.  
  115. Achtung: Manche Bilder enthalten nicht alle Auflösungen. (Wenn die Datei-
  116. länge sehr viel kleiner als 3MB ist) Es kann sein daß man dann die -x
  117. Option bei der Base-Auflösung nicht verwenden kann.
  118.  
  119.  
  120. ppm-Bildname
  121. ************
  122.  
  123. Name der zu erzeugenden ppm/pgm-Datei. (Nur nötig wenn die Option -pgm oder
  124. -ppm angegeben wurde.)
  125.  
  126.  
  127. Optionen
  128. ********
  129.  
  130. -b Name
  131.    Dieser Option muß ein Name folgen. Damit wird verhindert daß bei mehreren
  132.    CDs die gleichen map-Dateien für verschiedene Bilder verwendet werden.
  133.    (s. später) Beim Erzeugen der map-Dateien mit dem Shell-Skript PhotoMap ist
  134.    die gleiche Option dann anzugeben. Diese Option ist nur bei Farbanzeige
  135.    sinnvoll.
  136.  
  137. -x
  138.    Es wird der sog. overskip-Modus verwendet, der zu einer besseren Bild-
  139.    qualität führt. (nur bei Farbdarstellung.) Wird hierbei die Base-Auflösung
  140.    verwendet dann dauert die Bearbeitung viel länger und es ist sehr viel
  141.    Speicher nötig. (Mit 6MB ist es gerade noch möglich.)
  142.  
  143. -s
  144.    Die Schärfe des Bildes wird erhöht. Man sollte das aber nur bei wirklich
  145.    unscharfen Bildern einsetzen damit man mehr Details erkennen kann.
  146.  
  147. -c
  148.    Das Programm versucht eine eventuelle schwarze Berandung aus dem Bild zu
  149.    entfernen.
  150.  
  151. -n 
  152.    Das Bild wird nicht gedreht. Normalerweise versucht PhotoCDAGA die richtige
  153.    Orientierung selber herauszufinden (Hoch- oder Querformat) um das Bild
  154.    korrekt anzuzeigen.
  155.  
  156. -r
  157.    Das Bild wird im Uhrzeigersinn gedreht (d.h ins Hochformat gebracht)
  158.  
  159. -l 
  160.    Das Bild wird entgegen dem Uhrzeigersinn gedreht (d.h. ins Hochformat
  161.    gebracht)
  162.  
  163. -h 
  164.    Das Bild wird gekippt.
  165.  
  166. -m
  167.    Alle durchgeführten Schritte bei der Dekodierung werden auf dem Bildschirm
  168.    mitgeteilt.
  169.  
  170. -c-
  171.    Das Bild wird etwas dunkler angezeigt.
  172.  
  173. -c+
  174.    Das Bild wird etwas heller angezeigt.
  175.  
  176. -pgm
  177.  
  178.    Es wird eine pgm-Datei erzeugt. (d.h. 8bit-Graustufen-Format) Als zweiten
  179.    Parameter ist der Dateiname anzugeben.
  180.  
  181. -ppm
  182.    Es wird eine ppm-Datei erzeugt. (d.h. 24bit-Farbe) Als zweiten Parameter ist
  183.    der Dateiname anzugeben.
  184.  
  185. -gray
  186.    Die Anzeige erfolgt im Graustufen-Modus.
  187.  
  188. -vga
  189.    Bei der Anzeige wird der VGA-Bildschirmmodus verwendet. (Auch Multiscan
  190.    genannt.)
  191.  
  192. -0 n  (neu in Version 1.1)
  193.    Es wird eine Übersicht (16 Bilder) erzeugt, beginnend mit dem n-ten Bild.
  194.    Bei Graustufenanzeige (Option -gray) werden zusätzlich noch die jeweiligen
  195.    Bildnummern angezeigt. Die Eingabedatei muß eine sog. Overview-Datei sein.
  196.    (üblicherweise PHOTO_CD/OVERVIEW.PCD)
  197.  
  198. -1
  199.    Es wird die Base/16-Auflösung (128x192) angezeigt.
  200.  
  201. -2
  202.    Es wird die Base/4-Auflösung (256x348) angezeigt.
  203.  
  204. -3 
  205.    Es wird die Base-Auflösung (512x768) angezeigt.
  206.    (Das ist die Voreinstellung.)
  207.  
  208.  
  209.  
  210. Ein vorzeitiger Abbruch ist mit CTRL-C möglich. Wird bereits ein Bild angezeigt
  211. dann muß man die rechte Maustaste drücken. Der Bildschirm hat eine (unsichtbare)
  212. Ziehleiste sowie Vordergrund/Hintergrund Schalter, die voll funktionsfähig sind.
  213. Dank der Autoscroll-Eigenschaft wird der Bildschirm automatisch verschoben wenn
  214. man mit dem Mauszeiger den Rand erreicht.
  215.  
  216. Will man ein PhotoCD-Bild in das normale IFF-ILBM Format umwandeln dann muß man
  217. als erstes eine ppm-Datei erzeugen und anschließend ppm2AGA aufrufen. Näheres
  218. steht in der zugehörigen Anleitung.
  219.  
  220.  
  221. Erzeugung der map-Dateien
  222. *************************
  223.  
  224. Diese Dateien sind unbedingt erforderlich damit die Anzeige in der best-
  225. möglichen Qualität erfolgt. Sie werden im Normalfall durch das Shell-Skript
  226. PhotoMap erzeugt, so daß man sich nicht um die Details kümmern muß.
  227. Der Aufruf lautet:
  228.  
  229.  PhotoMap PhotoCD-Datei [-b BaseName]
  230.  
  231. Bei erfolgreicher Ausführung wird eine map-Datei mit korrektem Namen erzeugt.
  232. (auch auf PC-Dateisystemen) Man kann auch mehrere Dateien mit einem Aufruf er-
  233. zeugen. So werden z.B. durch den Befehl
  234.  
  235.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  236.  
  237. alle Bilder auf einer PhotoCD bearbeitet.
  238.  
  239. Falls es nicht möglich ist, die map-Datei an der gleichen Stelle wie das Bild
  240. abzuspeichern (das ist bei CD-ROMs immer der Fall) dann wird die map-Datei in
  241. dem Verzeichnis abgelegt, auf das die Umgebungsvariable MAPDIR weist. PhotoCDAGA
  242. wird sie dann ebenfalls dort suchen.
  243. Das Setzen der Umgebungsvariablen kann z.B. erfolgen mit dem Befehl:
  244.  
  245.  setenv MAPDIR HD:tempdir
  246.  
  247. Die Variable geht dann allerdings nach einem Zurücksetzen des Rechners verlo-
  248. ren. Man kann sie dauerhaft sichern mit dem Befehl:
  249.  
  250.  copy ENV:MAPDIR ENVARC:
  251.  
  252.  
  253. ACHTUNG: Auf keinen Fall darf man diselbe map-Datei für mehrere verschiedene
  254. Bilder verwenden, das führt zu einer Verschlechterung der Qualität. Wenn man
  255. mehrere PhotoCD's hat dann sollte man unbedingt mit der Option -b einen ver-
  256. schiedenen Basisnamen für jede CD angeben. Die Option ist für das Skript
  257. PhotoMap und für PhotoCDAGA anzugeben.
  258.  
  259. Wenn man z.B. eine CD mit Bilder aus Australien hat dann erzeugt man die map-
  260. Dateien mit dem Befehl: 
  261.  
  262.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australien
  263.  
  264. (Die Umgebungsvariable MAPDIR muß auch gesetzt sein!)
  265.  
  266. Anschließend kann man die Bilder anschauen mit:
  267.  
  268.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australien
  269.  
  270. (Wenn genügend Speicher vorhanden ist sollte man noch -x angeben.)
  271.  
  272.  
  273. Nun kommen wie üblich vorab ein paar Fragen und Antworten:
  274. **********************************************************
  275.  
  276. (das erspart mir später die Arbeit)
  277.  
  278. F: Ich habe 6MB Speicher aber ich kann die Optione -x in der Base-Auflösung
  279.    wegen Speichermangel nicht einsetzen.
  280.  
  281. A: Das ist gut möglich. Es empfiehlt sich, den Rechner ohne die Startup-Sequence
  282.    zu booten (d.h. man kommt direkt in die Shell) und es von dort aus zu
  283.    versuchen. (nur für Freaks...) Einige Tips:
  284.     - setpatch aufrufen
  285.     - das CD-ROM Laufwerk anmelden mit z.B. mount CD:
  286.     - assign ENV: RAM:, setenv MAPDIR xxx eingeben
  287.     - nun müßte es gehen
  288.     (eventuell vorher noch den Multiscan-Monitortreiber starten)
  289.  
  290.  
  291. F: Ich habe ein CD-ROM Laufwerk x und den Kontroller y, warum kann ich die
  292.    Photo-CDs nicht lesen ?
  293.  
  294. A: Das weiß ich leider auch nicht. Es empfiehlt sich auf jeden Fall, es mit
  295.    dem frei erhältlichen AmiCDROM-Dateisystem noch zu versuchen.
  296.  
  297.  
  298. Bei sonstigen Fehlern/Wünsche/Verbesserungsvorschläge bitte ich darum, mich
  299. zu benachrichtigen. Und nicht vergessen: Bei Fehlerbeschreibungen immer die
  300. verwendete Konfiguration angeben. (wie unten)
  301.  
  302. Getestete Konfiguration: (meine)
  303.  
  304. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  305. Prozesor: 68EC030/25MHz, Koprozessor: 68882/32MHz
  306.  
  307. CD-ROM Laufwerk: Mitsumi FX 001 D
  308. Kontroller: Tandem CD+IDE
  309. Filesysteme: TandemCacheCDFS, AmiCDROM
  310.  
  311.  
  312. Entstehungsgeschichte
  313. *********************
  314.  
  315. 1.0 - 20. November 1994
  316.  
  317.     - erste veröffentlichte Version
  318.  
  319. 1.1 - 11. April 1995
  320.  
  321.     - die ixemul.library wird nicht mehr benötigt
  322.     - ein Stack von 4000 Bytes reicht jetzt aus
  323.     - eine kleine Änderung im HAM-Kodierer bewirkt, daß bei einem seitlichen
  324.       Verschieben des Bildes die Störungen am linken Rand sehr viel kleiner
  325.       werden
  326.     - besseres und schnelleres Öffnen des Bildschirms
  327.     - 16-Bilder-Übersicht hinzugefügt (Option -0 n)
  328.  
  329.  
  330. Aufruf
  331. ******
  332.  
  333. Wie Du sicher gemerkt hast bietet das Programm bislang nicht sehr viel, es gibt
  334. noch viel zu tun. Meine Zeit ist leider begrenzt. (Ich studiere derzeit Elektro-
  335. technik an der Uni Stuttgart und habe neben der Computerei noch andere Hobbies.)
  336. Aus diesem Grund suche ich weitere Programmierer die bereit sind, mit mir zu-
  337. sammenzuarbeiten sowie Beta-Tester für die fertigen Programme. Wenn Du mitma-
  338. chen willst dann melde dich bitte. Es würde mich außerdem interessieren, was
  339. sonst noch an Optionen und Verbesserungen des Programms erwünscht ist. Die
  340. Übersichtsfunktion ist ja noch ziehmlich primitiv, da läßt sich noch viel
  341. machen.
  342.  
  343. Alle Zuschriften/Geschenke/Fehlerberichte/Vorschläge usw. sind an die folgenden
  344. Adressen zu schicken:
  345.  
  346.   Elektronische Post:                               Normale Post:
  347.   *******************                               *************
  348.  
  349.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  350.      (Internet EMAIL)                               Lerchenbergstr. 4
  351.                                                     D-73733 Esslingen
  352.  
  353.  
  354. Falls Du innerhalb von drei Wochen keine Antwort auf eine EMAIL bekommst
  355. so versuche es über die normale Post noch einmal.
  356.  
  357.  
  358. Hier noch die Adresse von Hadmut Danisch, auf dessen Quelltexten dieses
  359. Programm aufbaut.
  360.  
  361. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  362. E.I.S.S.  (European Institute for System Security)
  363. Universitaet Karlsruhe
  364. Am Fasanengarten 5
  365.  
  366. D-76128 Karlsruhe  
  367.  
  368. Germany
  369.  
  370. FAX: +49 721 696893
  371. Tel./FAX privat: +49 721 607306  (will change in future)
  372.