home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gfx / jpegaga-1.0.lha / jpegAGA-1.0 / jpegAGA.doc < prev    next >
Text File  |  1994-06-05  |  9KB  |  272 lines
  1.  
  2.                          jpegAGA 1.0 by Günther Röhrich
  3.                          ******************************
  4.  
  5.  
  6. jpegAGA is, at this time, the highest quality JPEG viewer (if a map-file for
  7. that picture is available) To use it you need the AGA chipset, a 68020 or
  8. higher processor and OS 3.0 or higher. This program uses the HAM8-mode, gray-
  9. scale display will use 256-color-mode.
  10.  
  11. If a precomputed colormap (a file with the ending .map) is available then
  12. the picture will be displayed in a much higher quality compared to other
  13. viewers.
  14. With the supplied shell script you can create such map-files for all your
  15. pictures. These files will only be 198 bytes long.
  16.  
  17. If a map-file is not available then you will get a lower quality display. For
  18. grayscale display this file is not needed.
  19.  
  20. The advantages of jpegAGA:
  21. - very high quality (better than any other viewer)
  22. - complete source is available
  23. - best compatibility to all JPEG pictures because the unmodified JPEG source
  24.   from the Independent JPEG group is used for decoding
  25.   (I have not changed even a single line.)
  26. - high speed gained by using the GNU C compiler and the 24-bit-RGB to HAM8 con-
  27.   verter written directly in assembly language
  28. - support for grayscale JPEG's and for showing color pictures in grayscale
  29.   format
  30.  
  31.  
  32. This program and the supplied source is Public Domain, you can do what you want
  33. with it. For the JPEG-source please read the file README.
  34.  
  35.  
  36.  
  37. I have to thank the following persons/groups:
  38.  
  39. The Independent JPEG Group (jpeg-info@uunet.uu.net):
  40.  for the source to decode/encode the JPEG picture format
  41.  
  42. Free Software Foundation, Inc. and all contributors for the GNU C compiler
  43. and related tools
  44.  
  45. ***********************************************************************
  46.  
  47.  
  48. Now let's go on with the real documentation:
  49.  
  50.  
  51. Installation
  52. ************
  53.  
  54. Copy the programs from the bin directory anywhere into your shell's search
  55. path. The file name extensions are showing for what processors they are com-
  56. piled. After installation you should remove these extensions.
  57.  
  58.  
  59. Extension 000:  68000 and 68010 processors, runs on all others too
  60. Extension 020:  68020 or higher processors
  61.  
  62. All programs are compiled with GNU C 2.5.8 and need therefore the file 
  63. ixemul.library in the LIBS: directory.
  64.  
  65. For using the shell script CreateMap you have to assign JPEGTMP: to a directory
  66. on your hard disk with enough free space. (e.g. assign JPEGTMP: HD:T) The pro-
  67. grams djpeg and cjpeg will eventually need this directory too.
  68. The best solution is to add this command to the user-startup file.
  69.  
  70. The shell script CreateMap should be copied to the S: directory. It assumes that
  71. the programs djpeg and ppm2AGA are available (with exactly these names) in the
  72. shell's search path and the JPEGTMP: directory exists.
  73.  
  74.  
  75.  
  76. Invoking jpegAGA:
  77.  
  78.   jpegAGA inputfile options
  79.  
  80.  
  81. Inputfile
  82. *********
  83.  
  84. The name of the JPEG-file that should be read. If the picture is in grayscale
  85. format it will be shown on a 256 colors screen without extensive computations.
  86. Unfortunately there are also grayscale pictures encoded in color mode. You
  87. should use the -GRAY option for such pictures.
  88. When showing the picture in color mode the map-file for this picture will be
  89. used if it is available. The map-file must have the same name as the picture
  90. with the additional ending .map. To support the PC-filesystem it will also
  91. accept a name that has the extension replaced by ".map".
  92. If a map-file is found this will be notified in the console window.
  93.  
  94. Examples for file names:
  95.  
  96. picture file: picture.jpeg    map-file: picture.jpeg.map  or  picture.map
  97.               pic1.jpg        map-file: pic1.jpg.map      or  pic1.map
  98.  
  99.  
  100. Options
  101. *******
  102.  
  103. All options are case-insensitive. If they are not set then internal default
  104. values will be used.
  105.  
  106.  
  107. -GRAY
  108.  
  109. Display picture in grayscale mode.
  110.  
  111.  
  112.  
  113. -BS
  114.  
  115. Use block-smoothing. You should set this option when the image has been
  116. encoded at a very low quality setting. Without this option you can see multi-
  117. ple blocks with a nearly constant color in the picture. When this option is
  118. set the borders of these blocks will be smoothed.
  119. You should use this option only for such cases.
  120.  
  121.  
  122.  
  123. -VGA
  124.  
  125. The picture will always use the VGA screenmode (also called 'multiscan') for
  126. display. Use this option when you know that the picture was intended for
  127. displaying on a PC or other machines with quadratic screen resolution.
  128. (this is the case for most JPEG-pictures)
  129.  
  130. NOTE: With 'quadratic' I don't mean that the screen has the same number of
  131. pixels in horizontal and vertical direction. (e.g. 1024x1024)
  132. I mean that a square composed of e.g. 100x100 pixels will be shown as a
  133. square on the screen. Because a usual picture tube has a ratio of 4 to 3
  134. the screen's resolution must be a multiple of that. (e.g. 640x480 because
  135.  
  136.  640   4
  137.  --- = - )
  138.  480   3
  139.  
  140.  
  141.  
  142. There is also a JPEG decompression program included. It converts JPEG
  143. pictures to the ppm format. (It is also needed for creating the map-files.)
  144. To use it enter:
  145.  
  146.  djpeg inputfile outputfile
  147.  
  148. In some cases djpeg will try to store temporary files to JPEGTMP:, you
  149. have then to assign this directory to somewhere on your hard disk.
  150. (for example assign JPEGTMP: HD:T)
  151. For more informations read the included documentation.
  152. With the program cjpeg you can create your own JPEG files.
  153.  
  154.  
  155.  
  156. Creating the map-files
  157. **********************
  158.  
  159. These files are needed for showing color picture with best possible quality.
  160. Normally, they are created by the shell-script CreateMap.
  161. Usage:
  162.  
  163.  CreateMap picturefile
  164.  
  165. After succesfull completion a map-file with the correct name will be created.
  166. (On PC-filesystems too) You can process several pictures with a single invo-
  167. cation. The command
  168.  
  169.  SPat CreateMap pictures/#?.jpg
  170.  
  171. will create, for example, a map-file for all pictures with the extension .jpg
  172. in the directory pictures.
  173.  
  174.  
  175. If problems occur please check the following:
  176.  
  177. - Have you installed everything as it is described in the section
  178.   "Installation" ?
  179.  
  180.   The files djpeg and ppm2AGA are needed under these names in the search path.
  181.   ixemul.library must exist in the LIBS: directory an the shell-script itself
  182.   must be in the S: directory.
  183.  
  184.   attention: - ppm2AGA must have version 1.3 or higher
  185.              - use djpeg from this distribution only
  186.  
  187.  
  188. - Have you assigned the directory JPEGTMP: correctly ?
  189.  
  190.  
  191. - Has the hard disk partion enough free space ?
  192.  
  193.  
  194. - Is enough memory available ?
  195.  
  196.   If not you can reduce memory usage by using the -M0 option with the shell
  197.   script. (See the documentation for ppm2AGA for more.)
  198.  
  199.   example: CreateMap pic.jpg -M0 or SPat CreateMap #?.jpg -M0
  200.  
  201.  
  202. - Is the disk, on which the JPEG-picture is stored, write enabled and does it
  203.   has enough free space ?
  204.  
  205.  
  206. You can interrupt the shell-script at any time by pressing CTRL-C. In this case
  207. all temporary files in the directory JPEGTMP: will be removed automatically.
  208.  
  209.  
  210.  
  211. The picture screen
  212. ******************
  213.  
  214. You can move it around with the mouse. It also has an invisible, but full
  215. functional drag bar and depth gadget.
  216. Pressing the right mouse button will close the screen.
  217.  
  218.  
  219.  
  220.  
  221. If you have additional questions, suggestions for enhancements, bug reports,
  222. Mungwall/Enforcer hits, etc. then please contact me. It would also be nice
  223. to send me a corrected version of this manual. (and for ppm2AGA too)
  224.  
  225.  
  226.  
  227. History
  228. *******
  229.  
  230. 1.0 - 4-June-1994
  231.  
  232.     - first public release
  233.  
  234.  
  235.  
  236. Announcement
  237. ************
  238.  
  239. The actual version of this program does not offer very much. My spare time
  240. is very limited because I am now studying Electrical Engineering at the Uni-
  241. versity Stuttgart. Therefore I am searching for other developers to cooperate
  242. with me and beta-testers for testing purposes. If you want to join in then
  243. please contact me. I will then create a detailed description of the source.
  244.  
  245. To recompile ppm2AGA you need the newiff package from Commodore.
  246. V37 is available on Fish-disk 705, V39 on the "3.1 Amiga Developer Update"
  247. disks and on Aminet. 
  248.  
  249.  
  250.  
  251.  
  252. To contact me write to:
  253.  
  254.   electronic mail:                                  normal mail:
  255.   ****************                                  ************
  256.  
  257.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  258.      (Internet EMAIL)