home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / WINDOWS / MISC / WINJP095.ZIP / WINJPEG.DOC < prev    next >
Text File  |  1992-05-23  |  8KB  |  192 lines
  1.                             WinJPEG v.0.95
  2.                          by Norman and Ken Yee
  3.  
  4. Introduction
  5. ------------
  6.  
  7.     WinJPEG v1.00 is an image viewer for Microsoft Windows 3.x with the
  8. following features:
  9.  
  10.     - display JPEG, *TARGA, or GIF images
  11.     - export an image to JPEG, *TARGA, GIF, Windows BMP, or OS/2 BMP format
  12.     - 1-pass/2-pass quantization, Floyd-Steinberg dithering
  13.     - adjust amount of red, green, and blue in an image
  14.     - adjust hue, saturation, and intensity
  15.     - rotate image, flip the image vertically/horizontally
  16.     - *image magnification/reduction
  17.     - *batch file conversion of GIFs or TARGAs to JPEG
  18.     - *slideshow: display selected files sequentially
  19.  
  20. * means that feature is not implemented yet.
  21.  
  22.     There are two versions of WinJPEG.  One is a plain JPEG/GIF viewer
  23. and the second is the full version with the features listed above.  The full
  24. version is about 10% slower than the other one.
  25.  
  26.  
  27. Memory Usage
  28. ------------
  29.  
  30. We suggest that you have at least:
  31.  
  32.   1) 4 Mb of memory according to Windows (under the "Help"/"About
  33.      Program Manager" menu item of Program Manager) or
  34.   2) 2 Mb physical memory (with no Windows swap disk/file) and sufficient
  35.      space for a temporary file.
  36.  
  37.     WinJPEG can use a temporary file or available memory.  If you choose
  38. the temporary file option, the temporary drive should have free space
  39. that is at least three times the area of a selected image in bytes (e.g., a
  40. 1024x1024 image would need 1024x1024x3 bytes or 3 Mb of disk space).  If
  41. you do not have enough space for the temporary file, WinJPEG will warn
  42. you and continue.  However, the image will be garbled: portions of the
  43. image may be repeated.  
  44.     When you select "Use available memory" under "Memory options,"
  45. WinJPEG will use the available physical and virtual memory.  If there
  46. isn't enough memory for the decoding routines, a temporary file will
  47. automatically be used.
  48.     You may want to play around with these memory options to determine
  49. what is optimum for your system configuration.  The choice between using
  50. available memory and using a temporary file depends on the size of the
  51. image and how much physical memory you have.  Generally, if you don't
  52. have much physical memory(less than 4 Mb), stick with the temporary file
  53. for optimum speed.  If you have at least 8Meg of physical memory, it may
  54. display faster if you select "Use available memory."  If you have memory
  55. that is between these two thresholds, you should use available memory for
  56. small images and use a temporary file for large(greater than 800x600)
  57. images.
  58.     A large amount of memory is needed for 2-pass quantization; if you do
  59. not have enough free memory, you may still be able to view the image by
  60. selecting the 1-pass quantization display option.
  61.  
  62.  
  63. JPEG Display/Save Options
  64. -------------------------
  65.  
  66.     You can select 1-pass or 2-pass quantization and whether dithering
  67. should be used.  1-pass quantization is faster than the 2-pass option but
  68. the output generally looks more grainy.  Also, 2-pass quantization
  69. requires more memory so it may be even slower because the routines will
  70. swap to hard disk when they run out of physical memory.
  71.     The dithering method is Floyd-Steinberg; dithering is useful when
  72. quantizing to 256 colors but it is not needed for a true-color (24-bit)
  73. display.  In some cases, you may want to turn off dithering since it
  74. causes a grainy output.
  75.     In the dialog box in which you select a file, pressing the "Display"
  76. button will display the file with the chosen display options.  Pressing
  77. the "Preview" button will display the file with 1-pass quantization and
  78. dithering off.  This combination will display an image 25-50% faster than
  79. 2-pass quantization with dithering on.
  80.     There are two save options: quality factor and entropy optimization.
  81. The quality factor, an integer between 0 and 100 inclusive, determines
  82. the tradeoff between the output file size and the output image quality.
  83. If you choose a high quality factor, the image quality will be high but
  84. the file size will be large.  A lower quality setting will yield a smaller
  85. file at a cost of lower quality.  Entropy optimization produces a smaller
  86. JPEG file but it takes more time to encode the image; it takes an extra
  87. two passes.
  88.  
  89.  
  90. Description of Menu Items
  91. -------------------------
  92.  
  93. Edit
  94. ----
  95.   HSI Adjustment
  96.   --------------
  97.       This option is available for only color-indexed bitmaps(i.e. 8-bit
  98.   bitmaps).  Use the scroll bars to adjust the average amount of hue,
  99.   saturation, and intensity/brightness in an image.
  100.  
  101.   Color Balance
  102.   -------------
  103.       This option is available for only color-indexed bitmaps.  Use the scroll
  104.   bars to adjust the average amount of red, green, and blue in an image.
  105.  
  106.   Rotate
  107.   ------
  108.       Rotate the image clockwise by 90 degrees.
  109.  
  110.   Flip Horizontal
  111.   ---------------
  112.       Flips the image around the vertical axis.
  113.  
  114.   Flip Vertical
  115.   -------------
  116.       Flips the image around the horizontal axis.
  117.  
  118. Options
  119. -------
  120.   8-bit Bitmap
  121.   ------------
  122.       When you load an image with this menu item checked, WinJPEG will
  123.   quantize the number of colors to 256, and display the image in an 8-bit
  124.   bitmap.  This feature is available in only Windows display modes that can
  125.   handle more than 256 colors.  An example of an application is to preview
  126.   a JPEG image in an 8-bit bitmap before saving it to a GIF.  However, it is
  127.   not necessary to use this feature to save a 24-bit JPEG into an 8-bit GIF.
  128.  
  129.   Auto-resize 
  130.   -----------
  131.       This menu item allows you to turn on/off the auto-resizing feature.
  132.   When it is enabled, WinJPEG will automatically resize the window so that
  133.   the image will fit just inside the window.  When an image is intially
  134.   loaded, the window size is changed so that the largest possible portion
  135.   of the image is displayed.  When you change the window size so that it is
  136.   larger than the image size, the window will be resized so that it just fits
  137.   around the image.
  138.   
  139.  
  140. Registration
  141. ------------
  142.  
  143.     The full version of WinJPEG will be available in the second week of
  144. June.  It may be purchased by completing the order form and mailing the form
  145. and $15 (non-US registrations may have an additional charge) to:
  146.  
  147.       Norman Yee
  148.       58 Chandler St.
  149.       Boston, MA 02116
  150.  
  151.     When you register, you will receive WinJPEG v1.00, a user manual, and a
  152. collection of JPEG images(I will put as many as I can fit on 2 720k 3 1/2"
  153. floppies, on 1 1.44M 3 1/2" floppy or on 4 360k 5 1/4" floppies).  Once you
  154. are registered, you will receive upgrades of WinJPEG for free except for a
  155. small charge for the disk and shipping.  If you have a Internet account or
  156. a Compuserve account, you will be e-mailed upgrades for no charge.
  157.     If you have any questions, comments, suggestions, or bug reports, please
  158. feel free to send me e-mail to my Internet account: nyee@osiris.ee.tufts.edu
  159.  
  160.  
  161. Reporting Errors
  162. ----------------
  163.  
  164.     If you encounter a problem with this program, please send in a bug
  165. report.  Please give us a description of the hardware configuration of the
  166. system you are using, what other software was running in the background, what
  167. file you were loading, what the symptoms are, and anything else that might
  168. help us reproduce the problem.
  169.  
  170.  
  171. Disclaimer
  172. ----------
  173.  
  174.     The authors of this program accept no responsibility for damages that
  175. are caused by this program and make NO WARRANTY or representation, either
  176. express or implied, with respect to this software.  This software is provided
  177. "AS IS", and you, its user, assume the entire risk when you use it.
  178.  
  179. WinJPEG is copyright (C) 1992, Norman and Ken Yee.  All rights reserved.
  180.  
  181.  
  182.  
  183. Acknowledgements
  184. ---------------- 
  185.  
  186. WinJPEG is based in part on the work of the Independent JPEG Group.
  187.  
  188. The Graphics Interchange Format(c) is the Copyright property of CompuServe
  189. Incorporated.  GIF(sm) is a Service Mark property of CompuServe Incorporated.
  190.  
  191. GIF2JPG is a trademark of Handmade Software, Inc.
  192.