home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Graphics / Graphics.zip / gall231.zip / README.DOC < prev    next >
Text File  |  1996-07-18  |  14KB  |  309 lines
  1.  
  2.                            Galleria and Galleria/CM
  3.                            ------------------------
  4.  
  5.                          Version 2.31 - July 18, 1996
  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, scanning
  12.    and capture of bitmapped images for 32-bit Intel-based systems using IBM
  13.    OS/2 2.1, 2.11, Warp 3.0, Warp Connect or OS/2 for Windows. Both are
  14.    high-performance tools which exploit OS/2 features such as large memory
  15.    space and multiple threads. As Presentation Manager applications, they
  16.    feature ease of use and full interoperability with other applications on
  17.    the desktop.
  18.  
  19.    Galleria is general purpose tool for the management of bitmapped images.
  20.    It provides a window for the display of images at varying resolutions
  21.    on all OS/2-supported display subsystems (up to 24-bit). Images can be
  22.    read from the OS/2 clipboard or from disk in numerous formats. Direct
  23.    support is provided for input from HP ScanJet desktop scanners. Once
  24.    loaded, the displayed image can be edited (cropped, resized, rotated
  25.    etc.) and converted to monochrome or grayscale. The modified image can be
  26.    transferred to other applications via the clipboard or saved on disk in a
  27.    different format. Monochrome or color printed output can also be
  28.    generated.
  29.  
  30.    Galleria reads and writes common bitmap file formats including BMP, GIF,
  31.    JPEG, PCX, PNG, Targa, TIFF and WPG, plus OS/2 metafiles. Full support is
  32.    provided for the import of Kodak Photo CD and Pro Photo CD images.
  33.  
  34.    Additional features include drag/drop support, a browse facility with
  35.    saved thumbnails, a file search function, multi-level undo/redo, filters,
  36.    the ability to create saved lists for screen shows, a floating zoom
  37.    window and limited DDE capability.
  38.  
  39.    Galleria/CM (Capture Module) can take a snapshot of the current OS/2
  40.    desktop contents and copy the resultant image to the clipboard, disk or
  41.    printer. Galleria can also be invoked automatically for post-processing
  42.    of the captured image. An options dialog enables selection of either the
  43.    full desktop, window or region for the capture.
  44.  
  45.    Galleria/CM operations can be controlled from either an icon on the
  46.    desktop or the keyboard (with the Print Screen key).
  47.  
  48.    Online manuals for both Galleria and Galleria/CM are provided as part of
  49.    the package.
  50.  
  51.  
  52. SOFTWARE/HARDWARE REQUIREMENTS:
  53.  
  54.    Minimum:
  55.  
  56.      o IBM OS/2 2.1, 2.11, Warp 3.0, Warp Connect or OS/2 for Windows
  57.      o 386SX
  58.      o 6MB total memory
  59.      o VGA, SVGA or XGA card with appropriate display driver
  60.      o Mouse
  61.      o 800KB free disk space
  62.  
  63.    Recommended:
  64.  
  65.      o IBM OS/2 Warp 3.0, Warp Connect
  66.      o 486DX (or better)
  67.      o 8MB-12MB total memory, 16MB+ for highest Photo CD resolutions
  68.      o Video card/display driver combination supporting 64K or 16M colors
  69.  
  70.  
  71. INSTALLATION:
  72.  
  73.    To install the software, online documentation etc. you must run the
  74.    INSTALL.EXE utility provided. This graphical utility will prompt you for
  75.    destination directories and installation options. All tasks performed as
  76.    part of the installation process will be displayed in a scrollable log.
  77.    This utility can also be used to fully de-install the software.
  78.  
  79.    For an Individual license, the software may be installed on a single
  80.    machine only. Enable all installation options. On completion of the
  81.    install process, you will have a new folder on your desktop with icons
  82.    for the software and documentation. You can then start the software or
  83.    read documentation by double-clicking on the respective icons. The first
  84.    time you start Galleria or Galleria/CM you will be prompted for your
  85.    license details.
  86.  
  87.    For a Corporate license, you have the option of proceeding as per an
  88.    Individual license above or, alternatively, you can first install a copy
  89.    of the software on a file server. For each LAN-attached client, run the
  90.    installation utility entering the full path name of the directories on
  91.    the server and deselect the option to copy files. The folder and icons
  92.    created on the desktop will reference the server copy of the software.
  93.    The first time you start Galleria or Galleria/CM you will be prompted for
  94.    your license details.
  95.  
  96.    When installing the software on a large number of machines (up to the
  97.    maximum permitted by your license) you may want to preset options for
  98.    each install. See the "Replicating installation options" section in the
  99.    online help of the installation utility for more information.
  100.  
  101.    A customized copy of this software with license details incorporated is
  102.    available on request to Corporate licensees with a 100+ user license.
  103.  
  104.    Note: If you have a previous version of this software installed, you must
  105.    ensure that any old versions of the library (BITWAREx.DLL) files are
  106.    either overwritten by the INSTALL.EXE utility provided, or otherwise
  107.    deleted.
  108.  
  109.  
  110. EVALUATION:
  111.  
  112.    When not licensed, this software is provided for evaluation purposes
  113.    only. You have thirty (30) days to complete evaluation. After this
  114.    period, should you decide not to purchase a license, this software must
  115.    be completely removed from your disk using the INSTALL.EXE provided.
  116.  
  117.    For evaluation, enter "DEMO" in the license name field when the software
  118.    is started. In this mode, the following features are disabled:
  119.  
  120.       o Saving files and lists to disk
  121.       o Printing
  122.       o Retention of preferences and settings across sessions
  123.       o Option to save thumbnails as Extended Attributes
  124.  
  125.    Full functionality will be enabled by entry of valid license details at
  126.    startup.
  127.  
  128.  
  129. LICENSE AGREEMENT:
  130.  
  131.    Below is the full text of the license agreement which must be acknowledged
  132.    on entry of license details:
  133.  
  134.       1. A license for use of this software is granted to the named licensee
  135.          (or official representative in the case of a Corporate license)
  136.          only.
  137.  
  138.       2. This software is licensed for installation and use on a single
  139.          machine (in the case of an Individual license), or multiple
  140.          machines up to the number permitted by your license (in the case of
  141.          a Corporate license). When installed on a file server, the number
  142.          of authorized users must not exceed that permitted by your license.
  143.  
  144.       3. When provided on floppy, you may make a single copy of the floppy
  145.          disk containing this software solely for backup or archival
  146.          purposes.
  147.  
  148.       4. Neither Bitware Australia Pty. Ltd. or its suppliers shall be
  149.          responsible for replacement of media or license details in the
  150.          event of loss or damage other than for physical defects in original
  151.          materials as supplied.
  152.  
  153.       5. This software is copyright material of Bitware Australia Pty. Ltd.
  154.          and is covered by international copyright laws and treaty
  155.          provisions. You may not alter, decompile or disassemble the
  156.          software.
  157.  
  158.       6. You may not resell, rent, lease or otherwise transfer your license
  159.          to any other party without the express permission of Bitware
  160.          Australia Pty. Ltd.
  161.  
  162.       7. This software is provided as is without any warranty, expressed or
  163.          implied, including but not limited to fitness for a particular
  164.          purpose.
  165.  
  166.       8. In no event shall Bitware Australia Pty. Ltd. or its suppliers be
  167.          liable for any damages whatsoever (including, without limitation,
  168.          damages for loss of business profits, business interruption, loss
  169.          of business information, or other pecuniary loss) arising out of
  170.          use of or inability to use the software.
  171.  
  172.  
  173. HP SCANJET SUPPORT:
  174.  
  175.    Galleria will support scanning with the HP ScanJet family of desktop
  176.    scanners provided that you have the appropriate OS/2 driver installed.
  177.    This driver could be provided by HP (none currently exists), a third-
  178.    party driver, or the BITWARE9.SYS included in this package and placed
  179.    in your installation directory.
  180.  
  181.    The BITWARE9.SYS driver supports HP ScanJets when attached to any OS/2
  182.    supported SCSI adapter. It does *not* directly support the HP-supplied
  183.    controller card. To use the BITWARE9.SYS driver you must manually add
  184.    the following statements to CONFIG.SYS:
  185.  
  186.          BASEDEV=OS2SCSI.DMD
  187.          DEVICE=d:\directory\BITWARE9.SYS
  188.  
  189.    changing the directory name in the DEVICE statement as appropriate. Turn
  190.    the scanner on and re-boot OS/2. Scan options should now appear in the
  191.    Galleria File menu. If you experience conflicts with other ASPI-based
  192.    scanner drivers you may need to modify the following statement in
  193.    CONFIG.SYS:
  194.  
  195.          BASEDEV=OS2ASPI.DMD /SHARE
  196.  
  197.    If you experience an error the first time the scanner is accessed, select
  198.    "Retry" from the options displayed.
  199.  
  200.  
  201. DISPLAY DRIVER PROBLEMS:
  202.  
  203.    Galleria, as a graphics-intensive application, demands a high level of
  204.    support from display drivers. It is recommended that you ensure that you
  205.    have the latest version of display driver installed for your display
  206.    adapter type prior to installation.
  207.  
  208.    With most errors (including exceptions, incorrect colors or scrolling
  209.    problems), this is normally an indication that the display driver
  210.    currently installed does not fully support the default display mode
  211.    used by Galleria. These problems may disappear if you change the driver
  212.    settings to use a different color depth. If not, you should be able to
  213.    bypass the problem by enabling the "Use fallback display mode for screen
  214.    writes" option in the Galleria Preferences dialog. For a permanent fix,
  215.    contact the vendor of your display adapter for an updated driver.
  216.  
  217.  
  218. PERFORMANCE CONSIDERATIONS:
  219.  
  220.    Memory requirements will depend on the size of the image being processed
  221.    and level of edits required. In most cases performance can be improved by
  222.    setting the pre-allocated size of your SWAPPER.DAT file to a large value
  223.    (eg. 16MB). The SWAPPATH statement in CONFIG.SYS would look something
  224.    like this:
  225.  
  226.                          SWAPPATH=d:\ 4096 16384
  227.  
  228.  
  229. DDE TOOLKIT:
  230.  
  231.    A DDE (Dynamic Data Exchange) toolkit is available which demonstrates how
  232.    to drive Galleria from your own application for the loading and display
  233.    of images. The DDE interface implemented is not intended to enable
  234.    Galleria to be used as a general purpose server, but specifically to add
  235.    image handling capabilities to other applications lacking this support.
  236.  
  237.    The toolkit consists of the full C language source, IBM C Set++ makefile
  238.    etc. of a simple OS/2 PM client. You are free to model your own client on
  239.    this sample program.
  240.  
  241.    The sample client source is included in the demo package or on the floppy
  242.    as DDE.ZIP.
  243.  
  244.  
  245. UPDATE HISTORY:
  246.  
  247.    Changes since Version 2.2 include:
  248.  
  249.       o fixed support for RLE_24 encoded OS/2 2.x BMP files
  250.       o added support for TIFF RGB files with ExtraSamples per pixel
  251.       o attempt load of GIF images with zero screen size
  252.       o enable support for generic "HPSCAN" driver interface
  253.       o do in-place rotation for vertical PhotoCD images
  254.       o updated JPEG import/export logic to IJG 5a level
  255.       o updated PhotoCD logic to allow for missing residual data
  256.       o updated logic for detection of correct PhotoCD orientation
  257.       o enable GIF 89a output with interlaced/transparency options
  258.       o added option to disable rotation on load of PhotoCD images
  259.       o added ability to read/write PNG files
  260.       o modified popup menu to display until selection by keyboard/mouse
  261.       o added File Browse facility to display thumbnail images
  262.       o added option to save/retrieve thumbnails as EAs
  263.       o added Preferences option to specify thumbnail size
  264.       o expanded format detection for files with MacBinary header
  265.       o fixed missing sub-directories on disks using Windows 95 file system
  266.       o fixed duplicate directory names when selecting existing disk
  267.       o flash selected color in Edit Palette dialog
  268.       o write install options to INSTALL.INI to assist replication
  269.       o removed usage of GALLERIA.LAN for license propagation
  270.       o modified license terms to comply with Unisys GIF-LZW agreement
  271.  
  272.    Changes since Version 2.3 include:
  273.  
  274.       o fixed intermittent bug with load of 64Base PhotoCD images
  275.       o added Web colors option to Convert color function
  276.       o changed Paint Directly cutoff value to fallback switch
  277.       o enable live update of scan preview display with changes to settings
  278.  
  279.  
  280. SALES/TECHNICAL SUPPORT:
  281.  
  282.    Full sales and technical support for this software is provided on the
  283.    OS2AVEN forum on CompuServe. Send a message to "Galleria support" at
  284.    100033,340 in section 1.
  285.  
  286.    Updated versions and fixes to this software will also be available for
  287.    download from library 1 of this forum.
  288.  
  289.    Major updates will be available for download from the Internet ftp site
  290.    ftp-os2.cdrom.com (and mirror sites) as /pub/os2/graphics/gallerxx.zip.
  291.  
  292.    You are encouraged to download updates from the locations above. There
  293.    will be no charge for any Galleria Version 2.x updates when so
  294.    downloaded. To make full use of such updates, make sure you retain your
  295.    license details.
  296.  
  297.  
  298. CONTACT:
  299.  
  300.    Bitware Australia Pty. Ltd.
  301.    P.O. Box 3097
  302.    Manuka  A.C.T.  2603
  303.    Australia
  304.  
  305.    Fax:        +61-6-2810175
  306.    CompuServe: 100033,340
  307.    Internet:   bitware@ibm.net
  308.  
  309.