home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1995 February / IMM0295.ISO / share / os2 / galeria / readme.doc < prev    next >
Encoding:
Text File  |  1994-08-13  |  12.0 KB  |  266 lines
  1.  
  2.                            Galleria and Galleria/CM
  3.                            ------------------------
  4.  
  5.                         Version 2.1 - August 13, 1994
  6.  
  7.  
  8. DESCRIPTION:
  9.  
  10.    Galleria and Galleria/CM together provide a sophisticated yet easy to
  11.    use environment for the display, editing, printing, conversion and
  12.    capture of bitmapped images for 32-bit Intel-based systems using IBM
  13.    OS/2 2.1 or OS/2 for Windows 1.0 (or later). Both are high-performance
  14.    tools which exploit OS/2 features such as large memory space and multiple
  15.    threads. As Presentation Manager applications, they feature ease of use
  16.    and full interoperability with other applications on the desktop.
  17.  
  18.    Galleria is general purpose tool for the management of bitmapped images.
  19.    It provides a window for the display of images at varying resolutions
  20.    on all OS/2-supported display subsystems (up to 24-bit). Images can be
  21.    read from the OS/2 clipboard or from disk in numerous formats. Once
  22.    loaded, the displayed image can be edited (cropped, resized, rotated
  23.    etc.) and converted to monochrome or grayscale. The modified image can be
  24.    transferred to other applications via the clipboard or saved on disk in a
  25.    different format. High quality monochrome or color printed output can
  26.    also be generated.
  27.  
  28.    Galleria reads and writes common bitmap file formats including BMP, GIF,
  29.    JPEG, PCX, Targa, TIFF and WPG, plus OS/2 metafiles. Full support is
  30.    provided for the import of Kodak Photo CD and Pro Photo CD images.
  31.  
  32.    Additional features include drag/drop support, a file search function,
  33.    multi-level undo/redo, the ability to create saved lists for screen
  34.    shows, a floating zoom window and limited DDE capability.
  35.  
  36.    Galleria/CM (Capture Module) can take a snapshot of the current OS/2
  37.    desktop contents and copy the resultant image to the clipboard, disk or
  38.    printer. Galleria can also be invoked automatically for post-processing
  39.    of the captured image. An options dialog enables selection of either the
  40.    full desktop, window or region for the capture.
  41.  
  42.    Galleria/CM operations can be controlled from either an icon on the
  43.    desktop or the keyboard (with the Print Screen key).
  44.  
  45.    Online manuals for both Galleria and Galleria/CM are provided as part of
  46.    the package.
  47.  
  48.  
  49. SOFTWARE/HARDWARE REQUIREMENTS:
  50.  
  51.    Minimum:
  52.  
  53.      o IBM OS/2 2.1 or OS/2 for Windows 1.0
  54.      o 386SX
  55.      o 6MB total memory
  56.      o VGA, SVGA or XGA card with appropriate display driver
  57.      o 700KB free disk space
  58.  
  59.    Recommended:
  60.  
  61.      o 486SX (or higher)
  62.      o 8MB-12MB total memory, 16MB+ for highest Photo CD resolutions
  63.      o Video card/display driver combination supporting 256 (or more) colors
  64.  
  65.  
  66. LICENSING:
  67.  
  68.    License details must be entered when the software is first started. These
  69.    will be provided when the software is licensed. 
  70.  
  71.    A limited function demonstration of this software is available by entering
  72.    "DEMO" in the license name field when the software is started. The saving
  73.    of files to disk will be disabled and personal preferences will not be
  74.    retained across sessions.
  75.  
  76.    Note: upgrades are available to licensees of 1.x versions of this software.
  77.    Please see the UPGRADES section in the ORDER.DOC file.
  78.  
  79.  
  80. INSTALLATION:
  81.  
  82.    To install the software, online documentation etc. you must run the
  83.    INSTALL.EXE utility provided. This graphical utility will prompt for
  84.    installation options and destination. All tasks performed as part of the
  85.    installation process will be displayed in a scrollable log. This utility
  86.    can also be used to fully de-install the software.
  87.  
  88.    The installation process can be classified as one of the following three
  89.    types:
  90.  
  91.    o Individual
  92.  
  93.      This applies when you have an INDIVIDUAL license and wish to install
  94.      the software on a standalone machine. For this type of install you must
  95.      elect to have the install utility copy files to the specified
  96.      directories. On completion, you should have a new folder on your
  97.      desktop with icons for Galleria etc. You can then start the software by
  98.      double-clicking on the required icon. The first time you start Galleria
  99.      or Galleria/CM you will be prompted for your license details. These
  100.      will be preserved across subsequent sessions or installs.
  101.  
  102.    o Server
  103.  
  104.      If you have a CORPORATE license you can install the software on a LAN
  105.      server for use by multiple clients (subject to the maximum number of
  106.      users permitted by your license). The install process is similar to
  107.      that for an Individual install above. The difference is that when you
  108.      start the software and enter license details, a file named
  109.      GALLERIA.LAN will be written to disk in the same directory as the
  110.      executables. (You must have write permission to this directory to
  111.      enable this file to be created.) When you start the software from a
  112.      client on the LAN, it will look for this file and license details will
  113.      be propagated automatically. Note that the GALLERIA.LAN file will be
  114.      invalidated if moved to another disk or server and will need to be
  115.      created anew.
  116.  
  117.    o Client
  118.  
  119.      After a copy of the software licensed for CORPORATE use has been
  120.      installed on the server (and the GALLERIA.LAN file created) you can
  121.      then proceed to install the software on clients attached to the LAN.
  122.      For a client install you should deselect the option to "Copy files to
  123.      directories", instead entering directories of those on the server
  124.      where the software resides. The install will then create icons
  125.      pointing to the server copy of the software. You will not be prompted
  126.      for license details (unless the server copy has been incorrectly
  127.      installed or the GALLERIA.LAN file has been invalidated).
  128.  
  129.    For installation of a copy of software licensed for CORPORATE use on
  130.    a standalone machine, proceed as per the Server install above. The
  131.    GALLERIA.LAN file should be retained.
  132.  
  133.    For an "unlimited use" CORPORATE license, a customized copy of the
  134.    Galleria executables is supplied. You will not be prompted for license
  135.    details as these stored permanently in the executables. You are free to
  136.    install the software on workstations or servers as required.
  137.  
  138.    Note: if you have a previous version of this software installed, you must
  139.    ensure that old versions of the library (BITWAREx.DLL) files are deleted.
  140.  
  141.  
  142. DISPLAY DRIVER PROBLEMS:
  143.  
  144.    Galleria, as a graphics-intensive application, demands a high level of
  145.    support from display drivers. It is recommended that you ensure that you
  146.    have the latest version of display driver installed for your display
  147.    adapter type prior to installation.
  148.  
  149.    Below are fixes or bypasses for common problems that may be experienced:
  150.  
  151.    o Failure with SYS3175/SYS3182 etc. when loading first image with VGA and
  152.      SVGA drivers. Replacement IBMVGA32.DLL and IBMDEV32.DLL modules are
  153.      included in the floppy-based version of this software in the FIXES
  154.      directory. These modules are also available for download from the
  155.      OS2AVEN forum on CompuServe (as GALPTF.ZIP). Alternatively, contact IBM
  156.      Support requesting the fix for APAR PJ10311.
  157.  
  158.    o Scrolling errors with 8514/A, S3 and ATI drivers. Bad data may be
  159.      displayed in the scrolled area or even outside of Zoom window. This
  160.      may also result in lockups on S3 systems. Replacement IBMS332.DLL and
  161.      8514_32.DLL modules are included in the floppy-based version of this
  162.      software in the FIXES directory. These modules are also available for
  163.      download from the OS2AVEN forum on CompuServe (as GALPTF.ZIP).
  164.      Alternatively, contact IBM Support requesting the fix for APAR PJ12059.
  165.  
  166.      For ATI cards, use the replacement 8514/A driver or contact ATI
  167.      Technologies for a fix.
  168.  
  169.    o Miscellaneous errors (including exceptions, incorrect colors or
  170.      scrolling problems) with other drivers. This is normally an indication
  171.      that the display driver currently installed does not fully support
  172.      the default "direct" paint mode used by Galleria. These problems may
  173.      disappear if you change the driver settings to use a different color
  174.      depth. If not, you should be able to bypass the problem by setting the
  175.      "Paint directly" cutoff value to the maximum in the Galleria
  176.      Preferences dialog. For a permanent fix, contact the vendor of your
  177.      display adapter for an updated driver.
  178.  
  179.  
  180. PERFORMANCE CONSIDERATIONS:
  181.  
  182.    Memory requirements will depend on the size of the image being processed
  183.    and level of edits required. In most cases performance can be improved by
  184.    setting the pre-allocated size of your SWAPPER.DAT file to a large value
  185.    (eg. 16MB). The SWAPPATH statement in CONFIG.SYS would look something
  186.    like this:
  187.  
  188.                          SWAPPATH=d:\ 4096 16384
  189.  
  190.  
  191. DDE TOOLKIT
  192.  
  193.    A DDE (Dynamic Data Exchange) toolkit is available which demonstrates how
  194.    to drive Galleria from your own application for the loading and display
  195.    of images. The DDE interface implemented is not intended to enable
  196.    Galleria to be used as a general purpose server, but specifically to add
  197.    image handling capabilities to other applications lacking this support.
  198.  
  199.    The toolkit consists of the full C language source, IBM C Set++ makefile
  200.    etc. of a simple OS/2 2.x PM client. You are free to model your own
  201.    client on this sample program.
  202.  
  203.    The sample client source is included in the floppy based version of this
  204.    software in the DDE directory. This is also available for download from
  205.    the OS2AVEN forum on CompuServe (as GALDDE.ZIP).
  206.  
  207.  
  208. UPDATE HISTORY:
  209.  
  210.    Changes since Version 2.0 include:
  211.  
  212.       o enable single license entry for installation on servers
  213.       o add option to disable copy of files for installation on clients
  214.       o fixed exception when saving very large images in GIF format
  215.       o reworked Photo CD import logic
  216.       o reduced import times for large files
  217.       o added recovery for traps on import due to unexpected data
  218.       o fixed metafile scaling and placement on import
  219.       o added workaround to accomodate incorrect printer driver data length
  220.       o use size of image on clipboard with Edit Merge function
  221.       o added option to turn off palette management in 256 color mode
  222.       o increased maximum permitted image size to 8192x8192
  223.       o fixed bad scaling of logo
  224.       o added File Delete function
  225.       o added full support for display, edit, saving of RGB (24-bit) images
  226.       o updated install utility to set association data for Galleria icon
  227.       o simplified Photo CD menu, disk label now in overview window title
  228.       o save Scale to Window setting across sessions
  229.       o added JPEG as File save format
  230.       o added import support for PBMPLUS PBM/PGM/PPM binary files
  231.       o added import support for PC Paint/Pictor (.PIC) files
  232.       o enable drag/drop of file(s) from Drives folders while active
  233.       o added DDE capability with corresponding destination in Galleria/CM
  234.       o added support for Pro Photo CD 64Base files
  235.       o added logic to preserve license details across subsequent installs
  236.       o simplified print setup options, improved color output etc.
  237.       o permit load of truncated GIF files
  238.       o added option to disable save prompt when image has been changed
  239.       o permit install to same directory as installation files
  240.       o added optional resampling filter to Enlarge/reduce function
  241.       o enabled CUA shortcut keys for Undo and Redo
  242.       o repaint image at completion of scroll
  243.  
  244.  
  245. SALES/TECHNICAL SUPPORT:
  246.  
  247.    Full sales and technical support for this software is provided on the
  248.    OS2AVEN forum on CompuServe. Send a message to "Galleria support" at
  249.    100033,340 in section 1.
  250.  
  251.    Updated versions and fixes to this software will also be available for
  252.    download from library 1 of this forum.
  253.  
  254.  
  255. CONTACT:
  256.  
  257.    Bitware Australia Pty. Ltd.
  258.    P.O. Box 3097
  259.    Manuka  A.C.T.  2603
  260.    Australia
  261.  
  262.    Fax:        +61-6-2810175
  263.    CompuServe: 100033,340
  264.    Internet:   100033.340@compuserve.com
  265.  
  266.