home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1996 November / IMM1196.iso01.iso / share / magazin / pview18 / polyview.doc next >
Text File  |  1995-05-07  |  19KB  |  467 lines
  1.                    PolyView User's Manual
  2.                              for
  3.                     PolyView Version 1.80
  4.                              by
  5.                           Polybytes
  6.                               
  7.                   Copyright 1995 Polybytes
  8.                               
  9.  
  10. Introduction
  11.  
  12.      PolyView is a multi-threaded 32-bit Microsoft Windows
  13.      NT application which provides viewing and image
  14.      manipulation support for JPEG, GIF, photo-cd, and
  15.      Windows and OS/2 8 and 24 bit BMP files. PolyView was
  16.      written and tested using Microsoft Windows NT
  17.      Workstation Version 3.5.
  18.      
  19. Registration
  20.  
  21.      PolyView is distributed as shareware. To register your
  22.      copy, send $20.00 to:
  23.      
  24.           Polybytes
  25.           3427 Bever Avenue S.E.
  26.           Cedar Rapids, Iowa 52403
  27.           
  28.      Registered users will receive product update
  29.      notifications and problem assistance.
  30.      
  31. Support
  32.  
  33.      All users are encouraged to communicate praise and
  34.      problems via e-mail to:
  35.      
  36.           PolyView@aol.com
  37.      
  38. Limitations
  39.  
  40.      PolyView supports 8 bit (256 colors), 16 bit (64K
  41.      colors) and 24 bit (2.7M color) display modes for JPEG,
  42.      GIF, photo-cd, and 8 bit BMP files. 24 bit BMP files
  43.      are supported only in 16 or 24 bit display modes.
  44.      
  45. Running PolyView
  46.  
  47.      PolyView.exe is the executable file which contains the
  48.      implementation of the PolyView application. PolyView
  49.      can be executed by Running it from the Program Manager
  50.      or File Manager.
  51.      
  52. Drag-and-Drop from File Manager
  53.      
  54.      PolyView supports drag-and-drop from the File Manager.
  55.      Drag-and-drop a file on a running PolyView application,
  56.      or on PolyView's minimize icon, to send the file or
  57.      files to PolyView. Depending upon the drag-and-drop
  58.      options selected from the Properties dialog, Polyview
  59.      will
  60.      
  61.           * Create a new window for each dragged file
  62.      
  63.           * Create a new slide show from the dragged files
  64.      
  65.           * Add the new files to an existing slide show
  66.      
  67.      Caution: If PolyView is configured to create a new
  68.      window for each dragged file and a large number of
  69.      files are "dropped", then PolyView can fairly quickly
  70.      use up large amounts of the real and virtual memory
  71.      resources in your system. If this occurs accidentally,
  72.      the multithreaded nature of PolyView will allow you to
  73.      correct your mistake by choosing the File:Exit command
  74.      to terminate file decompression and release all
  75.      resources.
  76.      
  77. Registry Usage
  78.  
  79.      Beginning with Version 1.70, PolyView uses the registry
  80.      for the storage of all information pertaining to
  81.      individual user settings from the Properties menu, most
  82.      recently used file list, and the most recently used
  83.      directory. The old polyview.ini file in the windows
  84.      directory (WINNT35, WINDOWS, etc.) is no longer needed
  85.      and may be discarded.
  86.      
  87.      Also starting with Version 1.70, PolyView automatically
  88.      registers itself with the File Manager or Windows 95
  89.      Explorer upon startup. This registration includes the
  90.      specification of the relevant DDE information so that
  91.      PolyView will be automatically started when a PolyView
  92.      "document" is run. The association of a file type with
  93.      PolyView is automatically done for JPG, GIF, PCD, and
  94.      BMP files, but only if an association for the
  95.      particular file type did not previously exist. If you
  96.      wish to replace an existing association, delete it from
  97.      the registry (using REGEDIT or REGEDIT32) and rerun
  98.      PolyView.
  99.      
  100. File Menu
  101.  
  102.      The File menu contains commands to:
  103.      
  104.           * Open and close image files
  105.           
  106.           * Start a slide show
  107.           
  108.           * Select from a list of the most recently viewed
  109.           images
  110.           
  111.           * Exit the PolyView application
  112.      
  113. View Menu
  114.  
  115.      The View menu contains commands to:
  116.      
  117.            * Zoom In and Zoom Out through a chain of image
  118.           magnifications
  119.           
  120.           * Use the entire display screen to view an image
  121.           
  122.           * Use the entire display screen to automatically
  123.           cycle through ALL the loaded images
  124.           
  125.           * Resize an image to better utilize the available
  126.           display
  127.           
  128.           * Change the mapping of an image to display its
  129.           full resolution
  130.           
  131.           * Enable and disable the display of the tool bar
  132.           and status bar
  133.      
  134. Options Menu
  135.  
  136.      The Options menu contains commands to:
  137.      
  138.           * Adjust the brightness, contrast, and colors of
  139.           an image (when the mode is Half Tone)
  140.           
  141.           * Invoke the Properties dialog to change
  142.           PolyView's configuration
  143.      
  144. Windows Menu
  145.  
  146.      The Windows menu contains commands to:
  147.      
  148.           * Change the positioning of the displayed images
  149.           
  150.           * Select an image from a list of active image
  151.           windows
  152.      
  153. The Toolbar
  154.  
  155.      PolyView's toolbar contains buttons for:
  156.      
  157.           * Opening files
  158.           
  159.           * Invoking full screen display mode
  160.           
  161.           * Manipulating the image appearance (active if the
  162.           display mode is set to Half Tone)
  163.           
  164.           * Viewing the PolyView About dialog box
  165.      
  166.      PolyView's toolbar is a docking toolbar. This means
  167.      that it can be grabbed with the left mouse button and
  168.      dragged to a new position within the PolyView window.
  169.      If positioned against an edge of the window it will be
  170.      docked there. The toolbar can also be left floating
  171.      anywhere in the window, or made invisible through the
  172.      View:Toolbar command.
  173.  
  174. Full Screen Display Modes
  175.  
  176.      The File:Slideshow, View:Full Screen View, and
  177.      View:Auto-browse Images commands display the current
  178.      image using the entire display screen. In Slideshow or
  179.      Auto-browse modes, images will be changed at the rate
  180.      indicated by the "Browsed Image Display Time" field of
  181.      the Browsing Properties dialog box. Full screen mode is
  182.      cancelled by pressing a key on the keyboard. Images
  183.      displayed in full screen mode will be downscaled to fit
  184.      the screen if the raw image size exceeds the screen
  185.      pixel dimensions.
  186.      
  187.      While browsing images in full screen mode, the left and
  188.      right mouse buttons can be used to manually cycle
  189.      through the selected images, cancelling any timed image
  190.      cycling that is in progress. The left mouse button
  191.      causes the display of the previously displayed image,
  192.      and the right mouse button causes the display of the
  193.      next image.
  194.      
  195.      When a slide show is manually browsed there will be
  196.      periods of time after a new image is displayed when the
  197.      next image will not be available for display. During
  198.      this file decompression period the system will display
  199.      an hourglass cursor. PolyView attempts to load the next
  200.      image to be displayed by assuming that it is the next
  201.      file in the slideshow list in the direction that was
  202.      directed by the last mouse click. When a manual
  203.      slideshow is initially started, PolyView displays the
  204.      first image and begins reading the next image to the
  205.      right (the second image in the list of slideshow
  206.      files). At this time the last file in the slideshow
  207.      file list is not loaded, so a left mouse button click
  208.      after the hourglass cursor disappears will start it
  209.      loading. When the hourglass again disappears a left
  210.      button click will move to that image.
  211.  
  212. Zooming the Image
  213.  
  214.      PolyView can change the magnification of a displayed
  215.      image in several ways.
  216.      
  217.      The View:Zoom In command increases the magnification of
  218.      a displayed image by about 50%. The original window
  219.      size is maintained, with the center of the newly
  220.      magnified image the same as that at the previous
  221.      magnification.
  222.      
  223.      The View:Zoom Out command decreases the magnification
  224.      and display position to the previous magnification.
  225.      
  226.      An interactive zoom is provided by using the left mouse
  227.      button to draw a rectangle around the area to be
  228.      displayed in the magnified image. When the button is
  229.      released, the image will be rescaled. The View:Zoom Out
  230.      command can be used to go back to the previous
  231.      magnification.
  232.      
  233. Panning
  234.  
  235.      Images that do not fit within a displayed window can be
  236.      panned (positioned) by using the scroll-bars that
  237.      appear on the window. Note that panning smoothness is
  238.      severely constrained by the selection of the Half Tone
  239.      display mode.
  240.      
  241. Image Appearance Manipulation
  242.  
  243.      The appearance of an image can be manipulated when the
  244.      display mode is set to the Half Tone mode via the
  245.      Properties dialog box. Although Half Tone mode has a
  246.      much slower display update than other modes, it does
  247.      allow the manipulation of brightness, contrast, color
  248.      intensity, and tint.
  249.      
  250.      The default display mode used for viewing an image is
  251.      either the mode set the last time the mode was changed
  252.      from the Properties dialog, or the mode last used for
  253.      that image when the use of the image specific
  254.      configuration file has been enabled.
  255.      
  256.      Some, if not all, Windows NT display drivers do not
  257.      function as indicated by the Win32 API when the screen
  258.      is configured for 24 bit color (True Color). The
  259.      symptom you will observe is that although the color
  260.      manipulation commands are enabled, they will appear to
  261.      be non-functional. This is also true when PolyView is
  262.      run under Windows 95.
  263.      
  264. Image Configuration File
  265.  
  266.      If the use of an image specific configuration file is
  267.      enabled through the Properties dialog then the
  268.      manipulation of the display mode and color/contrast
  269.      settings for that image will result in the creation of
  270.      a configuration file corresponding for the image. The
  271.      name of the file is derived from the name of the image
  272.      file by replacing the original file extension with the
  273.      extension "PVI". When this option is enabled, each time
  274.      an image is displayed it will use the settings from the
  275.      last time it was displayed.
  276.      
  277. File Properties
  278.  
  279.      The file properties are available from the
  280.      Options:Properties command under the File Properties
  281.      dialog box. These include:
  282.  
  283.           * Drag and Drop File Actions - controls whether
  284.           files dragged from the File Manager create new
  285.           image windows, or are used to create or augment a
  286.           slideshow.
  287.           
  288.           * Image File Open Actions - controls whether a
  289.           file opened by PolyView creates a new image window
  290.           or replaces the current image window.
  291.           
  292.           * Use image configuration files - controls whether
  293.           PolyView reads and writes configuration files for
  294.           images.
  295.           
  296. General Properties
  297.  
  298.      The general properties are available from the
  299.      Options:Properties command under the General Properties
  300.      dialog box. These include:
  301.      
  302.           * Display rendering mode - selects from the
  303.           available modes to control  the speed and accuracy
  304.           with which PolyView displays images.
  305.           
  306.           * Default One-For-One Mapping - if checked then
  307.           PolyView will not rescale an large image to fit
  308.           the available viewing space. Instead a window with
  309.           scroll bars will be displayed.
  310.           
  311.           * Enable Photo-CD Upsizing - if checked then
  312.           PolyView will choose an image size from a photo-cd
  313.           file which will fill the screen to the percentage
  314.           specified in the Screen Fill Percentage box in a
  315.           least one direction. See the paragraph describing
  316.           photo-cd upsizing for a further explanation of
  317.           this feature.
  318.           
  319. Browsing Properties
  320.  
  321.      The browsing properties are available from the
  322.      Options:Properties command under the Browsing
  323.      Properties dialog box. These include:
  324.      
  325.           * Browsed Image Display Time - adjusts the minimum
  326.           time an image will be displayed on the screen in
  327.           Auto-Browse or Slideshow modes.
  328.           
  329.           * Timed Browsing Mode - controls whether a
  330.           slideshow or image browse cycles once through the
  331.           images, cycles continuously through the images, or
  332.           cycles manually via user mouse button clicks.
  333.  
  334. JPEG Decompression Control Properties
  335.      
  336.      The JPEG decompression options are available from the
  337.      Options:Properties command under the JPEG Properties
  338.      dialog box.
  339.      
  340.      PolyView's JPEG algorithms provide several methods of
  341.      performing the Discrete Cosine Transform (DCT) used
  342.      during JPEG format file decompression. The methods
  343.      available include:
  344.      
  345.           * Fast but inaccurate integers - this is the
  346.           fastest method on most machines, but may suffer
  347.           from degraded image quality. For many images there
  348.           will be insignificant visible degradation.
  349.           
  350.           * Slow but accurate integers - this method is
  351.           slower than the first method, but achieves high
  352.           quality results.
  353.           
  354.           * Fast or slow but accurate floating point - this
  355.           highly accurate method may be the fastest on some
  356.           machines, but on machines without floating point
  357.           capability will be VERY slow.
  358.      
  359.      Chroma component upsampling characteristics control the
  360.      speed and accuracy of certain color manipulations
  361.      performed during decompression. The methods available
  362.      include:
  363.      
  364.           * Fast but less accurate
  365.      
  366.           * Slower but more accurate
  367.      
  368.      When the screen characteristics are set to 8 bit color
  369.      mode (256 colors), then color quantization is performed
  370.      during decompression. The methods available for this
  371.      quantization include:
  372.      
  373.           * Two pass quantization - in this mode the entire
  374.           image is scanned once to determine the optimum
  375.           color map to use, then scanned again to build the
  376.           final image. This is naturally slower than a
  377.           single pass mode, but does a much better job of
  378.           rendering colors.
  379.           
  380.           * Color dithering - color dithering can improve
  381.           the color characteristics of the decompressed
  382.           image in both single and two pass modes, but the
  383.           effects of dithering can be pronounced in single
  384.           pass mode.
  385.           
  386. Photo-CD Upsizing
  387.  
  388.      The algorithm that PolyView uses to select the display
  389.      image size of a photo-cd file depends on the Enable
  390.      Photo-CD Upsizing option of the General Properties
  391.      dialog.
  392.      
  393.      If upsizing is not enabled, then PolyView chooses an
  394.      image size that will fit within the dimensions of the
  395.      full screen viewing area, yielding the most accurate
  396.      display of the image. For example, if a horizontal
  397.      image is to be displayed on an 800x600 resolution
  398.      display, then the 768x512 image size will be chosen. On
  399.      the same display, however, a vertical image will be
  400.      displayed in a 256x384 format, since the next available
  401.      size of 512x768 will overfill the screen in the
  402.      vertical direction.
  403.      
  404.      If upsizing is enabled, then PolyView chooses an image
  405.      that will fill the screen to the Screen Fill Percentage
  406.      in at least one direction. For example, consider the
  407.      case where a 75% Screen Fill Percentage has been
  408.      chosen. On an 800x600 display, a horizontal image will
  409.      be displayed in the 768x512 image size because this
  410.      fills the screen to 96% in the horizontal direction,
  411.      and 85% in the vertical direction. For a vertical image
  412.      a 512x768 image will be chosen, because the next
  413.      smaller size of 256x384 will fill the screen to only
  414.      32% in the horizontal direction, and 64% in the
  415.      vertical direction. In this case, the 512x768 image
  416.      will be "shrunk" to exactly fill the available display
  417.      area.
  418.      
  419.      Caution: upsizing can cause PolyView to use a
  420.      significantly larger amount of memory during photo-cd
  421.      image decompression and display. Specifying a 90%
  422.      Screen Fill Percentage on an 800x600 display will
  423.      result in PolyView choosing a 1536x1024 image. During
  424.      decompression this size image requires a 4.6 Mbyte
  425.      memory structure to be allocated for the storage of a
  426.      device independent bitmap. On a 24 bit display the
  427.      resulting device dependent bitmap is also 4.6 Mbytes in
  428.      size, so the peak memory requirement to display this
  429.      image is more than 9.2 Mbytes. This will lead to
  430.      significant disk accesses and performance degradation
  431.      on memory challenged systems.
  432.      
  433. PolyView Version History
  434.  
  435.      1.00 Initial release.
  436.      1.10 Added default saving for application and image
  437.      configuration defaults.
  438.           Added "View:Resize to fit" command.
  439.      1.20 Added JPEG DCT method choice.
  440.           Changed bitmap algorithms for better Win95
  441.      compatibility.
  442.      1.30 Added support for 8 bit color modes.
  443.      1.40 Added "on-the-fly" image painting during file
  444.      reading.
  445.           Remember last screen position and state.
  446.           Remember last directory used to open a file.
  447.      1.50 Added full screen viewing mode.
  448.      1.60 Added slide show viewing mode.
  449.           Added properties dialog and additional JPEG
  450.      decompression options.
  451.      1.70 Added photo-cd file support.
  452.           Added system registry use for file association,
  453.           DDE commands, and replacement of polyview.ini.
  454.      1.80 Added photo-cd upsizing option.
  455.  
  456. Credits
  457.  
  458.      The Graphics Interchange Format(c) is the Copyright
  459.      property of CompuServe Incorporated. GIF(sm) is a
  460.      Service Mark property of CompuServe Incorporated.
  461.      
  462.      Microsoft Windows NT is a registered trademark of the
  463.      Microsoft Corporation.
  464.      
  465.      PolyView is in part based on the work of the
  466.      Independent JPEG Group.
  467.