═══ 1. Extended help for "Open Image" ═══ This dialog is where the name of the file to open is specified. There are four areas of interest on this dialog: o Format area o Files area o Directories area o Pushbutton area The "format area" is where you select the format of the file you wish to load. If you want the Image Toolkit to determine the format for you, select "(Determine the file format)". The "files area" is where you see the files in the current directory. Double-clicking on a file in this list is the same as selecting the file and then selecting the "Open" pushbutton. The "directories area" is where you see both the subdirectories beneath the current directory and the available drives from which to choose. Double-clicking on a file in this list is the same as selecting the directory and then selecting the "Open" pushbutton. The "pushbutton area" contains the pushbuttons corresponding to the available actions that can be performed on this dialog. "Open" will either opens the currently selected or entered file, refreshes the file list with the specified filename mask, or changes to the specified directory. The order of precedence is as follows: if a filename has been entered or selected and does not contain any "wildcard" characters, this will attempt to open the file and load the image contained therein; if the filename does contain any "wildcard" characters, this will refresh the file list using the specified filename mask; else, this will change the current directory to the one entered or specified. If nothing is entered and nothing is selected, it is taken as though "*.*" were entered in the filename area. "Properties" will display the format-specific properties dialog, allowing you to specify any format-specific options to be used upon loading. It is the decision of the format handler to use the specified options or not. "Cancel" will return you to the previous window with no action taken. "Help" will display this panel. ═══ 2. Extended help for "Save Image" ═══ This dialog is where the name of the file to save is specified. There are four areas of interest on this dialog: o Format area o Files area o Directories area o Pushbutton area The "format area" is where you select the format of the file you wish to save. The "files area" is where you see the files in the current directory. Double-clicking on a file in this list is the same as selecting the file and then selecting the "Save" pushbutton. The "directories area" is where you see both the subdirectories beneath the current directory and the available drives from which to choose. Double-clicking on a file in this list is the same as selecting the directory and then selecting the "Save" pushbutton. The "pushbutton area" contains the pushbuttons corresponding to the available actions that can be performed on this dialog. "Save" will either saves the currently selected or entered file, refreshes the file list with the specified filename mask, or changes to the specified directory. The order of precedence is as follows: if a filename has been entered or selected and does not contain any "wildcard" characters, this will attempt to save the image with the specified filename; if the filename does contain any "wildcard" characters, this will refresh the file list using the specified filename mask; else, this will change the current directory to the one entered or specified. If nothing is entered and nothing is selected, it is taken as though "*.*" were entered in the filename area. "Properties" will display the format-specific properties dialog, allowing you to specify any format-specific options to be used upon saving. It is the decision of the format handler to use the specified options or not. "Cancel" will return you to the previous window with no action taken. "Help" will display this panel. ═══ 3. Extended help for "Print Image" ═══ This dialog is where you specify the printer and the printing options to be used. There are five areas of interest on this dialog: o Printer list o Alignment area o Options area o Printer page o Pushbutton area The "printer list" is where the currently installed printers are listed, with the default printer selected when the dialog is initially displayed. The "alignment area" is where you can "snap" the image to a particular side or the center in both the horizontal and the vertical directions. The "options area" is where you can select any additional options to apply to the print job. Print to file By checking this checkbox, you can enter a file name to which the printer output will be spooled. To obtain a hardcopy from this file, you simply need to copy the file to the printer. The "printer page" is a depiction of the printable area for the printer you have selected. Here you can manipulate the image by using mouse button 1. When the pointer is in the middle of the image, depressing the button will allow you to change the position on the printer page, while depressing the button when the pointer is positioned on one of the image edges allows you to change the size of the image in the direction corresponding to the edge the pointer is on. Selecting a new printer in the printer list automatically resizes the printer page. The "pushbutton area" contains the pushbuttons corresponding to the available actions that can be performed on this dialog. "Print" will attempt to print the image using the options specified on this dialog on the selected printer. "Properties" will display the printer-specific job properties dialog allowing you to specify any printer-specific options to be used when printing. "Cancel" will return you to the previous window with no action taken. "Help" will display this panel. ═══ 4. Extended help for "Image Window" ═══ This is the main window where all actions are performed. There are three areas of interest (annotated in the picture above): o The action bar o The display area o The miniature view The action bar is where all of the actions are selected from. By moving the cursor to an item and pressing F1, you can get help for that menuitem. The display area is where the image is displayed. It is this area that is manipulated by subsequently selecting any of the appropriate menuitems. Actions such as saving and printing can be performed. (The miniature view is not used at this moment) The miniature view is used for drag-n-drop purposes. When used with applications that support the private format used by the Image Window, you can copy the contents of the display area to other appplications without going through the clipboard. The advantage of doing this is that you don't lose what is currently in the clipboard. ═══ 5. Extended help for "Dither options" ═══ Use the "Dither options" dialog to set the dithering options to be used for this window. On the dialog, three spinbuttons allow you to choose the dithering pattern type, size, and the darkness to be used when dithering an image. For more information, double click on one or more of the following topics: o Dithering o Dithering pattern type and size ═══ 6. Extended help for "Image Information" ═══ Use the "Image Information" dialog to get information about the currently displayed image. The following fields are currently displayed: o Format name o Format author o Width o Height o Color planes o Bits per pel The format name field describes the format that the image was in when it was originally loaded from the disk where it resides. The format author field specifies the author(s) of the format handler used to load the image from the disk. The width field specifies the image width in pels. The height field specifies the image height in pels. The color planes field specifies the number of color planes used for the image. This is a display adapter dependent number, usually. The bits per pel field specifies the number of bits used to describe the color of one pel. The total number of colors in any bitmap is, therefore, 2 raised to the power of this number. The common values are 1, 2, 4, 8, yielding 2, 4, 16, and 256 colors, respectively. ═══ 7. Keys help for "Image Window" ═══ The following keys can be used as short cuts for commonly-performed actions: Ctrl+O Attempts to load a specified image in the window. See also "Open...". Ctrl+S Saves the current image. See also "Save...". F3 Closes the image window. Shift+Del Remove the current image and places it on the clipboard. See also "Cut". Ctrl+Ins Copies the current image and places it on the clipboard. See also "Copy". Shift+Ins Deletes the current image and pastes a copy of the bitmap on the clipboard in the window. See also "Paste". Del Deletes the current image. Ctrl+P Prints the current image to a specified printer. See also "Print image...". Ctrl+I Displays information about the current image. See also "Image information...". ═══ 8. Help for menu "File" ═══ This pulldown menu contains actions dealing with image files. ═══ 9. Help for menuitem "New" ═══ Selecting this menuitem creates a new image window. ═══ 10. Help for menuitem "Open..." ═══ Selecting this menuitem displays a dialog allowing you to specify a file name to load into a new window. Additionally, you can specify that the file to be loaded is in a particular image format to eliminate the time used to determine the format of the file. ═══ 11. Help for menuitem "Import..." ═══ Selecting this menuitem displays a dialog allowing you to specify a file name to load into the current window. Additionally, you can specify that the file to be loaded is in a particular image format to eliminate the time used to determine the format of the file. ═══ 12. Help for menuitem "Save..." ═══ Selecting this menuitem displays a dialog allowing you to specify a file name and file format to save the current image. ═══ 13. Help for menuitem "Close" ═══ Selecting this menuitem closes the image window. ═══ 14. Help for menu "Edit" ═══ This pulldown menu contains actions dealing with editing the contents of the image window. ═══ 15. Help for menuitem "Cut" ═══ Selecting this menuitem copies the displayed image to the clipboard in bitmap format and removes it from the image window. ═══ 16. Help for menuitem "Copy" ═══ Selecting this menuitem copies the displayed image to the clipboard in bitmap format. ═══ 17. Help for menuitem "Paste" ═══ Selecting this menuitem deletes the currently displayed image and copies the bitmap from the clipboard into the image window. ═══ 18. Help for menuitem "Delete" ═══ Selecting this menuitem deletes the currently displayed image. ═══ 19. Help for menu "Options" ═══ This pulldown menu contains actions dealing with the displayed image. ═══ 20. Help for menuitem "Print image..." ═══ Selecting this menuitem displays a dialog allowing you to print the selected area on any local printer queue. Additionally, you can change the destination size and position on the printer page. For LAN printers, the following conditions must be met: There must be defined a local queue associated with a local printer definition. The printer definition must use the same printer driver that is used on the server for the printer in question. The port number (e.g. LPT1, LPT2, etc.) specified in the queue must match that which is used on the "NET USE" command. When PM sees an application spooling a print job to the local queue, it determines that this is to be printed on a LAN printer by the matching port numbers, so it sends the print job over the LAN to the server automatically. ═══ 21. Help for menuitem "Dither image" ═══ Selecting this menuitem dithering the image using the dithering options selected. For more information, double click on the following topic: o Dithering ═══ 22. Help for menuitem "Image information..." ═══ Selecting this menuitem displays a dialog detailing information about the displayed image. ═══ 23. Help for menuitem "Dither options..." ═══ Selecting this menuitem displays a dialog allowing you to change the dithering options to be used by this window. ═══ 24. Help for menuitem "Do not scale image" ═══ Selecting this menuitem indicates that IBrow should not scale the image. Scroll bars are shown, allowing you to scroll through the image if the size of the window is less than that of the image. When save or print is selected, the image is saved or printed in its original size regardless of the window size. ═══ 25. Help for menuitem "Scale image to window size" ═══ Selecting this menuitem indicates that IBrow should scale the image to fit in the window, stretching or compressing the image if necessary. When save or print is selected, the image is saved or printed in its current size. ═══ 26. Help for menuitem "Scale image and maintain aspect ratio" ═══ Selecting this menuitem indicates that IBrow should scale the image to fit in the window, stretching or compressing the image if necessary, while maintaining the ratio of width to height that is in the original image. This ratio is also maintained when the window is resized. When save or print is selected, the image is saved or printed in its current size. ═══ 27. Help for menuitem "Save options" ═══ Selecting this menuitem saves the current options selected to the OS2.INI file. ═══ 28. Help for menu "Help" ═══ This pulldown menu contains actions dealing with online help. ═══ 29. Help for menuitem "Help for help..." ═══ Selecting this menuitem displays help for using the OS/2 Help Manager. ═══ 30. Help for menuitem "Extended help..." ═══ Selecting this menuitem displays extended help for the main window. ═══ 31. Help for menuitem "Keys help..." ═══ Selecting this menuitem displays help for the active keys and their associated actions. ═══ 32. Help for menuitem "Help index..." ═══ Selecting this menuitem displays the help index. ═══ 33. Help for menuitem "About..." ═══ Selecting this menuitem displays the "About" box. ═══ 34. Field help ═══ The current dithering pattern selected is shown in this field. You can change the value using the arrow keys or by clicking on either arrow with the mouse. ═══ 35. Field help ═══ The current dithering pattern size selected is shown in this field. You can change the value using the arrow keys or by clicking on either arrow with the mouse. ═══ 36. Field help ═══ The current darkness selected is shown in this field. You can change the value using the arrow keys or by clicking on either arrow with the mouse. ═══ 37. Field help ═══ Selecting this will apply the current dithering options to the current window. Use the "Save options" menuitem to save these options across invokations. ═══ 38. Field help ═══ Selecting this will return you to the previous dialog or window without taking any action. ═══ 39. Field help ═══ Selecting this will display extended help for the current dialog. ═══ 40. Dithering ═══ Dithering is the process of converting a color or greyscale image to monochrome while preserving the contrast of the individual colors in the original image. The dithering process involves overlaying a two-dimensional pattern of weighting values on top of the original image in a quilt-like fashion. If the average of the color in the image is greater than that of the corresponding element in the dithering pattern, the proper pel in the destination image is set. The image colors are averaged with each component (red, green, and blue) weighted according to the natural eye sensitivity to that component. ═══ 41. Dither pattern type and size ═══ There are four dithering patterns that IBrow can use - diagonal, diamond, circle, and square. Each pattern comes in 3 sizes - 4x4, 6x6, and 8x8. Use the spinbuttons on the dialog to select the values to be used when dithering.