═══ 1. Copyright ═══ Galleria Copyright (c) 1992-1996 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 All rights reserved ═══ 2. Acknowledgements and trademarks ═══ The JPEG logic used in this software is based on the work of the Independent JPEG Group. The PNG logic used in this software is based on the work of Guy Eric Schalnat, Group 42, Inc. The Galleria and Galleria/CM executables are packaged using Info-ZIP's compression utility. The installation program uses UnZip to process compressed files from the install directory or diskette. Info-ZIP's software (Zip, UnZip and related utilities) is free and can be obtained as source code or executables from various anonymous-ftp sites on Internet, including ftp.uu.net:/pub/archiving/zip/*. ALL TRADEMARKS AND SERVICE MARKS ARE THE PROPERTY OF THEIR RESPECTIVE OWNERS. ═══ 3. Description ═══ 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. Images can also be scanned using a HP ScanJet scanner (if you have one). 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/redo 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. For general instructions on use of Galleria refer to the following descriptions: Using Galleria as a bitmap viewer Using Galleria for file format conversion Using Galleria as a bitmap editor Using Galleria to scan images Using Galleria for screen capture Galleria supports most common bitmap file formats including BMP, GIF, JPEG, PCX, PNG and TIFF. Kodak Photo-CD images are also supported for import. Refer to Supported file formats for a complete list of supported file formats (for import and export). A number of the most commonly asked questions on use of Galleria and answers to these can be found in Questions and answers below. Refer to the online help for detailed descriptions on use of all aspects of Galleria. Remember that pressing F1 while pull-down menus are active will display help for entries in that menu. ═══ 3.1. Using Galleria as a bitmap viewer ═══ Galleria is an ideal utility for the display of collections of bitmapped images found on disk or CD-ROM. Features such as the ability to select multiple files, a screen-show capability with read-ahead logic, optimized display of images on 256 color display subsystems and comprehensive file format support make Galleria a fast and flexible general purpose viewer. The easiest way to display an image is to use the File open, File browse or File search dialogs, select the desired file and press Open. Presuming that the file format is recognised by Galleria, the image will be displayed in the main Galleria window. If the image is larger than the current window size you can use the scroll bars to move areas not displayed into view. Alternatively, you can select Scale to window (from the Window menu) to have Galleria automatically scale the image to fit the window. To display the image without the window border etc. select Full screen from the System menu. A keystroke or mouse click will restore the window controls. You can magnify a portion of the displayed image by selecting Zoom (from the Window menu) and clicking the left mouse button when the crosshairs are over the area to be magnified. The contents of the floating Zoom window can scrolled or the magnification changed. Using the File open, File browse or File search dialogs you can also select multiple files for display. Only one image will be loaded in memory at a time so as many files as desired can be selected. The selected files constitute a list which can be controlled by the List menu. These operations permit positioning within the list to display each image in turn. Alternatively, you can use either the keyboard or the pushbuttons in the status area to move up and down the list. Select Start show mode to automatically display each successive image after a specified time delay. The list created above by selecting multiple files can be saved to disk as an text file, edited using the OS/2 System Editor (or equivalent) and then reloaded. This permits you to maintain catalogs to group like files together or to create your own screen shows. The files which make up the list may be in multiple directories or disks. Galleria fully supports Kodak's Photo CD format for high quality imaging. Each Photo CD contains a catalog of thumbnail views of all images and this overview can be displayed by selecting Open from the Photo menu. To display the desired image, simply double-click on the thumbnail in the Photo CD overview window. Any displayed image can also be printed (in black and white or color) by selecting File print. There is no need to first convert the image to the output format as this will be done automatically. You can specify the output size and quality desired. All printing will be queued and processed in the background so you can initiate as many print requests as you want without waiting for the first to finish. The print destination can be any locally- or LAN-attached printer or it could be a logical device associated with fax software. ═══ 3.2. Using Galleria for file format conversion ═══ Galleria supports a large number of different image file formats and you can use this capability to convert a specified file from one format to another. This may be useful when you wish to import an image in an application which does not support the original file format. To change the file format you must first open the file by selecting the desired file from the File open, File browse or File search dialogs and pressing Open. Then use File save as to select the output format from the list displayed and press Save. You can then import the new file created to another application. Changing the file format can also save you disk space as some formats are more economical than others. Galleria can read most file formats fairly quickly so there is generally no penalty in selecting a file format based purely on output size. Galleria will also optimize the palette of each image saved so that only the minimum space on disk is required. ═══ 3.3. Using Galleria as a bitmap editor ═══ Galleria can be used to perform basic edits on images and the image colors (or palette). A multi-level undo/redo capability lets you experiment with changes and revert to a previous state should the change not be to your liking. Files to be edited are selected using the File open, File browse or File search dialogs and pressing Open. You can then use the actions on the Image and Colors menus to implement changes to the image or image colors respectively. Image actions include Crop to cut a section from the image, Enlarge/reduce to change the image size and Mirror or Rotate to change the orientation of the image. Colors actions permit you to make changes to just the image palette. This includes Brightness/contrast and Color balance to make small changes to the overall image to correct color casts etc. You can also use the Convert monochrome, Convert grayscale and Convert color functions to convert from color to grayscale to monochrome (black and white) or simply to reduce the number of colors/shades in the image. Each conversion function has its own Options dialog to enable you to fine tune the conversion. Each change is added to the undo stack so you can revert to the image states prior to the change if desired. You can also replay the changes. The undo stack is controlled with the Edit undo and Edit redo actions. You can also specify the number of undo levels to maintain in order to conserve memory/swapspace. As a convenience you can display a menu of the most common edit actions by clicking (and holding) the right mouse button anywhere on the image then releasing the button when the pointer is over the desired action. ═══ 3.4. Using Galleria to scan images ═══ If you have a HP ScanJet scanner attached to an OS/2 supported SCSI adapter, you can use Galleria to scan images. See the README.DOC for info on driver installation. The Scan and Scanner info menu options will appear only if the driver has been correctly installed. To check that your scanner in functioning, select Scanner info from the File menu. This will display the hardware settings for the scanner. To initiate a scan, select Scan from the File menu. This will display a dialog to enable settings for the current scan operation. Select the desired image type (monochrome, grayscale or color), resolution and brightness/contrast. The region for the scan can be selected by pressing the Preview button then defining the area to be scanned. Click the mouse once on the preview display to define the top left corner, then again for the bottom right corner. This operation can be repeated to select a different region. Note the approximate file size given for the scan and press the Scan button to initiate the scan. There may be a short delay while the scanner light stabilizes. When dithered or halftoned monochrome output is desired, set the scan type to Grayscale and use Convert monochrome to do the conversion. ═══ 3.5. Using Galleria for screen capture ═══ Galleria can be integrated with the Galleria/CM utility for immediate post-processing of images captured from the OS/2 desktop. This enables you to modify or fine tune the captured image prior to it being saved or copied to the clipboard. To have Galleria invoked after the capture, simply select the Galleria or Galleria (DDE) destination in the main Options dialog of Galleria/CM. Subsequent captures will result in Galleria being invoked with the captured image displayed. Alternatively, you can set a File destination in Galleria/CM and process the created files with Galleria at a later time. (Note that GALLERIA.EXE must reside in the same directory as GALLERCM.EXE and the LIBPATH statement in CONFIG.SYS must contain an explicit entry for the directory in which the Galleria and Galleria/CM DLLs reside to enable the integration.) ═══ 4. File menu ═══ Use the File menu to transfer images to/from disk, search for images on disk or print the current image.  New will replace the current image. A dialog box is displayed prompting for the new image size and fill color. These are normally used as a base for subsequent Merge operations.  Open is used to load a new image from disk. A dialog box is displayed prompting for the name of the file to be read from disk.  Browse is used to display thumbnail images of files. The files to be loaded can be selected visually from the displayed images.  Search is used to search a number of disks for files matching the specified name or partial name. A dialog box is displayed prompting for disks to be searched and the file name to be found.  Save will save the current image to disk. The image will be written to a file with the original file name and format or those used for the last save operation. The current conversion options will be applied prior to the save. The undo stack will also be cleared. Note that not all read files can be saved in the same format. If no output is possible for the format, this option will be disabled. Use Save as to save with a supported format.  Save as will display a dialog box prompting for a new file name and/or format prior to saving to disk as in the Save operation above.  Delete will delete the current file from disk. You will be prompted for confirmation.  Use the Photo CD menu to display the Photo CD overview window or set Photo CD import options. Select Open to display a window containing thumbnail views of all images on the Photo CD. If already displayed, the overview contents will be refreshed. To load a Photo CD image, double click on the thumbnail view in the window displayed. An image can be selected prior to all thumbnail views being displayed. Use Disk to select the id of the disk representing the desired Photo CD to be used for the Open action above. Select Options to display the Photo CD options dialog to preset import options.  Scan will display a dialog to enable options for a scan operation.  Scanner info will display the hardware settings for the scanner.  Print will print the current image to a specified printer. A dialog box will be displayed prompting for destination and print options.  Preferences is used to display or change preferences. A dialog box is displayed permitting a number of operational settings to be changed. ═══ 4.1. File new ═══ The File new dialog is displayed to prompt for dimensions and fill color for a new image. Overtype the horizontal and vertical dimensions to set the new image size. Select the fill color for the new image. The selected color can also be that currently used for the OS/2 desktop. New images of the size and color specified can be used as a base or border for images merged from the clipboard. Press OK to create a new image with the specified dimensions and color or Cancel to ignore changes and exit with the current image unchanged. ═══ 4.2. File open ═══ The File open dialog prompts for the names of bitmap files on disk to be read and displayed. The path to a file is represented by a Disk, Directory and File name. Select the desired disk and/or directory and all files matching the current mask will be listed. Edit the file name and press Open. Alternatively, double click on a name from the list. To select multiple files, click on the desired file names from the list and press Open. Press All to select all listed files in the designated directory or None to select none. The number of files currently selected is shown. The files listed for the current disk and directory can be restricted by entering a mask. The "*" and "?" wild values can be specified. Normal search rules apply with the exception of file extension: when no extension is specified (eg. *, b* or boat), only those files with extensions predefined in the File extensions dialog will be listed. To list files with a specific extension, include this extension in the name (eg. *.bmp). To list all files, regardless of extension, enter *.*. A history of previous file names or masks specified can be accessed by selecting the drop-down arrow at the right of the file name/mask field. Press Extensions to display or update the list of file extensions to be included in the file list when none is specified. Press Open to list all files matching the current mask, or open the file when fully specified. Press Cancel to exit the dialog with the current image unchanged. ═══ 4.3. File browse ═══ The File browse dialog displays thumbnail images of files in the specified directory. (See the Preferences dialog for setting options for saving thumbnails as Extended Attributes and changing the thumbnail size.) The selection criteria is represented by the Disk, Directory and File name/mask. Select the desired disk and/or directory and thumbnail images of all files matching the current mask will be displayed. To open a single file, enter its name in the File name/mask field and press Open. Alternatively, double click on the thumbnail image. To open multiple files, click on the desired thumbnail images and press Open. Press All to select all displayed files or None to de-select all. The number of files currently selected is shown. To sort the files in alphabetical order, press Sort. The files displayed for the current disk and directory can be restricted by entering a mask. The "*" and "?" wild values can be specified. Normal search rules apply with the exception of file extension: when no extension is specified (eg. *, b* or boat), only those files with extensions predefined in the File extensions dialog will be listed. To display files with a specific extension, include this extension in the name (eg. *.bmp). To display all files, regardless of extension, enter *.*. A history of previous file names specified can be accessed by selecting the drop-down arrow at the right of the file name/mask field. Press Extensions to display or update the list of file extensions to be included in the file list when none is specified. Press Open to display all files matching the current mask, or open the file specified or selected. Press Cancel to exit the dialog with the current image unchanged. ═══ 4.4. File search ═══ Use the File search dialog to search a number of disks for files matching a full or partial file name. All directories on the selected disk(s) will be searched. When the required file is found, the remainder of the search operation can be aborted. Select the Disks to be searched from the list box. Multiple disks can be targeted for the search. Enter a full or partial file name in the Name/mask field. Wild characters "*" or "?" can be specified. When no extension is provided, only those files with extensions matching those in the File extensions dialog will be listed. Press Start/Stop to initiate/terminate the search. Press Open to terminate the search and open the file selected from the list. Alternatively, double-click on the desired file name. To select multiple files, click on the desired file names from the list and press Open. To select all files listed under a directory name, click on the directory name in the list. Press All to select all listed files regardless of directory or None to select none. The number of files currently selected is shown. Press Extensions to invoke the File extensions dialog to select file extensions for the search. Press Cancel to terminate the search and leave the current image unchanged. ═══ 4.5. File save ═══ The File save dialog prompts for the name to be used for the image when saved to disk. The path to a file is represented by a Disk, Directory and File name. Select the desired disk and/or directory and all files matching the current mask will be listed. Edit the file name and press Save. Alternatively, double click a a name from the list to overwrite an existing file. The files listed for the current disk and directory can be restricted by entering a mask. The "*" and "?" wild values can be specified. Normal search rules apply with the exception of file extension: when no extension is specified (eg. *, b* or boat), only those files with extensions predefined in the File extensions dialog will be listed. To list files with a specific extension, include this extension in the name (eg. *.bmp). To list all files, regardless of extension, enter *.*. Press Extensions to display or update the list of file extensions to be included in the file list when none is specified. Press Save to list all files matching the current mask, or save the file when fully specified. Press Cancel to exit the dialog without saving the file. ═══ 4.6. File save as ═══ Use the File save as dialog to save the current image to disk with the file name and format specified. Select the desired file format from the list displayed. (The file name extension will be changed to the default for that format.) Some formats have an optional compressed form which may reduce the disk space required to store the file created. Select Compressed to enable compression. Specify the file name of the output file. Press Save to save the file on disk with the specified name and format. Press List to browse files in the current directory or change the output disk and/or directory. Ensure that the desired file format is correct before proceeding. Press Cancel to terminate the dialog without saving the file. ═══ 4.7. GIF save options ═══ When saving files as GIFs, there are number of options you can specify to control end-use of the file. These options apply to GIFs for use on Internet web pages. The Transparency option enables you to select a single color from the palette of the image and indicate that this color is to be treated as transparent on display. A list of all colors in the image palette is displayed in decreasing order of occurrence. Click Enable and select the color to be made transparent. When you want multiple colors to be made transparent, first use the Color edit palette function to map these colors to a single color and designate this resultant color as the one to be made transparent. Note that Galleria will ignore the transparent setting when the file is re-opened. The Interlaced option governs how the image is displayed as it is downloaded. When interlaced, there will be a number of passes over the image, each pass filling in skipped lines. The result is that a coarser version of the image is quickly displayed, progressing to a complete and finer image over time. Support for progressive display will depend on the browser software. For best results in creating GIFs for web pages, you may want to use the Convert grayscale or Convert color functions to reduce the number of colors in the file. This will result in smaller files and faster downloads. ═══ 4.8. File extensions ═══ Use the File extensions dialog to display or update the relevant file name extensions to be listed when none is specified in the File open, File search and File save dialogs. (Note that file list/search times can be reduced by eliminating extensions not required.) The list of file name extensions together with an optional short description is displayed. Press Add to add a new entry. Fill in the file name extension (maximum of three characters) and an optional description and press OK. Press Change to change the currently selected entry. Overtype the file name extension and/or description and press OK. Press Delete to delete the currently selected entry. Press OK to accept these changes or Cancel to ignore any changes and exit with the original entries. ═══ 4.9. Photo CD overview ═══ The Photo CD overview window shows an thumbnail view of each image on the Photo CD. The display an image, simply double-click on the image desired. A gray border will be displayed around the thumbnail of the image selected. To refresh the window contents after loading a new Photo CD, select Open from the Photo menu. The window can be maximized or minimized (hidden) as required. To redisplay a minimized or hidden window, select Open from the Photo menu. To close the window, double-click on the System icon. ═══ 4.10. Photo CD options ═══ The Photo CD options dialog is (optionally) displayed when a file with extension .PCD is opened. Photo CD files are stored in a number of resolutions (or sizes). Select the desired Resolution. Make sure that you have enough memory and/or free swapspace before selecting the higher resolutions. Note that not all resolutions may be available for the selected image. In particular, display at 6144x4096 resolution will only be supported for Pro Photo CD images optionally scanned at 64Base. To display such images more quickly, select the Grayscale option. Only the grayscale component of the image will be read and displayed. Normally Galleria will rotate the Photo CD image to the orientation recorded on the disc. To load the image without rotation, deselect the Rotate image option. Note: Rotations are performed in-place and do not require additional memory. However, if insufficient memory is available to hold the entire image in memory, the rotation may take a long time. In this case, either select a lower resolution or deselect Rotate image and perform the rotation using the appropriate function from the Image menu. Select Prompt for options on load to display this dialog every time a Photo CD image is opened. Press OK to open the current file or save the settings for the next open. Press Cancel to abort the open or leave the settings unchanged. ═══ 4.11. Metafile options ═══ The Metafile options dialog is displayed when a file with extension .MET is opened. OS/2 metafiles (as vector files) are scalable and importing these files requires conversion to bitmap format. Specify the Background color and Size for the resulting bitmap. The color selected can also be that currently used for the OS/2 desktop. To change the size of the image, better resolution will result by re-opening the metafile with a different size than subsequent use of the Enlarge/reduce edit option. Press OK to open the file or Cancel to abort the open. ═══ 4.12. Scan options ═══ The Scan options dialogs is displayed prior to a scan operation to enable options for the scan to be set. Select the scan type (Monochrome, Grayscale or Color) to determine the output desired. Grayscale and Color images can also be automatically sharpened. Select the Resolution for the scan. The resolution will determine the output quality for the scan operation. This also determines the size of the scanned image which may be very large for high resolutions. For best results, select a resolution that is an integral factor of the optical resolution. Select the Brightness and Contrast for the scan. If you have a colour scanner with an ADF (Automatic Document Feeder) installed, press the Feed button to move the next page onto the platen ready for preview/scan. To display a preview (with the above type and brightness/contrast settings), press the Preview button. The preview can be displayed each time Scan options is invoked by selecting Do initial preview. To select a partial region for the scan, click the mouse on the preview display to define the top left corner. Click again to define the bottom right corner. The area selected will be highlighted. To change the selected region, repeat the above operation. Reducing the area for the scan will reduce the size of resultant image. Press Scan to initiate the scan operation with the above settings or Cancel to return. To abort a scan operation, press the Esc key. ═══ 4.13. Scanner info ═══ This dialog displays the hardware settings for the scanner. Press OK to return. ═══ 4.14. File print ═══ The File print dialog is displayed prior to a print operation to enable options for the current print to be changed. Specify the Queue for the print. To change printer driver settings see Setup below. Note that the selected Queue can also represent drivers provided with OS/2 fax software. Select the Area percentage to limit the output size. The value specified is a percentage of the total page area. Note that the image printed may be smaller in area than that specified if it would otherwise overlap the border above. Select a Border percentage to leave a blank edge along all sides of the page. The value specified is a percentage of the page width and height. For fine tuning monochrome output, the relative Color bias percentages can be changed to lighten/darken areas of the image depending on the red/green/ blue intensity of the original. A higher bias will result in a lighter tone for areas of that color. Additionally, the overall intensity can be changed by setting the desired Brightness. Position the slider arm at the desired position. The Preprocess image option will cause Galleria to use special rendering techniques to generate high quality output on most monochrome and color printers. This process may use large amounts of memory and elongate printing times. This can be minimized by either decreasing the output size or selecting a lower dpi setting (with Setup below). Press Setup to change the driver settings for the currently selected Queue. These settings will be retained until a different Queue is selected. Press OK to start printing with the options selected or Cancel to ignore changes and abort the current print operation. ═══ 4.15. Preferences ═══ Use the Preferences dialog to display or change personal preferences for use of Galleria. Select Show full file name in window title to display the full name of the current file in the title of main window. Select Use alternative file open and save dialogs to invoke alternative dialogs for the File open and File save as operations. The default alternative dialogs have a number of advantages over the standard OS/2 dialogs in that a list of file extensions can be specified to filter the file names displayed. Select Resize window to fit loaded image to change the window size so that it is the same as the newly loaded image. The window will not be resized when maximized. Select Recall last used directory at startup to carry over the last used file directory to subsequent sessions. If not selected, the directory specified as the Working directory in the Settings notebook will be used. Select Prompt for save when image changed or not yet saved to display a request to save the current image when Galleria is closed or a new image or loaded. The prompt will not be displayed if a current version of the image already exists on disk. Select Use palette management to enable Galleria to update the hardware palette of your display adapter with colors from the currently displayed image. Colors used by other applications or the OS/2 desktop may change as a result. This option applies only when running in 256 (8-bit) color mode and with display drivers that indicate that Palette Management is supported. If you experience display problems with Galleria, enable the Use fallback display mode for screen writes option. This option is provided solely to enable Galleria to work with incompatible display drivers. If this option is required, contact the vendor of your display adapter for an updated driver. Make sure you disable this option when you install the updated driver. When browsing files with File browse, the complete file is read and a thumbnail image is displayed. To speed subsequent display of thumbnail images, the thumbnail can be saved as an Extended Attribute (EA) attached to the file. The file itself is unchanged. To have Galleria automatically save the thumbnails the next time the file is browsed, select the Save thumbnail images as Extended Attributes option. Thumbnails are time-stamped and will be re-built if the file is changed. Thumbnails will not be saved if the file is on a floppy disk, remove drive or CD. Note: This option is not available when Galleria is in demo mode. You can also specify the Maximum thumbnail size of the thumbnail images (in pixels). The size can be anywhere from 16x16 to 128x128 and need not be square. Thumbnails will automatically be re-built at the specified size the next time the File browse dialog is invoked. Press OK to apply the selected preferences, Defaults to set default values or Cancel to ignore changes. ═══ 5. List menu ═══ Use the List menu to perform operations on file lists. A list is automatically created when multiple files are selected in the File open and File search dialogs. Lists can also be read from disk.  Use Open list to read and process an existing file list from disk. The List open dialog will be displayed. Files from the new list can be appended to those in the current list (if any).  Use Save list to save the current list of files in a file on disk. This list can later be read with Open list above.  The First, Previous, Next and Last options control enable positioning within the current list. Alternatively, the buttons in the information line can also be used to scroll up/down the files in the list. The selected image will replace the current one displayed.  Use Edit list to display the List edit dialog. This will display the names of all files in the current list. A specific file can be selected for display.  Use Drop from list to remove the currently displayed file from the list. The corresponding file on disk will not be deleted.  The Start show option will initiate a screen show of each image in the list in turn for the time set in the List show options dialog. When using this facility, images unable to be loaded for any reason will be skipped. Pressing any key or clicking the left mouse button will abort the screen show.  Use Show options to set preferences for the screen show facility. ═══ 5.1. List open ═══ Use the List open dialog to load an existing file list from disk. This file may have been created with List save or the System Editor. The file consists of fully qualified file names, one to a line. Leading and trailing blanks will be ignored. Select Merge with current list to append the names of files from the selected list with those in the current list (if any). Press Open to process the selected list or Cancel to leave the current loaded file/list unchanged. ═══ 5.2. List save ═══ Use the List save dialog to save the current file list on disk. This list can subsequently be loaded with List open. The created list (ideally with file extension .LST) can also be manipulated with the System Editor. Press Save to save the current list or Cancel to abort the save. ═══ 5.3. List edit ═══ Use the List edit dialog to select a file from the current list or modify the list. To display a particular file, simply select it from the list and press OK. Press Sort to sort the listed files by full file name. Press Drop to delete the selected file from the list. The file on disk will not be deleted. Select Full path name to display the full file name of each listed file. Press Cancel to leave the list elements and position unchanged. ═══ 5.4. List show options ═══ Use the List show options dialog to set preferences for the screen show facility. Select Start show in full screen mode to set full screen display for the images when the show is started. Note that you may also want to set Scale to window on the Window menu to scale the images to fit the screen size. Select Wrap to beginning when end of list reached to restart display with the first image after the last image in the current list is displayed. This permits perpetual display of all images in the list. Select Use read-ahead logic to preload next image to read and process the next image in the list while the current image is being viewed. This may result in nearly instantaneous display of the next image when it is selected. You may wish to disable this logic if displaying large images on machines with minimal memory. Select Select next image to show at random for a continuous, but not sequential, display of all images from the current list. Set the time delay to use between display of images when in screen show mode with the Set show update interval to value. Press OK to apply the selected preferences, Defaults to set default values or Cancel to ignore changes. ═══ 6. Edit menu ═══ Use the Edit menu to transfer images to/from the clipboard or reverse Image and/or Palette edits. The following operations apply to clipboard operations:  Copy places the current image in the clipboard. The clipboard can be used as either a temporary storage area or to facilitate transfer to another application. The clipboard copy will be converted as per the current conversion settings.  Paste copies the bitmap from the clipboard and replaces the current image.  Merge merges the bitmap in the clipboard with the current image. A rectangle with the same size as the image on the clipboard will be displayed to control placement. Position the top left corner of the displayed rectangle and press the left mouse button. The Merge operation can be aborted by pressing the Esc key.  Peek displays the current clipboard contents prior to a Paste or Merge operation.  Empty clipboard will clear the current clipboard contents. The following options apply to the undo (or reversal) and redo of edits made to the current image:  Redo will re-apply the last Image or Palette edit operation(s) undone by Undo or Undo all below.  Undo will restore the image to that displayed prior to the last Image or Palette edit operation.  Undo all will restore the image to the original as loaded from the clipboard or read from disk.  Undo levels permits setting of the number of undo levels to be retained. Each edit operation will require one level. When the number of edit operations exceeds the number set, earlier states will be discarded. Avoid setting too high a value when editing large images or virtual storage may be exhausted. When set to None, no previous states will be retained. ═══ 6.1. Edit peek ═══ Use the Edit peek dialog to display the current clipboard contents. Press Paste or Merge to paste or merge the displayed image into Galleria. Press Cancel to exit with the current image unchanged. ═══ 7. Image menu ═══ The following operations permit changes or edits to be made to the current image:  Crop is used to cut a rectangular portion from the current image. A size/position rectangle will be displayed to control the area of the image to be cut out. Position the top left corner of the size/position rectangle and press the left mouse button, then stretch the rectangle to the desired size and press the left mouse button again. The Crop operation can be aborted by pressing the Esc key.  Enlarge/reduce is used to enlarge or reduce the image size. A dialog box will be displayed prompting for new horizontal and vertical dimensions.  Mirror will flip the image around the vertical axis for a mirror image of that currently displayed.  Invert will flip the image around the horizontal axis to invert the current image.  Rotate left and Rotate right will turn the image 90 degrees anti-clockwise and clockwise respectively. Repeating this operation four times will restore the image to its original orientation.  Border can be used to add a colored border to the image. A dialog is displayed prompting for the border color and width.  Trim is used to crop the image edges. A dialog is displayed prompting for the edges to be trimmed and the trim width. As an alternative to selecting options from the pull-down menu, click the right mouse button anywhere on the displayed image. Select the desired action with the keyboard or left mouse button. This popup menu can be used to perform a range of edits whilst the image is displayed in full-screen mode. ═══ 7.1. Image enlarge/reduce ═══ Use the Image enlarge/reduce dialog to change the size of the image. The current horizontal and vertical dimensions are shown when the dialog is invoked. Overtype these values with the new dimensions desired. Alternatively, move the Proportional scaling slider to the left/right to decrease/ increase the size while retaining the original image proportions. The horizontal and vertical dimensions may not exceed a value of 8192. Select Use resampling filter to increase the quality of the enlarged/reduced image. This filter will remove "jaggies" from enlarged images and reduce other unwanted artifacts. The number of colors used in the image may increase as a result. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 7.2. Image border ═══ Use the Image border dialog to add a colored border to the image. The color selected can also be that used for the current OS/2 desktop. Select the desired border color and width. Note that if the image currently has 256 colors, the selected color will be remapped to the closest in the image palette. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 7.3. Image trim ═══ Use the Image trim dialog to trim the image edges. This permits finer adjustment in a cropping operation than may be possible with Image crop. Select one or more edges to be trimmed. A strip of the set width (below) will be cut from each of the edges selected. Set the width to be trimmed from the above edges. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 7.4. Image filters ═══ Choose one of the Image filters to enhance the overall image quality or apply special effects. Sharpen and Sharpen more will increase the sharpness of the image by enhancing edges and slightly increasing image contrast. Blur and Blur more will decrease the sharpness of the image. Median will blur the image by averaging neighbourhood pixels. This filter can be used to eliminate unwanted effects when scanning halftoned images. Find edges and Emboss are special effects filters. ═══ 8. Colors menu ═══ The following operations permit changes to be made to the colors of the current image:  Brightness/contrast is used to change the overall brightness and/ or contrast of the image. Only the luminance component of the image will be changed. A dialog box will be displayed.  Color balance is used to change the overall color balance of the image to remove color casts or make the image warmer/cooler in appearance. A dialog box will be displayed.  Negative will invert all the colors in the image palette. This option would normally be used on monochrome images to reverse the black and white areas.  Edit palette is used to change the color of entries in the image palette. A dialog box will be displayed.  Convert monochrome will convert the image using black and white colors only. The mapping of original colors to either black or white will be governed by the settings in the Convert monochrome options dialog. Select 2 colors to initiate the conversion.  Convert grayscale will convert the image using shades of gray only. The mapping of original colors to the respective shade of gray will be governed by the settings in the Convert grayscale options dialog. Select 8 colors, 16 colors, 32 colors, 64 colors or 256 colors to initiate the conversion.  Convert color will map the original colors in the image to a new palette with a different number of colors than the original. The mapping of the original colors will be governed by the settings in the Convert color options dialog. If the image is to be saved in GIF format for use on Web pages, use Web colors. This palette contains only colors suitable for display on multiple platforms (in 256-color mode). When System colors is selected, the palette used for the conversion will be that defined as the default for the current display driver. Converting the image colors to those from this palette will enable use of the image as a Desktop background. This option is not applicable when in RGB (64K or 16M color) mode. Select 8 colors, 16 colors, 32 colors, 64 colors, 256 colors or System colors to initiate the conversion. Conversions make take some time to process. To abort the current conversion, press the Escape key. ═══ 8.1. Color brightness/contrast ═══ Use the Color brightness/contrast dialog to change the overall overall brightness and/or contrast of the image. Only the luminance component of the image will be changed. The distribution graph shows the range of luminance values in the image. To darken/lighten the image, move the Brightness slider to the left/right. The graph will be updated to show the new luminance range. To decrease/increase image contrast, move the Contrast slider to the left/right. The graph will be updated to show the new luminance range. As a first attempt in setting optimal brightness and contrast for normal images, first use the Brightness slider to center the graph (above) then use the Contrast slider to expand (or contract) the graph to encompass the full tonal range. This function is not applicable to monochrome images. Press Reset to restore the original brightness and contrast values. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 8.2. Color balance ═══ Use the Color balance dialog to make overall changes to the image colors. Move the slider for the desired color(s) to the right to slightly increase the amount of this color in the image, or to the left to decrease the amount. This dialog is useful for removing color casts or making images warmer/cooler in appearance. This function does not apply to monochrome or grayscale images. Press Reset to restore the original color balance. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 8.3. Color edit palette ═══ Use the Color edit palette dialog to change the values of individual colors in the image palette. A list of colors is displayed in decreasing order of frequency in the image. The relative frequencies for each entry is displayed with the currently selected entry indicated by a marker of the graph. The RGB component values of the selected entry are represented by the sliders at the right. To change a color, select that entry from the list and move each slider until the desired new color is displayed. Any number of colors may be changed. Press Reset to restore the currently edited color to its original value. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 8.4. Convert monochrome options ═══ Use the Convert monochrome options dialog to fine-tune image conversion to monochrome (black & white). Select the Conversion technique. Options are Threshold for a simple re-map of each color to either black or white, or Random dither, Ordered dither or Error diffusion to dither or digitally halftone the image using dots of black or white. Choosing Threshold will give a sharper image but with the loss of the tonal range of the original. Error diffusion will more accurately preserve the overall tone. Random dither or Ordered dither may be more suitable for some applications. To fine tune the output, change the relative Color bias percentages to lighten/darken areas of the image depending on the red/green/blue intensity of the original. A higher bias will result in a lighter tone for areas of that color. Additionally, the overall intensity can be changed by setting the desired Brightness. Position the slider arm at the desired position. Select Enhance contrast to increase the contrast of the image or Sharpen for more clearly defined edges. Sharpen is recommended for Random dither but not for Ordered dither. Press Defaults to restore the default values for all settings. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 8.5. Convert grayscale options ═══ Use the Convert grayscale options dialog to fine-tune image conversion to shades of gray. Select the Conversion technique. Options are Threshold for a simple remap of each color to the closest shade of gray, or Error diffusion to dither or digitally halftone the image using grays from the new palette. The former method will result in a sharper image while the latter will more accurately preserve the overall tone. To fine tune the output, change the relative Color bias percentages to lighten/darken areas of the image depending on the red/green/blue intensity of the original. A higher bias will result in a lighter tone for areas of that color. Additionally, the overall intensity can be changed by setting the desired Brightness. Position the slider arm at the desired position. Select Enhance contrast to increase the contrast of the image or Sharpen for more clearly defined edges. Press Defaults to restore the default values for all settings. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 8.6. Convert color options ═══ Use the Convert color options dialog to fine-tune image conversion to a different or reduced color palette. Select the Conversion technique. Options are Closest color for a simple re-map of each color to the nearest color in the new palette, or Error diffusion (fast or normal) to dither or digitally halftone the image using colors from the new palette. The latter method will more accurately preserve the overall color of the original. Press Defaults to restore the default values for all settings. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 9. Window menu ═══ Use the Window menu to control the image display.  Selecting Zoom will display a floating Zoom window (if not already displayed). The allows you to magnify a selected area of the image. You can also double-click the left mouse button anywhere on the image to display this Zoom window.  Size to fit will resize the window to fit the displayed image.  The Scale to window setting determines the current image magnification. When set, the image will be scaled to fit within the window. When not set, the image will be displayed full-size and scroll bars can be used to move the non-displayed portions of the image into view. This option can be toggled on or off. The current display magnification is shown as a percentage in the information area.  The Information area setting will toggle on or off display of the information area at the bottom of the window.  Background permits the window background color and pattern to be changed. A dialog box will be displayed prompting for color and pattern. ═══ 9.1. Zoom ═══ The Zoom window will be displayed when Zoom is selected from the Window menu (or the left mouse button is double-clicked on an area of the main image). This window will float above the window containing the main image. To change the area magnified, position the crosshairs over the desired area of main image and click the left mouse button. Alternatively, use the scroll bars to move around the image. To change the magnification, use the slider at the bottom of the window. The current magnification will be displayed. ═══ 9.2. Window background ═══ Use the Window background dialog to change the color and pattern of the window. Select the desired color and/or pattern from the set displayed. The currently selected values are shown with a boxed border. Press OK to accept these changes or Cancel to ignore changes and exit with the original settings. ═══ 10. Help menu ═══ Use the Help menu for display of help information and product information.  Help index will display and index of the help topics available.  General help will display a general description of the program.  Using help will display instructions on use of the help facility.  Product information will display copyright and version information for the program.  License information will display licensing information. ═══ 11. License details ═══ The License details dialog is displayed the first time you start Galleria. You must enter both your license name and number at this time. Enter your license name exactly as specified. You may use upper or lower case but the name must match that supplied when the software was licensed. Enter your license number exactly as specified. All 16 digits must be entered. The license number must correspond to the name above. Press OK to validate the license information and start the application or Cancel to terminate. ═══ 12. License agreement ═══ The License agreement dialog is displayed after you complete your license details to display the text of the agreement for use of this software. You must read all of the agreement conditions and then press OK to complete the licensing process. Press Cancel to abort. ═══ 13. Questions and answers ═══ The following are answers to commonly asked questions about Galleria: Q. When I display my 256 color image with Galleria the colors are displayed incorrectly. The image displays correctly in a full-screen session but not with Galleria. Why? A. As Galleria is a Presentation Manager application all writes to the screen must be done via the installed display driver. Not all display drivers currently support the palette management required to enable the hardware palette to be changed. Ask the supplier of your video adapter to provide you with a display driver which supports 'OS/2 palette management'. Note that the 32-bit graphics engine (introduced in the 2.0 Service Pack) is a prerequisite for palette management support in OS/2 2.0. Q. When an image is loaded the display flashes and the desktop colors are changed. Why does this happen? A. On systems with 256 color (8-bit) display subsystems Galleria uses OS/2 palette management functions to load the image palette into the display hardware. This can cause other in-use color entries to be displaced, resulting in a mapping to the closest color in the modified palette. The desktop colors will be restored shortly after Galleria is minimized or closed. Q. If I save a 256 color image with Galleria and set this as the desktop background, the colors displayed are not correct. Why? A. Unfortunately, the OS/2 desktop does not use palette management functions to load the display hardware with the image palette. Reasonable images for use as the desktop background can be generated by using Galleria to convert the image to a 'standard' 16 or 256 color palette. Q. The images displayed by Galleria seem to be more vivid and have more accurate colors than with other applications. Why is this? A. When 256 color images are displayed on the desktop, typically only 240 colors are used by any application (and even less if other palette aware applications have the foreground). The remaining 16 colors are used for the desktop and other applications which do not use palette management functions. Galleria optimizes the image palette (when first loaded and after each edit) to ensure that the highest frequency colors will always be displayed. Q. Why are the files Galleria writes different in size to those written by other applications? A. The files written by Galleria are often smaller due to a number of reasons: Galleria optimizes the palette to discard unused or duplicate entries. For file formats which permit variable palette sizes, a small saving in size is often possible. Galleria will also write files with the smallest bit size possible. For example, if the image uses up to 16 colors the file may be written in 4-bit format even if the original was 8-bit. The palette optimization above and edit operations can contribute to lesser colors being required. Also, Galleria uses its own compression algorithms which are optimized for file size. Large differences in the resultant file size may be experienced with file formats that use RLE-based compression techniques. Q. When I load an OS/2 metafile into Galleria or other applications, the image palette is incorrect. Is there a way around this? A. When editing an image to be saved in the OS/2 metafile format, convert the palette to the standard 16 or 256 colors with the Convert color function (using closest colors or error diffusion dither). This will ensure that the image displays correctly on a subsequent load. Q. Why won't Galleria read my WordPerfect graphic (WPG) file? A. The WPG format supports both raster (bitmap) and vector data. The latter files ( usually quite small) contain eg. line drawings. Galleria supports only the bitmap format for import and export. Q. Why does the loading of 24-bit color files (eg. Photo-CD and JPEG) take much longer than other images? A. On systems which only support display of 256 colors (or less) Galleria will translate all RGB files loaded to 256 colors (with the highest quality display possible). This is the major contribution to the delay in displaying the image. Q. Why doesn't Galleria present a display showing 'percent complete' on such things as loading a file? A. Galleria is fully multi-threading and there may be a number of activities occurring in parallel. For example, file opens, saves, prints, directory searches may all be active concurrently. In addition, Galleria may use read-ahead logic to preload files. Presentation of current status (and for each activity) is not as trivial as in applications which initiate a single task in response to input and wait for completion of that task. ═══ 14. Supported file formats ═══ The following file formats are supported by this version. These file formats are supported for import (open):  BMP - IBM OS/2 1.x bitmap Standards: Bitmap or Bitmap Array (first image only) Bits: 1, 4, 8 or 24 Planes: 1  BMP - IBM OS/2 2.x bitmap Standards: Bitmap or Bitmap Array (first image only) Bits: 1, 4, 8 or 24 Planes: 1 Compression: None, HUFFMAN1D, RLE4, RLE8, RLE24  BMP - Microsoft Windows 3.x bitmap Standards: Bitmap or Bitmap Array (first image only) Bits: 1, 4, 8 or 24 Planes: 1 Compression: None, RLE4, RLE8  EPS - Encapsulated Postscript (TIFF preview) Standards: As per Tagged Image File Format  GIF - CompuServe Graphics Interchange Format Standards: GIF87a or GIF89a, single or multi-image, interlaced or non-interlaced Bits: 1 to 8  IFF - Amiga Interchange Format Files Standards: Non-masked, HAM Bits: 1 to 8, 24 Compression: None, RLE  IMG - Digital Research GEM Standards: Monochrome, grayscale, color Bits: 1, 4  JPG - JPEG (JFIF) Standards: Baseline, Extended baseline  MAC - Apple MacPaint Standards: Monochrome, with or without header  MET - OS/2 metafile  MSP - Microsoft Paint Standards: Monochrome  PBM/PGM/PPM - PBMPLUS Standards: Binary Bits: 1, 8 (grayscale) or 24  PCD - Kodak Photo CD Master, Pro Photo CD Standards: Base/16, Base/4, Base, 4Base, 16Base, 64Base Bits: 8 (grayscale), 24  PCX - ZSoft Paintbrush Standards: Version 2.8, 3.0 Bits: 1 to 8 Planes: 1, 4 (with 1 bit per pixel) or 3 (RGB)  PNG - Portable Network Graphics Standards: Grayscale, color, RGB, interlaced or non-interlaced Bits: 1, 2, 4, 8 or 24 (RGB) Compression: None, ZLIB  TGA - Truevision Targa-16/24/32 Standards: Type 1, 2, 3, 9, 10 and 11, non-interleaved Bits: 1 to 8 (color-mapped) or 16, 24, 32 (RGB) Compression: None, RLE  TIF - Tagged Image File Format Standards: Version 4.0, 5.0 (TIFF B, G, P and R), 6.0 (Baseline), Intel or Motorola byte ordering, first image only Bits: 1 to 8, 24 Planes: 1 Compression: None, Huffman (CCITT 1D), Packbits, LZW  WPG - WordPerfect graphic Standards: Version 5.0, 5.1, bitmap only Bits: 1 to 8 These file formats are supported for export (save):  BMP - IBM OS/2 1.x bitmap Bits: 1, 4, 8 or 24 Planes: 1  BMP - IBM OS/2 2.x bitmap Bits: 1, 4, 8 or 24 Planes: 1 Compression: None, HUFFMAN1D, RLE4, RLE8  BMP - Microsoft Windows 3.x bitmap Bits: 1, 4, 8 or 24 Planes: 1 Compression: None, RLE4, RLE8  GIF - CompuServe Graphics Interchange Format Standards: GIF89a, interlaced or non-interlaced, transparency Bits: 1 to 8  JPG - JPEG (JFIF) Standards: Baseline  MET - OS/2 metafile  PCX - ZSoft Paintbrush Standards: Version 2.8, 3.0 Bits: 1 or 8 Planes: 1, 4 (with 1 bit per pixel) or 3 (RGB)  PNG - Portable Network Graphics Standards: Grayscale, color, RGB, non-interlaced Bits: 1, 2, 4, 8 or 24 (RGB) Compression: None, ZLIB  TGA - Truevision Targa-24 Standards: Type 1, 2, 9 Bits: 8 (color mapped) or 24 (RGB) Compression: None, RLE  TIF - Tagged Image File Format Standards: Version 4.0, 5.0 (TIFF B, G, P and R), Intel byte ordering Bits: 1, 4, 8 or 24 Planes: 1 Compression: None, Packbits  WPG - WordPerfect graphic Standards: Version 5.0 Bits: 1, 4 or 8 Note that (for all formats other than OS/2 metafiles and Photo CD) Galleria ignores the file name extension when importing or exporting files. When a file is read, the format is determined by examining header information contained within the file. ═══ 15. Problems and diagnostics ═══ If the Galleria process detects an internal or external processing error, the program will terminate. To determine the cause of the error, restart Galleria with the -d switch parameter (on the command line or as a parameter in the session settings) and reproduce the sequence of events up to the failure. This will log error information to a file GALLERIA.LOG in the same directory as the executable. This file contains information which can be used to resolve problems. Please record the program version number and symptoms (what action was being performed at the time of the error) and return this information together with the contents of GALLERIA.LOG so that the problem can be resolved. Note that this log file will be over-written each time Galleria is started with the -d switch. There is no performance penalty incurred in use of this error logging facility. Also, if Galleria should fail to read and/or display a file specifically documented as being supported, please send this file to the address below on a 3.5 inch floppy disk (together with information on program version number, hardware configuration etc). An updated version of Galleria will be returned. Please send error reports or unsupported files to: Bitware Australia Pty. Ltd. P.O. Box 3097 Manuka A.C.T. 2603 Australia