═══ 1. General Help ═══ PMView v0.92 32-bit Multithreaded Image Viewer for OS/2 PM (c) 1992-1995 Peter Nielsen. All rights reserved. Some docs (c) 1992-1995 Raja Thiagarajan. PMView is a viewing and editing tool for bitmapped graphics. It provides support for systems with palette manager and deep color displays. On systems with palette manager, PMView gives you color animation and its color optimizing functions make sure that you always get good looking images with the best colors possible. PMView also has an easy-to-use slideshow feature that lets you create slideshows just by dragging and dropping the images you want. The slideshow controller gives you an easy way to control your slideshow while it's running. PMView supports a variety of file formats, including GIF, TIFF, PhotoCD PRO, and JPEG. PMView offers broader and faster support for these file formats than many other programs do, since we wrote all PMView's code for format handling ourselves, and did a lot of it in hand-optimized assembly. PMView has a unique automatic thumbnailing facility that will create thumbnails for your images. The thumbnails in the file open dialog make it possible for you to browse through hundreds of images in minutes. You'll never again have to load a bunch of images just because you forgot the name of the one you're looking for. PMView is mostly written in C++ using exeption handling. Time-critical tasks have been hand-coded in Pentium assembly language. Throughout this product, we have tried our hardest to provide you with the best possible performance and to take full advantage of the features of the Pentium. Our memory and file management routines will provide you with blazing speed and the best use of your hardware. PMView is dynamically multithreaded, meaning that threads will be created and destroyed as needed. There will never be threads spinning in the background doing nothing. We have also invented a Priority Boost system that will let you use idle time priority without having to worry about locking up PMView or your system. PMView offers online help at any time. Press F1 to obtain context sensitive help, or select Help from the main menu to get a list of all the help topics. ═══ 2. NEW FEATURES in PMView 0.92 ═══ Here is a list of features that are new in PMView 0.92. 1. Built-in Screen Capture that lets you capture a selected window, the interior of a window, the whole screen, or a selected area of the screen. PMView's screen capture includes an unique feature not found in other screen capture programs: PMView can capture parts of a window that lie outside the screen. Thus, if you use a virtual desktop program, you'll be able to capture the whole desktop, not only the visible part! To capture the desktop, select Capture->Window and left-click on the desktop. ATI Mach64 users: There is a bug in the Mach64 drivers shipped with OS/2 Warp that affects screen capture. For more information, read the Bugs section (or search all sections of the online help for "ATI", if you want to go directly to it). 2. New command line option /SHOrtfileretry that lets you use PMView to view images while they're being downloaded via FTP, FTP-PM, C-Kermit, nFTP, LiveWire 2.2, and many other programs. (Any program should work as long as it permits read sharing and writes the image sequentially.) If you add a timeout value to this flag, you can also use it to view POV-Ray images while they're being rendered! 3. TAP Support for LiveWire 3.0 and other terminal emulators that support LiveWire TAP. This will allow progressive display of images as they're downloaded. (In order to use this feature, you'll need to get the latest release of LiveWire. ZOC will also support TAP in a future version.) 4. New Progressive Loading option, on by default (setting is on the "Loading" page in PMView's notebook). This is useful for viewing files while they're being downloaded or created, or for seeing file interlacing. 5. PNG (Portable Network Graphics) file support, read/write 6. IFF (Electronic Arts) file support, read/write 7. MSP (Microsoft Paint) file support, read/write 8. Target directory for file conversions can now be specified on the "Directories" page in PMView's options notebook. 9. Separate option for confirm on slideshow save 10. Toggle visibility of Hidden Files in FOC (View->Hidden Files) 11. Pop-up menu in the FOB directory list box that allows you to toggle Longnames and visibility of Hidden Directories 12. File Revert changed to File Recall-> conditional cascade that remembers the last 8 files 13. Different (remembered) view for each drive in the FOC 14. Thumbnail creation options for saving and converting added to FOC. 15. New, more OS/2-like mini icons in the FOB drives combo. PMView now also has separate icons for CD-ROM, 3.5" disk, and removable media (disk drive icon was used for these in PMView 0.90). 16. GIF and TIFF-LZW are now licensed from Unisys 17. New GIF save options: Version, Interlace, Transparency, and Background. These can be very helpful when creating Web pages. 18. New JPEG save option: Progressive JPEG 19. New TGA save options: RightToLeft, TopToBottom, and InterlaceType 20. New TIFF save options: Compression, Photometric, and Strip size (Compression: [None, Packbits, CCITTRLE, CCITTFAX3, CCITTFAX4, and LZW], CCITTFAX3 options: [2D-Encoding, Fillbits, Uncompressed], CCITTFAX4 options: [Uncompressed], LZW options: [Horizontal differencing predictor], Photometric: [White is Min, and Black is Min], Strip size: [4, 8, 16, and 32 kB]) 21. PNG Save options: Interlace, Histogram, Time, Transparency, and Background. These can be helpful when creating Web pages. The following bugs are fixed in PMView 0.92. 1. File Open Container: File name edit didn't work in Detail View. 2. PMView: The palette was not reset to system colors after quitting PMView under Warp. 3. Thumbnailing: a 271x1 pixel image could crash PMView. 4. Thumbnailing: Black/white and graylevel images with (width <= 80 pixels) and (height <= 80 pixels) caused PMView to generate bad thumbnails. 5. Saving, PCX: Monochrome files were inverted when saved. 6. Saving, TIFF: Required tag 'StripOffsets' was missing 7. Loading, TGA: Some RLE encoded files decoded with small defects. 8. Loading, TIFF: CCITTFAX3 Uncompressed mode images weren't supported -> error. 9. Loading, TIFF: 3, 5, 6, and 7 bit images didn't load correctly 10. Slideshow: Images were shown according to the previously selected mode (View/Edit). This is not correct; slideshows should always run in View mode. 11. File Open/Save Dialog: "Open Filename:" entry field didn't recognize directories, e.g. typing 'c:\os2\' or 'c:\os2' will try to open the FILE 'os2' instead of switching directories. A lot of other problems with this field have been fixed. 12. Settings Notebook, Directory page: Empty field for load/save directory defaulted to root instead of the current directory. 13. File Open Container: Image info did not display width/height/bitcount information for PBMPlus files (PPM,PGM,PBM) 14. File Open Container: Image info did not display width/height/bitcount information for TIFF files that didn't include a 'BitsPerSample' tag. 15. File Save Container: Thumbnail options on background menu (Manual/Automatic/Loading Creates, Transparent Fill) didn't have any effect. 16. Undo/Redo: If you do a transformation (eg. rotate), saved the file with a different name and then selected undo, the file will get the name that it had before saving. That is, the file name change would also be undone. This is, of course, not correct. 17. PMView's Title Bar: Files with LONGNAME attribute attached and a longname containg or did not display correctly in the title bar. (The filename was truncated at the first ) 18. FOB Drive Combo: Selecting a removable drive did not update its drive label. 19. File Open Container: Pressing while the container still was filling up would give "Cannot delete file" error messages and could crash PMView with SYS3175. 20. Saving: Loading a new image while saving caused PMView to crash. 21. Printing: Loading a new image while printing caused PMView to crash. 22. Transformations: Loading a new image while transforming an image caused PMView to crash. 23. File Save dialog and Image Info dialog, 16 color systems: Having a deep color image loaded when you opened the Image info Dialog or File Save dialog would make PMView crash with SYS3175. 24. Saving: Exiting with the current image unsaved and answering "Yes" to save the image would trash the image (PMView would write an image with no contents). Other fixes and changes in PMView 0.92. 1. Saving, BMP: When saving bitmaps in OS/2 2.x bitmap format, PMView will now always write the complete OS/2 2.0 64-byte header (BITMAPINFOHEADER2). (To save disk space, previous versions of PMView would truncate the header after the last used field. This is legal [according to IBM's documentation], but some applications [such as IBM's resource compiler] could not read these shorter bitmaps.) 2. Loading, TIFF: Support for predictor added to bitcounts < 8 3. Loading, TIFF: Support for colormapped TIFFs with incorrectly stored color map. (For example WAVE9.TIF on the bonuspak disc.) 4. PMView: Behaviour of all Combos (Combinated list boxes) changed from OS/2 standard behavior to behave as requested by PMView users. For example, pressing in the "List Files of Type" field will now directly change to "JPEG" without confirmation by (OS/2's default behaviour requires you to press to activate the change). 5. File Open Container: Workaround for negative thumbnails. The option for this is on the "Special" page. ------------------------------------------------------- There was no PMView 0.91 because an unofficial beta was illegally uploaded to FTP-sites as 'PMVIEW91.ZIP'. ------------------------------------------------------- Here is a list of features that were new in PMView 0.90. 1. The shareware (unregistered) version is now fully functional. You can now test all the features before registering (except the ability to turn off the logo). 2. There is a new dialog for file saves. In addition to being able to save BMP files and PMView slideshows, you can now save a bitmap using GIF, JPEG, PCX, PIC, TGA, TIFF, or PBMPlus (PBM, PGM, and PPM) formats. (And BMPs can now be saved in OS/2 1.x, OS/2 2.x, or Windows 3.x format). 3. There is fully context-sensitive online help (just hit F1). 4. There is a new Convert to-> command on the File Open and Save popup menus. This makes it convenient to batch convert images as a background task. 5. You can now print! You can print an image across multiple pages, adjust gamma for your printer, set up your printer, set up your page margins using millimeters, inches, or percentages. 6. There are new filters, including user-definable filters. NOTE: The filter file format will change significantly in the next release of PMView, so you should be prepared. 7. There is a palette editor, so that you can change the palette entries on non-deep-color images. 8. You can now drag a rectangular area to cut, crop, or paste. An optional Track Info dialog box tells you the exact size and location of the selected area, and lets you type in a new location or size. 9. There is new support for reading and writing PBMPlus files (PBM, PGM, and PPM). 10. Kodak Photo CD PRO files (6144x4096) can now be read. 11. There is support for more TIFF formats: FAX3/2D, FAX4, and Thunderscan compressions. 12. There is a completely new multithreaded method for painting the PMView window. This usually requires 3-4 times less RAM(!) than the old method and lets PMView display arbitrarily large bitmaps. (The old method used a shadow bitmap and would have required approximately 120MB of virtual memory to display a 40MB TIFF file. This is, in fact, more than OS/2 PM can handle; trying to use a bitmap this large usually makes the system hang. With the new method, you can display the same bitmap with 45MB of free virtual memory.) However, since the new method may be slower on certain display drivers, the old method is available as an option in the settings notebook. Additionally, you can set an image-size threshold to choose between display methods depending on the image you want to view. 13. The new Edit mode allows you to load, view, and save images with more colors than you can display. (View mode discards extra colors to save memory, speed painting, and give the best display quality for your screen mode.) 14. Dithering (to the screen or when reducing colors) is now multithreaded. 15. Long file name support has been improved. PMView now displays the long file name in the title bar and in all info dialogs. PMView also handles the .LONGNAME extended attribute in full. So, for instance, you can copy an image from an HPFS drive to a FAT drive (using the Drives object), and PMView will display the long file name. It also means you can give your images arbitrarily long names, even on FAT drives, and PMView (and OS/2's drive object) will display these names. (Note that OS/2's DIR command and many other programs will not display the long names.) 16. If you wish, PMView can display physical file names instead of Long File Names. 17. Support for 16-color systems has been improved. You can choose from a variety of optional fixed palettes and dithering methods. 18. Support has been improved for 256 color systems without palette manager. You can choose from a variety of optional fixed palettes and dithering methods. 19. There is a new Solarize special effect. 20. You can now adjust Gamma for your screen. This can be very useful when displaying images created on other computer systems (which often look too dark or too bright). 21. You can reduce to black/white, 16 colors, or 256 colors. (The last command includes an option to let you choose any number of colors between 0 and 256.) 22. The new "complete" Undo/Redo works on any operation that has modified the image. 23. The bulky old progress bar has been replaced by an animated clock mouse pointer. This saves screen space, RAM, and time. 24. You can now see color adjustments (brightness/contrast, gamma, etc.) in real-time on systems with deep color or without palette manager! 25. All the transform functions have been enhanced. The clock pointer will show your progress, and you can cancel the operation at any time by pressing ESC. 26. Transform functions now run in idle-time (with priority boost). 27. Priority boost has been enhanced to be less sensitive to "CPU hogs" once the process has started. (Previous versions of PMView could boost load priority unnecessarily due to a temporary "CPU hog".) 28. There are new command-line options. For instance, /WPOS lets you control the initial size and position (including Z-order!) of PMView's window. 29. There are new pages in the options notebook. The Confirmations page lets you choose whether to be warned when deleting files, discarding changes, or stopping a batch conversion. The Logo page (disabled on the unregistered version) lets you select how long to display the opening logo (or you can turn it off). And, by popular demand, a second page has been added to the Slideshow page of the options notebook, so you can set the defaults for new slides. 30. PMView can now interpolate pixels when resizing or rotating images. This is a little slower, but the results look much better. 31. The File Open Container and Slideshow Container will now "auto scroll" when you keep the left mouse button pressed and move outside the container. This is very handy for selecting multiple files. 32. PMView has better support for national language conventions. For instance, PMView will sort the names in the File Open box correctly according to the country selected in OS/2. Dates, times, and numbers will be displayed in the way that you have configured OS/2. ═══ 3. Coming Soon: TWAIN Scanner Support ═══ TWAIN was acknowledged by IBM as an important workstation standard at the recent May 1995 New Orleans Technical interchange. TWAIN allows applications to control scanners that have TWAIN drivers. A version of PMView with full 32-bit TWAIN support should be available to registered users by October 1995. 32-bit OS/2 TWAIN scanner drivers are available from Solution Technology Inc. Currently supported scanners are:  Hewlett-Packard IIP, IIC, IICX, 3P, 3C, 3CX  Logitech Scanman 256  Bell & Howell 3338  Epson 1200C, GT-9000 Series  Fujitsu 3096, 3097, and ScanPartner 10  Microtek IISP (under development)  Mustek FMS-6000CX (under development) For more information about TWAIN drivers for other scanners, please contact STI. Solution Technology, Inc. 1101 South Rogers Circle, Suite 14, Boca Raton, FL 33487 Phone: (407) 241-3210 Fax: (407) 997-6518 E-mail: solution@gate.net ═══ 4. Menu Commands ═══ For a detailed explanation of each menu, select from the list below:  File...  Mode...  Edit...  Transform...  Color...  View...  Help... ═══ 4.1. File Menu ═══ The File menu lets you transfer files from/to disk or to delete the current image or run a slideshow.  Open is used to load an image from disk or to browse your images and create/delete thumbnails.  Recall will revert to the file on disk, which means any changes you had made to it (or your view of it) are lost. Recall also lets you recall one of 8 recently loaded files.  Save will save the current image to disk. The image will be written to a file with the same file name, format, and options that were used when the file was last saved.  Save As lets you save the file with a different name, in another file format, or with different save options.  Delete will delete the currently displayed  Close will close the current image or slideshow.  Capture will let you capture the whole screen or selected parts of it.  Print will print the currently displayed image.  Print Setup lets you select which printer to use, and its job properties (e.g., the page orientation).  Page Setup lets you alter page settings (e.g., the size of the paper and the margins).  Exit will quit PMView and returns you to OS/2. ═══ New ═══ ═══ 4.1.1. Open ═══ This opens the File Open Dialog that lets you load an image from disk, browse your images and create/delete thumbnails. The shortcut key for Open is Ctrl+O. ═══ 4.1.2. Recall ═══ This will let you revert to the current file on disk, or recall previously loaded files. The 8 most recently loaded files are listed and can directly be recalled by selecting the corresponding file. Note that you can revert to the current file by a single click on Recall, i.e. you don't need to open the Recall menu and select from the list. ═══ 4.1.3. Save ═══ This saves the current file to disk. The image (or slideshow) will be written to a file with the same file name, format and options that were used when the file was last saved. The shortcut key for Save is Ctrl+S. ═══ 4.1.4. Save As ═══ This saves the file with a different name, in another file format or change any of the save options. ═══ 4.1.5. Delete ═══ This deletes the currently displayed image from disk. Note: PMView will ask for file delete confirmation in accordance with the setting on the Confirmations page in PMView's Options Notebook. The shortcut key for Delete is Ctrl+D. Warning: This command is irreversible. ═══ Confirm Deletion ═══ You're about to delete the file you're currently viewing.  Select Yes to proceed and delete the file.  Select No if you want to keep the file. Warning: This command is irreversible. ═══ 4.1.6. Close ═══ This will close the current image or slideshow. ═══ 4.1.7. Capture ═══ This is PMView's built-in Screen Capture feature that lets you capture a selected window, the interior of a window, the whole screen, or a selected area of the screen.  Window lets you select a window and capture it completely with frame.  Window Interior lets you select a window and capture it without frame.  Screen will capture the current screen.  Area of Screen lets you select and capture a part of the screen.  Hide Windows lets you toggle whether you want PMView's windows to be included or not. ═══ 4.1.7.1. Window ═══ This will let you capture a window including its borders, title-bar and menu bar. Click the left mouse button to select window. Clicking the right mouse button or pressing ESC will cancel the capture. Use the Hide Windows option to select whether PMView should be hidden during capture. If this option is on, PMView and its windows will be hidden, thus making it easier for you to select the window to capture. However, if you would like to capture one of PMView's windows this option must be turned off. Note that PMView is capable of capturing parts of a window that lie outside the screen. Thus, if you use a virtual desktop program, you'll be able to capture the whole desktop, not only the visible part! To capture the desktop, please use the Window capture method and left-click on the desktop. Related information:  Hide Windows ═══ 4.1.7.2. Window Interior ═══ This will let you capture the inside of a window, i.e. its borders, title-bar and menu bar will not be included. Click the left mouse button to select window. Clicking the right mouse button or pressing ESC will cancel the capture. Use the Hide Windows option to select whether PMView should be hidden during capture. If this option is on, PMView and its windows will be hidden, thus making it easier for you to select the window to capture. However, if you would like to capture one of PMView's windows this option must be turned off. Note that PMView is capable of capturing parts of a window that lie outside the screen. Thus, if you use a virtual desktop program, you'll be able to capture the whole desktop, not only the visible part! To capture the desktop, please use the Window capture method and left-click on the desktop. Note: If the captured window belongs to a Win-OS/2 application the result is unpredictable. Please use the Window capture type when capturing Win-OS/2 applications. Related information:  Hide Windows ═══ 4.1.7.3. Screen ═══ This will capture the current screen, i.e. the visible part of the desktop. Use the Hide Windows option to select whether PMView should be hidden during capture. If this option is on, PMView and its windows will be included (visible) in the captured image. Note that PMView is able to capture the whole desktop, not only the visible part of it! To capture the desktop, please use the Window capture method and left-click on the desktop. Related information:  Hide Windows ═══ 4.1.7.4. Area of Screen ═══ This will let you select and capture a part of the screen. Select one of the corners of the area you wish to capture and press the left mouse button. Hold the mouse button down and move the mouse to select the capture area. Release the button to capture the currently selected area. Clicking the right mouse button or pressing ESC will cancel the capture. Use the Hide Windows option to select whether PMView should be hidden during capture. If this option is off, PMView and its windows will be included (visible) in the captured image. Related information:  Hide Windows ═══ 4.1.7.5. Hide Windows ═══ Use this option to select whether PMView should be hidden during capture or not. If on, PMView and its windows will be hidden, thus making it easier for you to select the window to capture. If off, PMView and its windows will not be hidden and you will be able to capture one of PMView's windows. Tip: You can make a 'contact sheet' by turning this option off and capturing PMView's File Open Container. ═══ Confirm Capture ═══ The area of the window you selected for capturing is more than twice as large as the screen area. Capturing it requires a lot of memory. Please confirm that you really want to capture this window.  Select Ok to proceed and capture the window.  Select Cancel to cancel the capture. ═══ 4.1.8. Print ═══ This opens up the Print Image dialog. that lets you print the currently displayed file. Related information:  Print Setup dialog.  Page Setup dialog.  Print Image dialog. ═══ 4.1.9. Print Setup ═══ This opens up the Print Setup dialog. that lets you select printer and printer specific options. Related information:  Print Setup dialog.  Page Setup dialog.  Print Image dialog. ═══ 4.1.10. Page Setup ═══ This opens up the Page Setup dialog. that lets you set margins and other page specific options. Related information:  Print Setup dialog.  Page Setup dialog.  Print Image dialog. ═══ 4.1.11. Exit ═══ This quits PMView and returns you to OS/2 The shortcut key for Exit is Ctrl+X. ═══ 4.2. Mode Menu ═══ The functions in the Mode menu sets the function mode of PMView  View This will set PMView into View mode, that is, PMView will convert the image to look as good as possible on your display. The image data may be converted, thus you should not use this mode if you have intended to save the image to disk. For instance, loading a deep color image on a 256-color system will reduce the number of colors to 256 colors. If you now save this image in View mode important color information may be lost! We recommend that you always use Edit mode when saving files.  Edit This will set PMView into Edit mode. In this mode PMView never converts the image. Full color information of the original image will be retained. If your display adapter cannot display all color information in the image, PMView will use dithering when showing the image. Use Edit mode when saving files.  Slideshow This will set PMView into Slideshow mode. Note: The two first options are replaced by one single option on deep color systems since these systems are capable of showing colors correctly, thus dithering is not needed. ═══ 4.2.1. View ═══ This will set PMView into View mode, that is, PMView will convert the image to look as good as possible on your display. The image data may be converted, thus you should not use this mode if you have intended to save the image to disk. For instance, loading a deep color image on a 256-color system will reduce the number of colors to 256 colors. If you now save this image in View mode important color information may be lost! We recommend that you always use Edit mode when saving files. Note: This option is replaced by View/Edit on deep color systems. ═══ 4.2.2. Edit ═══ This will set PMView into Edit mode. In this mode PMView never converts the image. Full color information of the original image will be retained. If your display adapter cannot display all color information in the image, PMView will use dithering when showing the image. Use this mode when saving files. Note: This option is replaced by View/Edit on deep color systems. ═══ 4.2.3. Slideshow ═══ This will set PMView into Slideshow mode. ═══ 4.3. Edit Menu ═══ The functions in the Edit menu handle undo/redo and copying of images to and from the OS/2 clipboard.  Undo/Redo will undo or redo the last change you made to the image.  Free Undo Memory will release undo/redo memory.  Undo Enabled lets you enable or disable the undo/redo function.  Cut takes out the current selection and puts it on the clipboard.  Copy copies the current selection and puts it on the clipboard.  Paste pastes the image that is currently on the clipboard into PMView.  Crop discards all pixels outside the selected area  Track Info toggles the Track Info dialog. ═══ 4.3.1. Undo/Redo ═══ This command will undo or redo the last change you made to the image. The shortcut key for Undo/Redo is Ctrl+U. ═══ 4.3.2. Free Undo Memory ═══ This command will release the memory used by Undo/Redo ═══ 4.3.3. Undo Enabled ═══ This command will enable or disable the Undo/Redo function. Disabling the Undo will require less memory for PMView to run. ═══ 4.3.4. Cut ═══ This command removes the current selection from PMView and puts it on the clipboard. For 24-bit and grayscale images the removed are will be filled with black. For 16- and 256-color images it will be the background color (= the color in palette index 0). The shortcut key for Cut is Shift+Delete. Related information:  How to mark a selection.  Track Info dialog. ═══ 4.3.5. Copy ═══ This command puts a copy of the current selection on the clipboard. The shortcut key for Copy is Ctrl+Insert. Related information:  How to mark a selection.  Track Info dialog. ═══ 4.3.6. Paste ═══ This command pastes the image that is currently on the clipboard into PMView.  Paste As Selection pastes the image on the clipboard into the current image.  Paste As New Image pastes the image on the clipboard as a new image. ═══ 4.3.6.1. Paste As Selection ═══ This command pastes the image that is currently on the clipboard into the current image. The shortcut key for Paste As Selection is Shift+Insert. Related information:  Track Info dialog. ═══ 4.3.6.2. Paste As New Image ═══ This command pastes the image that is currently on the clipboard as a new image. ═══ 4.3.7. Crop ═══ This command will discard all pixels outside the selected area. The shortcut key for Crop is Ctrl+R. Related information:  How to mark a selection.  Track Info dialog. ═══ 4.3.8. Track Info ═══ This command toggles whether the the Track Info dialog should be shown when selecting an area. The shortcut key for Track Info is Ctrl+T. Related information:  Track Info dialog. ═══ 4.3.9. How to mark a selection ═══ To mark a selection, hold down the left mouse button and move the mouse to size the rectangle. Afterwards, if you would like to move the selection rectangle you can point with the mouse somewhere inside the selected area, hold down the left mouse button and move. If you would like to resize the selection, you can grab any of the eight handles and move the selected edge. The four handles at the corners enables toy to move two edges at the same time. The four handles at the center of the edges lets you move only the selected edge. If you need to make a very precise selection you can zoom into the image with any of the Zoom functions. Use the Track Info dialog to view the coordinates and size of the selected area. You can cancel the selection by pressing Esc ═══ 4.3.10. Track Info dialog ═══ Using the Track Info dialog you can set and view the coordinates and size of the selected area. The coordinates of the four corners of the selected area are indicated in the format (x,y). The origin (0,0) is at the lower-left corner. At the bottom of the dialog the size of the selected area is indicated as (width x height). Below the size is the transformation angle. Use the Left,Right,Upper, and Lower controls to adjust the edges of the selection. Example on how to use the tracking rectangle to measure angles Below, we have an image of the number seven. The number has been rotated by an unknown amount. In order to be able to turn it back again, we need to know the angle. The angle can be measured by positioning the tracking rectangle (selection area) as illustrated below. Now you can read the angle directly from the Track Info dialog. In this case we would need to rotate the image by 35 degrees to the right in order to turn it back. Note that the angle depends on how you measure, sometimes you may need to calculate your angle as 90 degrees minus the angle indicated by PMView. Note: If you're pasting a selection you cannot resize the area, thus the upper setting will follow the lower setting, the right will follow the left and vice versa. ═══ 4.4. Transform Menu ═══ The functions in the Transform menu are used to change the pixel orientation and size of an image.  Mirror lets you mirror the image horizontally, vertically or diagonally.  Rotate lets you rotate the image to the left, right, upside down or by a specified angle.  Size lets you change the size of the image or stretch it in either direction.  Filter lets you apply a user defined filter to the image. ═══ 4.4.1. Mirror ═══ The functions in the Mirror menu are used to perform various mirror operations on the image data.  Horizontal reverses (mirrors) left and right on the image.  Vertical reverses (flips) top and bottom on the image.  Diagonal turns the image upside down. ═══ 4.4.1.1. Horizontal ═══ This reverses left and right on the image. If you had an image of a left parenthesis, it would look like a right parenthesis. This effect is often referred to as mirroring. Example of horizontal mirroring: The original bitmap Mirrored ═══ 4.4.1.2. Vertical ═══ This reverses top and bottom on the image. If you had an image of a big "M," it would look like the image of a big "W." This effect is often referred to as flipping. Note: Vertical mirroring is not the same as turning the image upside down. Example of vertical mirroring: The original bitmap Flipped ═══ 4.4.1.3. Diagonal ═══ This transforms left to right and top to bottom simultaneously, which is the same as turning the image upside down. If you had an image of an arrow pointing northeast, it would now point southwest. The effect is identical to a 180° rotation. Example of diagonal mirroring: The original bitmap Diagonally mirrored ═══ 4.4.2. Rotate ═══ The functions in the Rotate menu are used to perform various rotation operations on the image data.  90° ClockWise rotates the image by 90 degrees to the right.  90° CounterClockWise rotates the image by 90 degrees to the left.  180° Upside Down rotates the image by 180 degrees.  Arbitrary Angle opens a control that lets you rotate the image by a specified angle. ═══ 4.4.2.1. 90° ClockWise ═══ This turns the image 90 degrees to the right. An arrow that pointed up would now point right. Example of 90° clockwise rotation: The original bitmap Rotated to the right by 90 degrees ═══ 4.4.2.2. 90° CounterClockWise ═══ This turns the image 90 degrees to the left. An arrow that pointed up would now point left. Example of 90° counterclockwise rotation: The original bitmap Rotated to the left by 90 degrees ═══ 4.4.2.3. 180° Upside Down ═══ This rotates the image 180 degrees, that is turns it upside down. If you had an image of an arrow pointing northeast, it would now point southwest. The effect is identical to diagonal mirroring. Example of 180° rotation: The original bitmap Rotated by 180 degrees ═══ 4.4.2.4. Arbitrary Angle ═══ This lets you rotate the image by an arbitrary angle. Positive values rotate to the right (clockwise) and negative values to the left (counterclockwise). For example, if you enter "27," your image will be rotated 27 degrees to the right, "-27" would rotate it 27 degrees to the left. Interpolate pixels If checked, the pixels in the new image will be calculated using a pixel average method. Using interpolation is much slower, but gives a far better result. Rotating an image without interpolation may cause aliasing effects. For example, the image below has been rotated without interpolation. You may notice that the rotation has caused Monalisa's left eye to disappear. This would not have occured if interpolation had been used. Note that the image will be converted to RGB deep color when interpolation is used. Example of 45° rotation: The original bitmap Rotated by 45 degrees ═══ 4.4.3. Size ═══ This lets you change the actual size of the image.  Size Select either Custom size, Desktop size or one of the fixed sizes your image should get. - Custom This will let you specify the size using the Custom Size controls. - Desktop This will resize the image to fit your desktop. - 640x480 This will make the image 640 pixels wide and 480 pixels high. - 800x600 This will make the image 800 pixels wide and 600 pixels high. - 1024x768 This will make the image 1024 pixels wide and 768 pixels high. - 1280x1024 This will make the image 1280 pixels wide and 1024 pixels high.  Custom Size If Custom is selected, these controls are enabled and you can specify the new size of the image in pixels or percentage (%).  Keep Proportional If checked, the new image will keep the same proportions as the original; the width will automatically change as you change the height and vice versa. However, if you uncheck it, it is possible for you to alter the proportions. For instance, if you size an image of a circle by 150% width and 110% height the circle will no longer be a circle but an ellipse. This effect is often referred to as stretching.  Interpolate pixels If checked, the pixels in the new image will be calculated using a pixel average method. Using interpolation is much slower, but gives a far better result. For instance, if you enlarge an image by a factor of four (400%), 4x4 pixel squares may be visible if no interpolation is used. Reducing an image in size without interpolation may cause aliasing effects. Note that the image will be converted to RGB deep color when interpolation is used. Examples of sizing and stretching: The original bitmap Sized by 200% width and 200% height Stretched by 200% width and 100% height ═══ 4.4.4. Filter ═══ This opens the Select Filter dialog. ═══ Select Filter ═══ This lets you apply a filter on your image.  OK applies the currently selected filter on the image.  Cancel exits without changes to the image.  New lets you create a new filter.  Edit lets you edit the currently selected filter.  Delete deletes the currently selected filter. Related information:  The PMVIEW_FILTER environment variable ═══ Edit Filter ═══ This dialog lets you edit your own filter. Note that you can only edit filters that are smaller than or equal to 7x7 with PMView's built-in filter editor. If you need a larger filter PMView sure can apply it to your image, but you'll need to edit it with a separate (standard) ASCII-editor.  Filter Name The name of the filter.  Filter Weights The matrix of filter weights.  Divisor This is the number that the sum of the pixels in the weight matrix are divided with. Note that the filter size should always be uneven, i.e. the filters that can be edited with this editor are 3x3, 3x5, 3x7, 5x3, 5x5, 5x7, 7x3, 7x5, and 7x7 (larger filters must be edited separately as stated above). Empty fields will automatically be filled with zero (0).  Bias This number will be added to the resulting value once the weight and division factors have been applied. 100% bias corresponds to a bias value of 255.  Absolute value If on, the pixel values will be clamped as x = min (255, abs (x)). If off, the pixel values will be clamped as x = min (255, max (0, x)). Related information:  The PMVIEW_FILTER environment variable ═══ Invalid filter dimension ═══ The filter size should always be uneven, i.e. the filters that can be edited with PMView's internal filter editor are 3x3, 3x5, 3x7, 5x3, 5x5, 5x7, 7x3, 7x5, and 7x7 (larger filters must be edited with a separate (standard) ASCII-editor. ═══ Filter too large ═══ You can only edit filters that are smaller than or equal to 7x7 with PMView's built-in filter editor. You'll need to edit this filter with a separate (standard) ASCII-editor. ═══ 4.5. Color Menu ═══ The functions in the Color menu are used to change the colors or shades of an image.  Brightness/Contrast/Color opens a control that lets you adjust the brightness, contrast, and color of your image.  RGB Balance opens a control that lets you adjust the relative strengths of red, green, and blue in your image.  Gamma Correction opens a control that lets you adjust the gamma value of your image.  Solarize will apply the Solarize effect to your image and opens a control that lets you adjust the solarization threshold.  Negative inverts the colors in your image.  Convert to converts the colors in your image. Note: If you're handling images with more than 256 colors these adjustments may take a while, since every pixel in the bitmap must be remapped. In order to obtain smooth operation a system with palette manager should be used. Related information:  Example of using the color adjustment tools.  Example of creating an OS/2 background bitmap. ═══ 4.5.1. Brightness/Contrast/Color ═══ These controls let you adjust the brightness, contrast, and color of your image. Brightness and contrast work pretty much the way they do on most TV sets. Color lets you adjust how much color appears in the image (some TV sets have this control). If you change your mind later, you can come back to this control and press the Reset button. This will return you to your original settings for brightness, contrast, and saturation.  Brightness adjusts the brightness, i.e. amount of light in your image.  Contrast adjusts the contrast of your image. Images that exhibit low contrast can sometimes be visually enhanced by increasing the contrast.  Color adjusts the color strength of your image. If you turn the color all the way down (-100%), you'll get a black-and-white image. This control will be disabled if grayscale is turned on. Note: If you're handling images with more than 256 colors, you should adjust color last. This is because the other adjustments take twice as long when color has been moved away from 0% under those circumstances. Related information:  Example of using the color adjustment tools. ═══ 4.5.2. RGB Balance ═══ These controls let you adjust the relative strengths of red, green, and blue in your image. If you change your mind later, you can come back to this control and press the Reset button. This will return you to your original settings for red, green, and blue.  Red adjusts the amount of red in your image.  Green adjusts the amount of green in your image.  Blue adjusts the amount of blue in your image. Related information:  Example of using the color adjustment tools. ═══ 4.5.3. Gamma Correction ═══ This contol allows you to apply a gamma correction value to the colors of an image to correct for the difference in gamma levels between the computer's monitor and the equipment that originally produced the image. Your images may come from many different sources. Some of these sources do not use the same gamma values as your computer's monitor. As a result, your image's colors may not be correct; for instance, the dark areas of your image may be far too dark, but the bright areas may be about correct. This problem can be fixed by applying gamma correction. An example of an image that may need a gamma correction would be an image that was scanned by a scanner. Scanners use different gamma values than computer monitors. An example of an image that should not need gamma correction would be an image that was produced with a painting program. Since the colors of the image were selected on a computer monitor, your monitor should be able to represent the original colors. Related information:  Example of using the color adjustment tools. ═══ 4.5.4. Solarize ═══ This control lets you add a solarization effect and adjust the solarization threshold. The solarization effect is generated by selectively inverting pixels below or above a specified threshold level.  Threshold Set the brightness level above or below which pixel data is inverted. For instance, if this is set to 127 and the mode is set to Brighten, all pixels that have a value below 128 are inverted. Pixels with a value above or equal to 128 are left unchanged.  Mode - Darken Pixel values above the threshold level are inverted. - Brighten Pixel values below the threshold level are inverted. Related information:  Example of using the color adjustment tools. ═══ 4.5.5. Negative ═══ If you turn this option on, you will see a negative of your image; for example, black pixels will become white. Select it again to turn it off. Related information:  Example of using the color adjustment tools. ═══ 4.5.6. Edit Palette ═══ This control lets you edit each palette slot in the palette associated with the current image. Deep color images don't have a palette and the Edit Palette option is thus disabled. In this case you can use the Convert to option to convert the image to 256 colors or fewer. Select the color you would like to edit by clicking on the desired color slot. The slots are ordered from left to right, top to bottom with the first slot at the top left corner. The palette slots are arranged in order of frequency. The first slot contain the color that has the highest frequency (is most used) in the image. The last slot (bottom right) has the lowest frequency. If the image has fewer than 256 colors the empty palette slots are disabled (indicated by a diagonal line pattern). These empty slots cannot be edited. ═══ 4.5.7. Convert to ═══ The functions in the Convert to menu are used to change the number of colors or shades of an image.  Black/White will convert your image to black and white.  Grayscale will convert your image to shades of gray.  Indexed 16-Color will open a dialog that lets you reduce the number of colors in the image to a maximum of 16 distinct colors.  Indexed 256-Color will open a dialog that lets you reduce the number of colors in the image to a maximum of 256 distinct colors.  RGB Deep Color will convert your image to 24-bit deep color. Related information:  Example of creating an OS/2 background bitmap. ═══ 4.5.7.1. Black/White ═══ This will convert your image to a black and white image. Use the threshold control to set the treshold. A threshold setting of 128 means that pixels with values equal to and larger than 128 will be white. ═══ 4.5.7.2. Grayscale ═══ This will convert your image to shades of gray. ═══ 4.5.7.3. Indexed 16-Color ═══ This will reduce the number of colors in the image to a maximum of 16 distinct colors. Palette  Adaptive This will select the 16 best colors for the image. The palette generated for the image is optimized and unique for this image.  System This will only use the 16 fixed colors in OS/2's system palette. The palette for the image is fixed. Images converted to system palette will all have the same palette.  2-2-2 levels This will use a standard 2-2-2 level palette, that is, a palette with 2 intensity levels for each color component (Red,Green,Blue), thus the image will be reduced to a maximum of 8 colors. Dither  None The colors will be selected on best match basis. The color error is not compensated.  Ordered Ordered dithering is used to compensate the error. Ordered dithering can only be used with the 2-2-2 level palette.  Diffusion Floyd-Steinberg error diffusion dithering is used to compensate the color error. Related information:  Example of creating an OS/2 background bitmap. ═══ 4.5.7.4. Indexed 256-Color ═══ This will reduce the number of colors in the image to a maximum of 256 distinct colors. Palette  Adaptive This will select the 256 best colors for the image. The palette generated for the image is optimized and unique for this image.  System This will use the 256 fixed colors in OS/2's system palette. The palette for the image is fixed. Images converted to system palette will all have the same palette.  8-8-4 levels This will use the vaunted 3-3-2 bits fixed palette, that is, a palette with 8 intensity levels for the Red and Green components and 4 levels for Blue. This palette was used in the 2.x versions of Microsoft Windows.  6-7-6 levels This will use a 6-7-6 level fixed palette, that is, a palette with 6 intensity levels for the Red and Blue component and 7 levels for Green, thus the image will be reduced to a maximum of 252 colors.  6-6-6 levels This will use a 6-6-6 level fixed palette, that is, a palette with 6 intensity levels for each color component (Red,Green,Blue), thus the image will be reduced to a maximum of 216 colors. This palette is well suited for systems with palette manager since the Palette Manager works best if the palette contains no more than 236 color entries. Dither  None The colors will be selected on best match basis. The color error is not compensated.  Ordered Ordered dithering is used to compensate the error. Ordered dithering can only be used with R-G-B level palettes.  Diffusion Floyd-Steinberg error diffusion dithering is used to compensate the color error.  Maximum Error This sets the maximum accumulated error for the Floyd-Steinberg error diffusion dithering. Decreasing the maximum error will suppress dithering and vice versa. Real-life images generally look better with a high setting, whereas computer generated images (images with large areas of equal shade) look better with a low setting. Number of colors If you have selected Adaptive Palette this will let you select the maximum number of distinct colors in the image. Related information:  Example of creating an OS/2 background bitmap. ═══ 4.5.7.5. RGB Deep Color ═══ This will convert your image to 24-bit deep color. Some image manipulation functions may requre that the image is converted. ═══ 4.5.8. Example of creating an OS/2 background bitmap ═══ All bitmaps that the OS/2 workplace shell displays will use OS/2's fixed system palette unless you have a system configuration that supports deep color On deep color systems any bitmap will look good and doesn't need futher conversion. When selecting colors from the system palette, OS/2 uses a best fit color matching algorithm. Color errors are not compensated and the result is often a poor-looking image unless the colors happen to match well. By converting your bitmap to OS/2's system palette using a more sophisticated method (e.g. error diffusion dithering) you can produce a much better-looking image and OS/2 will display it correctly since the bitmap will only possess colors found in the OS/2 palette, thus no color errors will occur when it is displayed. On 256 color systems with palette manager only 16 colors are fixed. The other 240 will change when an application uses the palette manager. In this case you may want to use only 16 colors for your background bitmaps in order to keep them good-looking all the time. Example of creating an OS/2 background bitmap First choose method:  If your system has fewer than 256 colors, use Method #2  If your system don't have palette manager, use Method #1  If it is important that the background bitmap looks good also when an application that uses palette manager is running, use Method #2  If you want the best possible colors, use Method #1  If you just want a background bitmap and the issues above are not of importance, try Method #2. If the result isn't satisfactory, use Method #1 Then apply the selected method: Method #1 - Convert to 256 colors 1. Select Convert to Indexed 256-Color from the Color menu. 2. Set Palette to System. 3. Set Dither to Diffusion. 4. Press OK Method #2 - Convert to 16 colors 1. Select Convert to Indexed 16-Color from the Color menu. 2. Set Palette to System. 3. Set Dither to Diffusion. 4. Press OK ═══ 4.5.9. Example of using the color adjustment tools ═══ Example of using the color adjustments to produce an old looking black and white photography from a color image:  Load a color image of your choise.  Convert to grayscale. You'll now have a black and white image.  Adjust the red and green controls to approx. +8% each. This will add a slight shade of yellow to your image to produce that old look.  Finally you can adjust brightness and contrast to match your personal taste. ═══ 4.6. View Menu ═══ The first four functions in the View menu change how you see the image, but don't actually change the image itself. The rest change your PMView options.  Zoom lets you zoom in or out on your image.  Full Screen makes PMView use the whole desktop.  Fit Image sizes the window to fit the image.  Refresh redraws the image in the window.  Show Menu toggles the menu bar.  Show Controller toggles the slideshow controller.  Options opens a notebook that lets you control PMView's many options. ═══ 4.6.1. Zoom ═══ This lets you zoom in or out on your image or jump directly to certain zoom factors. For instance, to zoom in so that your image is twice normal size, select 2:1.  Out zooms out by an amount equal to a tenth of the current image size.  In zooms in by an amount equal to a tenth of the current image size.  1:8 zooms the image to an eighth of its original size.  1:4 zooms the image to a fourth of its original size.  1:3 zooms the image to a third of its original size.  1:2 zooms the image to half its original size.  1:1 zooms the image to its original size.  2:1 zooms the image to twice its original size.  3:1 zooms the image to three times its original size.  4:1 zooms the image to four times its original size.  8:1 zooms the image to eight times its original size.  Arbitrary factor zooms in or out by a specified factor. Note: Arbitrary factor is not available in slideshow mode. Related information:  Shortcut keys ═══ Arbitrary Factor ═══ This control lets you zoom the image with an arbitrary factor. For instance, to zoom in so that your image is twice the normal size, type "200%." The shortcut key for Zoom Arbitrary Factor is Ctrl+0. ═══ 4.6.2. Full Screen ═══ Choosing this command erases your whole screen (and not just the PMView window) and draws the image on it. This command acts like a toggle; choosing it again redraws the screen and puts the image "back" in the PMView window. Note: You can also toggle Full Screen by double-clicking on PMView's main window. In Full Screen mode you can toggle the mouse pointer by typing Ctrl+M. The shortcut key for Full Screen is F3. ═══ 4.6.3. Fit Image ═══ Choosing this command will shrink or grow the window to fit the size of the image, so that you can see the whole image and nothing but. The shortcut key for Fit Image is F4. ═══ 4.6.4. Refresh ═══ Choosing this will redraw the image in the window. You may want to do this if (for whatever reason) the image gets corrupted. The shortcut key for Refresh is F5. Note: Under OS/2 2.0, there was a screen driver bug that would corrupt the image when a menu dropped down on it; that bug has been thankfully fixed in OS/2 2.1. ═══ 4.6.5. Show Menu ═══ You can turn off PMView's menu bar by selecting this command. You can turn the menu bar back on by selecting this command again. When the menu bar is gone, you can select commands by moving to the middle of PMView's window and clicking the right mouse button. You can select any PMView command from the resulting popup menu. The shortcut key for Show Menu is Ctrl+B. ═══ 4.6.6. Show Controller ═══ You can turn off PMView's slideshow controller by selecting this command. You can turn the controller back on by selecting this command again. The shortcut key for Show Controller is Ctrl+C. Note: This command is only available in slideshow mode. ═══ 4.6.7. Options ═══ This opens PMView's Options Notebook that lets you control PMView's many options. ═══ 4.7. Help Menu ═══ The functions in the Help menu are used to get on-line help and various information on your system and image.  Help Contents brings up the help contents list  General Help gives you a brief description of PMView.  Help for Keys gives you information on PMView's shortcut keys.  Using Help gives you information on how to use the help facility  Image Information gives you various statistics about your current image.  System Information gives information on your system's current status.  About PMView displays product information about PMView. ═══ 4.7.1. Help Contents ═══ This will bring up the help contents list. ═══ 4.7.2. General Help ═══ This gives you a brief description of PMView. ═══ 4.7.3. Help for Keys ═══ This gives you information on PMView's shortcut keys. The shortcut key for Help for Keys is F9. ═══ 4.7.4. Using Help ═══ This gives you information on how to use the help facility. ═══ 4.7.5. Image Information ═══ This gives you various statistics about your current image.  Filename The (long) name of the file.  Filesize The size of the file in bytes (kilobytes)  Image format The file's image format.  Image size The size of the image in pixels and how much RAM the image is currently taking up in your system.  Number of colors The number of colors being used to display the image. For deep color images on deep color systems (or in the new Edit mode), this number will be replaced by the words "Deep Color (24-bit)." ═══ 4.7.6. System Information ═══ This gives information on your system's current status.  PM Version The version of OS/2 Presentation Manager you're running.  Machine type The model and submodel of your machine.  Display type The display type.  Driver version The version number of the display driver.  Desktop width x height The width and height of your desktop in pixels.  Number of bits, planes The number of bits and planes per pixel.  Number of colors The number of colors.  Number of physical colors The number of physical colors.  Palette manager available Tells whether your screen mode supports Palette Manager.  Physical memory The amount of RAM installed in your system.  Processor type The type of CPU you have.  Coprocessor present Tells whether you have a coprocessor installed or not. Note: Unfortunately, the information on whether Palette Manager is available may not be correct. Some screen drivers claim to support Palette Manager even when they do not. However, if this says No the information is probably correct. ═══ 4.7.7. About PMView ═══ This displays product information about PMView, as well as information about how to register the program. If you like PMView, please support shareware by registering it. Unregistered version: When PMView is started you cannot dismiss the dialog for 5 seconds. When 5 seconds has elapsed you may dismiss the dialog by pressing OK. Registered version: When PMView is started the dialog will be displayed for the time specified in the OS/2 Control Panel. You may dismiss the dialog any time by pressing OK. If you don't want the dialog displayed at all, you can disable it by changing the setting on the Logo page of the System object located in the OS/2 System Setup folder. ═══ 5. File Open Dialog ═══ Use this dialog to open a file or select files for a slideshow: 1. Select the down arrow to the right of the drive list to see all the drives on your system. 2. Select a drive from the drive list. 3. Select a directory from the directory list. 4. Select a file from the File Open Container, or type a file name. 5. Select Open to retrieve the file. For a detailed explanation of each field, select from the list below:  File Open Container  Open Filename  List Files of Type  Drive  Directory  Open  Cancel ═══ 5.1. File Open Container ═══ The File Open Container (FOC) is the large white area in the lower-left corner of PMView's File Open Dialog and File Save Dialog. To bring up the FOC popup menu, right-click inside the FOC (but not on any of the image objects). FOC popup menu commands:  View...  Refresh...  Select...  Sort...  Scramble...  Thumbnails... FOC image popup menu commands:  Open...  Rename...  Delete...  Thumbnail... ═══ 5.1.1. FOC Popup Menu Commands ═══ FOC popup menu commands:  View...  Refresh...  Select...  Sort...  Scramble...  Thumbnails... ═══ 5.1.1.1. View ═══ This determines how images are shown in the File Open Container.  Normal Lets the user select one of the Normal view modes. In Normal modes, PMView reads information from each image before displaying the image in the File Open Container. - Text Only PMView will display filenames only (no icons or thumbnails). - Icon PMView will display a standard-sized OS/2 icon. - Thumbnail PMView will display an 80x80 thumbnail for each file.  Quick Switches to Quick mode. In quick mode, PMView gets image file information from OS/2 rather than from the image file itself. This is fast, but only filenames, sizes, dates, and times can be loaded in this way.  Non-text Images are shown as icons (or thumbnails) without any text (filename) displayed.  Non-grid Images are displayed with filenames under their icons (or thumbnails). Images are "packed" as closely as possible.  Flowed Images are displayed in rows.  Non-flowed Images are displayed in a single column.  Detail All available information is displayed for each image.  Longnames If on, the LONGNAME attribute attached to the file's extended attribute will be displayed. If off, the physical file name will be displayed. For example, a file named "MyTestFile.GIF" will have a physical file name of e.g. "MYTESTFI.GIF" if the file system is FAT. Normally you'll never need to turn off this option.  Hidden Files If on, PMView will show files that have the HIDDEN system attribute set. If off, PMView will not show files that are hidden. ═══ 5.1.1.2. Refresh ═══ This command will refresh the view of the files in the File Open Container. You may need this in case you've added or deleted files in another session. ═══ 5.1.1.3. Select ═══  Select all This command selects all the images in the File Open Container.  Deselect all This command unselects all the images in the File Open Container, that is, it makes sure nothing is selected.  Sticky select If off, you must do Ctrl+click to add an image to the selection. If on, you need only click. The shortcut key for Select all is Ctrl+/. The shortcut key for Deselect all is Ctrl+\. ═══ 5.1.1.4. Sort ═══ These options choose how you want files sorted in the File Open Container. By default, files are sorted by name and in increasing order. The following choises are available:  Name Images are sorted by filename.  Type Images are sorted by file type (i.e., file extension)  Image format Images are sorted by actual image format. (The image's filename extension is ignored, except to break ties as in the note below.) Not available in Quick view.  Image Size Images are sorted by how many pixels they take up, that is, by their width times their height. Not available in Quick view.  Image Depth Images are sorted by how many colors their particular format can support (e.g. 16-color GIFs precede 256-color GIFs). Not available in Quick view.  File Size Images are sorted by how much disk space they take up.  Date and Time Images are sorted by their date and time stamps, from oldest to newest  Descending Order If selected, images are sorted and then displayed in reverse order. Note: If two images compare the same on the primary sort, PMView will "break ties" by comparing their filenames (including extensions). So, for instance, if you sort by File Size, and two files have the same size, those two will be sorted alphabetically by filename. ═══ 5.1.1.5. Scramble ═══ This randomly re-orders images in the File Open Container. ═══ 5.1.1.6. Thumbnails ═══ These commands determine thumbnail options:  Manual Create If selected, thumbnails are created (and deleted) only when the user right-clicks on them.  Automatic Create If selected, then PMView will create a thumbnail for every image in every directory that it enters.  Loading Creates If selected, PMView will create a thumbnail when it loads an image.  Saving Creates If selected, PMView will create a thumbnail when it saves an image.  Converting Creates If selected, PMView will create a thumbnail when it converts an image.  Transparent Fill If selected, thumbnails will be created with transparent "backgrounds." Otherwise, they will be created with black backgrounds. ═══ 5.1.2. FOC Image Popup Menu Commands ═══ FOC image popup menu commands:  Open...  Info...  Rename...  Delete...  Thumbnail... ═══ 5.1.2.1. Open ═══ This will load the selected image(s). ═══ 5.1.2.2. Info ═══ This will open up the File Info dialog that gives you detailed information on the selected image(s). ═══ 5.1.2.3. Rename ═══ This will let you rename the selected file. The edit window will only be opened for the current file if multiple files are selected. ═══ 5.1.2.4. Delete ═══ This will delete the selected file(s) from disk. Note: PMView will ask for file delete confirmation in accordance with the setting on the Confirmations page in PMView's Options Notebook. The shortcut key for Delete is Delete. Warning: This command is irreversible. ═══ 5.1.2.5. Thumbnail ═══  Create This will create a thumbnail for the selected image(s) in the File Open Container.  Delete This will delete the thumbnails of the selected image(s). You will be asked to confirm the deletion. Note: PMView will ask for thumbnail delete confirmation in accordance with the setting on the Confirmations page in PMView's Options Notebook. ═══ 5.1.2.6. Convert to ═══ This will convert the selected file(s) to the selected format. The conversion will be done as a background task, so you can continue working with PMView while your images are converted. The save options selected in the File Save Dialog will be used when converting the files. You can convert to the following formats:  Bitmap (BMP,DIB,RLE)...  Electronic Arts IFF (IFF)...  Graphics Interchange Format (GIF)...  JPEG File Interchange Format (JIF,JPG)...  Microsoft Paint (MSP)...  ZSoft Paintbrush Format (PCX)...  PC Paint/Pictor Format (PIC)...  PBMPlus Portable Bitmap (PBM)...  PBMPlus Portable Graymap (PGM)...  PBMPlus Portable Pixmap (PPM)...  Portable Network Graphics (PNG)...  Truevision Targa Format (TGA)...  Tagged Interchange File Format (TIF)... ═══ Confirm abort of file conversions ═══ You have marked one or several files for conversion to another file format. The conversion is still running. Press Yes to stop (abort) the conversion(s) and dismiss the file open dialog. Press No to let the conversion continue to run. ═══ File Info ═══ This gives you various statistics about the selected image.  Filename The name of the file.  Image format The file's image format.  Image size The size of the image in pixels and the color depth.  Filesize The size of the file in bytes.  Time The time when the file was last modified.  Date The date when the file was last modified. ═══ 5.1.3. Fonts and Background Color ═══ You can change the background color in the File Open Container by dragging the desired color from OS/2's Color Palette. You can also change the font in the File Open Container by dragging a font from OS/2's Font Palette. Note that each view mode have its own font. This means that you can have different fonts eg. for detail view and normal view. ═══ 5.1.4. File Open Container Q&A ═══ This section answers some common questions we have gotten on PMView's File Open Container and points out some non-obvious features. You should also refer to the general on-line help on the File Open Container for a complete reference to commands. Q. What is the File Open Container (FOC) ? A. The FOC is the large, initially white, rectangular area in the lower-left corner of PMView's File Open dialog. To see the File Open dialog, either select File Open or type Ctrl+O. The FOC is a standard container, which means that you change its view, drag and drop things to and from it, and resize it. (To do the last, resize the dialog and the FOC will also be resized.) You can also display a popup menu for the FOC and for each image inside it. Finally, you can rename an image by Alt+clicking on the filename (or on the thumbnail, in Non-Text view). Q. How do I bring up the FOC pop-up menu? A. The usual way: Right-click inside the container but not on one of the images. A menu will pop up. If the top item on the menu is Open, then you have the menu for one of the images; try again in another location. If you are in Flowed view, try right-clicking under the bottom row of icons. If you are in Detail view, right-click on one of the column headings, e.g., on top of the word "Name." Again, this is all as usual. Q. When I display the FOC, all I see is a bunch of squares that say "No Thumbnail Available". Why? A. By default, the FOC opens in Normal, Non-grid, Thumbnail view. When you start out, PMView hasn't created any thumbnails yet. Q. How can I create a thumbnail? A. Right-click on one of your images, preferably a small one. Click Thumbnail. (If you hit the arrow to the right of Thumbnail, then click Create.) The thumbnail will change to say "Creating Thumbnail." After a few seconds (or minutes, depending on how big the image is and whether you have other things tying up your computer), you will see a graphical thumbnail. Pretty nifty, huh? When PMView creates a thumbnail, it is attached to the file's extended attributes. Thus, if you move or copy the file, the thumbnail goes with it. PMView also creates a standard OS/2 icon at the same time. You can see the icon by switching the FOC View to Normal Icon mode (see below) or by looking at the image with a drives object. Since it is a standard OS/2 icon, you can do the usual things with it, e.g., set another object's icon by dropping your image onto that other object's notebook. Note that the thumbnail and icon may take up to 10,000 bytes. Make sure that you don't accidentally fill up your hard drive with thumbnails! Q. How can I make thumbnails for all my images? A. As with any other container, you can select all the images in the FOC by typing Ctrl+/, and then right-click on one of the images and select Thumbnail. PMView will split off threads to make thumbnails for all your images. A simpler way is to bring up the FOC popup menu (not the menu for one of the images), click Thumbnails, and click Automatic create. When PMView is in Automatic create mode, it will split off threads to make thumbnails for every image in the directories that you enter. Q. What are the other options under Thumbnails in the FOC popup menu? A. "Manual create" means that PMView won't make any thumbnails automatically; you'll have to make them all by hand. This is the default. "Automatic create" is as it says under the previous question; PMView will automatically split off threads to make thumbnails for the images in every directory that you enter. "Loading creates" means that PMView will create a thumbnail for an image when it loads that image. (This is my personal preference.) The last option, "Transparent Fill," determines what the "background" areas of a thumbnail should look like. Suppose you have a tall, thin image. Thumbnails are square, so the left and right edges of the thumbnail should take some sort of "background" color. If Transparent Fill is on, PMView will create thumbnails with a transparent background. Otherwise, the thumbnail backgrounds will be created black. Q. How do I select more than one image? A. The usual ways: You can drag a rectangular area, and all the images that touch the rectangle will be selected. (If you try to drag the rectangle "outside" the FOC, the FOC will automatically scroll.) Or you can click on the first image you want and Ctrl+click on the second and subsequent ones. Or if you want to select a bunch of images in order, you can click on the first one, then shift-click on the last one, and all the images between them will get selected. Or you can type Ctrl+/ to select all the images in the current directory. There's also one other "unusual" way: If you don't like having to hold down Ctrl, then bring up the FOC popup, click Select, and click Sticky select. While sticky select is on, you don't need to hold down Ctrl to add images to the selection. (To unselect while you're in sticky mode, click the image a second time.) Q. I don't like those huge thumbnails. What are my other choices? A. Bring up the FOC popup and click View. Now click the arrow to the right of Normal. You can choose to view Thumbnails, standard OS/2 icons, or text only. If you prefer the last,you might consider using Quick view. Q. Why is PMView so slow at putting images into the FOC? How can I speed it up? A. In Normal View mode, PMView has to load a lot of information for each image before it adds it to the FOC. It has to load the thumbnail and standard icon for each image. It also reads enough of the image to check its actual image format (as opposed to its filename extension) and its color depth (ie, how many colors the image could possibly have). It loads all this information in case you change to Detail view, or want to sort based on this info. If you don't need this info, try Quick view instead. In the Quick views, you can only see (and sort on) file names, sizes, dates, and times. But if that's all you want, Quick view is the way to go, especially on slow drives (such as CD-ROMs). Q. Whew! What are all those View choices? A. The best way to figure out the Views is to experiment, and to look at on-line documentation under "File Open Container." Q. How can I sort images? A. Bring up the FOC popup menu and click Sort. By default, PMView sorts by filenames. If you want to change this default, click the arrow to the right of Sort and pick the sort type you want. Note that some types of sorts are not available in Quick mode. For details on the sort options, check the on-line documentation. Q. Is there any way I can randomly rearrange the images? A. Use the Scramble command on the FOC popup. Each time you use it, PMView randomly rearranges the images in the FOC. Q. Is there anything else on the FOC popup? A. Yes -- the Refresh command. This rereads the current directory and updates the FOC display. Images will be sorted using the currently-selected method. Use Refresh if you're using another OS/2 program (or session) to add (or change) images. ═══ 5.2. Open File Name ═══ This entry field has several functions:  Retrieve a file by name.  Change the current drive and/or directory.  Change the file filter. For instance, to get a list of GIF files that start with RAY, enter RAY*.GIF and press ENTER. You can put several file filters together, separated by semicolons (;). So, for instance, RAY*.GIF;*.BMP will list all the files that either start with RAY and have the extension GIF or have the extension BMP. A shortcut for selecting a file extension is to pick it off the List Files of Type list. ═══ 5.3. List Files of Type ═══ This will set the file filter which determines what files are listed in the File Container. Select the down arrow to the right of the List Files of Type field to display the available file types. sets the file filter to *.*. All files will be displayed. Think of this as a filter off funtion. combines the filters of all the defined types. Related information:  Predefined file types and filters  Configure Extensions ═══ 5.4. Drive ═══ Use the down arrow to see the drives on your system. Select the drive that has the file you want to open. The Free/Total amount of disk space on the currently selected drive is displayed below this field. ═══ 5.5. Directory List Box ═══ Select Directory to view the files within a specific directory of your disk. Click the right mouse button to bring up the Directory View that lets you select different options for how directories are listed. The Free/Total amount of disk space on the currently selected drive is displayed above this field. ═══ Directory View ═══ This determines how directories are listed in the Direcory List Box.  Longnames If on, the LONGNAME attribute attached to the directory's extended attribute will be displayed. If off, the physical name of the directory will be displayed. For example, a directory named "Holiday_1995" will have a physical name of e.g. "HOLIDAY_" if the file system is FAT. Normally you'll never need to turn off this option.  Hidden Directories If on, PMView will show directories that have the HIDDEN system attribute set. If off, PMView will not show directories that are hidden. ═══ 5.6. Open ═══ Select Open to retrieve the file(s) currently selected in the File Open Container. ═══ 5.7. Cancel ═══ Select Cancel to hide the File Open Dialog. ═══ 6. File Save Dialog ═══ Use this dialog to save a file: 1. Select the down arrow to the right of the drive list to see all the drives on your system. 2. Select a drive from the drive list. 3. Select a directory from the directory list. 4. Type the file name in the save filename field. 5. Select a file format from the save format list. 6. Select Save to save the file. For a detailed explanation of each field, select from the list below:  File Open Container  Save Filename  Save Format  List Files of Type  Drive  Directory  Options  Save  Cancel ═══ 6.1. Save File Name ═══ This is where you type in the name of the file. ═══ 6.2. Save Format ═══ This will let you select which format to save in. Formats that can be saved:  Bitmap (BMP,DIB,RLE)...  Electronic Arts IFF (IFF)...  Graphics Interchange Format (GIF)...  JPEG File Interchange Format (JIF,JPG)...  Microsoft Paint (MSP)...  ZSoft Paintbrush Format (PCX)...  PC Paint/Pictor Format (PIC)...  PBMPlus Portable Bitmap (PBM)...  PBMPlus Portable Graymap (PGM)...  PBMPlus Portable Pixmap (PPM)...  Portable Network Graphics (PNG)...  Truevision Targa Format (TGA)...  Tagged Interchange File Format (TIF)... ═══ 6.3. List Files of Type ═══ This will set the file filter which determines what files are listed in the File Container. Select the down arrow to the right of the List Files of Type field to display the available file types. sets the file filter to *.*. All files will be displayed. Think of this as a filter off funtion. combines the filters of all the defined types. Related information:  Predefined file types and filters  Configure Extensions ═══ 6.4. Drive ═══ Use the down arrow to see the drives on your system. Select the drive where you want the file to be saved. The Free/Total amount of disk space on the currently selected drive is displayed below this field. ═══ 6.5. Directory ═══ Select Directory to view the files within a specific directory of your disk. The Free/Total amount of disk space on the currently selected drive is displayed above this field. ═══ 6.6. Options ═══ Select Options to bring up the options dialog for the save format selected with Save Format. This control is disabled if the format you have selected doesn't have any selectable options. For a detailed explanation of options for each format, select from the list below:  Bitmap (BMP,DIB,RLE)...  Electronic Arts IFF (IFF)...  Graphics Interchange Format (GIF)...  JPEG File Interchange Format (JIF,JPG)...  Microsoft Paint (MSP)...  ZSoft Paintbrush Format (PCX)...  PC Paint/Pictor Format (PIC)...  PBMPlus Portable Bitmap (PBM)...  PBMPlus Portable Graymap (PGM)...  PBMPlus Portable Pixmap (PPM)...  Portable Network Graphics (PNG)...  Truevision Targa Format (TGA)...  Tagged Interchange File Format (TIF)... Note: The color depth of the image you're saving will be the same or as close as possible to the currently selected depth. For instance, if you currently have selected Indexed 256-Color and you're saving a file in TGA format, the file will be saved as an 8-bit TGA. However, if you select RGB Deep Color the file will be saved as a 24-bit TGA. Files saved in a format like PCX that support 1, 2 and 4-bit data will be saved with the smallest number of bits possible. I.e. PMView will optimize your files for size and make them as small as possible. ═══ 6.7. Save ═══ Select Save to save the current file ═══ 6.8. Cancel ═══ Select Cancel to hide the File Save Dialog. ═══ No save format selected ═══ You have not selected a format in which the current image should be saved. Select the desired format from the Save Format list. ═══ Bitmap Save Options ═══ These options determine how PMView saves Bitmap files.  Bitmap Type - OS/2 2.x This will save the file with a header that is compatible with OS/2 version 2.x and Windows 3.x. RLE encoding will be used for 4, 8 and 24 bit images and 1 bit images will be Huffman 1D encoded. - OS/2 1.x This will save the file with a header that is compatible with OS/2 version 1.x and 2.x. Encoding will not be used. - Windows This will save the file with a header that is compatible with OS/2 version 2.x and Windows 3.x. RLE encoding will only be used for 4 and 8 bit images.  Use RLE/Huffman1D Encoding If set, PMView will RLE or Huffman1D encode the bitmap if the format you have selected supports encoding. Note that this usually only is suitable for images with large areas of the same color. Note: The OS/2 2.x and Windows options are interchangeable if encoding isn't used, i.e. if Use RLE/Huffman1D Encoding is disabled. ═══ IFF Save Options ═══ These options determine how PMView saves IFF files.  Use Packbits encoding If on, the image will be compressed using Packbits encoding. ═══ GIF Save Options ═══ These options determine how PMView saves GIF files.  Always Write GIF89a Format If on, the file will always be written in the newer GIF89a format. If off, the file will be written in GIF87a format, unless the Transparent Color Index option is used. The GIF89a format has a new color table flag that specifies whether the color table is sorted or not. If you know that the target application can take advantage of this information, you may turn on this option and the sort flag will be set (PMView always keeps the palette sorted). The flag will not be set for GIF87a files in order to preserve compability with older applications that (erroneously) will not accept GIF87a files with the sort flag set.  Interlace If on, the image will be saved using 4-pass interlacing. If off, the image will be saved sequentially in one pass. Using interlacing only makes sense with programs that progressively update the display while loading. For instance, when loading an interlaced GIF file the image will gradually be displayed during four passes. At the end of the first pass each eighth row of the image is visible. Already at this point of loading you'll probably see what the image looks like. With each pass the image quality will gradually improve as missing lines are added.  Transparent Color Index If on, transparency information will be written to the GIF file. Use this option if you would like one of the colors in your image to be transparent with the background. Typically you'll need this if you make images for WWW-browsers. Note that transparency information requires the newer GIF-variant; GIF89a. Thus, if this option is on, the file will be written in the GIF89a format instead of GIF87a. Note that PMView will not use transparency information when loading GIF files.  Background Color Index If on, the specified background color index will be written to the GIF file. Use this option if the target application fills unused space with the color specified in the GIF file. Typically may need this if you make images for WWW-browsers. If off, index zero (0) will be written to the file (in PMView index zero will always correspond to the most used color in the image). Note that PMView will not use this information when loading GIF files. ═══ JPEG Save Options ═══ These options determine how PMView saves JPEG files.  Quality This control lets you trade off compressed file size against quality of the reconstructed image: the higher the quality setting, the larger the JPEG file, and the closer the output image will be to the original input. Normally you want to use the lowest quality setting (smallest file) that decompresses into something visually indistinguishable from the original image. For this purpose the quality setting should be between 50 and 95; the default of 75 is often about right. If you see defects at 75, then go up 5 or 10 counts at a time until you are happy with the output image. The optimal setting will vary from one image to another.  Smooth This control lets you select a smoothing factor for filtering the input to eliminate fine-scale noise. This is often useful when converting GIF files to JPEG: a moderate smoothing factor of 10 to 50 gets rid of dithering patterns in the input file, resulting in a smaller JPEG file and a better-looking image. Too large a smoothing factor will visibly blur the image, however.  Optimize Entropy Encoding This option selects whether to perform optimization of entropy encoding parameters or not. Without this, default encoding parameters are used. Using this option usually makes the JPEG file a little smaller, but PMView saves the file somewhat slower and needs much more memory. Image quality and speed of decompression are unaffected by this option.  Progressive JPEG This option creates a "progressive JPEG" file. In this type of JPEG file, the data is stored in multiple scans of increasing quality. If the file is being transmitted over a slow communications link, the decoder can use the first scan to display a low-quality image very quickly, and can then improve the display with each subsequent scan. The final image is exactly equivalent to a standard JPEG file of the same quality setting, and the total file size is about the same --- often a little smaller. CAUTION: progressive JPEG is not yet widely implemented, so many decoders will be unable to view a progressive JPEG file at all. ═══ Microsoft Paint Save Options ═══ No options have been implemeted for this format yet. ═══ ZSoft PCX Save Options ═══ No options have been implemeted for this format yet. ═══ PC Paint/Pictor Save Options ═══ These options determine how PMView saves PC Paint/Pictor files.  EGA Palette If set, PMView will save PIC files with an EGA style palette (3 * 2 bits). Since the EGA palette only supports four intensities for each color channel, this may result in color errors. Use this option if the target application only understand EGA palettes. When using this option, you can get better colors by converting to 16 system colors with dithering before saving. If off, PMView will save files using the VGA palette (18 bits). Note: This option is ignored if the image you're saving has more than 16 colors. ═══ PBMPLus Portable Bitmap Save Options ═══ These options determine how PMView saves PBM files.  Raw data If set, PMView will save PBM files in raw data format. ═══ PBMPLus Portable Graymap Save Options ═══ These options determine how PMView saves PGM files.  Raw data If set, PMView will save PGM files in raw data format. ═══ PBMPLus Portable Pixmap Save Options ═══ These options determine how PMView saves PPM files.  Raw data If set, PMView will save PPM files in raw data format. ═══ PNG Save Options ═══ These options determine how PMView saves PNG files.  Adam7 Interlace If on, the image will be saved using Adam7 interlacing (7-pass). If off, the image will be saved sequentially in one pass. Using interlacing only makes sense with programs that progressively update the display while loading. For instance, when loading an interlaced PNG file the image resolution will gradually increase during seven passes. Interlacing slightly expands the file size on average, but it gives the user a meaningful display much more rapidly. Interlacing is for instance useful when transferring images over slow transmission lines (eg. modems), however note that is isn't a good idea to use interlacing if you don't need it since it may slow down normal loading from disk by a factor of two or three due to the high load caused by seven painting passes over the image.  Write Histogram Chunk [hIST] If on, a histogram chunk [hIST] will be written to the PNG file. The histogram chunk gives the usage frequency of each color in the palette. If a viewer is unable to provide all the colors listed in the palette, the histogram may help it decide how to choose a subset of the colors for display. You may need this option if you know that the target application can make use of the hIST chunk if present. PMView will not use this chunk (PMView builds its own histogram during loading).  Write Time Chunk [tIME] If on, a last modification time chunk [tIME] will be written to the PNG file. Note that the written time is local time.  Write Transparency Chunk [tRNS] If on, a transparency chunk [tRNS] will be written to the PNG file. Use this option if you would like one of the colors in your image to be transparent with the background. Typically you'll need this if you make images for WWW-browsers. Note that viewers are not bound to honor this information. PMView does not use this information when loading PNG files.  Write Background Chunk [bKGD] If on, a background chunk [bKGD] will be written to the PNG file. Use this option if you would like to specify a suggested background color. Typically may need this if you make images for WWW-browsers. Note that viewers are not bound to honor this information; a viewer may choose to use a different background color. PMView does not use this information when loading PNG files.  Transparency - Colormapped Images The index of the palette entry that is to be treated as transparent for Colormapped images. For Grayscale images this is the gray level of of the pixels that are to be treated as transparent.  Transparency - RGB Images The RGB color value of the pixels that are to be treated as transparent for RGB deep color images.  Background - Colormapped Images The index of the palette entry that is to be used as background color for Colormapped images. For Grayscale images this is the gray level that is to be used as background color.  Background - RGB Images The RGB color value of the color that is to be used as background color. ═══ Truevision TGA Save Options ═══ These options determine how PMView saves TGA files.  Use Run Length Encoding (RLE) If set, PMView will run length encode the image data. Note that this usually only is suitable for images with large areas of the same color.  Store from Bottom to Top (Flip) If set, PMView will store the TGA file starting with the bottom line. You may need this if the target application don't use the orientation information in the TGA file header and displays the image upside down. For general compability, leave this option off.  Store from Right to Left (Mirror) If set, PMView will store lines in the TGA file from right to left. You may need this if the target application don't use the orientation information in the TGA file header and displays a mirror image. For general compability, leave this option off.  Interlace Type This will select the interlace type, i.e. the ordering of image data in the file. Interlacing will only make sense with programs that progressively update the display while loading. For instance, when loading a 4-pass interlaced file each fourth row will be displayed during four passes. At the end of the first pass each fourth row of the image is visible. Already at this point of loading you'll probably see what the image looks like. With each pass the image quality will gradually improve as missing lines are added. Interlacing does not increase file size. Note: Many programs that read TGA files ignore the interlace option bits and incorrectly displays the image as two or four compressed images stacked one after the other. Don't use interlacing unless you know that the target application is able to use it - No Interlace (1-pass) The image will not be interlaced. - Each Second Row (2-pass) The image will be interlaced in two passes. - Each Fourth Row (4-pass) The image will be interlaced in four passes. ═══ TIFF Save Options ═══ These options determine how PMView saves TIFF files.  Compression - Bilevel Images This lets you choose compression method for Bilevel (Black/White) images. - None No compression is used - Packbits Use Apple Macintosh PackBits compression scheme - LZW Use LZW adaptive compression scheme - CCITT RLE Use Modified Huffman encoding scheme (CCITT Group 3 1D) - CCITT FAX3 Use CCITT Group 3 facsimile encoding scheme - CCITT FAX4 Use CCITT Group 4 facsimile encoding scheme  Compression - Color Images This lets you choose compression method for Color images. - None No compression is used - Packbits Use Apple Macintosh PackBits compression scheme - LZW Use LZW adaptive compression scheme  Photometric This setting applies only to Bilevel and Grayscale images. You may want to alter this setting if the target application displays your image as a negative. - White is Zero 0 is imaged as white. 2^BitsPerSample-1 is imaged as black. - Black is Zero 0 is imaged as black. 2^BitsPerSample-1 is imaged as white.  LZW Differencing Predictor This setting applies only if LZW compression is used. Applying a predictor may greatly improve compression ratios for some images.  Strip Size In order to optimize compression for non-bilevel images, select 32kB for Strip Size and use horizontal differencing. For compability with other applications, select 8kB for Strip Size and don't use differencing  Byte Ordering This setting determines the byte ordering used when saving TIFF files. If IBM PC is selected, Intel byte ordering will be used, i.e. the least significant byte is stored first. If Macintosh is selected, Motorola byte ordering will be used, i.e. the most significant byte is stored first. Select the byte ordering used by the target system. Note: For more information on these options, please refer to the TIFF 6.0 specification avaliable from Aldus Corporation. ═══ TIFF CCITT FAX3 Options ═══ These options determine how PMView saves TIFF CCITT FAX3 encoded files.  Uncompressed mode If checked, the file will be coded in uncompressed mode.  2-dimensional coding If checked, 2-dimensional coding will be used (otherwise 1-dimensional is assumed).  Fill to byte boundary If checked, fill bits will be added as necessary before EOL codes such that EOL always ends on a byte boundary. Note: For more information on these options, please refer to the TIFF 6.0 specification (pp. 51, 52) avaliable from Aldus Corporation. ═══ TIFF CCITT FAX4 Options ═══ These options determine how PMView saves TIFF CCITT FAX4 encoded files.  Uncompressed mode If checked, the file will be coded in uncompressed mode. Note: For more information on these options, please refer to the TIFF 6.0 specification (pp. 52, 53) avaliable from Aldus Corporation. ═══ Color depth too large ═══ The number of colors in the image that you're trying to save is larger than what is allowed for the format you've selected. Please select another format if you don't want to lose color infomation. Otherwise, select Convert to form the Color menu and convert the image to 256 colors or fewer. ═══ Confirm Save ═══ You have made changes to the image since it was last saved.  Select Yes to save the changes.  Select No to discard all changes made to the image.  Select Cancel to cancel this command. ═══ 7. Slideshow ═══ To create and run a slideshow: 1. Select File Open. 2. Drag the files you want to PMView's main window. 3. Press Play on the slideshow controller. Select one of the following for more information:  Slideshow Container...  Slideshow Controller...  Slide Settings...  Questions & Answers... Related information:  Shortcut keys ═══ 7.1. Slideshow Container ═══ SSC popup menu commands:  File...  Mode...  View...  Help...  View Slides...  Refresh...  Select...  Sort...  Scramble...  Run... SSC image popup menu commands:  Settings...  Copy Settings...  Remove...  Run... ═══ 7.1.1. SSC Popup Menu Commands ═══ SSC popup menu commands:  File...  Mode...  View...  Help...  View Slides...  Refresh...  Select...  Sort...  Scramble...  Run... ═══ 7.1.1.1. File Menu ═══ This is essentially a copy of the File Menu from the main menu bar. You can use either File from the menu bar or File here to do things like switch between image and slideshow modes, open new files, save the current file and exit PMView. The File menu lets you transfer files from/to disk or to delete the current image or run a slideshow.  Open is used to load an image from disk or to browse your images and create/delete thumbnails.  Recall will revert to the file on disk, which means any changes you had made to it (or your view of it) are lost. Recall also lets you recall one of 8 recently loaded files.  Save will save the current image to disk. The image will be written to a file with the same file name, format and options that were used when the file was last saved.  Save As is used if you would like to save the file with a different name, in another file format or change any of the save options.  Delete will delete the currently displayed  Close will close the current slideshow. image.  Exit will quit PMView and returns you to OS/2. ═══ 7.1.1.2. Mode Menu ═══ The functions in the Mode menu sets the function mode of PMView  View This will set PMView into View mode, that is, PMView will convert the image to look as good as possible on your display. The image data may be converted, thus you should not use this mode if you have intended to save the image to disk. For instance, loading a deep color image on a 256-color system will reduce the number of colors to 256 colors. If you now save this image in View mode important color information may be lost! We recommend that you always use Edit mode when saving files.  Edit This will set PMView into Edit mode. In this mode PMView never converts the image. Full color information of the original image will be retained. If your display adapter cannot display all color information in the image, PMView will use dithering when showing the image. Use Edit mode when saving files.  Slideshow This will set PMView into Slideshow mode. Note: The two first options are replaced by one single option on deep color systems since these systems are capable of showing colors correctly, thus dithering is not needed. ═══ 7.1.1.3. View Menu ═══ The first four functions in the View menu change how you see the image, but don't actually change the image itself. The rest change your PMView options.  Zoom lets you zoom in or out on your image.  Full Screen makes PMView use the whole desktop.  Fit Image sizes the window to fit the image.  Refresh redraws the image in the window.  Show Menu toggles the menu bar.  Show Controller toggles the slideshow controller.  Options opens a notebook that lets you control PMView's many options. ═══ 7.1.1.4. Help Menu ═══ The functions in the Help menu are used to get on-line help and various information on your system and image.  Help Contents brings up the help contents list  General Help gives you a brief description of PMView.  Help for Keys gives you information on PMView's shortcut keys.  Using Help gives you information on how to use the help facility  Image Information gives you various statistics about your current image.  System Information gives information on your system's current status.  About PMView displays product information about PMView. ═══ 7.1.1.5. View Slides ═══ This determines how images are shown in the Slideshow Container.  Normal Lets the user select one of the Normal view modes. In Normal modes, PMView reads information from each image before displaying the image in the Slideshow Container. - Text Only PMView will display filenames only (no icon or thumbnail). - Icon PMView will display a standard-sized OS/2 icon. - Thumbnail PMView will display a thumbnail for each file.  Quick Switches to Quick mode. In quick mode, PMView gets image file information from OS/2 rather than from the image file itself. This is fast, but only filenames, sizes, dates, and times can be loaded in this way.  Non-text Images are shown as icons (or thumbnails) without any text (filename) displayed.  Non-grid Images are dispalyed with filenames under their icons (or thumbnails). Images are "packed" as closely as possible.  Flowed Images are displayed in rows.  Non-flowed Images are displayed in a single column.  Detail All available information is displayed for each image.  Longnames If on, the LONGNAME attribute attached to the file's extended attribute will be displayed. If off, the physical file name will be displayed. For example, a file named "MyTestFile.GIF" will have a physical file name of e.g. "MYTESTFI.GIF" if the file system is FAT. Normally you'll never need to turn off this option. ═══ 7.1.1.6. Refresh ═══ This command will refresh the view of the files in the Slideshow Container. You may need this in case you've added or deleted files in another session. ═══ 7.1.1.7. Select ═══  Select all This command selects all the images in the Slideshow Container.  Deselect all This command unselects all the images in the Slideshow Container, that is, it makes sure nothing is selected.  Sticky select If off, you must do Ctrl+click to add an image to the selection. If on, you need only click. The shortcut key for Select all is Ctrl+/. The shortcut key for Deselect all is Ctrl+\. ═══ 7.1.1.8. Sort ═══ These options choose how you want files sorted in the Slideshow Container. By default, files are sorted by name and in increasing order. The following choises are available:  Name Images are sorted by filename.  Location Images are sorted by their full path, that is, their location on disk.  Type Images are sorted by file type (i.e., file extension)  Image format Images are sorted by actual image format. (The image's filename extension is ignored, except to break ties as in the note below.) Not available in Quick view.  Image Size Images are sorted by how many pixels they take up, that is, by their width times their height. Not available in Quick view.  Image Depth Images are sorted by how many colors their particular format can support (e.g. 16-color GIFs precede 256-color GIFs). Not available in Quick view.  File Size Images are sorted by how much disk space they take up.  Date and Time Images are sorted by their date and time stamps, from oldest to newest  Descending Order If selected, images are sorted and then displayed in reverse order. Note: If two images compare the same on the primary sort, PMView will "break ties" by comparing their filenames (including extensions). So, for instance, if you sort by File Size, and two files have the same size, those two will be sorted alphabetically by filename. ═══ 7.1.1.9. Scramble ═══ This randomly re-orders images in the Slideshow Container. ═══ 7.1.1.10. Run ═══ This starts a slideshow. The shortcut key for Run is Ctrl+R. ═══ Confirm Save ═══ You have made changes to the slideshow since it was last saved.  Select Yes to save the changes.  Select No to discard all changes made to the slideshow.  Select Cancel to cancel this command. ═══ Confirm File Replace ═══ You're about to replace a file that already exists on the disk.  Select Yes to proceed.  Select No to cancel. ═══ 7.1.2. SSC Image Popup Menu Commands ═══ SSC image popup menu commands:  Settings...  Copy Settings...  Remove...  Run... ═══ 7.1.2.1. Settings ═══ This opens the settings dialog(s) of the selected slide(s). You can also open the settings dialog of a slide by double clicking on it. ═══ 7.1.2.2. Copy Settings ═══ This copies the settings of the CURRENT slide TO the SELECTED slide(s).  All Settings This will copy all the settings.  Selected Settings This will copy the selected settings only.  Manual/Automatic If on, the state of the Manual/Automatic button will be copied when copying settings.  Advance Time If on, the Display Time will be copied when copying settings.  Display Notes If on, the state of the Display Notes button will be copied when copying settings.  Note Text If on, the Note Text will be copied when copying settings. ═══ No Target Selected ═══ You have not selected any slides(s) to which the settings of the current file should be copied. Select all the slides you wish to copy the settings to and try again. ═══ Confirm Copy Settings ═══ You're about to copy the settings of the current slide to the selected slide(s).  Select Yes to proceed and copy the settings.  Select No to cancel. ═══ 7.1.2.3. Remove ═══ This takes the selected slide(s) out of the slideshow. (It will not delete the file(s) from disk.) The shortcut key for Remove is Delete. ═══ Remove Slide ═══ You're about to remove the selected slide(s) from the current slideshow.  Select Yes to proceed and remove the slides.  Select No to leave the slideshow unchanged. ═══ 7.1.2.4. Run ═══ This will run the selected slide(s) only. This can be useful if you want to run a subset of the slideshow. ═══ 7.2. Slideshow Controller ═══ This control is used to control the slideshow. You can start the slideshow by pressing Rev, Play or Pause. The Preview Window will show you the image that is currently being preloaded, or already is preloaded and ready to show. The text above the Progress Bar tells the current status of loading.  Rev This will start the slideshow in reverse direction, or change the direction to backwards if it currently is forwards.  Stop This will stop the slideshow.  Pause This will pause the slideshow.  Play This will start the slideshow, or change the direction to forwards if it currently is backwards.  Preview Window This shows you the image in the preload buffer. You must have thumbnails attached for your images, otherwise this will be black.  Position Slider This shows you the current position in the slideshow and also lets you set the position. The slider is positioned on the slide that is currently being preloaded.  Progress Bar This will show you the current status of the preloading. ═══ 7.3. Slide Settings Dialog ═══ This dialog contains the settings of a slide. You can double-click on a slide to open up its settings dialog, or you can right-click on the slide and select Settings from the popup menu. Advance to next image  Manually This will turn off the timer, thus you will have to manually advance to the next image by pressing the Play button in the slideshow controller or by right-clicking.  Automatically after This will enable the timer. You can still advance manually, but if you haven't proceeded to the next image before the specified time has elapsed, PMView will automatically move to the next image. Notes PMView will let you type notes about the slide in this field. These notes will be saved when you save the slideshow.  Display Notes If on, your note will be displayed in a window while that slide is shown. You can copy any or all of these settings by selecting Copy Settings. To choose which settings get copied, click on the arrow to the right of the word Settings, and select the settings you want to copy. ═══ 7.4. Slideshow Q&A ═══ This answers most of the questions we've been asked about slideshows. If you run PMView and try each question in order, you can also learn how to use most of PMView's slideshow features. Q. How do I create a slideshow? A. Select Mode->Slideshow to take you to slideshow mode. Select File Open, and drag the files you want to PMView's main window. In fact, you can skip the Mode->Slideshow. If you drag more than one file at once to PMView's main window, it will take you to slideshow mode (if you aren't there already) and add these files to the slideshow. Q. How can I change the order of the slides? A. Drag them around. If you drop one slide on top of another, it will be inserted directly after that slide. (Moving a slide to the beginning of the slideshow takes two steps: First, drop it on the first slide. Second, drop the first slide on it.) Q. How do I run a slideshow? A. Choose Run from the slideshow's popup menu, or type Ctrl+R. (To get to the slideshow's popup menu, right-click in a blank area of the main window. While you're in slideshow mode, the main window is a container, just like the OS/2 desktop or a folder.) By default, the slideshow will run full screen, and the slideshow controller will be visible. You will have to move to the next slide manually, by either pressing the right arrow key, clicking the right mouse button, or pressing the PLAY button on the slideshow controller. Q. How can I hide or unhide the slideshow controller? A. During the slideshow, type Ctrl+C to toggle the controller's visibility. Of course, you can also click the hide button on the controller to make it invisible. To start with a hidden slideshow controller, right click in the main window, then unselect View->Show Controller. Q. How can I quit the slideshow? A. You can click your middle mouse button (if you don't have one, you can click both left and right buttons simultaneously). Or you can hit your Esc key. If the controller's visible, you can click the STOP button. Q. How can I save the slideshow? A. Choose File Save (or File Save as). Slideshows are saved with an extension of *.SHW. Note that a slideshow is a plain ASCII text file, so that you can edit it with your favorite editor. The only restriction is that you may not modify the first line; it has to be left exactly as is, or PMView won't recognize the slideshow properly. Q. What if I don't want to run the slideshow full screen? A. Right-click in the main window, then click View-> and select Options. This takes you to the options notebook. Go to the slideshow page and turn off Run Fullscreen. During the slideshow, you can toggle in and out of Fullscreen mode by typing F3, or left double-clicking on the image. Q. What if I don't want to have to move to the second slide manually? A. Right-click on the first slide to bring up its popup menu. Click Settings. In the group that says, "Advance to next image," choose "Automatically after" and specify a number of seconds. Then, when you run the slideshow, PMView will move to the second slide after that many seconds. Q. What if I don't want to have to move to the third slide manually? A. Right-click on the second slide to bring up its popup menu, then follow the instructions above. Q. Hey! If I want each slide to stay on for 5 seconds, do I have to change every slide by hand?? A. You can, but there's an easier way. Think WPS. Set up the first slide for five seconds. Select all the other slides (you can type Ctrl+/ to do this). Right-click on the first slide, then choose Copy Settings (don't click on the arrow). Choose OK, and all the slides will now be automatic with a 5-second delay. What if you only want a 5-second delay on the first, third, and fifth slide? Set up the first, select the third and fifth (via Ctrl+left click, as with any other container) and right-click the first slide's Copy Settings command. Q. What are the other settings for a slide? A. The "Notes" option lets you type notes about the slide. These notes will be saved when you save the slideshow. If you select Display Notes, your note will be displayed in a window while that slide is shown. You can copy any or all of these settings by selecting Copy Settings, as explained in the previous question. To choose which settings get copied, click on the arrow to the right of the word Settings, and select the settings you want to copy. (This is much easier to do than say.) Q. What are the other commands for a slide? A. Remove will take the slide out of the slideshow. Run (on a slide, not on the main window background) will let you "run" just that slide (to check its note, for example). Q. Getting back to slideshows, what options are available for them? A. Under the Options menu, we have  Show Menu This toggles whether the menu bar will be visible or not. You can also type Ctrl+B  Show Controller This toggles whether the controller will be visible at the start of the slideshow. You can use Ctrl+C to hide and show the controller.  Run Fullscreen If on, each slide will be drawn Fullscreen. If off, each slide will be drawn in the PMView window (in which case, the settings on the Window page of PMView's main Options notebook will be used).  Run Continuously If on, the slideshow will "wrap around" if you try to go past either end. (For example, if you reach the last slide and press the right arrow, PMView will go back to the first slide.) Otherwise, PMView's slideshow will end if you go forward from the last slide (or backward from the first slide).  Swap Mouse Buttons If on, then the left mouse button will move forward a slide and the right mouse button will move backwards. Some people prefer this. ═══ 8. Options Notebook ═══ PMView's Options Notebook lets you control PMView's many options.  View...  Full Screen...  Window...  Loading...  Directory...  Extensions...  Palette...  Color...  Photo CD...  Slideshow...  Special...  Confirmations...  Logo... ═══ 8.1. View ═══  Center image if it is smaller than window If set, PMView will draw an image that's smaller than its window in the center of the window. If not set, PMView will draw the image in the upper left corner.  Zoom image to fit window If set, then whenever you load an image or resize PMView's window, PMView will zoom the image so that it fits perfectly either horizontally or vertically in the window. Otherwise, the image will always be drawn at "actual size" until you use a Zoom command. All zooming in PMView is proportional; circles will always stay circles. ═══ 8.2. Full Screen ═══  Center image if it is smaller than screen If set, PMView will center the image when drawing in Full Screen Mode. Othewise, the image will be drawn in the upper left corner of the screen.  Zoom image if it is larger than screen If set, PMView will zoom out so that your image will fit onscreen, if necessary. Zooming is done proportionally.  Zoom image if it is smaller than screen If set, PMView will zoom in so that your image will reach completely across the screen either vertically or horizontally. Again, zooming is proportional.  Hide mouse pointer If set, PMView will initially hide the mouse pointer when you enter Full Screen mode. ═══ 8.3. Window ═══ Automatically adjust window size and position  When loading a new image If set, PMView will automatically adjust the window's size and position to display newly-loaded images at actual size.  When editing or zooming If set, PMView will adjust the window's size and position if it's appropriate during an edit or zoom operation. For instance, if you take a tall, narrow image and rotate it, it will become a short, wide image. If this option is set, PMView's window will resize (and possibly move) accordingly. Otherwise, you might get a horizontal scroll bar and some blank space in your window. Automatically adjust window position  Never  When required  Always move to upper left corner If you pick the first option, the upper left corner of PMView's window will never budge. If you pick the second option, PMView will leave the upper left corner in place unless moving it a short distance will let you see your whole image. Then it will move. Finally, "Always move to upper left corner" means that your window will move to the upper left corner of your screen every time you hit F4 (or load a new image, if the first option on this page is checked). ═══ 8.4. Loading ═══ Startup options  Startup minimized (iconized)  Normal  Full Screen each loaded image automatically If you pick the first option, PMView will start up minimized when you first load it. The second option will make it start up with the size of the image you specify on the command line (or the size it was when it last closed). (To make it do this every time it loads an image, select "When loading a new image" on the window page.) The last option will make PMView go into Full Screen mode every time it loads an image. (Why would you want to start up PMView iconified? Suppose you have associations set in OS/2 so that whenever you double-click on the name of a GIF file, it starts up PMView automatically. It's quite convenient to be able to double-click on several GIF files and have each one appear as an icon at the bottom of your screen, so you can pick which ones to look at after they're done loading. Loading options Progressive Loading If on, PMView will clear its window immediately when an image is being loaded and the image will be shown incrementally during the loading. If off, PMView will retain any previous image until the image has been fully loaded and not display the new image until PMView has finished loading it. Note that progressive loading won't start immediately when loding high resolution Photo-CD formats (1536x1024 and above). For instance, 1536x1024 must load 50% before progressive painting can begin. Show Progress Indicator This options decide the visibility of the progress indicator, that sliding bar that some people love and some people hate. ═══ 8.5. Directory ═══ On this page you can type the paths for the default directories  Default Load Directory This is the directory where PMView will initially go the first time you do a File Open. If this field is empty, the current directory will be used.  Default Save Directory This is the place where PMView will save files by default. If this field is empty, files will be saved in the current directory.  Default Convert Directory This is the place where PMView will put converted files. If this field is empty, converted files will be put in the current directory. ═══ 8.6. Extensions ═══ This page is allows you to change the ordering, lettering, or comments on the extensions that PMView loads. For instance, if you're running HPFS and use the extension .JPEG for your JPEG files, you can type JPEG in the Extension field, type My JPEGs in the description field, and click Ok >>. Then whenever you do a File Open, PMView will also display files with the extension of *.JPEG. What's more My JPEGs will appear in the List Files of Type list. And if you enter PMVIEW filename at an OS/2 prompt, PMView will be able to add the .JPEG extension automatically. Related information:  Predefined file types and filters ═══ 8.7. Palette ═══ The following options configures how PMView uses the palette manager. Of course, if you don't have palette manager support, the following options won't be available.  Use palette manager If on, PMView will use the palette manager to display images.  Blank window before changing the palette If on, PMView will clear the window before changing the palette, e.g. when a new image is loaded. If off, the window won't be cleared and color noise may appear when loading a new image. You may want to turn off this option if you have a sequence of images (slideshow) that uses the same palette and the blanking between the images is inappropriate.  Override system colors in Full Screen mode If on, PMView will use all 256 colors in Full Screen mode, rather than letting OS/2 reserve 20 for the user interface. ═══ 8.8. Color ═══  Color rendering options These options will depend on your system configuration. Please double-click your configuration below: - 256 color systems with Palette Manager - 256 color systems - Systems with fewer than 256 colors - Deep Color Systems ═══ name=PANEL_OPTIONS_COLOR_PALMAN. Color rendering options - Systems with Palette Manager ═══ These options determine how PMView will reduce the number of colors when loading an image. Palette  Adaptive This will select the best colors for the image.  System This will only use colors in OS/2's system palette.  8-8-4 levels This will use the vaunted 3-3-2 bits fixed palette, that is, a palette with 8 intensity levels for the Red and Green components and 4 levels for Blue.  6-7-6 levels This will use a 6-7-6 level fixed palette, that is, a palette with 6 intensity levels for the Red and Blue component and 7 levels for Green.  6-6-6 levels This will use a 6-6-6 level fixed palette, that is, a palette with 6 intensity levels for each color component, thus the image will be reduced to a maximum of 216 colors. This palette is well suited for systems with palette manager since the Palette Manager works best if the palette contains no more than 236 color entries. Dither  None The colors will be selected on best match basis. The color error is not compensated.  Ordered Ordered dithering is used to compensate the error. Ordered dithering can only be used with R-G-B level palettes.  Diffusion Floyd-Steinberg error diffusion dithering is used to compensate the color error.  Maximum Error This sets the maximum accumulated error for the Floyd-Steinberg error diffusion dithering. Decreasing the maximum error will suppress dithering and vice versa. Real-life images generally look better with a high setting, whereas computer generated images (images with large areas of equal shade) look better with a low setting. ┌────────────────────┬───────────┬─────────┐ │Preference │Palette │Dither │ ├────────────────────┼───────────┼─────────┤ │Best color quality │Adaptive │Diffusion│ ├────────────────────┼───────────┼─────────┤ │Fastest loading │6-6-6 level│Ordered │ ├────────────────────┼───────────┼─────────┤ │Suppress flicker │6-6-6 level│Diffusion│ ├────────────────────┼───────────┼─────────┤ │OS/2 default │Adaptive │None │ └────────────────────┴───────────┴─────────┘ Note: You can suppress the palette flicker that normally occurs when you run multiple PMView sessions by selecing one of the fixed palettes. ═══ name=PANEL_OPTIONS_COLOR_256COLOR. Color rendering options - 256 color systems ═══ These options determine how PMView will reduce the number of colors when loading an image. Palette  Adaptive This will select the best colors for the image.  System This will only use colors in OS/2's system palette.  8-8-4 levels This will use the vaunted 3-3-2 bits fixed palette, that is, a palette with 8 intensity levels for the Red and Green components and 4 levels for Blue.  6-7-6 levels This will use a 6-7-6 level fixed palette, that is, a palette with 6 intensity levels for the Red and Blue component and 7 levels for Green.  6-6-6 levels This will use a 6-6-6 level fixed palette, that is, a palette with 6 intensity levels for each color component. Dither  None The colors will be selected on best match basis. The color error is not compensated.  Ordered Ordered dithering is used to compensate the error. Ordered dithering can only be used with R-G-B level palettes.  Diffusion Floyd-Steinberg error diffusion dithering is used to compensate the color error.  Maximum Error This sets the maximum accumulated error for the Floyd-Steinberg error diffusion dithering. Decreasing the maximum error will suppress dithering and vice versa. Real-life images generally look better with a high setting, whereas computer generated images (images with large areas of equal shade) look better with a low setting. ┌────────────────────┬───────────┬─────────┐ │Preference │Palette │Dither │ ├────────────────────┼───────────┼─────────┤ │Best color quality │System │Diffusion│ ├────────────────────┼───────────┼─────────┤ │Fastest loading │8-8-4 level│Ordered │ ├────────────────────┼───────────┼─────────┤ │OS/2 default │Adaptive │None │ └────────────────────┴───────────┴─────────┘ ═══ name=PANEL_OPTIONS_COLOR_16COLOR. Color rendering options - Systems with fewer than 256 colors ═══ These options determine how PMView will reduce the number of colors when loading an image. Palette  Adaptive This will select the 16 best colors for the image and hand over the final color selection to OS/2. Since OS/2's color selection is crude, the image won't look good.  System This will use the 16 fixed colors in OS/2's system palette.  2-2-2 levels This will use a standard 2-2-2 level fixed palette, that is, a palette with 2 intensity levels for each color component (Red,Green,Blue). Dither  None The colors will be selected on best match basis. The color error is not compensated.  Ordered Ordered dithering is used to compensate the error. Ordered dithering can only be used with the 2-2-2 level palette.  Diffusion Floyd-Steinberg error diffusion dithering is used to compensate the color error. ┌────────────────────┬───────────┬─────────┐ │Preference │Palette │Dither │ ├────────────────────┼───────────┼─────────┤ │Best color quality │System │Diffusion│ ├────────────────────┼───────────┼─────────┤ │Fastest loading │2-2-2 level│Ordered │ ├────────────────────┼───────────┼─────────┤ │OS/2 default │Adaptive │None │ └────────────────────┴───────────┴─────────┘ ═══ name=PANEL_OPTIONS_COLOR_DEEPCOLOR. Color rendering options - Deep Color systems ═══ The options are disabled since images don't need to be converted in Deep Color mode. ═══ 8.9. Photo CD ═══ These options are for use with Photo CD images. Default resolution  192 x 128  384 x 256  768 x 512  1536 x 1024  3072 x 2048  6144 x 4096 Photo CD images actually store five copies of each picture, one for each resolution above. You should select the resolution you want by default. Photo CD PRO images additionally store a sixth resolution (6144x4096). Beware! The larger Photo CD resolutions will need a lot of memory to load.  Ask for resolution before loading image If on, PMView will ask you which resolution you want before you load a Photo CD image. Note: The default resolution will always be used in a slideshow. In case the selected default resolution is 6144 x 4096 and the image is not a Photo CD PRO image, then the best available resolution (3072 x 2048) will be used instead. ═══ 8.10. Slideshow ═══ This lets you configure the different settings for slideshows. Page 1 - Slideshow Settings  Run Fullscreen If on, each slide will be drawn Fullscreen. If off, each slide will be drawn in the PMView window (in which case, the settings on the Window page of PMView's main Options notebook will be used).  Run Continuously If on, the slideshow will "wrap around" if you try to go past either end. (For example, if you reach the last slide and press the right arrow, PMView will go back to the first slide.) Otherwise, PMView's slideshow will end if you go forward from the last slide (or backward from the first slide).  Run Scrambled If on, the slides will be scrambled when you start the slideshow. The order will be restored when the slideshow is stopped, thus the slideshow won't be modified.  Swap Mouse Buttons If on, then the left mouse button will move forward a slide and the right mouse button will move backwards. Page 2 - Default Slide Settings  Advance to next image These controls will let you set the default timer settings that are copied to a new slide. Look at the help for the Slide Settings Dialog for more information on these options.  Display Notes This control will let you set the default Display Notes setting that is copied to a new slide. Look at the help for the Slide Settings Dialog for more information on this option. ═══ 8.11. Special ═══  Use idle time priority If on, PMView will use the lowest priority in OS/2 when it loads and saves files and during image transformations. In PMView versions before 0.86, this could be a problem because if you were running a "greedy" OS/2 or DOS program that required lots of CPU power to run, PMView could get "stuck" and never finish loading. But one of the major advances in PMView 0.86 is a clever system that will "boost" PMView's priority if PMView hasn't accomplished anything for two seconds. If you are continually running greedy programs and hate waiting the extra two seconds, you may want to disable idle-time loading. Otherwise, we recommend that you leave it on.  Use GpiDrawBits If on, PMView will use the OS/2 function GpiDrawBits when painting. This function will send the image data straight to the display driver, thus this gives you the best performance. If off, PMView will first create a temporary bitmap from the image data, then use the OS/2 function WinDrawBitmap to draw it and then destroy the bitmap. This is a workaround for driver bugs. Due to bugs/limitations in some display drivers this option is off by default, however we recommend that you try enabling Use GpiDrawBits and leave it on if it is possible. If PMView won't work correctly, you may want to contact IBM to get a newer display driver that works with GpiDrawBits.  Use Shadow Bitmap If on, PMView will create a shadow bitmap in memory. This will make PMView's painting very fast. However, this will use much more RAM. For instance, if your image is a true color (24-bit) image with a size of 1024 x 1024 pixels, the image "raw" data will require 3 MB. Without shadow bitmap PMView will only need some hundred kilobytes to paint the image. However, if creating a shadow bitmap, the OS/2 Presentation Manager additionally needs a memory amount that equals two to three times the size of the "raw" data, in this case 3MB + (2..3) * 3MB. Thus the display of the image may require up to 12 MB ! Another problem is that the OS/2 Presentation Manager cannot cope with very large bitmaps (more than 20 MB may cause PM to crash). This is why we have the threshold setting described below. We recommend that you only enable this option if you feel that the painting otherwise is too slow (don't forget to try turning on Use GpiDrawBits first). Use the threshold setting to set the size of the largest image for which a shadow bitmap should be used. We recommend that you should keep this below 20,480 (or below the installed amount of RAM divided by three) in order to keep your system stable. Note that a shadow bitmap will not be used when PMView needs to dither your image. Warning! Turning on this option causes PMView to violate the CUA standard for a well-behaved multithreaded application. PMView may block the message queue for a longer period than 0.1 seconds when creating the shadow bitmap. THIS OPTION MUST NOT BE USED IN SYSTEMS RUNNING TIME-CRITICAL APPLICATIONS!  Negative Thumbnails Use this option if the thumbnails in the FOC are displayed as negatives. This may occur due to a bug in your display driver. ═══ 8.12. Confirmations ═══  Confirm on file delete If on, PMView will always ask you to confirm the deletion of a file. If off, PMView will boldly delete files without nagging.  Ask whether to save changed images If on, PMView will ask you whether you would like to save changed images before exiting or not. If off, PMView will discard your changes to an image without asking when exiting PMView.  Ask whether to save changed slideshows If on, PMView will ask you whether you would like to save slideshows before exiting or not. If off, PMView will discard unsaved slideshows without asking when exiting PMView.  Ask whether to continue converting files If on, PMView will check with you whether it is okay or not to abort the conversion of files. If off, PMView will stop the conversion of files without asking when quitting PMView or closing the file open or file save dialog. ═══ 8.13. Logo ═══ This option applies only to registered users, since it is not possible to turn off the logo (About) dialog in the unregistered version of PMView.  Don't display logo Press this if you don't want to see the About dialog when you start PMView.  Display logo for nn seconds This lets you set the time for how long the About dialog is displayed when you start PMView (1...65 seconds). ═══ 9. File Formats ═══ All code for handling the file formats supported in PMView has been written completely from scratch. Therefore, we are proud to be able of providing full technical support on all of the formats below and enhance support for a specific format when needed (for instance, the TIFF format). If PMView fails to load a file that you need, please contact us so we can try to support your file's format in our next release. Formats that can be read:  Bitmap (BMP,DIB,RLE)...  Electronic Arts IFF (IFF)...  Encapsulated PostScript (EPS)...  Graphics Interchange Format (GIF)...  JPEG File Interchange Format (JIF,JPG)...  Microsoft Paint (MSP)...  Kodak Photo-CD (PCD)...  ZSoft Paintbrush Format (PCX)...  PC Paint/Pictor Format (PIC)...  PBMPlus Portable Bitmap (PBM)...  PBMPlus Portable Graymap (PGM)...  PBMPlus Portable Pixmap (PPM)...  Portable Network Graphics (PNG)...  PMView Slideshow File Format (SHW)...  Truevision Targa Format (TGA)...  Tagged Interchange File Format (TIF)... Formats that can be written:  Bitmap (BMP,DIB,RLE)...  Electronic Arts IFF (IFF)...  Graphics Interchange Format (GIF)...  JPEG File Interchange Format (JIF,JPG)...  Microsoft Paint (MSP)...  ZSoft Paintbrush Format (PCX)...  PC Paint/Pictor Format (PIC)...  PBMPlus Portable Bitmap (PBM)...  PBMPlus Portable Graymap (PGM)...  PBMPlus Portable Pixmap (PPM)...  Portable Network Graphics (PNG)...  PMView Slideshow File Format (SHW)...  Truevision Targa Format (TGA)...  Tagged Interchange File Format (TIF)... Note: The Kodak Photo-CD format cannot be saved, since saving files in this format is not legally permitted by Kodak Corporation. (Currently no other programs, with the exception of Kodak's own programs, allows this to be done). The TIFF and GIF LZW compression/decompression included in this software are licensed under U.S. Patent No. 4,558,302 and foreign counterparts. ═══ 9.1. Bitmap (BMP,DIB,RLE) ═══ General Description The bitmap format was introduced in the early 1.1 version of OS/2. Later, Microsoft Corp. enhanced the format and included it in its best selling operating environment: Microsoft Windows 3.0. In OS/2 2.0 IBM further extended the format by adding some fields and by defining a structure for storing multiple bitmaps in the same file (this type of file is often referred to as a bitmap array). Although we have put much effort into making PMView save files with all the possible bitmap compression schemes, we discourage you from using it since the PNG or JPEG format normally will give you much smaller files. The RLE extension is sometimes used for compressed bitmap files under Windows. Another common extension is DIB. None of these two extensions are normally used under OS/2. BMP is the default extension for bitmap files. Since the native operating systems for this file format are exclusively DOS and OS/2, the BMP format is not recommended as a generalized format for image exchange. We recommend that you use PNG, TIFF or JPEG for this purpose. PMView Support PMView will read all types of OS/2 and Windows bitmaps. For now, only the first image in a bitmap array will be displayed. Technical Information The following bitmap types are supported: 1. IBM OS/2 1.x bitmaps 2. IBM OS/2 1.x bitmap arrays 3. IBM OS/2 2.x bitmaps 4. IBM OS/2 2.x bitmap arrays 5. Windows 3.x bitmaps Bitcounts: 1, 2, 4, 8 and 24 bit Compressions: ┌───────┬───────────┬────────────┐ │1 bit │HUFFMAN_1D │types: 3,4 │ ├───────┼───────────┼────────────┤ │4 bit │RLE_4 │types: 3,4,5│ ├───────┼───────────┼────────────┤ │8 bit │RLE_8 │types: 3,4,5│ ├───────┼───────────┼────────────┤ │24 bit │RLE_24 │types: 3,4 │ └───────┴───────────┴────────────┘ ═══ 9.2. Encapsulated PostScript (EPS) ═══ General Description The Encapsulated PostScript file format (EPSF) is a standard format for importing and exporting PostScript language files among applications in a variety of environments. The standard extension for EPS files is EPSF and EPSI (depending on the type of the EPS file). In order to be compatible with different file systems, PMView will use EPS as default extension. PMView Support For now, only EPSF-2.0 conforming files with TIFF-preview are supported. Future PMView versions will support the newer EPSF-3.0 device independent EPS interchage file format (EPSI). Technical Information Only EPSF-2.0 conforming files with TIFF-preview are supported. ═══ 9.3. Electronic Arts IFF (IFF) ═══ General Description The IFF format was defined by Electronic Arts back in 1985. The IFF format is very common on Commodore Amiga computers. Note that the IFF format can be used to hold a vide variety of information. An IFF file does not necessarily contain an image; it can contain sound clips, animations, text or whatever else. The default extension is IFF, though you'll probably encounter a lot of other extensions like MP, HAM, ILBM, LBM, etc. PMView Support PMView only supports FORM type IFF files that holds an image. The following two sub-types are supported:  ILBM: 1..n planes  PBM: 8 bits chunky format The following special types of ILBM files are supported:  HAM: 3..16 planes  Dynamic HAM (DHAM)  Sliced HAM (SHAM)  Palette change (PCHG) Technical Information PMView uses information from the following chunks when reading an IFF file: BMHD CAMG CMAP SHAM CTBL PCHG BODY ═══ 9.4. Graphics Interchange Format (GIF) ═══ General Description The GIF format was designed by Compuserve in 1987. Since then it has become very popular for general image exchange. There are two types of GIF files; GIF87a, the original standard of 1987 and GIF89a, the revised standard of 1989 that adds features for including comments, animation and text. The GIF format is a lossless format and is good for saving any type of image that has 256 colors (or shades of gray), or fewer. This format is suitable as a generalized format for image exchange, though the color information limit in the format may require you to choose PNG, TIFF or JPEG instead. In general this is the best format for images with a limited number of colors, since the compression ratio is good (regarding that the format is lossless) and GIF files can be decompressed very quickly. The Graphics Interchange Format is a proprietary format of Compuserve Incorportated. The standard extension for GIF files is GIF PMView Support PMView supports the original GIF87a specification in full. GIF89a files can also be read, but the GIF89a specific information will be ignored. For now, PMView will only display the first image of a multi-image GIF. Technical Information Versions: 87a, 89a Bitcount: 1..8 The GIF compression/decompression included in this software is licensed under U.S. Patent No. 4,558,302 and foreign counterparts. ═══ 9.5. JPEG File Interchange Format (JIF,JPG) ═══ General Description The JPEG format is a "lossy" format, meaning that the image you get out of decompression isn't quite identical to what you originally put in. The algorithm achieves much of its compression by exploiting known limitations of the human eye, notably the fact that small color details aren't preceived as well as small details of light-and-dark. Thus, JPEG is intended for storing images that will be looked at by humans. If you plan to machine-analyze your images, the small errors introduced by JPEG may be a problem for you, even though they are invisible to the eye. This format is good for general image exchange. The extension recommended by the Joint Photographic Experts Group is JIF. Another commonly used extension is JPG, which is the default. PMView Support Support in accordance with the Independent JPEG Group's revision 6. Technical Information This space intentionally left blank ═══ 9.6. Microsoft Paint (MSP) ═══ General Description MSP is the native format for Windows Paint, a drawing program found in the early 1.0 and 2.0 versions of Microsoft Windows. In Windows 3.0 this program was replaced by Windows Paintbrush which writes Windows Bitmaps (BMP) by default, thus rendering MSP obsolete. Though PMView is able to save files in the MSP format, we discourage you to do so, since the format is obsolete. The default extension is MSP. PMView Support PMView supports MSP Windows versions 1 and 2. Technical Information MSP is a monocrome, black/white format that uses a variant of run-length encoding. ═══ 9.7. Kodak Photo-CD (PCD) ═══ General Description Kodak Photo-CD allows you to have conventional photographs converted to Kodak's proprietary CD-ROM format. Not all CD-ROM drives can access Photo-CDs. You might want to contact Kodak for a full list of those that can. Each PCD file contains five scans of the same image at the resolutions listed below. Photo-CD files reside in the \PHOTO_CD\IMAGES\ directory on the CD-ROM and are named IMGxxxx.PCD, where xxxx is a four digit number ranging from 0001 to the number of images on the disk. A sixth resolution (6144x4096) may be available on Photo-CD PRO disks. This is an extension to the standard, and resides in a different directory on the disk. PMView will use the information in \PHOTO_CD\IPE\IMGxxxx\64BASE\INFO.IC when reading this resolution. PMView Support All five standard image resolutions and orientations are supported. When needed, the images will automatically be rotated without any extra memory overhead during decoding. The Photo-CD PRO extension (64 Base) is also supported. PMView will prompt you for the desired resolution before loading an image. A default resolution can also be specified in the options notebook. Thumbnails will be loaded from \PHOTO_CD\OVERVIEW.PCD if it is available. An option for automatically loading/showing the startup file \PHOTO_CD\STARTUP.PCD is not available. However, if required, it can be viewed simply by changing the directory. Technical Information Standard Photo CD image resolutions and memory needed for decoding: ┌────────────┬─────────────────┐ │192 x 128 │73,728 bytes │ ├────────────┼─────────────────┤ │384 x 256 │294,912 bytes │ ├────────────┼─────────────────┤ │768 x 512 │1,179,648 bytes │ ├────────────┼─────────────────┤ │1536 x 1024 │4,784,128 bytes │ ├────────────┼─────────────────┤ │3072 x 2048 │19,070,976 bytes │ ├────────────┼─────────────────┤ │6144 x 4096 │75,694,080 bytes │ └────────────┴─────────────────┘ The specified amount of memory needed for decoding includes the size needed for the huffman tables and may therefore differ from the size reported by other programs. ═══ 9.8. ZSoft Paintbrush Format (PCX) ═══ General Description PCX files are created by ZSoft's PC Paintbrush, one of the most popular PC drawing tools. Since the native operating system for this file format is DOS, the PCX format is not recommended as a generalized format for image exchange. We recommend that you use PNG, TIFF or JPEG for this purpose. The default extension is PCX. PMView Support At least the following PCX revisions are supported: 1. Version 2.5 of PC Paintbrush 2. Version 2.8 with or w/o palette 3. Version 3.0 4. Version 5.0 including 24-bit PCX PMView is not dependent of the version number tag, so in practise PMView should be able to display any PCX file conforming to the technical specs below. The version list above is provided as a guideline only. Technical Information Images up to 8-bit color depth [bits*planes <= 8]: 1, 2, 4 or 8 bits 1, 2 or 4 planes Support for 24-bit images (PCX rev 5.0): 3 planes 8 bits ═══ 9.9. PC Paint/Pictor Format (PIC) ═══ General Description PIC files are created by PC Paint/Pictor (not PC Paintbrush) and are used by Grasp, among others. Since the native operating system for this file format is DOS, the PIC format is not recommended as a generalized format for image exchange. We recommend that you use PNG, TIFF or JPEG for this purpose. The default extension is PIC. Note! This extension is used by a number of applications to mean widely different things. If PMView cannot read your file with PIC extension, you can assume that it isn't a PC Paint/Pictor file. For instance, PMView will not read Lotus 1-2-3 PIC files (these are vector graphics, not bitmaps). PMView Support In conformance with the PIC file specifications PMView will be able to display any PIC file complying to the technical specifications below. Note! The 24-bit format is NOT standard. Many applications will not be able to handle files saved in this format. Technical Information Images up to 8-bit color depth [bits*planes <= 8]: 1..8 bits 1..8 planes Extended support for 24-bit images (non standard format): 3 planes 8 bits ═══ 9.10. PBMPlus Portable Bitmap (PBM) ═══ General Description PBMPlus files are created by Jef Poskanzer's PBMPlus image processing software (UNIX). Since this format isn't standard and the native operations sytem is UNIX, the PBMPlus format is not recommended as a generalized format for image exchange. We recommend that you use PNG, TIFF or JPEG for this purpose. The default extension is PBM. PMView Support In conformance with Jef Poskanzer's specifications of 1990. The full specification is included below. Technical Information PBM - Portable Bitmap File Format DESCRIPTION The portable bitmap format is a lowest common denominator monochrome file format. It was originally designed to make it reasonable to mail bitmaps between different types of machines using the typical stupid network mailers we have today. Now it serves as the common language of a large family of bitmap conversion filters. The definition is as follows:  A "magic number" for identifying the file type. A pbm file's magic number is the two characters "P1".  Whitespace (blanks, TABs, CRs, LFs).  A width, formatted as ASCII characters in decimal.  Whitespace.  A height, again in ASCII decimal.  Whitespace.  Width * height bits, each either '1' or '0', starting at the top-left corner of the bitmap, proceding in normal English reading order.  The character '1' means black, '0' means white.  Whitespace in the bits section is ignored.  Characters from a "#" to the next end-of-line are ignored (comments).  No line should be longer than 70 characters. Here is an example of a small bitmap in this format: P1 # feep.pbm 24 7 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 1 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 1 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Programs that read this format should be as lenient as possible, accepting anything that looks remotely like a bitmap. There is also a variant on the format, available by saving the image with the RAWBITS option. This variant is different in the following ways:  The "magic number" is "P4" instead of "P1".  The bits are stored eight per byte, high bit first low bit last.  No whitespace is allowed in the bits section, and only a single character of whitespace (typically a newline) is allowed after the height.  The files are eight times smaller and many times faster to read and write. ═══ 9.11. PBMPlus Portable Graymap (PGM) ═══ General Description PBMPlus files are created by Jef Poskanzer's PBMPlus image processing software (UNIX). Since this format isn't standard and the native operations sytem is UNIX, the PBMPlus format is not recommended as a generalized format for image exchange. We recommend that you use PNG, TIFF or JPEG for this purpose. The default extension is PGM. PMView Support In conformance with Jef Poskanzer's specifications of 1990. The full specification is included below. Technical Information PGM - Portable Graymap File Format DESCRIPTION The portable graymap format is a lowest common denominator grayscale file format. The definition is as follows:  A "magic number" for identifying the file type. A pgm file's magic number is the two characters "P2".  Whitespace (blanks, TABs, CRs, LFs).  A width, formatted as ASCII characters in decimal.  Whitespace.  A height, again in ASCII decimal.  Whitespace.  The maximum gray value, again in ASCII decimal.  Whitespace.  Width * height gray values, each in ASCII decimal, between 0 and the specified maximum value, separated by whitespace, starting at the top- left corner of the graymap, proceding in normal English reading order. A value of 0 means black, and the maximum value means white.  Characters from a "#" to the next end-of-line are ignored (comments).  No line should be longer than 70 characters. Here is an example of a small graymap in this format: P2 # feep.pgm 24 7 15 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 0 0 7 7 7 7 0 0 11 11 11 11 0 0 15 15 15 15 0 0 3 0 0 0 0 0 7 0 0 0 0 0 11 0 0 0 0 0 15 0 0 15 0 0 3 3 3 0 0 0 7 7 7 0 0 0 11 11 11 0 0 0 15 15 15 15 0 0 3 0 0 0 0 0 7 0 0 0 0 0 11 0 0 0 0 0 15 0 0 0 0 0 3 0 0 0 0 0 7 7 7 7 0 0 11 11 11 11 0 0 15 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Programs that read this format should be as lenient as possible, accepting anything that looks remotely like a graymap. There is also a variant on the format, available by saving the image with the RAWBITS option. This variant is different in the following ways:  The "magic number" is "P5" instead of "P2".  The gray values are stored as plain bytes, instead of ASCII decimal.  No whitespace is allowed in the grays section, and only a single character of whitespace (typically a newline) is allowed after the maxval.  The files are smaller and many times faster to read and write. Note that this raw format can only be used for maxvals smaller than or equal to 255. If you use the PGM library and try to write a file with a larger maxval, it will automatically fall back on the slower but more general plain format. ═══ 9.12. PBMPlus Portable Pixmap (PPM) ═══ General Description PBMPlus files are created by Jef Poskanzer's PBMPlus image processing software (UNIX). Since this format isn't standard and the native operations sytem is UNIX, the PBMPlus format is not recommended as a generalized format for image exchange. We recommend that you use PNG, TIFF or JPEG for this purpose. The default extension is PPM. PMView Support In conformance with Jef Poskanzer's specifications of 1990. The full specification is included below. Technical Information PPM - Portable Pixmap File Format DESCRIPTION The portable pixmap format is a lowest common denominator color image file format. The definition is as follows:  A "magic number" for identifying the file type. A ppm file's magic number is the two characters "P3".  Whitespace (blanks, TABs, CRs, LFs).  A width, formatted as ASCII characters in decimal.  Whitespace.  A height, again in ASCII decimal.  Whitespace.  The maximum color-component value, again in ASCII decimal.  Whitespace.  Width * height pixels, each three ASCII decimal values between 0 and the specified maximum value, starting at the top-left corner of the pixmap, proceding in normal English reading order. The three values for each pixel represent red, green, and blue, respectively; a value of 0 means that color is off, and the maximum value means that color is maxxed out.  Characters from a "#" to the next end-of-line are ignored (comments).  No line should be longer than 70 characters. Here is an example of a small pixmap in this format: P3 # feep.ppm 4 4 15 0 0 0 0 0 0 0 0 0 15 0 15 0 0 0 0 15 7 0 0 0 0 0 0 0 0 0 0 0 0 0 15 7 0 0 0 15 0 15 0 0 0 0 0 0 0 0 0 Programs that read this format should be as lenient as possible, accepting anything that looks remotely like a pixmap. There is also a variant on the format, available by saving the image with the RAWBITS option. This variant is different in the following ways:  The "magic number" is "P6" instead of "P3".  The pixel values are stored as plain bytes, instead of ASCII decimal.  Whitespace is not allowed in the pixels area, and only a single character of whitespace (typically a newline) is allowed after the maxval.  The files are smaller and many times faster to read and write. Note that this raw format can only be used for maxvals smaller than or equal to 255. If you use the ppm library and try to write a file with a larger maxval, it will automatically fall back on the slower but more general plain format. ═══ 9.13. Portable Network Graphics File Format (PNG) ═══ General Description The PNG format is intended to provide a portable, legally unencumbered, well-compressed, well-specified standard for lossless bitmapped image files. PNG is highly recommended as a generalized format for image exchange. The default extension is PNG. PMView Support PMView supports the PNG format in full, according to the 10th draft of the PNG specification (5 May, 1995). We have coded all the routines from scratch and optimized the code for speed under OS/2, thus PMView does not use the public PNG-library. Technical Information Color Type and Bit Depth ┌───┬──────────┬────────────────────────────────────────┐ │ │Bit Depth │Interpretation │ ├───┼──────────┼────────────────────────────────────────┤ │0 │1,2,4,8,16│Grayscale images │ ├───┼──────────┼────────────────────────────────────────┤ │2 │8,16 │RGB deep color images │ ├───┼──────────┼────────────────────────────────────────┤ │3 │1,2,4,8 │Colormapped images │ ├───┼──────────┼────────────────────────────────────────┤ │4 │8,16 │RGB deep color images with alpha channel│ ├───┼──────────┼────────────────────────────────────────┤ │6 │8,16 │Grayscale images with alpha channel │ └───┴──────────┴────────────────────────────────────────┘ Compression Type ┌───┬──────────────────────────────────────────────────┐ │0 │Deflate/inflate compression with 32K sliding │ │ │window │ └───┴──────────────────────────────────────────────────┘ Filter Type ┌───┬──────────────────────────────────────────────────┐ │0 │Adaptive filtering with five basic filter types │ └───┴──────────────────────────────────────────────────┘ Interlace Type ┌───┬──────────────────────────────────────────────────┐ │0 │No interlace │ ├───┼──────────────────────────────────────────────────┤ │1 │Adam7 interlace │ └───┴──────────────────────────────────────────────────┘ ═══ 9.14. PMView Slideshow File Format (SHW) ═══ General Description This is the format of PMView slideshows. The default extension is SHW. PMView Support PMView will read files that have been generated by PMView (saved by PMView) and files that have been edited with a standard ASCII editor. Technical Information A PMView slideshow file consists of a file header and one or more image headers. File Header PMView SlideShow BeginShow . [Image Header(s)] . EndShow Image Header BeginImage . [Image Statement(s)] . EndImage Image Statements ┌───────────────┬───────────────────────────────────┐ │FileName │Full filename + path │ ├───────────────┼───────────────────────────────────┤ │UseTimer │[Yes|No] │ ├───────────────┼───────────────────────────────────┤ │DisplayTime │Time to display (in seconds) │ ├───────────────┼───────────────────────────────────┤ │ShowInfo │[Yes|No] │ ├───────────────┼───────────────────────────────────┤ │Information │Notes text │ └───────────────┴───────────────────────────────────┘ Example of a slideshow file: PMView SlideShow BeginShow BeginImage FileName D:\ss\image1.jif ShowInfo Yes Information "Demo slideshow" EndImage BeginImage FileName D:\ss\image2.jif UseTimer Yes DisplayTime 2 EndImage BeginImage FileName D:\ss\image3.jif UseTimer Yes EndImage EndShow In this example the note "Demo slideshow" will be displayed with the first image (image1.jif). The timer is not used for the first image, the user must manually continue. The second image (image2.jif) uses the timer and will display for 2 seconds. The third image also uses the timer and will display the default time; 5 seconds. ═══ 9.15. Truevision Targa Format (TGA) ═══ General Description In addition to developing the famous Truevision Targa boards, Truevision Inc. also have come up with a specification for a high-end file format that will support images suitable for display on Targa hardware. The Targa format, or TGA, supports images of any dimensions with between 1 and 32 bits of color. While the Targa format originated with Truevision's hardware, it has migrated to many other applications. It's probably the most universally supported 24-bit file format for PC applications. Unlike TIFF, for example, it's subject to relatively few variations. Software that reads Targa files should be able to read all Targa files. The default extension is TGA. PMView Support The Targa file format recognizes over a dozen subfile formats, some of which are more widely used than others. We have chosen to only support the formats that are actually used for general image exchange, that is the formats specified in the official Truevision TGA File Format Specification, available from Truevision Inc. on request. PMView supports the following most popular versions of the Targa format: 1, 2, 3, 9, 10, and 11. Again, if PMView fails to load a file that you need, please contact us so we can try to support your file's format in our next release. Technical Information Supported Targa file subformats:  1 is uncompressed, color-mapped images with 16, 24, or 32-bit palette entries  2 is uncompressed RGB images with 15, 16, and 24-bit support  3 is uncompressed grayscale 8-bit (256 shades) support  9 is RLE color-mapped images with 16, 24, or 32-bit palette entries  10 is RLE RGB with 15, 16, and 24-bit support  11 is compressed grayscale 8-bit (256 shades) support Supported Targa file descriptors:  Image orientation: Top, Bottom, Left, Right  Raster format: Non-interlaced, 2-pass interlaced, 4-pass interlaced ═══ 9.16. Tagged Interchange File Format (TIF) ═══ General Description This format is suitable as a generalized format for cross platform image exchange since applications for processing TIFF images are available on most platforms. Beware! Many applications only handle a small subset of the formats specified in the TIFF specs. Don't take for granted that an application will be able to read the files you save! TIFF is a proprietary format of Aldus Corporation. The default extension is TIF. PMView Support PMView provides full Baseline support conforming with the TIFF 6.0 specification and supports the following TIFF Extensions:  Orientation Tag  CCITT Bilevel Encodings  LZW Compression  Differencing Predictor  Tiled Images  CMYK Images  RGB Image Colorimetry  YCbCr Images The TIFF JPEG extension will be supported in a later revision of PMView. Technical Information  Both Intel and Motorola byte orders are handled.  Tiled Images.  Class B Bilevel images ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │1 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │1 │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │None, CCITT 1D, PackBits │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │Min is White, Min is Black │ └──────────────────────────┴────────────────────────────────────────┘  Class G Grayscale images ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │1..8 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │1..8 │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single, Multiple │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │None, LZW │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │Min is White, Min is Black │ └──────────────────────────┴────────────────────────────────────────┘  Class P Palette color images ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │1..8 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │1..8 │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single, Multiple │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │None, LZW │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │Palette RGB │ ├──────────────────────────┼────────────────────────────────────────┤ │ColorMap │256 entries or fewer │ └──────────────────────────┴────────────────────────────────────────┘  Class R RGB full color images ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │1..3 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │<1..8, 1..8, 1..8> │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single, Multiple │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │None, LZW │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │RGB │ └──────────────────────────┴────────────────────────────────────────┘  Class F Facsimile ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │1 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │1 │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │CCITT Group 3 and 4 │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │Min is White, Min is Black │ ├──────────────────────────┼────────────────────────────────────────┤ │FillOrder │MSB, LSB │ ├──────────────────────────┼────────────────────────────────────────┤ │Group3Options │2D Encoding, Zero fill, Uncompressed │ │ │mode │ ├──────────────────────────┼────────────────────────────────────────┤ │Group4Options │Uncompressed mode │ └──────────────────────────┴────────────────────────────────────────┘  Class S Separated images ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │4 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │<1..8, 1..8, 1..8> │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single, Multiple │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │None, LZW │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │Separated │ ├──────────────────────────┼────────────────────────────────────────┤ │InkSet │CMYK │ └──────────────────────────┴────────────────────────────────────────┘  Class Y JPEG images ┌──────────────────────────┬────────────────────────────────────────┐ │SamplesPerPixel │3 │ ├──────────────────────────┼────────────────────────────────────────┤ │BitsPerSample │<8, 8, 8> │ ├──────────────────────────┼────────────────────────────────────────┤ │PlanarConfiguration │Single, Multiple │ ├──────────────────────────┼────────────────────────────────────────┤ │Compression │None, LZW │ ├──────────────────────────┼────────────────────────────────────────┤ │PhotometricInterpretation │YCbCr │ └──────────────────────────┴────────────────────────────────────────┘ The TIFF LZW compression/decompression included in this software is licensed under U.S. Patent No. 4,558,302 and foreign counterparts. ═══ 9.17. Predefined file types and filters ═══ Predefined file types and filters (may differ if you have reconfigured the extensions in the options notebook): ┌────────────────────────────────────────┬──────────┐ │Type of File │Filter │ ├────────────────────────────────────────┼──────────┤ │Bitmap │*.BMP │ ├────────────────────────────────────────┼──────────┤ │Encapsulated Postscript │*.EPS │ ├────────────────────────────────────────┼──────────┤ │Graphics Interchange Format │*.GIF │ ├────────────────────────────────────────┼──────────┤ │Electronic Arts IFF │*.IFF │ ├────────────────────────────────────────┼──────────┤ │JPEG File Interchange Format │*.JPG │ ├────────────────────────────────────────┼──────────┤ │Microsoft Paint │*.MSP │ ├────────────────────────────────────────┼──────────┤ │PC Paint/Pictor │*.PIC │ ├────────────────────────────────────────┼──────────┤ │Kodak Photo CD │*.PCD │ ├────────────────────────────────────────┼──────────┤ │ZSoft Paintbrush │*.PCX │ ├────────────────────────────────────────┼──────────┤ │Portable Network Graphics │*.PNG │ ├────────────────────────────────────────┼──────────┤ │PBMPlus Portable Bitmap │*.PBM │ ├────────────────────────────────────────┼──────────┤ │PBMPlus Portable Graymap │*.PGM │ ├────────────────────────────────────────┼──────────┤ │PBMPlus Portable Pixmap │*.PPM │ ├────────────────────────────────────────┼──────────┤ │PMView Slideshow │*.SHW │ ├────────────────────────────────────────┼──────────┤ │Tagged Interchange File Format │*.TIF │ ├────────────────────────────────────────┼──────────┤ │Truevision TGA │*.TGA │ └────────────────────────────────────────┴──────────┘ ═══ Palette Manager ═══ OS/2 2.0 introduced a new display subsystem called the palette manager. Most video hardware can distinguish between 262,144 different colors, but cannot display all of them at once. Palette manager mediates requests for colors and decides which colors are shown on the screen at any given time. Most 256-color OS/2 screen drivers support palette manager. If your computer can display more than 256 colors at a time, you have a deep color video system. Deep color systems don't use (or need) palette manager. Palette manager also provides color animation. ═══ Deep Color ═══ A device that is capable of directly displaying colors in a specific format without having to reduce the number of colors by software is referred to as a deep color device. For instance 15 bit (32,768 colors), 16 bit (65,536 colors) and 24 bit (16.7 million colors) graphics adapters are deep color devices. These adapters can directly display 24-bit RGB data, so programs like PMView do not need to do any color reduction. 24-bit deep color is usually called true color. However, some people use true color interchangeably with deep color. ═══ Dithering ═══ Dithering uses several colors together to create the look of a color that is actually not available in the physical device palette. By filling an area with pixels of alternating colors a desired color can be approximated. An example of using this technique is filling an area with varying amounts of black and white pixels to create various shades of gray. ═══ Color Animation ═══ Color animation makes it possible to smoothly transform the colors of an image. With animation it is possible to adjust brightness, contrast and colors as smoothly as turning the knobs on your TV set. Color animation is traditionally provided only on systems that support palette manager. However, this release of PMView supports color animation on deep color systems as well. ═══ Automatic Thumbnailing ═══ PMView provides automatic thumbnailing in the file open dialog. When you enter a directory PMView will scan the files and automatically start to create thumbnails for all files that don't have a thumbnail already. ═══ Thumbnail ═══ A thumbnail is a miniature preview image attached to a file. PMView provides thumbnails as an alternative to file names. Thumbnails are available in the file open and file save dialogs. The thumbnail is attached to the extended attributes of a file. This makes it possible to copy and move files without losing the thumbnail information. The thumbnail data is also valid icon data, thus thumbnails created with PMView will also be visible in OS/2's drives folders. The thumbnails are not display driver dependent. You can view thumbnails created on a 256 color system on a deep color system and vice versa. It doesn't matter if you're in 256 or deep color mode when you create the thumbnails; the thumbnail data will always be the same, regardless of your current system configuration. To obtain the best possible thumbnail quality, PMView uses a couple of tricks to enhance the thumbnail quality. PMView thumbnails are created as follows: 1. The image is scaled to a 80x80 bitmap using anti-aliasing (a pixel average method). 2. The bitmap is sharpened by convolution. 3. The bitmap color data is quantized to 256 colors and dithered using Floyd-Steinberg error diffusion. 4. The bitmap is attached to the .ICON EA of the file. ═══ Pixel ═══ Technical term for picture element, the smallest element of an image. Pixels are arranged in rows and columns to create an image. ═══ Directory ═══ An area on a disk where files can be found. Think of a disk as being like a filing cabinet. Then a directory is like a hanging folder inside the filing cabinet, and the files are like sheets of paper inside the hanging folder. ═══ 10. Shortcut keys ═══ PMView provides a number of shortcut keys. Select one of the following groups for more information:  General keys...  Slideshow keys...  Zooming keys...  Scrolling keys...  Container keys... ═══ 10.1. General keys ═══ ┌────────────────┬────────────────────────────────────────┐ │Key │Function │ ├────────────────┼────────────────────────────────────────┤ │F1 │Context-sensitive help │ ├────────────────┼────────────────────────────────────────┤ │F3 │Toggle full screen │ ├────────────────┼────────────────────────────────────────┤ │F4 │Fit window to image size │ ├────────────────┼────────────────────────────────────────┤ │F5 │Refresh │ ├────────────────┼────────────────────────────────────────┤ │F9 │Keys help │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+B │Toggle menu │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+D │Delete current file │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+M │Toggle mouse pointer │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+O │Open file browser window │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+R │Crop │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+S │Save current file │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+T │Toggle Track Info dialog │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+U │Undo/Redo last command │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+X │Exit PMView │ ├────────────────┼────────────────────────────────────────┤ │Shift+Delete │Cut to clipboard │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+Insert │Copy to clipboard │ ├────────────────┼────────────────────────────────────────┤ │Shift+Insert │Paste from clipboard │ └────────────────┴────────────────────────────────────────┘ Note: You can also toggle full screen by double-clicking on the image. ═══ 10.2. Slideshow keys ═══ ┌────────────────┬────────────────────────────────────────┐ │Key │Function │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+C │Toggle slideshow controller │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+P │Pause slideshow │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+R │Run slideshow │ ├────────────────┼────────────────────────────────────────┤ │LeftArrow │Previous slide │ ├────────────────┼────────────────────────────────────────┤ │RightArrow │Next slide │ ├────────────────┼────────────────────────────────────────┤ │Escape │Stop slideshow │ └────────────────┴────────────────────────────────────────┘ Note: The right and left arrow keys will move to the next respectively previous image in the slideshow and will not scroll the image like they do in image mode. The scrolling keys are not available in slideshow mode. Note: Escape will stop the slideshow unlike in image mode where it can be used to take you out of full screen mode. Use F3 to toggle off full screen mode. ═══ 10.3. Zooming keys ═══ ┌────────────────┬──────────────────────────────────────────────────┐ │Key │Function │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+8 │Zoom to 12.5% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+4 │Zoom to 25.0% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+3 │Zoom to 33.3% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+2 │Zoom to 50.0% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+1 or Ctrl+1 │Zoom to 100% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Ctrl+2 │Zoom to 200% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Ctrl+3 │Zoom to 300% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Ctrl+4 │Zoom to 400% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Ctrl+8 │Zoom to 800% of the original image size │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+0 or Ctrl+0 │Zoom arbitrarily (manually enter zoom percentage) │ ├────────────────┼──────────────────────────────────────────────────┤ │Alt+Z │Zoom out (decrease current zoom percentage by 10%)│ ├────────────────┼──────────────────────────────────────────────────┤ │Ctrl+Z │Zoom in (increase current zoom percentage by 10%) │ └────────────────┴──────────────────────────────────────────────────┘ ═══ 10.4. Scrolling keys ═══ ┌────────────────┬────────────────────────────────────────┐ │Key │Function │ ├────────────────┼────────────────────────────────────────┤ │Alt+Arrow │Fine scroll (1 pixel) │ ├────────────────┼────────────────────────────────────────┤ │Arrow │Coarse scroll (8 pixels) │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+Arrow │Page scroll (window size) │ ├────────────────┼────────────────────────────────────────┤ │PageUp │Page scroll up │ ├────────────────┼────────────────────────────────────────┤ │PageDown │Page scroll down │ ├────────────────┼────────────────────────────────────────┤ │Home │Scroll all the way left │ ├────────────────┼────────────────────────────────────────┤ │End │Scroll all the way right │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+PageUp │Scroll all the way up │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+PageDown │Scroll all the way down │ └────────────────┴────────────────────────────────────────┘ Note: These keys are not available in slideshow mode. ═══ 10.5. Container keys ═══ ┌────────────────┬────────────────────────────────────────┐ │Key │Function │ ├────────────────┼────────────────────────────────────────┤ │Delete │Delete (Remove) the selected file(s) │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+/ │Select all files in the container │ ├────────────────┼────────────────────────────────────────┤ │Ctrl+\ │Deselect all files in the container │ └────────────────┴────────────────────────────────────────┘ Note: If you keep the Ctrl key pressed when selecting a file, previously selected files will remain selected. ═══ 11. Command-line flags ═══ There are 21 optional flags that you can use when invoking PMView. You can specify the flags in any mix of upper and lower case. You can specify the flags in any order you like, before or after the file name. Only the first three letters are important (which is why they're highlighted below). Here's the complete list of command-line switches: /Inifile=fullfile: This overrides the value of the PMVIEW_INI environment variable and specifies the path and name of the file where PMView should read and store its options. This flag is useful if you want different PMView sessions to use different settings. Sample use: PMVIEW /INI=D:\PMVIEW\PMVINI2.INI /Filterpath=fullpath: This overrides the value of the PMVIEW_FILTER environment variable and specifies the full path to the directory where PMView should search for filter files. Sample use: PMVIEW /FIL=D:\PMVIEW\NEWFILTER /Helppath=fullpath: This overrides the value of the PMVIEW_HELP environment variable and specifies the full path to the directory where PMView can find its help files. Sample use: PMVIEW /HEL=D:\PMVIEW\NEWHELP /NoHelp : This specifies that PMView should not load the online help. Use this if you don't need help and you want PMView to start up as quickly as possible. /Logfile=fullfile: This specfies the path and name of the "log file" where PMView should store debugging information in case it crashes. If you contact us with a bug report, we may want to know what your log file says. Sample use: PMVIEW /LOG=D:\PMVIEW\TROUBLE.LOG /Idleload: This specifies that PMView should use idle-time loading (with priority boost). This is the default. /NoIdleload: This specifies that PMView should not use idle-time loading but should use ordinary (higher) priority instead. This will tend to speed up the PMView session, but slow down everything else that is running in OS/2 at the same time. /PaletteManager: This specifies that PMView should use Palette Manager if it is available. /NoPaletteManager: This specifies that PMView should not use Palette Manager, even if it is available. /Red=num: This specifies a level for red balance. The number can be from -100% (no red) to 100% (maximum red). /Green=num: This specifies a level for green balance. The number can be from -100% (no green) to 100% (maximum green). /Blue=num: This specifies a level for blue balance. The number can be from -100% (no blue) to 100% (maximum blue). /Brightness=num: This specifies a level of brightness. The number can be from -100% (minimum brightness) to 100% (maximum brightness). /Contrast=num: This specifies a level of contrast. The number can be from -100% (minimum contrast) to 100% (maximum contrast). /Color=num: This specifies a level of color. The number can be from -100% (minimum color) to 100% (maximum color). /Gamma=num: This specifies a gamma value. The number can be from 0.010 (minimum gamma) to 10.00 (maximum gamma). /Grayscale: If this flag is specified, PMView will convert loaded images to shades of gray. /Negative: If this flag is specified, PMView will show loaded images in negative. /WPos=(Left,Bottom,Width,Height,Flags): This flag determines the initial position and size of PMView's main window. Click here for more information on the /WPos switch. / SHOrtfileretry: This flag will let PMView wait for more data to be available when PMView is loading an incomplete file and comes to an unexpected end of the file. Click here for more information on the /SHO switch. Warning! This switch affects the performance of PMView /TAP=pipename: This flag lets a TAP server start PMView by specifying the pipe name. This flag also lets you register and deregister PMView as a TAP application. Click here for more information on the /TAP switch. Example: Suppose you want to use e:\inis\pmview.ini for your INI file, you want to use the help files in e:\pmview, you want to have maximum contrast, you want to be in negative mode, and you want PMView to start by loading the file CUBE.GIF. You could do all this by entering the following at an OS/2 command prompt: pmview /ini=e:\inis\pmview.ini /hel=e:\pmview /con=100 /neg cube.gif ═══ /WPos flag ═══ /WPos=(Left,Bottom,Width,Height,Flags): This flag determines the initial position and size of PMView's main window. IMPORTANT: If you use /WPos, make sure that you don't type any spaces between numbers or flags. If no value is specified, the default value(s) will be used. Left, Right, Width and Height can be specified in pixels or percent of the desktop size. To specify a percentage, add the letter "p" (for example, 17p stands for 17 percent). Flags can be one or none of the following flags Maximize Start PMView maximized Minimize Start PMView minimized Restore Start PMView in non min/maximized state and can be combined with one or more of the following flags Activate Make PMView's main window the active window. Foreground Bring PMView to the foreground Example: Start PMView maximized PMView /WPos=(,,,,Max) Example: Set PMView's main window size to 100x100 pixels PMView /WPos=(,,100,100,Res) Example: Activate PMView and bring it to the foreground PMView /WPos=(,,,,ForAct) Example: Center PMView on desktop, making it half as wide and tall as the screen PMView /WPos=(25p,25p,50p,50p) ═══ /TAP flag ═══ The /TAP flag takes either a pipe name or one of the two parameters REGisterapplication or DERegisterapplication /TAP=\PIPE\pipename: This flag lets a TAP server start PMView by specifying the pipe name that should be used for client-server communication. If the pipe is valid and PMView successfully can connect to it, PMView will go into TAP mode. In TAP mode all file operations are controlled by the server and thus the File Menu only has one single command: Exit. TAP mode cannot be altered at run-time; once PMView is started in TAP mode it will remain in TAP mode until terminated. /TAP=REGisterapplication: This tells PMView that is should register itself as a TAP (client) application. When PMView is invoked with this flag, it will write TAP information to the OS/2 system INI file and thereafter immediately exit. This (and /TAP=DER) is the only time that PMView will ever write to your system files. /TAP=DERegisterapplication: This tells PMView that is should deregister itself as a TAP application. When PMView is invoked with this flag, it will remove any TAP information previously written to the INI file by /TAP=REGisterapplication. This (and /TAP=REG) is the only time that PMView will ever write to your system files. Note: When PMView is registered as TAP application the current location, i.e. full path, of the PMView executable (PMView.EXE) will be stored. If you at a later point move PMView to another location on your hard disk, you may need to run pmview /TAP=REG to update the information in the OS/2 system INI file. Note that you are not required to deregister before re-registering. ═══ /SHOrtfileretry flag ═══ The /SHOrtfileretry flag will let PMView wait for more data to be available when PMView is loading an incomplete file and comes to the (unexpected) end of the file. Warning! This option makes PMView update the display line by line, thus the painting will be much slower than usual. Don't use this option unless you need it. If this flag is used when loading a short file (that is, a file that has not been fully written to disk yet and data is missing at the end of the file) PMView will wait for more data to be written to the file and progressively update the image until all data has arrived. If the writing application closes the file PMView will assume that the file is completely written and stop waiting. You can for instance use this feature with terminal emulators that don't support PMView's TAP system or with your favorite ray-tracer to progressively view files as they are downloaded/created. Note that the other application that writes the file must have opened it with shared read access. If this isn't true, PMView will not have rights to access the file and will thus fail with a file open error. Furthermore the writing application must write the file sequentially, from start to end. This option will not work correctly with non-sequential file formats like TIFF, PIC and 256-color PCX that require random access to the file. In this case the file cannot and will not be displayed until all data has arrived, i.e. the whole file is written. Some applications write files in several steps. After each step the file is closed and reopened when the next pass starts. (For instance, POV-Ray may do this.) If this happens, and PMView gives you an "Unexpected end of file" error, try supplying a timeout value to the /SHO flag. This value tells PMView that if the file is closed, PMView should wait for the specified time period (in milliseconds) and check the file again before giving up. So, for instance, if you get "Unexpected end of file" errors while watching POV-Ray render an image, try using "/SHO=250" in the command line when you invoke PMView. Warning! Setting a timeout value will make PMView idle during the specified time after loading is complete. Don't set a timeout value unless you really need it, and try to keep it as small as possible. ═══ 12. Environment variables ═══ Currently there are three OS/2 environment variable that PMView uses: PMVIEW_INI This variable specifies the filename (including full path) that PMView should use for storing its options. If this environment variable is not set, PMView will create the file PMVIEW.INI in the current directory and store its information there. You can use the /INI= command-line flag to override this variable and specify a different INI file to use. PMVIEW_HELP This variable specifies the directory (including full path) where PMView's help files reside. If this variable is not set, PMView will look for its help files in the current directory. If PMView cannot find its help files when it starts up, it will display an error message. You can use the /HEL= command-line flag to override this variable and point to a different directory, or the /NOH= command-line flag to PMView skip loading any help files at all. PMVIEW_FILTER This variable specifies the directory (including full path) where PMView's filter files reside. If this variable is not set, PMView will look for the filters in the current directory. If PMView cannot find its filter files when it starts up, the Select Filter dialog will be empty. You can use the /FIL= command-line flag to override this variable and point to a different directory. We recommend that you put the following lines in your CONFIG.SYS. In the example PMView is assumed to reside in the PMVIEW directory on the D: drive. set PMVIEW_INI=D:\PMVIEW\PMVIEW.INI set PMVIEW_HELP=D:\PMVIEW set PMVIEW_FILTER=D:\PMVIEW\FILTERS ═══ 13. Questions & Answers ═══ Select one of the following:  General Q&A  File Open Container Q&A  Slideshow Q&A ═══ General Q&A ═══ This answers the most common questions we've been asked about PMView. Don't forget to look at the File Open Container Q&A and the Slideshow Q&A. Q. How do I get rid of the annoying About dialog that always pop up when I start PMView? A. If you haven't registered PMView yet; Register! In the unregistered version of PMView you cannot dismiss the dialog until 5 seconds has elapsed. In the registered version you can disable the dialog by changing the setting on the Logo page in PMView's Options Notebook. Q. Why is the painting of images slow and jumpy ? A. This depends on your OS/2 version or machine setup. Try enabling the Use GpiDrawBits and/or the Use Shadow Bitmap options in the Options Notebook. Please also read the on-line help for these options. Q. Why do desktop colors change/flash whenever I load an image ? A. This is caused by OS/2's palette manager when it remaps system colors. If you're willing to sacrifice color quality, you can fix this problem by turning off the palette manager; Uncheck Use Palette Manager on the Palette page in PMView's options notebook. Q. Why does/doesn't PMView ask for confirmation before deleting a file? A. PMView will ask for file delete confirmation in accordance with the setting on the Confirmations page in PMView's Options Notebook. Q. Why does PMView create a file called PMView.INI in every directory PMView is started from? A. Set the PMVIEW_INI environment variable in your CONFIG.SYS. Q. Why cannot PMView sometimes find its help file? A. Set the PMVIEW_HELP environment variable in your CONFIG.SYS. Q. Can I change the background color of PMView's main window? A. Yes! Drag the desired color from OS/2's Color Palette to PMView's main window. Note that you can also set the colors and fonts in the File Open and File Save dialogs. Q. PMView can read files in the Kodak Photo CD format, why cannot PMView save them in the same format? A. Kodak Corporation only allows reading their file format. It is not legally permitted to write files in the Photo-CD format. (Currently no other programs, with the exception of Kodak's own programs, allow this to be done). ═══ 14. Bugs and known problems ═══ How to report bugs If you encounter a problem in PMView and can't find the problem listed below, please report it to us. Please record the program version number and a description of the action being performed at the time of the error. We welcome any and all bug reports at sthiagar@nickel.ucs.indiana.edu. PMView bugs If you try to delete an image by dragging it from the File Open container to the shredder, you will hear the sound of the shredder, but the file will not be deleted. Fixing this bug will require completely changing PMView's WPS support. We will do it, but it may not happen for a few versions. For now, please use the Del key, or the Delete right-mouse-button command. For now, the width and height of any image that can be viewed is limited to 65,535 pixels. Although the memory requirement for, say, a 70,000x50x256 image is fulfilled (approx. 3.5 MB) the image cannot be loaded by PMView, since PMView uses a 32-bit integer fixed-point notation that uses 16 bits for the integer part (and the other 16 of the 32 bits for the fraction part). If you load an image larger than 65,535 pixels wide or high the result is unpredictable. However, please note that this "feature" only affect the viewing/loading of images. PMView's convert function will work correctly, so at least you are able to convert these files to other formats, though you cannot view them. If you need this feature/bug to be fixed soon, please let us know and we'll fix it. There are no other known bugs in this release of PMView. OS/2 bugs Everything from here on is a bug in OS/2 and not in PMView. 1. PROBLEMS WITH SPECIFIC OS/2 VERSIONS For best results, you should run PMView under Warp, since Warp fixed a lot of screen driver bugs. The second-best choice is OS/2 2.11 (i.e., OS/2 2.1 with the service pack) -- but see FATAL BUG below. We do not recommend that you run PMView under other OS/2 versions. While you cannot "damage" your system, the screen driver bugs may give disappointing performance. FATAL BUG OS/2 version 2.1 + service pak: If you have a large number of files with thumbnails (typically > 300) in the File Open Container (FOC) the whole WPS will lock and a warm boot (Ctrl-Alt-Del) is required. This bug is due to a problem with bitmap resources in OS/2 2.1 with the service pack installed. The problem does not occur without the service pack. Neither does it occur on any version of OS/2 2.0. 2. GENERAL OS/2 BUGS As of this writing, OS/2 does not recover very gracefully if you run out of swap space. Running many copies of PMView while viewing big images may get you in trouble. (Remember, a 1024x768x256 image represents 768K of pixel data alone!) There's also a "feature" of OS/2's WPS that you might want to know about. Suppose you associate *.GIF files with PMView. This means that you'll be able to double-click on a *.GIF file (when you have a drives object open, for instance) and PMView will start up and display that file. The "feature" is this: If you start up PMView this way and then do a File Delete, OS/2 will kill PMView shortly after the file gets deleted. If there is sufficient interest, Peter will try to write a workaround. 3. OS/2 SCREEN DRIVER BUGS If you see screen corruption, the first thing you should try in most cases is to turn off GpiDrawBits (on the Special page of the options notebook). While Warp fixed many screen driver bugs, there are still some drivers that have problems with GpiDrawBits if you scroll. Screen Bugs Under Warp The ATI Mach64 drivers shipped with Warp do not function properly in 65536 color mode. There is a bug in how the driver handles the GPI function GpiQueryBitmapBits. The bug causes PMView's Capture function to capture with wrong colors. The bug may also cause problems when exporting/importing images with Cut/Copy/Paste from/to other applications. A new Mach64 driver that fixes this problem is available via FTP from ftp.atitech.ca /pub/support/OS2/64os2154.zip The ATI Mach32 and Mach64 drivers have bugs that prevent them from working with GpiDrawBits turned on (scrolling does not work correctly). The drivers for the IBM ThinkPad 755 cause thumbnails to be painted in reverse, like film negatives. As a workaround we have supplied an option on the Special page in PMView's options notebook that will reverse the thumbnails. Screen Bugs Before Warp In OS/2 2.11 and earlier, the standard VGA driver and most S3 drivers have bugs that prevent them from working with GpiDrawBits turned on. The bug in the VGA driver will crash PMView immediately when an image is loaded. The S3 driver bug causes scrolling to not work properly. In these cases you cannot/may not want to use GpiDrawbits. On some machines, the desktop icons will occasionally "bleed through" and be visible when they shouldn't be. We have not found any pattern to this bug, except that it seems to occur more often on faster machines. If your screen driver does not support palette manager, you may not get a very attractive display. However, most 256-color screen drivers now support Palette Manager. ═══ 15. Why Register? ═══ Since the shareware copy of PMView that you have is fully functional, you may wonder what you'll gain by registering. This section tries to clarify the matter. You may use PMView for a 31-day trial period, as long as you agree to the provisions of the license agreement. If you continue to use PMView beyond this 31-day trial period, you are obligated to register it. Creating this piece of software has required years of hard work. We are trusting you to register if you continue to use it after the trial period. This is what shareware is all about. This is the first time we have released PMView in a version that lets you save files before you register it. If our trust is repaid by a drop in the number of registrations, we will have no choice but to go back to disabling file saves in the unregistered version. If you like PMView, please support it, so we can keep releasing it as fully functional, non-crippled shareware. Registering PMView will not give you any new functionality, but you'll be able to turn off the annoying nag-dialog (and the PMView icon will look a little nicer). Furthermore, when you register PMView you can rest assured that we will continue to enhance it to take advantage of advances in future hardware and software technology. Also, while we will listen to any suggestions we receive, we pay close attention to requests and suggestions from registered users. Related information:  How to Register.  Order Form ═══ 16. How to Register ═══ Since PMView is distributed as shareware, you may use it for a 31-day trial period, as long as you agree to the provisions of the license agreement. If you continue to use PMView beyond the 31-day trial period, you are obligated to register it. When you register PMView, you will be given instructions for converting it to the full, non-shareware version. You may not distribute the full version. You may treat it just like a book, except that you may copy it onto a computer to be used and you may make archival copies of it for the sole purpose of backing up the software and protecting your investment from loss. Registrations A PMView registration costs $40. You must give us your name. In return, you will receive a short "secret code" (of about 30 letters and numbers) that will enable you to run REGISTER.EXE and thus register any and all versions of PMView up to 1.0 and beyond. Thus, your one-time payment of $40 is a lifetime license for all future versions of PMView. Note: You will not receive PMView on a floppy, unless you order it at the same time (see below). If you have access to CompuServe or an up-to-date ftp site, you generally won't need a copy of PMView on a floppy. How do I send my order? You can order from Workshops by Thiagi by check, international money order, or VISA/Mastercard.  Order by phone: Call Workshops by Thiagi at (812) 332-1478 between 9-12 in the morning or 1-5 in the afternoon, Eastern Standard Time, and order with your VISA or Mastercard.  Order by fax: Fill in the order form along with your VISA or MasterCard information and fax it to WBT at (812) 332-5701.  Order by e-mail: Fill in the order form along with your VISA or MasterCard information and and e-mail it to us in PGP encrypted form (see the order form for details). Please do not e-mail unencrypted credit card information to us or anyone else !  Order by paper-mail or with a check: Fill in the order form and mail it along with your check or international money order to Workshops by Thiagi, 4423 E Trailridge Rd, Bloomington, IN 47408-9633, USA. Your check or money order must be made out in US dollars, and it must be made out to Workshops by Thiagi. If you want to use VISA or MasterCard, include your name, credit card number, expiration date, and signature. Note that residents of Indiana (USA) must pay an additional 5% state sales tax. (Thus 1 registration costs $42 and 1 PMView floppy costs $7.35 if you live in Indiana.) People residing anywhere else pay the usual $40 per registration or $7 per disk. If you have any questions or comments concerning ordering from Workshops by Thiagi, please send an e-mail note to Raja Thiagarajan at sthiagar@nickel.ucs.indiana.edu. PMView on a floppy If you need to, you can order a copy of the current version of PMView on a 1.44MB floppy. This costs $7, or is free if you send your own self-addressed, stamped 1.44MB floppy disk. The version you get won't be special in any way. It will be completely identical to the latest version you can download from ftp.cdrom.com or CompuServe. It will not be registered. To order PMView on a floppy, either send a self-addressed, stamped floppy disk (with postage for both ways!) or send a note with your name, address, and $7 to the address indicated in the order form. Quantity discounts? User group discounts? We offer both. For more information, contact us at the address below. Questions? Comments? Want to be a beta tester? Send an e-mail note to Raja Thiagarajan at sthiagar@nickel.ucs.indiana.edu. If you have a question or comment but no e-mail access, send it to Peter or WBT, and they can either answer it themselves or pass it on to me. Note that if you want to participate in our beta program, you must have e-mail access to the Internet and you must be able to routinely receive large (roughly 1 megabyte) single, uuencoded messages. Related information:  Why Register ?  Order Form ═══ Order Form ═══ For your convenience, you may use this form to order PMView. This order form is also available as plain ASCII text in the file ORDFORM.TXT. ORDER FORM *** ORDER FORM *** ORDER FORM Workshops by Thiagi Phone: (812) 332-1478 4423 E Trailridge Rd Fax: (812) 332-5701 Bloomington, IN 47408-9633 Email: sthiagar@nickel.ucs.indiana.edu USA =========================== ITEMS YOU WANT ========================== _____ PMView registrations at $40 each Name(s): ____________________ ____________________ ____________________ ____________________ ____________________ ____________________ WE MUST HAVE ONE NAME FOR EACH REGISTRATION! _____ copies of PMView on a disk at $7 each _____ Indiana State 5% Sales Tax (if your address is within Indiana, USA, you must add $2.00 per registration and $0.35 per disk) _____ total ====================== WHERE TO SEND THE ITEMS ====================== [ ] E-mail the registration(s) to: ____________________________________________________ [ ] Mail the registration(s) / disk(s) to: ____________________________________________________ ____________________________________________________ ____________________________________________________ ____________________________________________________ ____________________________________________________ Note: We can usually e-mail registrations out within a few days. Allow 4-6 weeks for paper mail. ============================= PAYMENT =============================== [ ] My check or money order, made out is US dollars to "Workshops by Thiagi," is enclosed. [ ] Charge my VISA or MasterCard Card number: _______________________________ Expiration date: ___________________________ Signature: _________________________________ BE SURE TO INCLUDE YOUR NAME, ADDRESS, AND E-MAIL ADDRESS (if you have one) WITH YOUR ORDER. If you use PGP, you can also encrypt this form and e-mail it to Raja Thiagarajan. His e-mail address is sthiagar@nickel.ucs.indiana.edu. You can finger him for his PGP public key, or send him a note asking for it. PLEASE DO NOT E-MAIL UNENCRYPTED CREDIT CARD INFORMATION TO US OR ANYONE ELSE ! *** THANKS FOR YOUR ORDER! *** ═══ 17. License Agreement ═══ The use of PMView is subject to the following terms and conditions. The copy of PMView that you have is distributed as shareware. You may freely copy and distribute the file PMVIEW.ZIP but only AS LONG AS THIS FILE IS NOT MODIFIED IN ANY WAY. You may NOT distribute individual components of PMVIEW.ZIP, either as-is or in modified form, without written permission from Peter Nielsen. Since PMView is distributed as shareware, you may use it for a 31-day trial period, as long as you agree to the provisions of this license agreement. If you continue to use PMView beyond the 31-day trial period, you are obligated to register it. Instructions for registering PMView can be found by selecting Help About from the PMView menu bar. When you register PMView, you will be given instructions for converting it to the full, non-shareware version. You may not distribute the full version. You may treat it just like a book, except that you may copy it onto a computer to be used and you may make archival copies of it for the sole purpose of backing up the software and protecting your investment from loss. By saying "just like a book," we mean that the full version may be used by any number of people, and may be freely moved from one computer location to another, so long as there is NO POSSIBILITY of it being used at one location or on one computer while it is being used at another. Just like a book cannot be read by two different people in two different places at one time, neither can the full version of PMView be used by two different people in two different places at the same time (unless, of course, Peter Nielsen's copyright is being violated). PMView is the copyright property of Peter Nielsen, Brahegatan 10 A 16, FIN-20110 Turku, FINLAND. ═══ 18. Limited Warranty ═══ Peter Nielsen does not warrant that PMView will meet your requirements or that its operation will be uninterrupted or error free. In no event will Peter Nielsen's liability for any damages to you or any other person ever exceed the registration fee that was paid to Peter Nielsen. Peter Nielsen SHALL NOT IN ANY CASE BE LIABLE FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR OTHER SIMILAR DAMAGES ARISING FROM ANY BREACH OF THESE WARRANTIES EVEN IF HE OR HIS AGENTS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Some states do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you. BETA VERSION NOTE: The particulars of how you register may be different in the final, non-beta version of PMView. PMView is the copyright property of Peter Nielsen, Brahegatan 10 A 16, FIN-20110 Turku, FINLAND. ═══ 19. Acknowledgements ═══ The TIFF and GIF LZW compression and decompression included in this software are licensed under U.S. Patent No. 4,558,302 and all foreign counterparts. The Tagged Interchange File Format, TIFF(tm), is the copyright property of Aldus Incorporated. The Graphics Interchange Format(c) is the copyright property of CompuServe Incorporated. GIF(sm) is a service mark property of CompuServe Incorporated. The JPEG compression and decompression included in this software is based in part on the work of the Independent JPEG Group. PMView is the copyright property of Peter Nielsen, Brahegatan 10 A 16, FIN-20110 Turku, FINLAND. ═══ Select Photo CD resolution ═══ Select Photo CD resolution:  192 x 128  384 x 256  768 x 512  1536 x 1024  3072 x 2048  6144 x 4096 Photo CD images actually store five copies of each picture, one for each resolution above. You should select the resolution you want by default. Photo CD PRO images additionally store a sixth resolution (6144x4096). Beware! The larger Photo CD resolutions will need a lot of memory to load. ═══ Confirm abort of file save ═══ PMView was in progress of saving your current file when it recieved a request to exit or load a new file. The requested operation requires that saving must complete before proceeding. Press Yes to stop (abort) saving of the current image. Press No to let saving continue to run. ═══ Confirm abort of transformation ═══ PMView was in progress of transforming your current file when it recieved a request to exit or load a new file. The requested operation requires that the transformation must complete before proceeding. Press Yes to stop (abort) transformation of the current image. Press No to let the transformation continue to run. ═══ Confirm abort of printing ═══ PMView was in progress of printing your current file when it recieved a request to exit or load a new file. The requested operation requires that printing must complete before proceeding. Press Yes to stop (abort) printing of the current image. Press No to let printing continue to run. ═══ Progress Indicator ═══ The Progress Indicator displays the status of loading progress. The text above the indicator tells the current "phase":  Reading The image is being read into memory.  Decoding The image is being decoded.  Decompressing The image is being decompressed.  Analyzing The image data is being analyzed.  Quantizing The colors in the image are being reduced.  Converting The colorspace and/or the image orientation is being transformed.  Creating Thumbnail A thumbnail is being created for the image.  Ready The image data is ready to be used. ═══ Print Setup ═══ Select from the listbox the printer you want to use for printing. Use the Job properties... pushbutton to start a dialog from which you can control your printing configuration. Related information:  Page Setup dialog.  Print Image dialog. ═══ Page Setup ═══ Select from the listbox the form you want to use. Use the Margins fields to set the margins you want to use. The minimum margins allowed corresponds to the hardware clip limits of the printer. The maximum margins are the size of the form. Use the Unit Selector to set the desired unit of measurement; millimeters, inches, or percent of page size. Related information:  Print Setup dialog.  Print Image dialog. ═══ Print Image ═══ Image Size Use the Width or Height control to set the desired size of the image. Note that PMView is able to split the image on several pages if the selected size is too large to fit on one sheet of paper. This allows you to create a large poster by gluing the pages together. (Don't forget that you also can increase the size of the margins in the Page Setup dialog). The total number of sheets required is indicated in the field below. Use the Unit Selector to set the desired unit of measurement; millimeters, inches, or percent of page size. Printer Gamma This control lets you adjust the printer gamma. You may need this if your image printout is too bright or dark. Values below one (1) makes the image darker, values above one makes it brighter. Press Print to print the file. Related information:  Print Setup dialog.  Page Setup dialog.