Galleria and Galleria/CM ------------------------ Version 2.31 - July 18, 1996 DESCRIPTION: Galleria and Galleria/CM together provide a sophisticated yet easy to use environment for the display, editing, printing, conversion, scanning and capture of bitmapped images for 32-bit Intel-based systems using IBM OS/2 2.1, 2.11, Warp 3.0, Warp Connect or OS/2 for Windows. Both are high-performance tools which exploit OS/2 features such as large memory space and multiple threads. As Presentation Manager applications, they feature ease of use and full interoperability with other applications on the desktop. Galleria is general purpose tool for the management of bitmapped images. It provides a window for the display of images at varying resolutions on all OS/2-supported display subsystems (up to 24-bit). Images can be read from the OS/2 clipboard or from disk in numerous formats. Direct support is provided for input from HP ScanJet desktop scanners. Once loaded, the displayed image can be edited (cropped, resized, rotated etc.) and converted to monochrome or grayscale. The modified image can be transferred to other applications via the clipboard or saved on disk in a different format. Monochrome or color printed output can also be generated. Galleria reads and writes common bitmap file formats including BMP, GIF, JPEG, PCX, PNG, Targa, TIFF and WPG, plus OS/2 metafiles. Full support is provided for the import of Kodak Photo CD and Pro Photo CD images. Additional features include drag/drop support, a browse facility with saved thumbnails, a file search function, multi-level undo/redo, filters, the ability to create saved lists for screen shows, a floating zoom window and limited DDE capability. Galleria/CM (Capture Module) can take a snapshot of the current OS/2 desktop contents and copy the resultant image to the clipboard, disk or printer. Galleria can also be invoked automatically for post-processing of the captured image. An options dialog enables selection of either the full desktop, window or region for the capture. Galleria/CM operations can be controlled from either an icon on the desktop or the keyboard (with the Print Screen key). Online manuals for both Galleria and Galleria/CM are provided as part of the package. SOFTWARE/HARDWARE REQUIREMENTS: Minimum: o IBM OS/2 2.1, 2.11, Warp 3.0, Warp Connect or OS/2 for Windows o 386SX o 6MB total memory o VGA, SVGA or XGA card with appropriate display driver o Mouse o 800KB free disk space Recommended: o IBM OS/2 Warp 3.0, Warp Connect o 486DX (or better) o 8MB-12MB total memory, 16MB+ for highest Photo CD resolutions o Video card/display driver combination supporting 64K or 16M colors INSTALLATION: To install the software, online documentation etc. you must run the INSTALL.EXE utility provided. This graphical utility will prompt you for destination directories and installation options. All tasks performed as part of the installation process will be displayed in a scrollable log. This utility can also be used to fully de-install the software. For an Individual license, the software may be installed on a single machine only. Enable all installation options. On completion of the install process, you will have a new folder on your desktop with icons for the software and documentation. You can then start the software or read documentation by double-clicking on the respective icons. The first time you start Galleria or Galleria/CM you will be prompted for your license details. For a Corporate license, you have the option of proceeding as per an Individual license above or, alternatively, you can first install a copy of the software on a file server. For each LAN-attached client, run the installation utility entering the full path name of the directories on the server and deselect the option to copy files. The folder and icons created on the desktop will reference the server copy of the software. The first time you start Galleria or Galleria/CM you will be prompted for your license details. When installing the software on a large number of machines (up to the maximum permitted by your license) you may want to preset options for each install. See the "Replicating installation options" section in the online help of the installation utility for more information. A customized copy of this software with license details incorporated is available on request to Corporate licensees with a 100+ user license. Note: If you have a previous version of this software installed, you must ensure that any old versions of the library (BITWAREx.DLL) files are either overwritten by the INSTALL.EXE utility provided, or otherwise deleted. EVALUATION: When not licensed, this software is provided for evaluation purposes only. You have thirty (30) days to complete evaluation. After this period, should you decide not to purchase a license, this software must be completely removed from your disk using the INSTALL.EXE provided. For evaluation, enter "DEMO" in the license name field when the software is started. In this mode, the following features are disabled: o Saving files and lists to disk o Printing o Retention of preferences and settings across sessions o Option to save thumbnails as Extended Attributes Full functionality will be enabled by entry of valid license details at startup. LICENSE AGREEMENT: Below is the full text of the license agreement which must be acknowledged on entry of license details: 1. A license for use of this software is granted to the named licensee (or official representative in the case of a Corporate license) only. 2. This software is licensed for installation and use on a single machine (in the case of an Individual license), or multiple machines up to the number permitted by your license (in the case of a Corporate license). When installed on a file server, the number of authorized users must not exceed that permitted by your license. 3. When provided on floppy, you may make a single copy of the floppy disk containing this software solely for backup or archival purposes. 4. Neither Bitware Australia Pty. Ltd. or its suppliers shall be responsible for replacement of media or license details in the event of loss or damage other than for physical defects in original materials as supplied. 5. This software is copyright material of Bitware Australia Pty. Ltd. and is covered by international copyright laws and treaty provisions. You may not alter, decompile or disassemble the software. 6. You may not resell, rent, lease or otherwise transfer your license to any other party without the express permission of Bitware Australia Pty. Ltd. 7. This software is provided as is without any warranty, expressed or implied, including but not limited to fitness for a particular purpose. 8. In no event shall Bitware Australia Pty. Ltd. or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of use of or inability to use the software. HP SCANJET SUPPORT: Galleria will support scanning with the HP ScanJet family of desktop scanners provided that you have the appropriate OS/2 driver installed. This driver could be provided by HP (none currently exists), a third- party driver, or the BITWARE9.SYS included in this package and placed in your installation directory. The BITWARE9.SYS driver supports HP ScanJets when attached to any OS/2 supported SCSI adapter. It does *not* directly support the HP-supplied controller card. To use the BITWARE9.SYS driver you must manually add the following statements to CONFIG.SYS: BASEDEV=OS2SCSI.DMD DEVICE=d:\directory\BITWARE9.SYS changing the directory name in the DEVICE statement as appropriate. Turn the scanner on and re-boot OS/2. Scan options should now appear in the Galleria File menu. If you experience conflicts with other ASPI-based scanner drivers you may need to modify the following statement in CONFIG.SYS: BASEDEV=OS2ASPI.DMD /SHARE If you experience an error the first time the scanner is accessed, select "Retry" from the options displayed. DISPLAY DRIVER PROBLEMS: Galleria, as a graphics-intensive application, demands a high level of support from display drivers. It is recommended that you ensure that you have the latest version of display driver installed for your display adapter type prior to installation. With most errors (including exceptions, incorrect colors or scrolling problems), this is normally an indication that the display driver currently installed does not fully support the default display mode used by Galleria. These problems may disappear if you change the driver settings to use a different color depth. If not, you should be able to bypass the problem by enabling the "Use fallback display mode for screen writes" option in the Galleria Preferences dialog. For a permanent fix, contact the vendor of your display adapter for an updated driver. PERFORMANCE CONSIDERATIONS: Memory requirements will depend on the size of the image being processed and level of edits required. In most cases performance can be improved by setting the pre-allocated size of your SWAPPER.DAT file to a large value (eg. 16MB). The SWAPPATH statement in CONFIG.SYS would look something like this: SWAPPATH=d:\ 4096 16384 DDE TOOLKIT: A DDE (Dynamic Data Exchange) toolkit is available which demonstrates how to drive Galleria from your own application for the loading and display of images. The DDE interface implemented is not intended to enable Galleria to be used as a general purpose server, but specifically to add image handling capabilities to other applications lacking this support. The toolkit consists of the full C language source, IBM C Set++ makefile etc. of a simple OS/2 PM client. You are free to model your own client on this sample program. The sample client source is included in the demo package or on the floppy as DDE.ZIP. UPDATE HISTORY: Changes since Version 2.2 include: o fixed support for RLE_24 encoded OS/2 2.x BMP files o added support for TIFF RGB files with ExtraSamples per pixel o attempt load of GIF images with zero screen size o enable support for generic "HPSCAN" driver interface o do in-place rotation for vertical PhotoCD images o updated JPEG import/export logic to IJG 5a level o updated PhotoCD logic to allow for missing residual data o updated logic for detection of correct PhotoCD orientation o enable GIF 89a output with interlaced/transparency options o added option to disable rotation on load of PhotoCD images o added ability to read/write PNG files o modified popup menu to display until selection by keyboard/mouse o added File Browse facility to display thumbnail images o added option to save/retrieve thumbnails as EAs o added Preferences option to specify thumbnail size o expanded format detection for files with MacBinary header o fixed missing sub-directories on disks using Windows 95 file system o fixed duplicate directory names when selecting existing disk o flash selected color in Edit Palette dialog o write install options to INSTALL.INI to assist replication o removed usage of GALLERIA.LAN for license propagation o modified license terms to comply with Unisys GIF-LZW agreement Changes since Version 2.3 include: o fixed intermittent bug with load of 64Base PhotoCD images o added Web colors option to Convert color function o changed Paint Directly cutoff value to fallback switch o enable live update of scan preview display with changes to settings SALES/TECHNICAL SUPPORT: Full sales and technical support for this software is provided on the OS2AVEN forum on CompuServe. Send a message to "Galleria support" at 100033,340 in section 1. Updated versions and fixes to this software will also be available for download from library 1 of this forum. Major updates will be available for download from the Internet ftp site ftp-os2.cdrom.com (and mirror sites) as /pub/os2/graphics/gallerxx.zip. You are encouraged to download updates from the locations above. There will be no charge for any Galleria Version 2.x updates when so downloaded. To make full use of such updates, make sure you retain your license details. CONTACT: Bitware Australia Pty. Ltd. P.O. Box 3097 Manuka A.C.T. 2603 Australia Fax: +61-6-2810175 CompuServe: 100033,340 Internet: bitware@ibm.net Galleria and Galleria/CM ------------------------ Order Forms and Information GENERAL INFORMATION: Please read the contents of the README.DOC file in full prior to registration. The conditions below apply: o Use a separate order form for each licensee. o All credit card orders (except email orders) must be signed by the cardholder. o All orders on Amex must include the 4 digit identification code (non- embossed number on the face of the card). o Make sure you include all digits of your credit card number. Visa card numbers have either 13 or 16 digits. Mastercards always have 16 digits. o All credit card payments will be charged in Australian currency (AUD). US dollar equivalents quoted in the order forms below are approximate only and the actual amount charged may vary slightly due to currency fluctuations. o Payment by cheque/check can be made in either Australian currency (drawn on an Australian bank and branch), in US currency or any other currency at current exchange rates. In each case, the currency must match the country of origin of the cheque/check (e.g. US dollars drawn on a branch of a US bank). Eurocheques cannot be accepted. o Payment by Postal Order cannot be accepted. o Details for payment by direct bank transfer are available on request. o All quoted prices (excluding email orders via SWREG) are inclusive of shipping & handling. o Quoted prices are exclusive of local taxes, customs duty etc. The licensee shall be solely responsible for payment of such taxes (where applicable). LICENSE TYPES: There are two basic license types: o An INDIVIDUAL license permits use of the software by a single named individual. The software must be installed on a single machine only. o A CORPORATE license permits use by multiple employees/members/etc. of a named corporation or institution (up to the designated number of users). CORPORATE licenses are available for up to 10 users, and up to 100 users. (For more than 100 users, pricing is a multiple of that for the 100 user license. Enter the applicable number of 100 user licenses required.) In the case of CORPORATE licenses, only a single copy of the software will be supplied. The licensee must ensure that the number of machines on which the software is installed or in use does not exceed that specified by the license. A company that has a requirement for more than one individual user of this software will be expected to license the software for CORPORATE use. NEW LICENSE: You can license this software in a number of ways: o If you have access to CompuServe, you can register online with GO SWREG. Follow the instructions and enter the identification number 3120 when requested. License details will be sent to your id shortly afterwards. No software will be sent. The current version will be available for download from the OS2AVEN forum (library 1, GALLER.ZIP). Registration by SWREG is available for a single copy of an INDIVIDUAL license only. The license will be made out in the name specified. Cost for registration via SWREG is US $65. This will be charged directly to your CompuServe account. o Complete the ORDER FORM below with full details and send via: - email CompuServe: 100033,340 Internet: bitware@ibm.net - fax +61-6-2810175 - post Bitware Australia Pty. Ltd. P.O. Box 3097 Manuka A.C.T. 2603 AUSTRALIA Include payment (credit card particulars or check/cheque). Unless you indicate otherwise in the order forms below, a licensed copy of the software will be sent on 3.5 inch floppy via post to the address you specify. Delivery (via airmail) is normally 2 weeks from receipt of order. o Fax or post a Purchase Order (on company letterhead) to the fax number/address above. Purchase Orders will be accepted for CORPORATE licenses ONLY. Please include a contact name and email/fax number for queries. Unless you indicate otherwise in the order form below, a licensed copy of the software on 3.5 inch floppy will be sent via post to the address you specify. Delivery (via airmail) is normally 2 weeks from receipt of order. ORDER FORM Galleria + Galleria/CM Name: _____________________________________________________________ Company: _____________________________________________________________ Address: _____________________________________________________________ _____________________________________________________________ _____________________________________________________________ _____________________________________________________________ Phone: _________________________ Fax: __________________________ Email: _____________________________________________________________ License type: ___ Individual ________________________ AUD $75 (US $59) _______ ___ Corporate (up to 10 users) ________ AUD $385 (US $305) _______ ___ Corporate (up to 100 users) _______ AUD $895 (US $710) _______ ___ Tick here if you would prefer to have license details (only) sent to you via email or fax instead of receiving a floppy in the post. Enclose cheque/check for the appropriate amount above (or converted equivalent), or complete credit card details: Credit card: ___ Mastercard ___ Visa ___ Amex id: ______ Card number: ________________________________ Expiry: __ / __ Cardholder's name: ___________________________________________________ Signature: ___________________________________________________ Revised: 4/96 UPGRADES: If you already have a license for Nikon II, Galleria Lite, or Galleria or Galleria/CM (including 1.x versions) and wish to upgrade your license (e.g. from 1.x to 2.x, from an INDIVIDUAL license to a CORPORATE one, or to a CORPORATE license for an increased number of users) you can use the UPGRADE FORM below. In each case you will credited with the amount already paid. (If unsure, please contact Bitware Australia for your credit amount.) A minimum charge of AUD $30 (US $24) will apply for such upgrades. New license details will be provided, along with a 3.5 inch diskette containing the latest version of the software (unless indicated otherwise in the order form below). UPGRADE FORM Galleria + Galleria/CM Name: _____________________________________________________________ Company: _____________________________________________________________ Address: _____________________________________________________________ _____________________________________________________________ _____________________________________________________________ _____________________________________________________________ Phone: _________________________ Fax: __________________________ Email: _____________________________________________________________ New license type: ___ Individual ________________________ AUD $75 (US $59) _______ ___ Corporate (up to 10 users) ________ AUD $385 (US $305) _______ ___ Corporate (up to 100 users) _______ AUD $895 (US $710) _______ Less credit _______ Total _______ ___ Tick here if you would prefer to have license details (only) sent to you via email or fax instead of receiving a floppy in the post. Enclose cheque/check for the total above (or converted equivalent), or complete credit card details: Credit card: ___ Mastercard ___ Visa ___ Amex id: ______ Card number: ________________________________ Expiry: __ / __ Cardholder's name: ___________________________________________________ Signature: ___________________________________________________ Revised: 4/96