home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CDRom / PHOTOC12.LZX / doc / PhotoCDAGA.doc next >
Encoding:
Text File  |  1995-10-18  |  10.8 KB  |  345 lines
  1.                     PhotoCDAGA 1.2 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.7.0, 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. NOTE: Starting with this version PhotoCDAGA uses its own chunky to planar
  68. routines for faster screen rendering. If you want to use a gfx card you have
  69. to set the -orig option.
  70.  
  71. As input to the program you need some pictures in the PhotoCD format. They have
  72. the ending .PCD and can be found in the directory PHOTO_CD/IMAGES on Photo-CD's.
  73. For the overview (option -0) you need an overview file. (PHOTO_CD/OVERVIEW.PCD)
  74.  
  75.  
  76. Installation
  77. ************
  78.  
  79. Copy the programs from the bin directory anywhere into your shell's search
  80. path. 
  81.  
  82. For using the shell script PhotoMap you have to assign JPEGTMP: to a directory
  83. on your hard disk with enough free space. (e.g. assign JPEGTMP: HD:T) This is
  84. also needed to create map-files for the program jpegAGA.
  85. The best solution is to add this command to the user-startup file.
  86.  
  87. The shell script PhotoMap should be copied to the S: directory. It assumes that
  88. the programs PhotoCDAGA and ppm2AGA are available in the shell's search path and
  89. the JPEGTMP: directory exists. You may also need to set the MAPDIR environment
  90. variable, see later.
  91.  
  92.  
  93.  
  94. Invoking PhotoCDAGA:
  95. ********************
  96.  
  97. PhotoCDAGA PhotoCD-file [ppm-file] options
  98.  
  99.  
  100. PhotoCD-file
  101. ************
  102.  
  103. This should be a file in the PhotoCD format. (or overview file)
  104. (e.g. cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  105. If the format is wrong you will see garbage on the screen.
  106.  
  107. Note: Some pictures don't contain all resolutions. (If the file length is much
  108. shorter than 3MB.) It is possible that you will not be able to use the -x
  109. option for Base resolution in this case.
  110.  
  111.  
  112. ppm-file
  113. ********
  114.  
  115. This is the name of the ppm/pgm file that should be created. (Only needed when
  116. the -ppm or -pgm option is specified.)
  117.  
  118.  
  119. Options
  120. *******
  121.  
  122. -b Name
  123.    When using this option you must specify a name. This is needed to prevent
  124.    PhotoCDAGA from using the same map-file for different pictures if you have
  125.    more than one PhotoCD's. (see later) When creating map-files with the shell
  126.    script you have to set the same option.
  127.    This is only useful for color display.
  128.  
  129. -x
  130.    Use the overskip mode, this improves the color quality. If you are using the
  131.    Base resolution decoding will take much longer and will use much more
  132.    memory. (6MB is the absolute minimum, you have to boot with no Startup-
  133.    Sequence in that case.)
  134.    This option is not applicable for grayscale display/conversion.
  135.  
  136. -s
  137.    Make the picture sharper. Using this with a blurred picture it allows you to
  138.    detect more details in it.
  139.  
  140. -c
  141.    The program tries to cut off the black frame that sometimes appears at the
  142.    image borders.
  143.  
  144. -n
  145.    Don't rotate the picture. Normally PhotoCDAGA tries to find out the correct
  146.    orientation (portrait or landscape) and rotates the picture accordingly.
  147.  
  148. -r
  149.    Rotate the picture clockwise for portrait format.
  150.  
  151. -l
  152.    Rotate the picture counter-clockwise for portrait format.
  153.  
  154. -h
  155.    Flip the image horizontally.
  156.  
  157. -m
  158.    Write messages about the phase of decoding.
  159.  
  160. -c-
  161.    Darken the image.
  162.  
  163. -c+
  164.    Brighten the image.
  165.  
  166. -pgm
  167.    Create a pgm file. (8bit-grayscale) You have to specify a filename as
  168.    second option.
  169.  
  170. -ppm
  171.    Create a ppm file. (24bit-color) You have to specify a filename as second
  172.    option.
  173.  
  174. -gray
  175.    Show picture in grayscale mode.
  176.  
  177. -vga
  178.    Use the VGA (multiscan) screen mode for display.
  179.  
  180. -orig (new in version 1.2)
  181.    Use original system routines for screen rendering. This option is needed if
  182.    you want to use a gfx card. Don't set this option if you are using the AGA
  183.    chipset because it will get slower.
  184.  
  185. -0 n (new in version 1.1)
  186.    Create a 16-pictures-overview, starting with picture n. In grayscale
  187.    mode (option -gray) the numbers of the pictures will also be displayed.
  188.    The input file must be an overview file. (e.g. PHOTO_CD/OVERVIEW.PCD)
  189.  
  190. -1
  191.    Use the Base/16 resolution. (128x192)
  192.  
  193. -2
  194.    Use the Base/4 resolution. (256x348)
  195.  
  196. -3
  197.    Use the Base resolution. (512x768) (default)
  198.  
  199.  
  200. You can stop decoding by pressing CTRL-C. If the screen is already opened press
  201. the right mouse button to stop. The screen has an invisible but full functional
  202. drag bar and depth gadget. It also has the autoscroll feature.
  203.  
  204. If you want to have a normal IFF-ILBM file you have to create a ppm-file
  205. first and use the program ppm2AGA to convert. See the corresponding documen-
  206. tation for more.
  207.  
  208.  
  209. Creating the map-files
  210. **********************
  211.  
  212. These files are needed for showing pictures with best possible quality.
  213. Normally, they are created by the shell-script PhotoMap. You don't have to
  214. care about the details.
  215. Usage:
  216.  
  217.  PhotoMap PhotoCD-file [-b BaseName]
  218.  
  219. After succesfull completion a map-file with the correct name will be created.
  220. (On PC-filesystems too) You can process several pictures with a single invo-
  221. cation. The command
  222.  
  223.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  224.  
  225. will create, for example, a map-file for all pictures on a Photo-CD.
  226. If it is not possible to store the map-file at the same location as the picture
  227. itself (this is true for all CD-ROM's) then it will be stored in the directory
  228. pointed to by the environment variable MAPDIR. PhotoCDAGA will then also try to
  229. find the map-file in that place. You can set the environment variable e.g. with
  230. the command:
  231.  
  232.  setenv MAPDIR HD:tempdir
  233.  
  234. If you reset your machine the variable will get lost. To prevent this you can
  235. use the command:
  236.  
  237.  copy ENV:MAPDIR ENVARC:
  238.  
  239.  
  240. NOTE: Don't use the same map-file for different pictures, this will make the
  241. quality worse. If you have more than one Photo-CD you should use the -b option
  242. and specify a different base name for each CD. You must use the same option
  243. with the shell script and PhotoCDAGA itself.
  244.  
  245. If you have for example a PhotoCD with pictures from Australia then you can
  246. create the map-files with the command:
  247.  
  248.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australia
  249.  
  250. (Of course, the environment variable MAPDIR also must be set.)
  251.  
  252. Then you can look at the pictures e.g. with the command:
  253.  
  254.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australia
  255.  
  256. (If you have enough memory you can also use the -x option.)
  257.  
  258.  
  259.  
  260. If you have any comments/suggestions/bug reports then please contact me. Don't
  261. forget to mention your configuration for bug reports. (look below for an
  262. example)
  263.  
  264.  
  265. Tested configuration: (mine)
  266.  
  267. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  268. Processor: 68EC030/25MHz, Coprocessor: 68882/32MHz
  269.  
  270. CD-ROM drive: Mitsumi FX 001 D
  271. Controller: Tandem CD+IDE
  272. Filesystem: TandemCacheCDFS, AmiCDROM
  273.  
  274.  
  275. History
  276. *******
  277.  
  278. 1.0 - 20-November-1994
  279.  
  280.     - first public release
  281.  
  282. 1.1 - 11-April-1995
  283.  
  284.     - ixemul.library is not needed any more
  285.     - a stack size of 4000 bytes is enough
  286.     - when moving the picture screen around the errors at the left border
  287.       will be much smaller
  288.     - better and faster screen opening
  289.     - added 16-pictures-overview (option -0 n)
  290.  
  291. 1.2 - 18-October-1995
  292.  
  293.     - compiled with gcc 2.7.0 and libnix 1.0
  294.     - a fast chunky to planar routine is used for screen rendering, this makes
  295.       the display much faster
  296.     - added -orig option to use system functions for screen rendering
  297.     - the 16-pictures-overview will always use the "topaz 8" font
  298.       (gives better readability)
  299.  
  300.  
  301. Announcement
  302. ************
  303.  
  304. The actual version of this program does not offer very much. My spare time
  305. is very limited because I am now studying Electrical Engineering at the Uni-
  306. versity Stuttgart. Therefore I am searching for other developers to cooperate
  307. with me and beta-testers for testing purposes. If you want to join in then
  308. please contact me. I am also interested to hear what other features you would
  309. like to have. The overview needs lot of improvements, for example.
  310.  
  311.  
  312. All messages/gifts/etc. should be sent to the following addresses:
  313.  
  314.  
  315.   electronic mail:                                  normal mail:
  316.   ****************                                  ************
  317.  
  318.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  319.      (Internet EMAIL)                               Lerchenbergstr. 4
  320.                                                     73733 Esslingen
  321.                                                         Germany
  322.  
  323.  
  324. You may also visit my personal WWW pages at:
  325.  
  326.  http://rpool1.rus.uni-stuttgart.de/~etk10325
  327.  
  328. If you don't get an answer to an EMAIL within 3 weeks then try it again
  329. with normal mail. (Normally I answer EMAIL's within 4 days.)
  330.  
  331.  
  332. Here comes the address of Hadmut Danisch:
  333.  
  334. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  335. E.I.S.S.  (European Institute for System Security)
  336. Universitaet Karlsruhe
  337. Am Fasanengarten 5
  338.  
  339. D-76128 Karlsruhe  
  340.  
  341. Germany
  342.  
  343. FAX: +49 721 696893
  344. Tel./FAX privat: +49 721 607306  (will change in future)
  345.