═══ 1. Copyright ═══ Galleria/CM Copyright (c) 1991-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. Description ═══ Galleria/CM is a utility for capturing the displayed desktop or portions thereof, and saving the image captured in a bitmap. Either the whole desktop (screen contents), windows for selected applications, a selected region or the contents of a window can be captured. The result can be saved in the clipboard for subsequent pasting into another application, printed, stored on disk in a number of bitmap file formats or Galleria invoked for further processing of the image. For instructions on setting options and initiating captures double-click on the following topics: Controlling Galleria/CM from the desktop Controlling Galleria/CM from the keyboard Once the capture is complete, the image will be output to the selected destination. A status of working below the minimized icon indicates that processing of the image is incomplete. The time for this processing will depend on the options selected. Note that another capture can be initiated while in the working status but processing and output of the second image is queued. Refer to Supported file formats for a list of bitmap file formats currently supported. Select Close from the system menu to terminate the program. The current capture options will be saved for subsequent execution. ═══ 2.1. Controlling Galleria/CM from the desktop ═══ To display Galleria/CM as an icon the desktop you must set the Minimize button behaviour to Minimize window to desktop. This option is found on the Window page on the settings notebook. It is set by default on installation. When Galleria/CM is started, a boxed icon will appear at the bottom of the desktop. The options dialog can be displayed by single clicking on this icon and selecting Options. To initiate a capture, select Snap or double-click on this icon. If a delayed capture is specified, a count of the remaining seconds to the capture will be shown below the Galleria/CM icon. Select Stop countdown to terminate a delayed capture. If you would prefer to control Galleria/CM by the keyboard only, set the Minimize button behaviour to Hide window instead. ═══ 2.2. Controlling Galleria/CM from the keyboard ═══ To control Galleria/CM operations from the keyboard you must start the program with the -k parameter. It is set by default on installation. When Galleria/CM is started, the options dialog can be displayed by pressing Ctrl+Print Screen. To initiate a capture, press the Snap button from the options dialog. Alternatively, save the current settings and press Print Screen. If you would prefer to control Galleria/CM from the desktop only, remove the -k startup parameter. ═══ 3. Options ═══ Refer to the Description for general help on this program. Use the Options dialog to select the source and destination for the capture. The source can be either the Desktop (entire screen contents), all windows for selected Application(s), a selected Region or a selected Window frame or Window client. Both Desktop and Application(s) sources will result in a screen size capture being taken. For a Desktop capture, the current (or delayed) desktop contents will form the resultant image. For Application(s) captures, only those windows belonging to the selected application(s) will be captured and the background will be blanked out. For Active window captures, the contents of the window active at the end of the delay period will be automatically selected. When a Region, Window frame or Window client capture is initiated, the status will change to selecting and a pointer displayed to enable a region or window to be selected. For a Region capture, position the top left-hand corner of the box displayed and click the left mouse button, then size the box and click the left mouse button again. The inclosed area will form the captured image. For Window frame or Window client captures, move the four arrow mouse pointer over the window desired and click the left mouse button. The whole window or client area will form the captured image. Note that dialog windows should be captured with the Window frame option. The output destination can be either Galleria, the clipboard, a file on disk or a specified print queue. A destination of Galleria will invoke a new session of Galleria for further processing of the image. The captured image will be displayed in the main Galleria window. Alternatively, the destination of Galleria (DDE) will transfer the captured image to a current Galleria session via DDE (Dynamic Data Exchange). If no available Galleria session exists then a new one will be started. The DDE link will be broken when either Galleria or Galleria/CM is closed, or the destination is changed. Selecting Clipboard will place the image in the system clipboard in a standard format for subsequent pasting into another application. Selecting File will save the image in a file on disk. The file name and format are specified in the File Options dialog. Selecting Printer will print the captured image. The printer queue, layout etc. can be changed in the Printer Options dialog. For Desktop, Application(s) and Active window captures, a timed delay can be set to allow rearrangement of the screen contents. Select Stop countdown from the system menu to abort delayed captures. Note that a delay must always be set for Active window captures. Additionally, the pointer icon (cursor) can be included in Desktop or Application(s) captures. Select Add border to enclose the captured image with a line border. Select Prompt for options to display the Options dialog when each capture is initiated. Press More to change options for the currently selected destination. Press OK to accept these changes or Cancel to ignore changes and exit with original settings. ═══ 3.1. File options ═══ If the File destination is selected in the Options dialog, the image will be saved on disk in a file with the name given and in the format specified. Specify the full path name to the output file. If the file name ends with a sequence number (eg. SNAP0123.BMP) the number component can be automatically incremented on each capture to permit a series of files to be retained. Select the desired format for the output file from the list given. Note that the OS/2 2.x format may not be accepted by older applications. Some formats have an optional compressed form which may reduce the disk space required to store the file created. Select Compressed to enable compression. Refer to Supported file formats for a list of bitmap file formats currently supported. Press OK to accept these changes or Cancel to ignore changes and return to main options dialog with original settings. ═══ 3.2. Printer options ═══ If the Printer destination is selected in the Options dialog, the captured image will be printed. 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. This value is ignored if the Print to scale option is selected. 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/CM 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). The Print to scale option will print the captured image at the same scale as shown on the screen. Exact sizing will depend on display and driver but individual print proportions will be a constant. If the scaled image exceeds the page size (with border) it will be reduced to fit. 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 accept these changes or Cancel to ignore changes and return to main options dialog with original settings. ═══ 4. License details ═══ The License details dialog is displayed the first time you start Galleria/CM. 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. ═══ 5. 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. ═══ 6. Setup ═══ The Setup will appear when Galleria/CM is started only if the name of the Desktop application has been changed from the default. Select the current name from the list given. The name may be OS/2 Desktop, OS/2 2.0 Desktop or something similar. Press OK to accept the selected entry. ═══ 7. Supported file formats ═══ The following file formats are supported by this version.  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, 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 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 - AT&T 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 or P), 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