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