home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CDRom / fotocd11.lha / doc / PhotoCDAGA.doc next >
Encoding:
Text File  |  1995-04-12  |  10.0 KB  |  323 lines
  1.                     PhotoCDAGA 1.1 by Günther Röhrich
  2.                     *********************************
  3.  
  4.  
  5. PhotoCDAGA is a viewer/converter for pictures in the PhotoCD format. It is
  6. based on the sources of the program "hpcdtoppm" written by Hadmut Danisch.
  7. For this reason you have to observe his copyright notice:
  8.  
  9.    hpcdtoppm (Hadmut's pcdtoppm) v0.6
  10.    Copyright (c) 1992, 1993, 1994 by Hadmut Danisch (danisch@ira.uka.de).
  11.    Permission to use and distribute this software and its
  12.    documentation for noncommercial use and without fee is hereby granted,
  13.    provided that the above copyright notice appear in all copies and that
  14.    both that copyright notice and this permission notice appear in
  15.    supporting documentation. It is not allowed to sell this software in 
  16.    any way. This software is not public domain.
  17.  
  18. All these terms do also apply to PhotoCDAGA. If you have more questions about
  19. legal issues then contact me or Hadmut Danisch. (you can find his address at
  20. the end of this doc)
  21.  
  22. Advantages of PhotoCDAGA:
  23.  
  24. - it does not cost you anything
  25. - complete source code is included, it can be compiled with all C compilers on
  26.   the Amiga
  27. - high speed (it is compiled with gcc 2.6.3, a part of it is written directly
  28.   in assembly language)
  29. - high picture quality gained by using the overskip mode and map-files
  30.   (probably better than with all other programs)
  31. - saving in ppm-format is possible to allow conversion into other picture
  32.   formats
  33.   (e.g. to IFF-ILBM with ppm2AGA or to JPEG with cjpeg)
  34.   In the NETPBM package you can find converters for almost all formats.
  35.   (Aminet: gfx/pbm)
  36.  
  37. Disadvantages: (sorry)
  38.  
  39. - needs lot of memory
  40. - not very comfortable (shell command)
  41. - resolutions higher than Base (512x768) are not supported
  42.   (you have to use hpcdtoppm, the original, in this case)
  43.  
  44.  
  45. Many thanks to Hadmut Danisch for writing hpcdtoppm and releasing the source
  46. code to the public. Without his program PhotoCDAGA would not exist.
  47.  
  48. Also many thanks to all who have contributed to the GNU C compiler.
  49.  
  50. *************************************************************************
  51.  
  52. Now I should start with the real documentation:
  53.  
  54.  
  55. System requirements:
  56.  
  57. An Amiga with lot of (virtual) memory and:
  58.  
  59. - AGA chipset
  60. - 68020 or higher processor
  61. - OS 3.0 or higher
  62. - a CD-ROM drive capable of reading Photo-CD's
  63.  
  64. Starting with this release the ixemul.library is not needed any more and a
  65. stack size of 4000 bytes is enough.
  66.  
  67. As input to the program you need some pictures in the PhotoCD format. They have
  68. the ending .PCD and can be found in the directory PHOTO_CD/IMAGES on Photo-CD's.
  69. For the overview (option -0) you need an overview file. (PHOTO_CD/OVERVIEW.PCD)
  70.  
  71.  
  72. Installation
  73. ************
  74.  
  75. Copy the programs from the bin directory anywhere into your shell's search
  76. path. 
  77.  
  78. For using the shell script PhotoMap you have to assign JPEGTMP: to a directory
  79. on your hard disk with enough free space. (e.g. assign JPEGTMP: HD:T) This is
  80. also needed to create map-files for the program jpegAGA.
  81. The best solution is to add this command to the user-startup file.
  82.  
  83. The shell script PhotoMap should be copied to the S: directory. It assumes that
  84. the programs PhotoCDAGA and ppm2AGA are available in the shell's search path and
  85. the JPEGTMP: directory exists. You may also need to set the MAPDIR environment
  86. variable, see later.
  87.  
  88.  
  89.  
  90. Invoking PhotoCDAGA:
  91. ********************
  92.  
  93. PhotoCDAGA PhotoCD-file [ppm-file] options
  94.  
  95.  
  96. PhotoCD-file
  97. ************
  98.  
  99. This should be a file in the PhotoCD format. (or overview file)
  100. (e.g. cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  101. If the format is wrong you will see garbage on the screen.
  102.  
  103. Note: Some pictures don't contain all resolutions. (If the file length is much
  104. shorter than 3MB.) It is possible that you will not be able to use the -x
  105. option for Base resolution in this case.
  106.  
  107.  
  108. ppm-file
  109. ********
  110.  
  111. This is the name of the ppm/pgm file that should be created. (Only needed when
  112. the -ppm or -pgm option is specified.)
  113.  
  114.  
  115. Options
  116. *******
  117.  
  118. -b Name
  119.    When using this option you must specify a name. This is needed to prevent
  120.    PhotoCDAGA from using the same map-file for different pictures if you have
  121.    more than one PhotoCD's. (see later) When creating map-files with the shell
  122.    script you have to set the same option.
  123.    This is only useful for color display.
  124.  
  125. -x
  126.    Use the overskip mode, this improves the color quality. If you are using the
  127.    Base resolution decoding will take much longer and will use much more
  128.    memory. (6MB is the absolute minimum, you have to boot with no Startup-
  129.    Sequence in that case.)
  130.    This option is not applicable for grayscale display/conversion.
  131.  
  132. -s
  133.    Make the picture sharper. Using this with a blurred picture it allows you to
  134.    detect more details in it.
  135.  
  136. -c
  137.    The program tries to cut off the black frame that sometimes appears at the
  138.    image borders.
  139.  
  140. -n
  141.    Don't rotate the picture. Normally PhotoCDAGA tries to find out the correct
  142.    orientation (portrait or landscape) and rotates the picture accordingly.
  143.  
  144. -r
  145.    Rotate the picture clockwise for portrait format.
  146.  
  147. -l
  148.    Rotate the picture counter-clockwise for portrait format.
  149.  
  150. -h
  151.    Flip the image horizontally.
  152.  
  153. -m
  154.    Write messages about the phase of decoding.
  155.  
  156. -c-
  157.    Darken the image.
  158.  
  159. -c+
  160.    Brighten the image.
  161.  
  162. -pgm
  163.    Create a pgm file. (8bit-grayscale) You have to specify a filename as
  164.    second option.
  165.  
  166. -ppm
  167.    Create a ppm file. (24bit-color) You have to specify a filename as second
  168.    option.
  169.  
  170. -gray
  171.    Show picture in grayscale mode.
  172.  
  173. -vga
  174.    Use the VGA (multiscan) screen mode for display.
  175.  
  176. -0 n (new in version 1.1)
  177.    Create a 16-pictures-overview, starting with picture n. In grayscale
  178.    mode (option -gray) the numbers of the pictures will also be displayed.
  179.    The input file must be an overview file. (e.g. PHOTO_CD/OVERVIEW.PCD)
  180.  
  181. -1
  182.    Use the Base/16 resolution. (128x192)
  183.  
  184. -2
  185.    Use the Base/4 resolution. (256x348)
  186.  
  187. -3
  188.    Use the Base resolution. (512x768) (default)
  189.  
  190.  
  191. You can stop decoding by pressing CTRL-C. If the screen is already opened press
  192. the right mouse button to stop. The screen has an invisible but full functional
  193. drag bar and depth gadget. It also has the autoscroll feature.
  194.  
  195. If you want to have a normal IFF-ILBM file you have to create a ppm-file
  196. first and use the program ppm2AGA to convert. See the corresponding documen-
  197. tation for more.
  198.  
  199.  
  200. Creating the map-files
  201. **********************
  202.  
  203. These files are needed for showing pictures with best possible quality.
  204. Normally, they are created by the shell-script PhotoMap. You don't have to
  205. care about the details.
  206. Usage:
  207.  
  208.  PhotoMap PhotoCD-file [-b BaseName]
  209.  
  210. After succesfull completion a map-file with the correct name will be created.
  211. (On PC-filesystems too) You can process several pictures with a single invo-
  212. cation. The command
  213.  
  214.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  215.  
  216. will create, for example, a map-file for all pictures on a Photo-CD.
  217. If it is not possible to store the map-file at the same location as the picture
  218. itself (this is true for all CD-ROM's) then it will be stored in the directory
  219. pointed to by the environment variable MAPDIR. PhotoCDAGA will then also try to
  220. find the map-file in that place. You can set the environment variable e.g. with
  221. the command:
  222.  
  223.  setenv MAPDIR HD:tempdir
  224.  
  225. If you reset your machine the variable will get lost. To prevent this you can
  226. use the command:
  227.  
  228.  copy ENV:MAPDIR ENVARC:
  229.  
  230.  
  231. NOTE: Don't use the same map-file for different pictures, this will make the
  232. quality worse. If you have more than one Photo-CD you should use the -b option
  233. and specify a different base name for each CD. You must use the same option
  234. with the shell script and PhotoCDAGA itself.
  235.  
  236. If you have for example a PhotoCD with pictures from Australia then you can
  237. create the map-files with the command:
  238.  
  239.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australia
  240.  
  241. (Of course, the environment variable MAPDIR also must be set.)
  242.  
  243. Then you can look at the pictures e.g. with the command:
  244.  
  245.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australia
  246.  
  247. (If you have enough memory you can also use the -x option.)
  248.  
  249.  
  250.  
  251. If you have any comments/suggestions/bug reports then please contact me. Don't
  252. forget to mention your configuration for bug reports. (look below for an
  253. example)
  254.  
  255.  
  256. Tested configuration: (mine)
  257.  
  258. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  259. Processor: 68EC030/25MHz, Coprocessor: 68882/32MHz
  260.  
  261. CD-ROM drive: Mitsumi FX 001 D
  262. Controller: Tandem CD+IDE
  263. Filesystem: TandemCacheCDFS, AmiCDROM
  264.  
  265.  
  266. History
  267. *******
  268.  
  269. 1.0 - 20-November-1994
  270.  
  271.     - first public release
  272.  
  273. 1.1 - 11-April-1995
  274.  
  275.     - ixemul.library is not needed any more
  276.     - a stack size of 4000 bytes is enough
  277.     - when moving the picture screen around the errors at the left border
  278.       will be much smaller
  279.     - better and faster screen opening
  280.     - added 16-pictures-overview (option -0 n)
  281.  
  282.  
  283. Announcement
  284. ************
  285.  
  286. The actual version of this program does not offer very much. My spare time
  287. is very limited because I am now studying Electrical Engineering at the Uni-
  288. versity Stuttgart. Therefore I am searching for other developers to cooperate
  289. with me and beta-testers for testing purposes. If you want to join in then
  290. please contact me. I am also interested to hear what other features you would
  291. like to have. The overview needs lot of improvements, for example.
  292.  
  293.  
  294. All messages/gifts/etc. should be sent to the following addresses:
  295.  
  296.  
  297.   electronic mail:                                  normal mail:
  298.   ****************                                  ************
  299.  
  300.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  301.      (Internet EMAIL)                               Lerchenbergstr. 4
  302.                                                     73733 Esslingen
  303.                                                         Germany
  304.  
  305.  
  306. If you don't get an answer to an EMAIL within 3 weeks then try it again
  307. with normal mail. (Normally I answer EMAIL's within 4 days.)
  308.  
  309.  
  310. Here comes the address of Hadmut Danisch:
  311.  
  312. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  313. E.I.S.S.  (European Institute for System Security)
  314. Universitaet Karlsruhe
  315. Am Fasanengarten 5
  316.  
  317. D-76128 Karlsruhe  
  318.  
  319. Germany
  320.  
  321. FAX: +49 721 696893
  322. Tel./FAX privat: +49 721 607306  (will change in future)
  323.