home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 35 / hot35.iso / ficheros / DGRAF / SHOWJPG.ZIP / SHOWJPG.DOC next >
Text File  |  1998-02-08  |  6KB  |  170 lines
  1.  
  2.  
  3.  
  4.                                ShowJPG 2.60
  5.  
  6.         Copyright (c) 1995-98 by Jan Patera, All Rights Reserved
  7.                          Patera@km1.fjfi.cvut.cz
  8.  
  9.                       Ultra-fast JPEG image viewer
  10.     with capability of displaying and scrolling during decompression.
  11.          Image swapping to XMS when out of conventional memory.
  12.  
  13.  
  14.  
  15. Usage: ShowJPG.exe File_name [Width] [-q] [-l]
  16.  
  17.    File_Name  is  a  name  of  the  file  to  be  viewed, must include an
  18. extension and may include a path.
  19.    Optional parameter Width is a number saying the width in pixels of the
  20. graphics  mode you  want to  view the  image in.  Your video adapter must
  21. support any graphics  mode with this width (what  a surprise!). This mode
  22. must be 256 color for black-and-white  images and must be HiColor (32k or
  23. 64k colors) or TrueColor (16m colors) for color images. If this parameter
  24. is not specified,  ShowJPG chooses the best mode in  that all or possibly
  25. the biggest  part of the  image that can  be displayed. A  TrueColor mode
  26. rather than a HiColor one is chosen for color images .
  27.    Optional  parameter -q  or -Q  commands the  ShowJPG to decompress the
  28. image  preserving the  maximum quality  of the  image. If  specified, the
  29. decompression is slower than if not specified.
  30.    Optional parameter -l or -L allows to use the left mouse button to end
  31. ShowJPG, instead of the default  right button. This is usable for example
  32. in publicly accessible info-boxes with a screen and a simple touchpad.
  33.  
  34. Examples:
  35.  
  36.  ShowJPG parrot.jpg
  37.  ShowJPG e:girl.jff 1192 -Q
  38.  ShowJPG ..\country\house.jif   1280 -l
  39.  
  40.  
  41.    You  may  scroll  the  image  in  all  directions  using  a  mouse and
  42. a keyboard.
  43.    Scrolling is even available during decompression.
  44. Use these keys to scroll:
  45. "Left" - moves the image to the right and displays next part on the left
  46. "Right" - moves the image to the left and displays next part on the right
  47. "Up" - moves the image down and displays next part toward the top
  48. "Dn" - moves the image up and displays next part toward the bottom
  49. "PgUp" - displays the top of the image
  50. "PgDn" - displays the bottom of the image
  51. "Home" - displays the left side of the image
  52. "End" - displays the right side of the image
  53.  
  54.    Zooming can be  performed by pressing + (plus,  Zoom-in) and - (minus,
  55. Zoom-out) keys on the numeric keypad. Zooming is actually switching among
  56. graphics modes  with higher or  lower resolution. With  color images, all
  57. TrueColor  (16m colors),  all HiColor  (32k colors)  and all HiColor (64k
  58. colors)  modes are  looped  cyclically.  Notice that  transformations are
  59. performed when switching among 16m, 32k and 64k color modes. So the image
  60. looses its quality after displaying in any HiColor mode.
  61.  
  62.    Viewing can be ended by pressing Esc, Enter or Space or mouse button.
  63.  
  64.  
  65.  
  66. I would like  to thank Douglas  Bashford for his  careful reading of  all
  67. texts in this package and corrections  of my mistakes. Release of English
  68. version of ShowJPG would be impossible without his effort.
  69.  
  70.  
  71.  
  72. HISTORY
  73.  
  74. 1.0 - March 1995 - First public release
  75.  
  76. 2.0 - November 1995
  77.   - Sped up by 4 times.
  78.   - Option for extra-quality decompression added.
  79.   - Mouse support added.
  80.   - Support of non-standard graphics modes added.
  81.   - Displaying in 32bit TrueColor modes fixed.
  82.   - Choosing of graphics modes by specifying width of the mode rather than
  83.     illogical mode numbers.
  84.  
  85. 2.1 - January 1996
  86.   - Support of MacBinary files with JPEG compression added.
  87.  
  88. 2.2 - February 1996
  89.   - Displaying very wide images fixed.
  90.   - Only a part of the image is displayed if it is too large to fit in
  91.     memory.
  92.  
  93. 2.25 - March 1996
  94.   - Reading of images with 4:1:1 subsampling fixed
  95.   - Reading of some images with 1:1:1 subsampling fixed.
  96.  
  97. 2.50 - January 1997
  98.   - Support of Progressive mode images from the Internet added.
  99.   - Displaying in 32bit TrueColor modes really fixed.
  100.     It really was not fixed in the 2.0 release.
  101.     Why did nobody report this BUG?????????????
  102.  
  103. 2.51 - February 1997
  104.   - Decompressing of Progressive Mode JPEGs with unusual color component
  105.     IDs fixed.
  106.  
  107. 2.52, 2.52b - February 1997
  108.   - Images that are too large and they do not fit in any TrueColor mode,
  109.     are automatically displayed in the best HiColor mode to fit on the
  110.     screen now.
  111.  
  112. 2.52c - March 1997
  113.  
  114.   - Reading of Progressive Mode JPEGs fixed.
  115.  
  116. 2.52d - October 1997
  117.  
  118.   - ShowJPG allows to use the left mouse button instead of the right.
  119.  
  120. 2.52e - November 1997
  121.  
  122.   - Decompressing of Progressive Mode JPEGs with no refine scans
  123.     (e.g. created with Adobe Photoshop 4) fixed.
  124.  
  125. 2.60  - February 1998
  126.  
  127.   - Decompressing of Progressive Mode JPEGs with subsampling 1:1:1
  128.     and 2:1:1 added.
  129.  
  130. ShowJPG  requires:
  131. -386 processor or better
  132. -VGA videoadapter with VESA BIOS
  133.  
  134. ShowJPG  recommends:
  135. -XMS
  136.  
  137. ShowJPG supports:
  138. -Progressive Mode JPEG,  Baseline JFIF-JPEG,  Raw JPEG  and MacBinaryJPEG
  139.  images in grayscales and in YCbCr (TrueColor) color scheme
  140. -Subsampling types 1x1:1:1, 2x1:1:1 (2:1:1) and 2x2:1:1 (4:1:1) only
  141.  
  142.  
  143. I have to say that:
  144. -I have  recoded a routine for  Reverse DCT into assembler  directly from
  145. the source texts by the Independent JPEG Group, Releases 3 and 4,
  146. -I have  borrowed the overview of  the JPEG file structure  from the same
  147. source.
  148. -I have  borrowed the overview  of the Progressive  Mode JPEG compression
  149. algorithm from the same source, Release 6.
  150.  
  151.  
  152.  
  153. This software is freeware, so you may use it as freely as you want to and
  154. where you want to. No fees for the author are required.
  155. All  warranties  are  disclaimed,  including  damage  to  hardware and/or
  156. software from use of this product. In  no event will I be held liable for
  157. any damages, including lost profits,  lost savings or other incidental or
  158. consequential damages  arising out of  your use or  inability to use  the
  159. program, or any other claim by any other party.
  160.  
  161. Please, send  your impressions, suggestions and  reports via the Internet
  162. to:
  163.  
  164.  patera@km1.fjfi.cvut.cz
  165.  
  166. The newest version can be got from:
  167.  
  168.  http://pascal.fjfi.cvut.cz/~patera/pictview
  169.  http://www.geocities.com/SiliconValley/Pines/9994
  170.