Galleria and Galleria/CM (Capture Module)
Version 1.5 - June 12, 1993 together provide
a complete package for the display, edit,
printing and conversion of bitmapped images
for systems using IBM OS/2 2.0 (or later).
Both are high-performance 32-bit tools which
exploit OS/2 2.0 features such as large
memory space and multiple threads.

Galleria and Galleria/CM (Capture Module)
Version 1.5 - June 12, 1993 together provide
a complete package for the display, edit,
printing and conversion of bitmapped images
for systems using IBM OS/2 2.0 (or later).
Both are high-performance 32-bit tools which
exploit OS/2 2.0 features such as large
memory space and multiple threads.

Galleria and Galleria/CM (Capture Module)
-----------------------------------------

Version 1.5 - June 12, 1993


(c) Copyright 1991-1993
Bitware, Software & Services


Galleria and Galleria/CM together provide a complete package for the display,
edit, printing and conversion of bitmapped images for systems using IBM OS/2
2.0 (or later). Both are high-performance 32-bit tools which exploit OS/2 2.0
features such as large memory space and multiple threads. As Presentation
Manager applications, they feature ease of use and interoperability with other
applications on the desktop. Comprehensive online help is also available.


Galleria is a general purpose tool for the management of bitmapped images. It
provides a window for the display of bitmaps at varying resolutions. Bitmaps
can be read from the OS/2 clipboard or from disk in numerous formats. Once
loaded, the displayed image can be edited (cropped, resized, rotated etc.) and
converted to monochrome or grayscale. The result can be transferred to other
applications via the clipboard or saved on disk in a different format. High
quality printed output can also be generated.

Galleria supports a file search function to list all bitmaps available. Also,
a multi-level undo capability is provided to reverse previous edits. Concurrent
operation of most tasks (such as display, conversion, file save and printing)
is possible due to OS/2's multi-threading capability.

Galleria supports all common bitmap file formats including BMP, PCX, TIFF and
GIF. Kodak Photo-CD and JPEG (JFIF) formats are also supported for import.
Refer to the online documentation for a complete list of supported file formats
(for import and export).


Galleria/CM (Capture Module) is an optional add-on to Galleria. This utility
can take a snapshot of the current OS/2 desktop contents and save the captured
image as a bitmap. A number of options exist to control both the portion of the
desktop captured and the destination for the bitmap. A capture is initiated by
double-clicking on the Galleria/CM icon or (optionally) pressing the Print
Screen key. Various options for the capture can be set by invoking the Options
dialog from the pop-up system menu.

Galleria/CM supports a full desktop capture, all windows for selected
applications, a selected region of the desktop or a complete window or window
client area. For desktop, application and active window captures, a delay can
be set to enable the desktop contents to be arranged prior to the capture.

Once the capture is complete, the captured image can be:

- placed in the system clipboard for subsequent use by any application
- displayed by Galleria for immediate post-processing, conversion etc.
- saved as a file on disk in numerous formats
- printed at a specified size and resolution on any attached printer


Galleria and Galleria/CM require either IBM OS/2 2.0 (at CSD level XR06055) or
IBM OS/2 2.1. Use on OS/2 2.0 prior to application of the 2.0 Service Pack or
on beta code is NOT supported.

--------------------------------------------------------------------------------

Do you have the LATEST copy of Galleria and Galleria/CM? Updated versions of
this software will be uploaded (together) to both the OS2USER forum on
CompuServe (as GALLER.ZIP) and the Fernwood BBS on +1-203-483-0348
(as GALLERnn.ZIP). Licensed users can also download these files periodically
to avail themselves to enhancements, bug fixes etc.

--------------------------------------------------------------------------------

New in this version:

- added alternative of using Print Screen key to trigger CM captures
- conversion of image to 'standard' 256 colors (closest or dither) added
- added import support for JPEG (JFIF) baseline files
- modified File Open and Save dialogs to prompt for directory
- discard background on import of single-image GIF files
- added Image Border option for setting colored border
- added uncompressed/compressed options on save of BMP, TGA and TIFF files
- answers to commonly asked questions about Galleria added to online docs
- added option for changing image brightness and contrast

--------------------------------------------------------------------------------

Installation instructions:

- Delete all files (excluding .KEY files) associated with previously
installed versions of Galleria and Galleria/CM.

- Copy all files to a directory of your choice. The GALLERIA.EXE and
GALLERCM.EXE files must both reside in the same directory for Galleria/CM
captures with the "Editor" destination to function.

- If you are a licensed user, copy the GALLERIA.KEY and/or GALLERCM.KEY
file(s) to the same directory as above.

- Optionally, type "EAUTIL GALLERIA.EXE GALLERIA.EA /j" to attach the
extended attributes to the Galleria executable. These attributes contain
file association information to enable Galleria to be added to the "Open"
menu of all bitmap files. Refer to the online OS/2 Command Reference for
information on the EAUTIL utility.

- Update the LIBPATH and SET HELP statements in CONFIG.SYS with an explicit
reference to the directory containing the .DLL and .HLP files. Re-boot to
implement CONFIG.SYS changes.

- Create desktop icons with program references for both GALLERIA.EXE and
GALLERCM.EXE. DO NOT drag the icons representing the executables from the
file system (Drives window). Instead, take a copy (Ctrl+drag) of an
existing icon (eg. anything in the system Command Prompts folder), open
the settings notebook and edit the "Program" parameters with the
complete path name of each file. (The "Working directory" may differ
from that containing the executable.) The icon title can be set on the
"General" page of the settings notebook.

- For the Galleria/CM program reference icon created for GALLERCM.EXE, open
the settings notebook (right mouse button on the icon), select the
"Window" page and set the "Minimized button behaviour" to "Minimize window
to desktop". This setting is MANDATORY for correct operation.

- To use the Print Screen key as a trigger to initiate captures with
Galleria/CM, add the "-k" switch to the Optional parameters field of
the Program page in the settings notebook.

- Double click on the program reference icon to start each program.

- Type "VIEW GALLERIA.INF" or "VIEW GALLERCM.INF" to read program
documentation. For printed documentation, select Print/All sections. All
the information contained in these files is also available by invoking
online help.


De-installation instructions:

(These instructions apply ONLY if extended attributes were attached with
EAUTIL during installation.)

- Delete both program reference icons and all files. If the extended
attributes were applied, deleting GALLERIA.EXE will restore ICONEDIT as
the default on the Open menu of bitmap files. Note that there may be a
delay before such a change takes effect.

- To restore templates, open the settings notebook for the icon in the
templates folder with the "G" and press "Default" on the "General" page.
Make sure that the template status is retained.

--------------------------------------------------------------------------------

License information:

These copies of Galleria and Galleria/CM are provided with a limited evaluation
license not exceeding 21 days in duration from first use. Unregistered use
beyond this evaluation period is in violation of this license, as is use for
any commercial purpose prior to registration.

If you find Galleria (and optionally Galleria/CM) useful and would like to
register this software, a license fee is payable. Registration of this software
will entitle you (or your corporation) to unlimited use of current and
subsequent releases of the product(s) plus best-effort support via CompuServe.

Two license types are available: individual and corporate. An individual license
is for the sole use of the named individual. A single corporate license entitles
use by all employees/members of the named corporation/institution.

A software key made out in the name of an individual or corporation is returned
when the software is registered. Please indicate the license type required.


How to register Galleria and Galleria/CM:

- Send a mail message to CompuServe 100033,340 with your credit card
details (card number, full name on card and expiry date). The following
cards are accepted: Mastercard, Visa and Amex.

A software key for enablement of unlimited use will be returned to your
CompuServe id.

- Send a fax to +61-6-2810175 with credit card particulars.

The current version plus software key will be sent on 3.5 inch floppy to
the address you specify. Delivery (by airmail) is normally 2 weeks
from receipt of order. A shipping & handling charge will apply.

- Post either credit card particulars or a cheque/check for the
appropriate registration fee (in Australian currency or converted
equivalent) to:

Bitware, Software & Services
P.O. Box 3097
Manuka A.C.T. 2603
Australia

The current version plus software key will be sent on 3.5 inch floppy
to the address you specify. Delivery (by airmail) is normally 2 weeks
from receipt of order. A shipping & handling charge will apply.

- Purchase Orders (on company letterhead) will be accepted for corporate
license ONLY. Please include a contact name and fax number for queries.
Fax your order to +61-6-2810175, or post to:

Bitware, Software & Services
P.O. Box 3097
Manuka A.C.T. 2603
Australia

The current version plus software key will be sent on 3.5 inch floppy
to the address you specify. Delivery (by airmail) is normally 2 weeks
from receipt of order. A shipping & handling charge will apply.


Conditions:

- Use a separate order form for each licensee.

- All orders on Amex must include the 4 digit identification code (non-
embossed number).

- All credit card payments will be charged in Australian currency (AUD).
Payment by cheque/check can be made in AUD, quoted USD equivalents or
other currency at current exchange rates.

- A shipping & handling charge is applicable to all international orders
(EXCLUDING those via CompuServe where postage of the software and key(s)
is optional).

- Quoted prices are exclusive of local taxes, customs duty etc. The licensee
shall be solely responsible for payment of such taxes (where applicable).


See the enclosed ORDER.DOC file for order details and pricing.

--------------------------------------------------------------------------------

Attention Nikon II licensees

Nikon II, Bitware's screen capture utility, is no longer available as a
separate product. It has been replaced by Galleria/CM (Capture Module),
available only as an optional add-on to Galleria. If you have previously
licensed Nikon II and wish to switch to Galleria/CM, simply rename your
NIKON2.KEY file to GALLERCM.KEY and place in the same directory as
GALLERCM.EXE.

See the enclosed ORDER.DOC for pricing on upgrades to a combined Galleria and
Galleria/CM license.

--------------------------------------------------------------------------------

This software is based in part on the work of the Independent JPEG Group.

--------------------------------------------------------------------------------

THESE PROGRAMS ARE SHAREWARE AND AS SUCH YOU ARE PERMITTED TO DISTRIBUTE THEM
WITHOUT CHARGE PROVIDED THAT ALL FILES (EXCLUDING KEY FILES) ARE UNMODIFIED AND
DISTRIBUTED TOGETHER. DUE COPYRIGHT MUST BE OBSERVED. THESE PROGRAMS ARE
PROVIDED AS IS WITHOUT ANY WARRANTY, EXPRESSED OR IMPLIED, INCLUDING BUT NOT
LIMITED TO FITNESS FOR A PARTICULAR PURPOSE.

ALL TRADEMARKS AND SERVICE MARKS ARE THE PROPERTY OF THEIR RESPECTIVE OWNERS.