home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 February / PCWK0296.iso / sharewar / os2 / grafika / galleria / readme.doc < prev    next >
Text File  |  1995-01-23  |  12KB  |  277 lines
  1.  
  2.                            Galleria and Galleria/CM
  3.                            ------------------------
  4.  
  5.                         Version 2.2 - January 24, 1995
  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 or 3.0, or OS/2 for Windows. 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. Direct
  22.    support is provided for input from HP ScanJet desktop scanners. Once
  23.    loaded, the displayed image can be edited (cropped, resized, rotated etc.)
  24.    and converted to monochrome or grayscale. The modified image can be
  25.    transferred to other applications via the clipboard or saved on disk in a
  26.    different format. High quality monochrome or color printed output can
  27.    also be generated.
  28.  
  29.    Galleria reads and writes common bitmap file formats including BMP, JPEG,
  30.    PCX, Targa, TIFF and WPG, plus OS/2 metafiles. Full support is provided
  31.    for the import of Kodak Photo CD and Pro Photo CD images.
  32.  
  33.    Additional features include drag/drop support, a file search function,
  34.    multi-level undo/redo, filters, the ability to create saved lists for
  35.    screen shows, a floating zoom window and limited DDE capability.
  36.  
  37.    Galleria/CM (Capture Module) can take a snapshot of the current OS/2
  38.    desktop contents and copy the resultant image to the clipboard, disk or
  39.    printer. Galleria can also be invoked automatically for post-processing
  40.    of the captured image. An options dialog enables selection of either the
  41.    full desktop, window or region for the capture.
  42.  
  43.    Galleria/CM operations can be controlled from either an icon on the
  44.    desktop or the keyboard (with the Print Screen key).
  45.  
  46.    Online manuals for both Galleria and Galleria/CM are provided as part of
  47.    the package.
  48.  
  49.  
  50. SOFTWARE/HARDWARE REQUIREMENTS:
  51.  
  52.    Minimum:
  53.  
  54.      o IBM OS/2 2.1, 2.11 or 3.0, OS/2 for Windows
  55.      o 386SX
  56.      o 6MB total memory
  57.      o VGA, SVGA or XGA card with appropriate display driver
  58.      o Mouse
  59.      o 750KB free disk space
  60.  
  61.    Recommended:
  62.  
  63.      o IBM OS/2 3.0
  64.      o 486DX (or better)
  65.      o 8MB-12MB total memory, 16MB+ for highest Photo CD resolutions
  66.      o Video card/display driver combination supporting 256 (or more) colors
  67.  
  68.  
  69. LICENSING:
  70.  
  71.    License details must be entered when the software is first started. These
  72.    will be provided when the software is licensed. 
  73.  
  74.    A limited function demonstration of this software is available by entering
  75.    "DEMO" in the license name field when the software is started. The saving
  76.    of files to disk and printing will be disabled, nor will personal
  77.    preferences be retained across sessions.
  78.  
  79.    Note: upgrades are available to licensees of 1.x versions of this software.
  80.    Please see the UPGRADES section in the ORDER.DOC file.
  81.  
  82.  
  83. INSTALLATION:
  84.  
  85.    To install the software, online documentation etc. you must run the
  86.    INSTALL.EXE utility provided. This graphical utility will prompt for
  87.    installation options and destination. All tasks performed as part of the
  88.    installation process will be displayed in a scrollable log. This utility
  89.    can also be used to fully de-install the software.
  90.  
  91.    The installation process can be classified as one of the following three
  92.    types:
  93.  
  94.    o Individual
  95.  
  96.      This applies when you have an INDIVIDUAL license and wish to install
  97.      the software on a standalone machine. For this type of install you must
  98.      elect to have the install utility copy files to the specified
  99.      directories. On completion, you should have a new folder on your
  100.      desktop with icons for Galleria etc. You can then start the software by
  101.      double-clicking on the required icon. The first time you start Galleria
  102.      or Galleria/CM you will be prompted for your license details. These
  103.      will be preserved across subsequent sessions or installs.
  104.  
  105.    o Server
  106.  
  107.      If you have a CORPORATE license you can install the software on a LAN
  108.      server for use by multiple clients (subject to the maximum number of
  109.      users permitted by your license). The install process is similar to
  110.      that for an Individual install above. The difference is that when you
  111.      start the software and enter license details, a file named
  112.      GALLERIA.LAN will be written to disk in the same directory as the
  113.      executables. (You must have write permission to this directory to
  114.      enable this file to be created.) When you start the software from a
  115.      client on the LAN, it will look for this file and license details will
  116.      be propagated automatically. Note that the GALLERIA.LAN file will be
  117.      invalidated if moved to another disk or server and will need to be
  118.      recreated.
  119.  
  120.    o Client
  121.  
  122.      After a copy of the software licensed for CORPORATE use has been
  123.      installed on the server (and the GALLERIA.LAN file created) you can
  124.      then proceed to install the software on clients attached to the LAN.
  125.      For a client install you should deselect the option to "Copy files to
  126.      directories", instead entering directories of those on the server
  127.      where the software resides. The install will then create icons
  128.      pointing to the server copy of the software. You will not be prompted
  129.      for license details (unless the server copy has been incorrectly
  130.      installed or the GALLERIA.LAN file has been invalidated).
  131.  
  132.    For installation of a copy of software licensed for CORPORATE use on
  133.    a standalone machine, proceed as per the Server install above. The
  134.    GALLERIA.LAN file should be retained.
  135.  
  136.    For an "unlimited use" CORPORATE license, a customized copy of the
  137.    Galleria executables is supplied. You will not be prompted for license
  138.    details as these stored permanently in the executables. You are free to
  139.    install the software on workstations or servers as required.
  140.  
  141.    Note: if you have a previous version of this software installed, you must
  142.    ensure that old versions of the library (BITWAREx.DLL) files are deleted.
  143.  
  144.  
  145. HP SCANJET SUPPORT:
  146.  
  147.    Included is (optional) support for the HP ScanJet family of desktop
  148.    scanners when attached to an OS/2 supported SCSI adapter (no support is
  149.    currently provided for the HP-supplied controller card).
  150.  
  151.    To enable scanner support you must manually add the following statements
  152.    to CONFIG.SYS:
  153.  
  154.          BASEDEV=OS2SCSI.DMD
  155.          DEVICE=d:\directory\BITWARE9.SYS
  156.  
  157.    changing the directory name in the DEVICE statement as appropriate.
  158.  
  159.    Turn the scanner on and re-boot OS/2. Scan options should now appear
  160.    in the Galleria File menu.
  161.  
  162.  
  163. DISPLAY DRIVER PROBLEMS:
  164.  
  165.    Galleria, as a graphics-intensive application, demands a high level of
  166.    support from display drivers. It is recommended that you ensure that you
  167.    have the latest version of display driver installed for your display
  168.    adapter type prior to installation.
  169.  
  170.    Below are fixes or bypasses for common problems that may be experienced:
  171.  
  172.    o Failure with SYS317x/SYS318x etc. when loading first image with VGA and
  173.      SVGA drivers. Replacement IBMVGA32.DLL and IBMDEV32.DLL modules are
  174.      included in the floppy-based version of this software in PJ10311.ZIP.
  175.      These modules are also available for download from the OS2AVEN forum
  176.      on CompuServe (as GALPTF.ZIP). Alternatively, contact IBM Support
  177.      requesting the fix for APAR PJ10311.
  178.  
  179.      This problem has been fixed in OS/2 3.0.
  180.  
  181.    o Scrolling errors with 8514/A, S3 and ATI drivers. Bad data may be
  182.      displayed in the scrolled area or even outside of Zoom window. This
  183.      may also result in lockups on S3 systems. Contact IBM Support
  184.      requesting the fix for APAR PJ12059.
  185.  
  186.      For ATI cards, contact ATI Technologies for a fix.
  187.  
  188.    o Miscellaneous errors (including exceptions, incorrect colors or
  189.      scrolling problems) with other drivers. This is normally an indication
  190.      that the display driver currently installed does not fully support
  191.      the default "direct" paint mode used by Galleria. These problems may
  192.      disappear if you change the driver settings to use a different color
  193.      depth. If not, you should be able to bypass the problem by setting the
  194.      "Paint directly" cutoff value to the maximum in the Galleria
  195.      Preferences dialog. For a permanent fix, contact the vendor of your
  196.      display adapter for an updated driver.
  197.  
  198.  
  199. PERFORMANCE CONSIDERATIONS:
  200.  
  201.    Memory requirements will depend on the size of the image being processed
  202.    and level of edits required. In most cases performance can be improved by
  203.    setting the pre-allocated size of your SWAPPER.DAT file to a large value
  204.    (eg. 16MB). The SWAPPATH statement in CONFIG.SYS would look something
  205.    like this:
  206.  
  207.                          SWAPPATH=d:\ 4096 16384
  208.  
  209.  
  210. DDE TOOLKIT
  211.  
  212.    A DDE (Dynamic Data Exchange) toolkit is available which demonstrates how
  213.    to drive Galleria from your own application for the loading and display
  214.    of images. The DDE interface implemented is not intended to enable
  215.    Galleria to be used as a general purpose server, but specifically to add
  216.    image handling capabilities to other applications lacking this support.
  217.  
  218.    The toolkit consists of the full C language source, IBM C Set++ makefile
  219.    etc. of a simple OS/2 2.x PM client. You are free to model your own
  220.    client on this sample program.
  221.  
  222.    The sample client source is included in the floppy based version of this
  223.    software in as DDE.ZIP. This is also available for download from the OS2AVEN
  224.    forum on CompuServe (as GALDDE.ZIP).
  225.  
  226.  
  227. UPDATE HISTORY:
  228.  
  229.    Changes since Version 2.1 include:
  230.  
  231.       o use default icon for folder created with install
  232.       o provide position/size info in status line for crop/merge operations
  233.       o added random option to list show function
  234.       o added basic set of image filters
  235.       o restriction on concurrent read and write of JPEG files removed
  236.       o removed fixed scaling factors with Scale to Window option
  237.       o fixed divide exception with Galleria/CM Print to Scale option
  238.       o revised logic for IFF files, 4096 color "HAM" files now supported
  239.       o added support for 4bpp GEM IMG files (grayscale and color)
  240.       o added support for Huffman-1D compressed monochrome OS/2 BMP files
  241.       o improved load times for 4Base, 16Base and 64Base Photo CD images
  242.       o enable separate paths/formats for Open and Save
  243.       o fixed bug with save of files in compressed TIFF format
  244.       o reset desktop palette immediately on exit
  245.       o updated resampling filter used for resizing
  246.       o expanded color conversion options (added 32, 64 and system colors)
  247.       o accept drag/drop operation if *any* are files (rather than *all*)
  248.       o removed ColorMap tag on output of grayscale TIFF files
  249.       o removed GIF output logic (pending resolution of LZW patent debacle)
  250.       o corrected negative output of monochrome MET files
  251.       o accept drag/drop file items with missing (DRF_UNKNOWN) format type
  252.       o fixed exception when printing large page area at high resolution
  253.       o added HP ScanJet support
  254.  
  255.  
  256. SALES/TECHNICAL SUPPORT:
  257.  
  258.    Full sales and technical support for this software is provided on the
  259.    OS2AVEN forum on CompuServe. Send a message to "Galleria support" at
  260.    100033,340 in section 1.
  261.  
  262.    Updated versions and fixes to this software will also be available for
  263.    download from library 1 of this forum.
  264.  
  265.  
  266. CONTACT:
  267.  
  268.    Bitware Australia Pty. Ltd.
  269.    P.O. Box 3097
  270.    Manuka  A.C.T.  2603
  271.    Australia
  272.  
  273.    Fax:        +61-6-2810175
  274.    CompuServe: 100033,340
  275.    Internet:   bitware@ibm.net
  276.  
  277.