home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / graphics / gvw_jpg2 / jpeg_gvs.eng next >
Text File  |  1995-01-10  |  9KB  |  237 lines
  1.  
  2.       Documentation for the GEM-View Savingmodule JPEG.GVS
  3.       """"""""""""""""""""""""""""""""""""""""""""""""""""
  4.  
  5.               (C) by Guido Vollbeding, Jan 10 1995
  6.               """"""""""""""""""""""""""""""""""""
  7.  
  8.  
  9. Changes
  10. #######
  11.  
  12. - Code optimizations in Huffman encoder -> totally around 10 %
  13.   speed increase (a side product of similar work on the decoder
  14.   for 1stGuide :-).
  15. - Correction in special key checking.
  16. May 14 1994:
  17. - Got rid of problems in dialog handling after Load/Save for
  18.   braindamaged file selectors (like the original TOS one).
  19. - Little code optimizations in color conversion routines.
  20. May 12 1994:
  21. - First release.
  22.  
  23.  
  24. Introduction
  25. ############
  26.  
  27. Yeah,  here  it is,  the hardly wanted JPEG-Savingmodule for  the
  28. exciting  Shareware program GEM-View (Version 3.xx)  from  Dieter
  29. Fiebelkorn. Since more and more people more and more asked me for
  30. this in the last time (Hi Dieter, Georg, Harald, ...), I left all
  31. other  things  aside some days to get this part ready  by  hardly
  32. working.
  33.  
  34.  
  35. Installation
  36. ############
  37.  
  38. Unlike the internal complexity of the subject,  the usage is very
  39. simple:  Just  copy the file JPEG.GVS into the GVWSAVE folder  of
  40. your GEM-View installation.
  41.  
  42. Within  GEM-View you can now select this module like  any  other.
  43. Please note, that this module only supports True-Color-Images and
  44. therefore  is only available if you select the TC-Button  in  the
  45. Saving  and  Conversion dialogs.  With  the  GEM-View  Conversion
  46. module  it  is possible to process True-Color  pictures  indepen-
  47. dently from the actual screen resolution, even in monochrom.
  48.  
  49. During  saving a progress monitor is shown by the module  in  the
  50. GEM-View  Log-window as a sequence of dots.  8 dots  are  totally
  51. displayed.  In  case  of successful  completion  of  saving,  the
  52. achieved  compression ratio (Original Image Size in  relation  to
  53. the JPG File Size) is displayed.
  54.  
  55.  
  56. Options
  57. #######
  58.  
  59. If  you  hold  the  Alternate key down  at  entering  the  saving
  60. function,  a  dialog  appears  where you  can  choose  some  JPEG
  61. compression parameters.
  62.  
  63. Alternatively you can set the parameters offline by starting  the
  64. module  as a program without GEM-View from the Desktop.  In  that
  65. case  exactly the same dialog appears as with the module in  GEM-
  66. View.
  67. To  achieve  this,  you  can for instance rename  the  module  to
  68. JPEG.PRG or JPEG.APP.  A more likely way,  however,  is to insert
  69. the following line in your NEWDESK.INF desktop configuration file
  70. at the marked point:
  71. ...
  72. #W 00 00 06 01 34 09 00 @
  73. #G 03 04 000 C:\1STGUIDE.ACC@ *.*@ @
  74. #G 03 FF 000 *.AC*@ @ @
  75. #G 03 FF 000 *.GV?@ @ @                 <<--
  76. #G 03 FF 000 *.APP@ @ @
  77. #G 03 FF 000 *.PRG@ @ @
  78. ...
  79. This  avoids unlikely renaming and allows you to  directly  start
  80. any GEM-View modules as programs from the Desktop.
  81. The  changes  you made in case of start as  a  program  have,  of
  82. course, only an effect by saving them.
  83.  
  84. The  method  of  calling the dialog with  the  Alternate  key  is
  85. consistent  with the method used in GEM-View to load images  with
  86. the Alternate key.
  87. If you, however, should not like this for any reasons, the dialog
  88. provides  the possibility to change the calling condition to  any
  89. combination  of  special  keys  Shift/Control/Alternate.  Here  a
  90. selected  button represents a pressed  keystate,  otherwise  non-
  91. pressed.  So, for example, if you deselect all four buttons, then
  92. the dialog would appear normally EVERY time the saving is called.
  93. So,  if  you  convert many pictures,  you  could  set  individual
  94. parameters for each picture immediately before saving.
  95.  
  96. Now let's have a look at the parameters in special:
  97.  
  98. Quality
  99. -------
  100.  
  101. The most important parameter certainly is the predefined quality.
  102. Possible values are 0 to 100 %. The default setting is 75 %. This
  103. guarantees in allmost situations a good compromise between  visi-
  104. ble image quality and compression ratio. The resulting images are
  105. nearly  visually indistinguishable from the original  (very  good
  106. image  quality),  and the achieved compression ratios range  from
  107. 10:1 to 20:1 depending on the image contents.
  108.  
  109. To  control the resulting image quality,  you should read in  the
  110. picture  after  saving  to display it  in  the  highest  possible
  111. screen color depth  (!).  To do this you can either use  GEM-View
  112. itself, or users of 1STGUIDE can also use this instead.
  113. If  you  see defects at default quality 75,  then go up 5  or  10
  114. counts  at  a  time until you are happy with  the  output  image.
  115. Quality values above about 95 are NOT recommended for normal use.
  116. The compressed file size goes up dramatically for hardly any gain
  117. in output image quality.
  118. In the other direction, if you prefer small files to be produced,
  119. set the quality value down until about 50. Lower values should be
  120. avoided because of visible loss of image quality.
  121.  
  122. Entropy Optimization
  123. --------------------
  124.  
  125. Activating this option usually makes the resulting file a  little
  126. smaller,  but  runs somewhat slower and needs much  more  memory!
  127. Image quality and speed of decompression are, however, unaffected
  128. by this option.
  129. This  option  is not yet supported,  but is reserved  for  future
  130. versions.
  131.  
  132. Smoothing
  133. ---------
  134.  
  135. This value filters the input to eliminate fine-scale noise.  This
  136. is  useful  when converting  dithered  palette-type  pictures:  A
  137. moderate  smoothing  factor  of 10 to 50 gets  rid  of  dithering
  138. patterns in the input image,  resulting in a smaller JPG file and
  139. a better-looking image. Too large a smoothing factor will visibly
  140. blur the image, however.
  141. This option is not currently supported, since it is not necessary
  142. for  real  True-Color input.  If I feel free to  support  reduced
  143. palette-type pictures in the future, this option will be used.
  144.  
  145. Greyscale Output
  146. ----------------
  147.  
  148. With this option activated, a pure greyscale image is produced by
  149. throwing away the color information completely.
  150. ATTENTION!  Some  programs can't read in such files!  This  is  a
  151. disadvantage of these programs.  Insure,  that a certain  program
  152. you  want  to  use with such files  can  handle  this  correctly.
  153. GEMVIEW and 1STGUIDE don't have any problems with this!
  154. The  resulting files are,  of course,  somewhat smaller and  take
  155. less time to decode.  The corresponding compression  ratio,  how-
  156. ever,  (only  the  greyscale information taken into  account)  is
  157. relatively  small  (at Q = 75 % about  5:1),  because  the  color
  158. components  normally can be harder compressed  (only  considering
  159. the color-subsampling).
  160.  
  161.  
  162. Distribution
  163. ############
  164.  
  165. I  decided  to put this project as real FREEWARE to  the  public,
  166. although much work has been spent in it and is expected to do  in
  167. the future.
  168. The package, consisting of the following 3 files:
  169.  
  170.      JPEG.GVS            -> the real GEM-View-Module, also
  171.                             executable as PRG or APP;
  172.      JPEG_GVS.GER        -> the german description;
  173.      JPEG_GVS.ENG        -> this text as english description
  174.  
  175. may be freely distributed,  as long as all files remain  together
  176. and unchanged.  Any commercial distribution (including  PD-Series
  177. or so) is strictly excluded,  because nobody else should be  paid
  178. for my work if I myself also don't get anything.
  179. I accept NO LIABILITY for damages of any kind.  A certain kind of
  180. data  loss is unavoidable,  however ;-).  This is caused  by  the
  181. subject. So BE CAREFUL in usage, and read the above instructions!
  182.  
  183. For questions,  hints,  critics (constructive!) or thanks here is
  184. my contact address:
  185.  
  186.      Guido Vollbeding
  187.      Turmstraβe 61
  188.      D-06110 Halle (Saale)
  189.      (Germany)
  190.  
  191. Email: Guido Vollbeding @ HAL (Mausnet)
  192.  
  193. Bank:  Stadt- u. Saalkreissparkasse Halle
  194.        Blz.: 800 537 62
  195.        Kto.: 486 260 725
  196.  
  197. To  questions  I  can answer preferably only if  they  come  from
  198. registered 1STGUIDE-users.
  199. It should be clear,  that anybody who uses this module MUST be  a
  200. registered GEMVIEW-user.
  201.  
  202. BTW: A DSP-Support for the Falcon is not currently in question. I
  203. have  spent  much  time in  optimizing  the  code,  however,  but
  204. somewhat can be done in the future to increase performance a bit.
  205. As programming environment Pure-C is used (what else ?).
  206.  
  207.  
  208. References
  209. ##########
  210.  
  211. If  you  want to learn more about the  theory  behind  JPEG,  the
  212. following article should be read as introduction:
  213.  
  214. Wallace, Gregory K. "The JPEG Still Picture Compression Standard"
  215. Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44
  216.  
  217. At  the end of this article you will find more detailed  referen-
  218. ces.
  219.  
  220.  
  221. Last Words
  222. ##########
  223.  
  224. At  this  point a great thank goes to Dieter Fiebelkorn  for  the
  225. fruitable cooperation (over years).
  226. Only  the flexibility and comfort of GEM-View made  it  possible,
  227. that now an in my opinion ideal environment for JPEG  compression
  228. is available.
  229.  
  230. A further thank goes,  of course,  to the Independent JPEG Group.
  231. It's  excellent sources built the basic of my work  at  all,  and
  232. without them the subject JPEG certainly would be pure theory  for
  233. a long time yet.
  234.  
  235. Now  I wish you much fun by using this module and hope to  see  a
  236. lot of beautiful JPEG images in the future.
  237.