home *** CD-ROM | disk | FTP | other *** search
/ TopWare 18: Liquid / Image.iso / liquid / top2181 / vueprint.doc < prev    next >
Text File  |  1994-04-28  |  16KB  |  397 lines
  1.  
  2.  
  3.                         VuePrint User's Guide
  4.                              Version 2.2
  5.                  Copyright (c) 1994 Edward B. Hamrick
  6.                          All Rights Reserved
  7.  
  8.  
  9. 1.0  Introduction
  10.  
  11.      VuePrint is a Windows 3.1 program that lets you display and print
  12. graphics  files  that use  the GIF,  JPEG,  and BMP  graphics formats.
  13. VuePrint supports all graphics displays and printers that operate with
  14. the  MicroSoft Windows 3.1  operating environment, using  a 386 or 486
  15. microprocessor.
  16.  
  17.      The  two  key features  of VuePrint  are speed  and ease  of use.
  18. VuePrint is more than twice as fast as most other JPEG viewers, and is
  19. able  to scale images to  full-screen more than five  times as fast as
  20. other   viewers.    VuePrint  will  scale  images  to  fill  a  window
  21. automatically, without distorting the image shape.  While VuePrint has
  22. many features, and all are integrated in an easy to use menu system.
  23.  
  24.      Version  2.0 of VuePrint  added one key feature  - the ability to
  25. display  24-bit  per pixel  JPEG files  on  16-bit and  24-bit Windows
  26. displays.   This means that JPEG files will look much more natural and
  27. smooth than under previous versions of VuePrint.  JPEG files displayed
  28. on some 16-color displays may look much better as well.
  29.  
  30.      Version  2.1 adds full integration with the Windows File Manager,
  31. supports  drag  & drop  files,  better supports  extremely  large JPEG
  32. files,  adds support for .SLI (slideshow) files, uses standard Windows
  33. dialogs  for printing and opening files, supports GIF89a transparency,
  34. fixes miscellaneous bugs, and adds lots of features.
  35.  
  36.      Version  2.2  adds support  for compressed  BMP (DIB)  files, and
  37. prevents screen savers from starting when a slide show is running.  It
  38. also searches for VUEPRINT.INI in the current directory, then uses the
  39. DOS  PATH variable,  then uses the  Windows directory.   Pressing both
  40. mouse buttons simultaneously will exit the program.
  41.  
  42.      Most  printers are only  capable of displaying  an array of black
  43. (or  sometimes colored)  dots.   However, many  graphics files contain
  44. images  with up to  256 different colors.   VuePrint uses  a very fast
  45. error-dispersion  algorithm  (also called  a dithering  or half-toning
  46. algorithm)  to  print the  image  in the  graphics  file.   This error
  47. dispersion  algorithm takes advantage  of the number  of colors that a
  48. printer  supports.   If  a display  is unable  to display  256 colors,
  49. VuePrint uses this same dithering algorithm to display an image.
  50.  
  51.      VuePrint  also  supports viewing  GIF or  JPEG images  that can't
  52. completely  fit into the available memory.   It does this by storing a
  53. lower-resolution  image  in  memory.    This  is  useful  when running
  54. multiple copies of VuePrint in different windows, doing slide shows in
  55. each window.  Running multiple copies of VuePrint simultaneously works
  56. best  on 16-bit and 24-bit displays,  but it works acceptably on other
  57. types of displays.
  58.  
  59.      One  of the  design goals  of VuePrint was  to make  it quick and
  60. inexpensive  to download.   The size  of the file  VUEPRI.ZIP is about
  61. 75,000 bytes, which can be downloaded in about 5 minutes at 2400 baud.
  62. This   costs  less  than  $1.00.     Other  programs  with  comparable
  63. functionality take up to four times as long to download.
  64.  
  65.  
  66.  
  67. 2.0  Prerequisites
  68.  
  69.      In  order to use VuePrint, you will need a personal computer that
  70. is  running Microsoft  Windows version 3.1  or higher.   You will also
  71. need a 386 or 486 microprocessor.  VuePrint will work with any Windows
  72. display,  including Hercules, EGA,  16-color, 256-color, 16-bit color,
  73. and 24-bit color displays.
  74.  
  75.      VuePrint  is distributed via CompuServe  as shareware, and may be
  76. evaluated  for 15 days.  If you  decide you want to register VuePrint,
  77. type "GO SWREG" and register program #1883.
  78.  
  79.      When  you register VuePrint, you'll receive assistance via e-mail
  80. with  any problems  you may encounter.   You'll also  receive a Serial
  81. Number  identifying your copy of VuePrint.  This serial number is also
  82. valid  for  VueSav -  a fast  JPEG/GIF Screen  Saver for  Windows 3.1.
  83. VueSav can be obtained separately from CompuServe, America Online, and
  84. various Internet and BBS sites (VUESAV.ZIP).
  85.  
  86.      If  you'd prefer to  register VuePrint by mail,  you can send the
  87. $40.00 registration fee to:
  88.  
  89.           Ed Hamrick
  90.           11588 Raintree Spring Ct.
  91.           Cupertino, CA  95014
  92.  
  93. 3.0  Installing and Running VuePrint
  94.  
  95.      To  install VuePrint,  put the  file VUEPRINT.EXE  in a directory
  96. that's  convenient for  you.  Then  use the  Windows Program Manager's
  97. File->New  menu item to install a new program item named VuePrint.  To
  98. run VuePrint, just double-click on the VuePrint Icon.
  99.  
  100.      To  get the highest quality image  display, set up Windows to use
  101. the  highest resolution display driver available.  If you run VuePrint
  102. with  a 16-color display driver, you'll get a hint that a 256-color or
  103. higher  display driver will help.   This message is only displayed for
  104. the two days after first running VuePrint.  To get the highest quality
  105. JPEG displays, use a 16-bit or 24-bit display driver.
  106.  
  107.      All  commands are accessible through the  menu bar.  Each command
  108. has a short-cut key which consists of a single keystroke.  In addition
  109. to  the short-cut keys documented in the menu bar, the arrow keys move
  110. the  image when it is zoomed in.  The arrow keys along with the shift-
  111. key move the image one full screen at a time.
  112.  
  113.      Pressing  the left-hand mouse button causes  the image to zoom in
  114. by  a factor of two at the point  the mouse was located.  Pressing the
  115. right-hand mouse button allows you to move the image around when it is
  116. zoomed in.  Double-clicking the right mouse button displays the entire
  117. image,  undoing any previous zooming.   Holding down both the left and
  118. right mouse buttons exits the program.
  119.  
  120.      Note  that the menu items that increase and decrease the contrast
  121. are actually increasing and decreasing the "gamma" of the image. Gamma
  122. is  a  non-linear function  that compensates  for  the fact  that most
  123. monitors  display  non-linear intensities  when presented  with linear
  124. color lookup tables.  The gamma adjustment that's used for the display
  125. is also used to change the contrast on the printout.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.      One  feature that's a little bit subtle is the ability to convert
  134. JPEG  files to GIF files.   If you check  the JPEG Option "Write GIF",
  135. every  time you view  a JPEG file, a  GIF file will  be written at the
  136. same  time.  For instance, if you  display XYZ.JPG, you'll find a file
  137. XYZ.GIF  in the  same directory.   When VuePrint is  started, the JPEG
  138. (and  View) options are  set to the  values that should  result in the
  139. highest quality display.
  140.  
  141. 4.0  Menu Items
  142.  
  143.      Each  of VuePrint's  menu items is  described below.   The single
  144. keystroke  equivalent of this command is also included to the right of
  145. the menu name.
  146.  
  147. 4.1  File Menu
  148.  
  149.      Open...             O         brings up the open file dialog box.
  150.  
  151.      Next                Space     displays the next image in the
  152.                                    list.
  153.  
  154.      Previous            BkSp      displays the previous image in the
  155.                                    list.
  156.  
  157.      Random              Enter     scrambles (randomizes) the list of
  158.                                    images.
  159.  
  160.      Print               P         brings up the print dialog box.
  161.  
  162.      Printer Setup...    S         brings up the printer setup dialog
  163.                                    box.
  164.  
  165.      Exit                X         exits VuePrint.
  166.  
  167.      About VuePrint...   A         displays information about how to
  168.                                    register VuePrint.  This is the
  169.                                    menu item you choose when entering
  170.                                    the VuePrint Serial Number.
  171.  
  172. 4.2  View Menu
  173.  
  174.      Zoom In             PgUp      blows up the image by a factor of
  175.                                    two.
  176.  
  177.      Zoom Out            PgDn      reduces the size of the image by a
  178.                                    factor of two.  It doesn't allow
  179.                                    you to reduce the size of the image
  180.                                    less than full size.
  181.  
  182.      Rotate              End       rotates the image 90 degrees
  183.                                    clockwise.
  184.  
  185.      Mirror              Ins       makes a mirror image of the image
  186.                                    (swaps the left side with the right
  187.                                    side).
  188.  
  189.      Flip                Del       flips the image upside down.
  190.  
  191.      Brighter            Keypad +  increases the brightness of the
  192.                                    image.
  193.  
  194.      Dimmer              Keypad -  decreases the brightness of the
  195.                                    image.
  196.  
  197.      More Contrast       Keypad *  increases the contrast (gamma) of
  198.                                    the image.
  199.      Less Contrast       Keypad /  decreases the contrast (gamma) of
  200.                                    the image.
  201.  
  202.      Reset               Home      causes the image to revert to full
  203.                                    size, without any rotation,
  204.                                    flipping, changes in brightness, or
  205.                                    changes in contrast.
  206.  
  207. 4.3  Options Menu
  208.  
  209.      Dither Display      D         causes the display to be made up of
  210.                                    a pattern of dots (dither pattern)
  211.                                    instead of trying to use the
  212.                                    display's multiple-intensity
  213.                                    capability.
  214.  
  215.      Dither Printer      T         causes VuePrint to send a pattern
  216.                                    of dots to the printer driver when
  217.                                    on.  When turned off, lets the
  218.                                    printer driver do the dithering.
  219.  
  220.      Color Display       R         displays the image in color.
  221.  
  222.      Color Printer       N         prints the image in color.
  223.  
  224.      White Border        I         displays the border in white when
  225.                                    on.  When turned off, displays the
  226.                                    border in black.
  227.  
  228.      Show Comments       H         displays any comments associated
  229.                                    with an image starting at the top
  230.                                    of the screen.  Causes the image to
  231.                                    be displayed at the bottom of the
  232.                                    screen.
  233.  
  234.      Auto Scale          Tab       displays the image scaled-up to
  235.                                    fill the window whenever it is
  236.                                    smaller than the window.  When
  237.                                    turned off, a small image is
  238.                                    displayed centered in the window
  239.                                    with no stretching.  Images that
  240.                                    are larger than the window are
  241.                                    always shrunk to fit the window,
  242.                                    regardless of the setting of this
  243.                                    option.
  244.  
  245.      Fill Window         Escape    toggles on and off the Window frame
  246.                                    and menu.
  247.  
  248.      Quarter Page        Q         causes any printed image to fill
  249.                                    the upper-left hand quarter page.
  250.                                    This is useful for test printouts
  251.                                    to check intensity and contrast,
  252.                                    since it allows printing to be 4
  253.                                    times faster than normal.
  254.  
  255.      Save                F1        saves all options in VUEPRINT.INI
  256.                                    in the Windows directory.
  257.  
  258.      Restore             F2        restores all options from
  259.                                    VUEPRINT.INI.
  260.  
  261.      Save On Exit        F3        saves all options in VUEPRINT.INI
  262.                                    upon program exit.
  263.  
  264.  
  265.      Default             F4        restores all options to their
  266.                                    default settings.
  267.  
  268. 4.4  JPEG Menu
  269.  
  270.      Two Pass            W         reads JPEG files in two passes.
  271.                                    The first pass reads the 24-bit
  272.                                    data, and the second pass converts
  273.                                    from 24-bits to 8-bits.  If the
  274.                                    JPEG file is being displayed on a
  275.                                    16-bit or 24-bit display (and the
  276.                                    Maximize Colors option is set),
  277.                                    only one pass is performed,
  278.                                    regardless of the setting of this
  279.                                    option.
  280.  
  281.      Maximize Colors     C         causes 24-bit data to be stored in
  282.                                    memory when reading JPEG files for
  283.                                    display on a 16-bit or 24-bit
  284.                                    display.
  285.  
  286.      Use Dithering       U         causes the 24-bit to 8-bit
  287.                                    conversion process to use Floyd-
  288.                                    Steinberg dithering.
  289.  
  290.      Use Grey Scale      Y         causes only the intensity data to
  291.                                    be read from the JPEG file.  While
  292.                                    the resultant image is only grey-
  293.                                    scale, this can be significantly
  294.                                    faster than processing full color
  295.                                    images.
  296.  
  297.      Block Smoothing     B         causes the 8x8 blocks to be
  298.                                    smoothed before transforming from
  299.                                    frequency domain.
  300.  
  301.      Pixel Smoothing     E         causes the 8x8 blocks to be
  302.                                    smoothed after transforming from
  303.                                    frequency domain.
  304.  
  305.      Write GIF           F         causes a GIF file to be written for
  306.                                    every JPEG file that is read.
  307.  
  308. 4.5  Slide Show Menu
  309.  
  310.      The  slide show menu allows you  to select a delay between images
  311. in  a slide show of 1 to 9 seconds.   If you choose 0, then there will
  312. be  no slide  show.   While a  slide show  is being  displayed, screen
  313. savers are disabled (even if VuePrint isn't zoomed to full screen).
  314.  
  315. 5.0  Bug Reports and Enhancement Requests
  316.  
  317.      If  you  have  problems running  VuePrint,  or have  an  idea for
  318. enhancing  VuePrint, please send e-mail to Ed Hamrick on CompuServe at
  319. 71470,3236.     You  can  also  send   e-mail  from  the  Internet  to
  320. 71470.3236@compuserve.com.
  321.  
  322.      VuePrint  only reads images  that have a maximum  size of 2048 by
  323. 2048, and can zoom images up to 6000 by 6000.
  324.  
  325.  
  326.  
  327.                                    TRADEMARKS
  328.  
  329.  
  330.  
  331. GIF,  Graphics Interchange  Format, and  CompuServe are  trademarks of
  332. CompuServe, Inc., an H&R Block Company.
  333.  
  334. Microsoft  is a  registered trademark  and Windows  is a  trademark of
  335. Microsoft Corporation.
  336.  
  337.  
  338.  
  339.                                 ACKNOWLEDGEMENTS
  340.  
  341.  
  342. VuePrint is based in part on the work of the Independent JPEG Group.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.