home *** CD-ROM | disk | FTP | other *** search
/ TopWare 18: Liquid / Image.iso / liquid / top2181 / vueprint.doc < prev    next >
Encoding:
Text File  |  1994-04-28  |  15.4 KB  |  397 lines

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