home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / OS2 / GRAPHICS / PMJPG142 / PMJPEG.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-09-04  |  28KB  |  703 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. PMJPEG is a shareware image viewer with image processing and conversion 
  5. capabilities for OS/2 2.x.  PMJPEG is a port of WinJPEG to OS/2 2.x. 
  6.  
  7. PMJPEG v.1.40 has the following features: 
  8.  
  9. Γûá display JPEG, GIF, TIFF, Targa, PCX, Windows BMP, or OS/2 BMP images
  10. Γûá export an image to JPEG, GIF, TIFF, Targa, PCX, Windows BMP, or OS/2 BMP images
  11. Γûá capability of generating OS/2 desktop-background bitmaps that use the system colors
  12. Γûá display an image in 16 color, 256 color, or truecolor display modes
  13. Γûá display an image in full screen mode
  14. Γûá print an image with scaling, best proportional fit on the page, or fit for full page
  15. Γûá red/green/blue or hue/saturation/brightness adjustment
  16. Γûá contrast enhancement
  17. Γûá gamma correction
  18. Γûá image rotation, vertical or horizontal flip, and image resizing
  19. Γûá image cropping
  20. Γûá batch file compression of GIF, TIFF, or Targa files to JPEG File Interchange Format
  21. Γûá copy an image to the clipboard or paste an image from the clipboard
  22. Γûá slideshow: display selected files sequentially with a cycle option
  23. Γûá image buffering in a cyclic slideshow
  24. Γûá support for file name extension association and starting a slideshow from the command line
  25.  
  26.  
  27. ΓòÉΓòÉΓòÉ 2. Known Problems ΓòÉΓòÉΓòÉ
  28.  
  29. There are two bugs in the 256 color ET4000 driver that comes with the OS/2 2.1 
  30. beta or OS/2 2.0 + Service Pack: 1) the driver does not stretch the bitmap 
  31. correctly so the Stretch to Fit Window option does not work properly, and 2) 
  32. the image under the dialog box or under the drop-down menu is not re-drawn with 
  33. the right colors.  Use the Auto-Refresh option if you have the second problem. 
  34.  
  35. If you are using the 256 color ET4000 driver, for certain images such as 24-bit 
  36. images displayed with Maximum Color Depth set to 256 colors, the text that 
  37. shows the cropping dimensions is garbled by a filled box.  This appears to be a 
  38. bug in OS/2's palette manager or the driver. 
  39.  
  40. If you are using a 256 color driver, when you exit PMJPEG, the system colors do 
  41. not immediately return to normal.  The system colors are gradually restored by 
  42. OS/2.  You can force the colors to change back by opening and/or closing a 
  43. window, such as the window list that pops up when you hit CTL-ESC. 
  44.  
  45.  
  46. ΓòÉΓòÉΓòÉ 3. JPEG ΓòÉΓòÉΓòÉ
  47.  
  48. Joint Photographic Experts Group (JPEG)  refers to a still-picture compression 
  49. standard that specifies several modes of operation.  The mode used by the 
  50. Independent JPEG Group's(IJPEG) software, which is incorporated into PMJPEG, is 
  51. sequential buildup;  in this mode,  each component of an image is encoded in a 
  52. left-to-right and top-to-bottom scan.  Sequential mode is lossy, which means 
  53. that when you compress an image, you will lose information.  That is, when you 
  54. decode the compressed image, the decoded image will not exactly match the 
  55. original.  One reason that sequential mode JPEG is lossy is that the algorithm 
  56. compresses an image by removing visually insignificant information, colors that 
  57. the human eye cannot detect. 
  58.  
  59.  
  60. ΓòÉΓòÉΓòÉ 4. Converting File Formats with PMJPEG ΓòÉΓòÉΓòÉ
  61.  
  62. Images can be converted from one file format to another by loading an image 
  63. with the File Open menu item and saving it to the desired file format with the 
  64. File Save menu item. 
  65.  
  66. Before you load an image that you want to convert, you should check the Maximum 
  67. Color Depth option.  This option determines the maximum number of colors in a 
  68. displayed image.  Even though an image may look good, there may have been a 
  69. loss of colors and data in the image.  For example, suppose you are viewing a 
  70. 24-bit image with Maximum Color Depth set to 256 colors.  The 24-bit image can 
  71. have up to 16.7 million colors but the number of colors in the image is reduced 
  72. to 256 when it is loaded.  When you save this image to a different format, you 
  73. lose many colors that were in the original image.  To avoid losing colors in 
  74. the image, you should set Maximum Color Depth to 16.7 million colors before 
  75. loading the image. 
  76.  
  77. PMJPEG saves a displayed image to a specified file format with 8-bits per pixel 
  78. or 24-bits per pixel. Images stored with 1, 2, or 4-bits per pixel are 
  79. converted to 8-bits per pixel and can be saved in this format only.  Images 
  80. with 8 or 24-bits per pixel are saved with 8 or 24-bits per pixel, 
  81. respectively.  The two exceptions to the color depth of the saved file format 
  82. are the JPEG file format which is always 24-bits per pixel and the GIF format 
  83. which is 8-bits per pixel. 
  84.  
  85. Batch Compression of images to JPEG is not affected by the Maximum Color Depth 
  86. option. 
  87.  
  88. If you are creating a bitmap to be used as an OS/2 desktop-background image, 
  89. apply the Map to System Colors function to a displayed image before saving it 
  90. to an OS/2 BMP file.  If you are converting a 24-bit image to an OS/2 BMP, you 
  91. should set Maximum Color Depth to 16.7 million colors before you load the 
  92. image.  This produces a better looking background image than one created by 
  93. loading a 24-bit image with a Maximum Color Depth of 256 colors and then 
  94. applying the Map to System Colors function. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 5. Starting a Slideshow from the Command Line ΓòÉΓòÉΓòÉ
  98.  
  99. A slideshow can be initiated from the OS/2 command line by executing the 
  100. following at the OS/2 prompt: 
  101.  
  102.   pmjpeg [filename 1] [filename 2] [filename 3] ... [filename n] 
  103.  
  104. The files are displayed in the order in which they are entered on the command 
  105. line.  Also, the slideshow options that were saved by the Save All Options menu 
  106. item are used.  If no options were saved, the default slideshow options are 
  107. used.  There is no limit to the number of files that you enter.  The only 
  108. restrictions are the number of characters that you can fit in one command at 
  109. the OS/2 prompt. 
  110.  
  111. For example, if you wanted to display the files, "colrtest.jpg", "mirri3.jpg", 
  112. and "image1.gif", in the order listed , type 
  113.  
  114.   pmjpeg colrtest.jpg mirri3.jpg image1.gif 
  115.  
  116. This example assumes that PMJPEG is in your search path and this command is 
  117. executed in the directory containing the images.  If OS/2 can't find 
  118. "pmjpeg.exe" or the images, you can prefix "pmjpeg.exe" or the images with a 
  119. standard OS/2 path. 
  120.  
  121.  
  122. ΓòÉΓòÉΓòÉ 6. Image File Formats ΓòÉΓòÉΓòÉ
  123.  
  124. o JPEG File Formats 
  125. o TIFF 
  126. o Graphics Interchange Format (GIF) 
  127. o Targa 
  128. o PCX 
  129. o BMP 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 6.1. JPEG File Formats ΓòÉΓòÉΓòÉ
  133.  
  134. The JPEG committee has not specified a standard file format, and consequently, 
  135. many applications of the JPEG algorithm use their own proprietary format. 
  136. PMJPEG uses the JPEG File Interchange Format(JFIF) which transports only pixel 
  137. information.  JFIF is supported by the IJPEG Group's software and other 
  138. programs based on their code. 
  139.  
  140. Handmade Software's GIF2JPG and Image Alchemy use a proprietary JPEG format 
  141. that is not compatible with the JFIF standard.  This proprietary format is not 
  142. supported by PMJPEG.  When you use GIF2JPG v.2.0, remember to leave out the 
  143. "-s" option to produce a JPEG file that is compatible with the JFIF standard 
  144. and viewable with PMJPEG. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 6.2. Graphics Interchange Format (GIF) ΓòÉΓòÉΓòÉ
  148.  
  149. PMJPEG can view interlaced/non-interlaced GIF87a and GIF89a files, and it can 
  150. save non-interlaced GIF87a files. If a GIF89a file contains more than one 
  151. image, it will display the first image in the file. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 6.3. Targa ΓòÉΓòÉΓòÉ
  155.  
  156. PMJPEG can view uncompressed or run-length encoded TARGA files stored with 8, 
  157. 15, 16, 24, or 32 bits per pixel and it can save uncompressed TARGA files with 
  158. 8 or 24 bits per pixel. 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 6.4. PCX ΓòÉΓòÉΓòÉ
  162.  
  163. PMJPEG can view PCX files stored with 1, 4, 8, or 24 bits per pixel.  If a 1, 
  164. 4, or 8 bits per pixel PCX file does not have a valid palette, PMJPEG will use 
  165. a default palette.  It can save PCX Version 5.0 files with 8 or 24 bits per 
  166. pixel. 
  167.  
  168.  
  169. ΓòÉΓòÉΓòÉ 6.5. BMP ΓòÉΓòÉΓòÉ
  170.  
  171. PMJPEG can view Windows and OS/2 (1.x and 2.0) BMP files stored with 1, 4, 8, 
  172. or 24 bits per pixel and can view BMP files that are run-length encoded(RLE). 
  173. In addition, it can display the first image in an OS/2 bitmap array. It can 
  174. save uncompressed Windows or OS/2 BMP files in 8 or 24 bits per pixel and can 
  175. save BMP files with RLE. 
  176.  
  177. Note that some graphics viewers use the file extension ".RLE" for run-length 
  178. encoded Windows BMP files.  PMJPEG uses the ".BMP" extension as a default for 
  179. such files. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 6.6. Tagged Interchange File Format (TIFF) ΓòÉΓòÉΓòÉ
  183.  
  184. PMJPEG supports a subset of the TIFF 6.0 specification.  PMJPEG can view TIFF 
  185. files stored with 1, 2, 4, 8, or 24 bits per pixel.  PMJPEG can read TIFF 
  186. images stored in strip format, in which the image is divided into horizontal 
  187. strips of pixels, and tile format,  in which an image is divided into 
  188. rectangular grids of pixels.  The compression modes LZW, Packbits, Thunderscan, 
  189. NeXT, and CCITT (RLE, RLEW, FAX3, FAX4) can be read as well as uncompressed 
  190. TIFF images. 
  191.  
  192. PMJPEG can save uncompressed or LZW compressed TIFF files with 8 or 24 bits per 
  193. pixel.  TIFF files are saved in strip format. 
  194.  
  195.  
  196. ΓòÉΓòÉΓòÉ 7. Menu Commands ΓòÉΓòÉΓòÉ
  197.  
  198. The menus are ordered by the following main topics: 
  199.  
  200. o File Menu 
  201. o Edit Menu 
  202. o Options 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 7.1. File Menu ΓòÉΓòÉΓòÉ
  206.  
  207. The File menu includes commands that enable you to open and save files, to 
  208. batch convert files to JPEG, and to display multiple images in a selected 
  209. order. 
  210.  
  211. o Open 
  212. o Save 
  213. o Save All Options 
  214. o Delete 
  215. o Batch Compression 
  216. o Slideshow 
  217. o Print 
  218. o Print Setup 
  219. o Print Options 
  220. o Exit 
  221.  
  222.  
  223. ΓòÉΓòÉΓòÉ 7.1.1. File Open ΓòÉΓòÉΓòÉ
  224.  
  225. Select a file to display. 
  226.  
  227. The list boxes in the left column display the drives and the directories in the 
  228. current path, and the list box in the right column displays the files in the 
  229. current path. 
  230.  
  231. To display a file, click on a file from the file list and press "OK," or double 
  232. click on the desired file. 
  233.  
  234.  
  235. ΓòÉΓòÉΓòÉ 7.1.2. File Save ΓòÉΓòÉΓòÉ
  236.  
  237. Select a file name to save the currently displayed image. 
  238.  
  239. The list boxes in the left column display the drives and the directories in the 
  240. current path, and the list box in the right column displays the files in the 
  241. current path. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 7.1.3. Save All Options ΓòÉΓòÉΓòÉ
  245.  
  246. This will save all the PMJPEG options to a file named "pmjpeg.sav" in the same 
  247. directory as the PMJPEG executable.  When PMJPEG is initially loaded, the 
  248. options will be loaded if "pmjpeg.sav" exists. 
  249.  
  250.  
  251. ΓòÉΓòÉΓòÉ 7.1.4. Delete ΓòÉΓòÉΓòÉ
  252.  
  253. This menu command lets you delete the file containing the currently displayed 
  254. image.  PMJPEG will prompt you for confirmation before deleting the file. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 7.1.5. Batch Compression ΓòÉΓòÉΓòÉ
  258.  
  259. Select GIF, TIFF, and TARGA files to compress to JPEG format with the options 
  260. specified in the JPEG Options dialog.  The list boxes in the left column 
  261. display the drives and the directories in the current path, the list box in the 
  262. middle displays the files in the current path, and the one in the right 
  263. displays a list of files to be converted.  To add file(s) to the "Files 
  264. Selected" box, select the file(s) you want to convert and press the "Add" 
  265. button.  To remove file(s) from this box, select the file(s) in this box and 
  266. press the "Remove" button. 
  267.  
  268. The output file(s) will have the same name as the input file(s) except that 
  269. they will have a ".jpg" extension.  Also, the output file(s) will be placed in 
  270. the same directory path in which the input file(s) were located. 
  271.  
  272. See also JPEG Options. 
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 7.1.6. Slideshow ΓòÉΓòÉΓòÉ
  276.  
  277. Select the JPEG, TIFF, GIF, Targa, and BMP files to display in a slideshow. 
  278. The order in which you add the files will be the order in which they are 
  279. displayed. 
  280.  
  281. After a picture is loaded and displayed, if Automatic Slide Advancement is 
  282. selected, there will be a user-selected delay before the next picture is 
  283. loaded.  To advance to the next picture before the delay has elapsed, click on 
  284. the window with the right mouse button.  If Manual Slide Advancement is 
  285. selected, PMJPEG will wait until you click with the right mouse button before 
  286. advancing to the next picture. 
  287.  
  288. If you would like the slideshow to continue from the beginning of the list 
  289. after the last picture is displayed, check off the Cycle Slideshow menu option. 
  290.  
  291. To abort the slideshow, click on the window with the left mouse button, click 
  292. on the "Yes" button in the confirmation dialog, and the slideshow will stop 
  293. after the currently loading picture is displayed. 
  294.  
  295. See also Slideshow Options. 
  296.  
  297.  
  298. ΓòÉΓòÉΓòÉ 7.1.7. Print ΓòÉΓòÉΓòÉ
  299.  
  300. Print the image currently displayed. 
  301.  
  302.  
  303. ΓòÉΓòÉΓòÉ 7.1.8. Print Setup ΓòÉΓòÉΓòÉ
  304.  
  305. The Print Setup dialog box lets you select the Printer and Job Properties.  The 
  306. Job Properties dialog box allows printer driver-dependent options to be 
  307. changed. 
  308.  
  309.  
  310. ΓòÉΓòÉΓòÉ 7.1.9. Print Options ΓòÉΓòÉΓòÉ
  311.  
  312. The displayed image can be printed in three ways: 1) best fit for the page, 2) 
  313. fit for the full page, or 3) scaled by a user-selected factor.  Best Fit scales 
  314. the image for maximum fit on a printed page while maintaining the image's 
  315. aspect ratio.  Fit for Full Page scales the image such that it fits the entire 
  316. page. The Scale option scales the printed image's width or height by an integer 
  317. factor that is selected by the user. 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 7.1.10. Exit ΓòÉΓòÉΓòÉ
  321.  
  322. Exit from PMJPEG. 
  323.  
  324.  
  325. ΓòÉΓòÉΓòÉ 7.2. Edit Menu ΓòÉΓòÉΓòÉ
  326.  
  327. The Edit menu includes commands that enable you to transfer images to and from 
  328. the clipboard, change the color components of an image, and to manipulate the 
  329. image. 
  330.  
  331. o Copy 
  332. o Paste 
  333. o Crop 
  334. o HSV Adjustment 
  335. o Color Balance 
  336. o Contrast Enhancement 
  337. o Grayscale 
  338. o Gamma Correction 
  339. o Map To System Colors 
  340. o Rotate 
  341. o Flip Horizontal 
  342. o Flip Vertical 
  343. o Resize 
  344.  
  345.  
  346. ΓòÉΓòÉΓòÉ 7.2.1. Copy ΓòÉΓòÉΓòÉ
  347.  
  348. Copy the entire image to the clipboard. 
  349.  
  350.  
  351. ΓòÉΓòÉΓòÉ 7.2.2. Paste ΓòÉΓòÉΓòÉ
  352.  
  353. Paste an image from the clipboard. 
  354.  
  355.  
  356. ΓòÉΓòÉΓòÉ 7.2.3. Crop ΓòÉΓòÉΓòÉ
  357.  
  358. If a region of the image is selected (see Selecting a Region to Crop), keep 
  359. that region and discard the image outside of the selected region. 
  360.  
  361.  
  362. ΓòÉΓòÉΓòÉ 7.2.4. HSV Adjustment ΓòÉΓòÉΓòÉ
  363.  
  364. Use the scroll bars to adjust the amount of hue, saturation, and 
  365. value/brightness in an image.  A value of 0 on the scroll bar means that there 
  366. is no change in the corresponding color component. When the value is increased 
  367. or decreased, the color component is increased or decreased, respectively. 
  368.  
  369.  
  370. ΓòÉΓòÉΓòÉ 7.2.5. Color Balance ΓòÉΓòÉΓòÉ
  371.  
  372. Use the scroll bars to adjust the amount of red, green, and blue in an image. 
  373. A value of 0 on the scroll bar means that there is no change in the 
  374. corresponding color component.  When the value is increased or decreased, the 
  375. color component is increased or decreased, respectively. 
  376.  
  377.  
  378. ΓòÉΓòÉΓòÉ 7.2.6. Contrast Enhancement ΓòÉΓòÉΓòÉ
  379.  
  380. Use the scroll bar to adjust the amount of contrast in an image.  A value of 0 
  381. on the scroll bar means that there is no change in the contrast.  When the 
  382. value is increased or decreased, the contrast is increased or decreased, 
  383. respectively. 
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ 7.2.7. Grayscale ΓòÉΓòÉΓòÉ
  387.  
  388. Convert a color image into a grayscale one. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 7.2.8. Gamma Correction ΓòÉΓòÉΓòÉ
  392.  
  393. Use the scroll bar to adjust the amount of gamma.  A value of 1.0 on the scroll 
  394. bar means that there is no change in the image.  In general, increasing the 
  395. gamma makes the image lighter and decreasing it makes the image darker.  A 
  396. gamma of 2.2 is a commonly used value. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 7.2.9. Map To System Colors ΓòÉΓòÉΓòÉ
  400.  
  401. Converts the displayed image to an image that has a 256-color palette 
  402. containing the system colors of the OS/2 desktop.  Use this option to generate 
  403. an image that can be used as a 256-color OS/2 desktop-background image. 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ 7.2.10. Rotate ΓòÉΓòÉΓòÉ
  407.  
  408. Rotate the image clockwise by 90 degrees. 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ 7.2.11. Flip Horizontal ΓòÉΓòÉΓòÉ
  412.  
  413. Flip the image around the vertical axis. 
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ 7.2.12. Flip Vertical ΓòÉΓòÉΓòÉ
  417.  
  418. Flip the image around the horizontal axis. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 7.2.13. Resize ΓòÉΓòÉΓòÉ
  422.  
  423. Change the spatial resolution of the displayed image.  Common sizes such as 
  424. 640x680, 800x600, 1024x768, and 1280x1024 can be easily selected. 
  425.  
  426. The Maximize Fit on Desktop option will resize the image into the largest 
  427. possible window that will fit on the desktop while keeping the aspect ratio, 
  428. the ratio between the original width and height. 
  429.  
  430. Also, a custom size can be manually entered.  If Keep Aspect Ratio is enabled, 
  431. only one dimension needs to be entered because the other one is automatically 
  432. changed to maintain the aspect ratio. 
  433.  
  434.  
  435. ΓòÉΓòÉΓòÉ 7.3. Options Menu ΓòÉΓòÉΓòÉ
  436.  
  437. The Options menu includes commands that let you determine how other commands 
  438. operate. The settings for the options can be saved with the Save All Options 
  439. command. 
  440.  
  441. o Stretch to Fit Window 
  442. o View Fullscreen 
  443. o Maximum Color Depth 
  444. o Display Old Image during Load 
  445. o Move Window after Load 
  446. o Auto-Refresh 
  447. o JPEG Options 
  448. o Slideshow Options 
  449.  
  450.  
  451. ΓòÉΓòÉΓòÉ 7.3.1. Stretch to Fit Window ΓòÉΓòÉΓòÉ
  452.  
  453. When this option is checked, the scrollbars for the PMJPEG window are turned 
  454. off and the image is stretched to the dimensions of the client area of the 
  455. PMJPEG window.  This option does not permanently change the resolution of the 
  456. image.  If you save the image, the original image is saved, not the stretched 
  457. one. 
  458.  
  459.  
  460. ΓòÉΓòÉΓòÉ 7.3.2. View Fullscreen ΓòÉΓòÉΓòÉ
  461.  
  462. View the currently displayed image with the full screen.  If the image is 
  463. larger than the entire screen, the image will be resized with the best 
  464. proportional fit before it is displayed.  If the image is smaller, it will be 
  465. displayed in the center of the screen.  To exit from full screen mode, press 
  466. any key or click on the screen with the left mouse button. 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 7.3.3. Maximum Color Depth ΓòÉΓòÉΓòÉ
  470.  
  471. When you load an image that has more colors than the Maximum Color Depth 
  472. setting, PMJPEG will reduce the number of colors to the Maximum Color Depth 
  473. setting before displaying the image.  If you are viewing images, you should set 
  474. this option to the number of colors supported by your display driver. If you 
  475. are converting images from one file format to another, you should set it to 
  476. 16.7 million colors. 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ 7.3.4. Display Old Image during Load ΓòÉΓòÉΓòÉ
  480.  
  481. If this option is checked, you can continue viewing the currently displayed 
  482. image while another image is being loaded.  However, this option will use more 
  483. memory because PMJPEG has to maintain two images.  Consequently, it may slow 
  484. down the loading of the next image if PMJPEG runs out of physical memory and 
  485. must use slower virtual memory. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 7.3.5. Move Image after Load ΓòÉΓòÉΓòÉ
  489.  
  490. If this option is checked, the PMJPEG window is moved to the upper left-hand 
  491. corner of the desktop after an image is loaded. 
  492.  
  493.  
  494. ΓòÉΓòÉΓòÉ 7.3.6. Auto-Refresh ΓòÉΓòÉΓòÉ
  495.  
  496. The purpose of this option is to provide a temporary solution to a bug in the 
  497. 256 color drivers.  This bug is evident when the area of the image under a 
  498. drop-down menu or under a dialog box is not properly redrawn after the 
  499. drop-down menu or the dialog, respectively, is closed. 
  500.  
  501. If this menu item is checked, PMJPEG will automatically refresh the image when 
  502. it is necessary. 
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ 7.3.7. JPEG Options ΓòÉΓòÉΓòÉ
  506.  
  507. 2-pass(Heckbert) quantization produces better looking output than 1-pass 
  508. quantization and it is slower.  Also, 2-pass quantization uses more memory so 
  509. it may be even slower because PMJPEG will swap to hard disk when it runs out of 
  510. virtual memory.  The output of 1-pass generally looks more grainy. 
  511.  
  512. Dithering uses available colors in a palette to simulate additional colors. 
  513. The dithering method that PMJPEG uses is called Floyd-Steinberg Dithering. 
  514. Dithering is useful when quantizing to 256 colors or less but it is not needed 
  515. for a true-color (24-bit) display.  You may want to turn off dithering since it 
  516. sometimes causes a grainy output image. 
  517.  
  518. The Quality Factor, an integer between 0 and 100 inclusive, determines the 
  519. tradeoff between the output file size and the output image quality.  If you 
  520. choose a high quality factor, the image quality will be high but the file size 
  521. will be large.  A lower quality setting will yield a smaller file at a cost of 
  522. lower fidelity.  Since the JPEG algorithm is lossy, a quality factor of 100 
  523. will not give you a losslessly compressed image. 
  524.  
  525. The Smoothing Factor, also an integer between 0 and 100 inclusive, determines 
  526. the degree of smoothing to apply to an image before compressing that image with 
  527. JPEG.  The higher you set the factor, the higher the degree of smoothing that 
  528. is applied.  A smoothing factor of 0 means that no smoothing is performed. 
  529. Smoothing removes noise introduced when an image is dithered, and, in turn, 
  530. smoothing produces a smaller JPEG file.  It should be used for only dithered 
  531. images, like photographic GIF pictures.  Generally, a factor between 10 and 50 
  532. removes the dithering noise from an image. 
  533.  
  534. Entropy Optimization produces a smaller JPEG file but it takes more time to 
  535. encode the image. 
  536.  
  537. If PMJPEG runs out of virtual memory while it is decoding/encoding JPEG files, 
  538. it will use temporary files that are created in the specified path. 
  539.  
  540.  
  541. ΓòÉΓòÉΓòÉ 7.3.8. Slideshow Options ΓòÉΓòÉΓòÉ
  542.  
  543. When a slideshow is running, the Cycle Slideshow option determines whether or 
  544. not a list of images are continuously displayed in a cycle.  If this option is 
  545. on, the slideshow returns back to the first picture after the last one is 
  546. displayed and continues to display all the images in a selected list until you 
  547. abort the slideshow. 
  548.  
  549. The Fullscreen option lets you display the images in the slideshow with the 
  550. full screen as described in the View Fullscreen section. 
  551.  
  552. The Slide Advancement options determine how to advance to the next image in a 
  553. slideshow.  In Manual mode, PMJPEG will wait until you click with the right 
  554. mouse button before advancing to the next picture.  In Automatic mode, there 
  555. will be a user-selected time delay before the next picture is loaded.  To 
  556. advance to the next picture before the delay has elapsed, click on the window 
  557. with the right mouse button.  The Delay can be set to a value between 0 and 999 
  558. seconds. 
  559.  
  560. The Buffer Image Formats options allow buffering of selected image formats 
  561. during a cyclic slideshow.  If a type is selected, all images of that type are 
  562. stored in memory after they are loaded and decompressed, and they will not be 
  563. loaded/decompressed the next time they are displayed.  This feature must be 
  564. used in conjunction with the Cycle Slideshow option.  Buffering images can use 
  565. a lot of memory; if you don't have much physical memory, be certain that there 
  566. is enough disk space on OS/2's swap drive to handle this memory usage. 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 7.3.9. Progress Options ΓòÉΓòÉΓòÉ
  570.  
  571. For time-consuming tasks like loading, saving, batch compressing, and mapping 
  572. to system colors, PMJPEG displays a percentage that indicates how much of the 
  573. task has been completed.  The progress can be displayed in either a dialog box 
  574. or the title bar of the PMJPEG window. 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 8. Selecting a Region to Crop ΓòÉΓòÉΓòÉ
  578.  
  579. To select a region of the image, click on the image with the left mouse button. 
  580. While holding down that button, move your mouse until the rectangle surrounds 
  581. the desired region, and then release the mouse button.  The dimensions of the 
  582. selected region are displayed in the center of the indicated region. 
  583.  
  584.  
  585. ΓòÉΓòÉΓòÉ 9. How to Register ΓòÉΓòÉΓòÉ
  586.  
  587. If you use PMJPEG for more than 14 days, you are expected to register PMJPEG. 
  588. When you register, you will receive the latest version of PMJPEG, a user 
  589. manual, and a collection of JPEG images (we will put as many as we can fit on 2 
  590. 720k 3 1/2" floppies, on 1 1.44M  3 1/2" floppy, or on 4 360k 5 1/4" floppies). 
  591. Also, the registered version does not have the reminder-to-register screen at 
  592. the start. 
  593.  
  594. The registration fee is only $20.  MA residents, add 5% sales tax to the 
  595. registration fee.  US residents, add $4 for shipping and handling; non-US 
  596. residents, add $8 for shipping and handling.  If you want PMJPEG e-mailed to 
  597. your account instead of having it physically mailed to you, there is no extra 
  598. shipping charge. 
  599.  
  600. Updates are free but the shipping charge described above applies to updates. 
  601. Users who register PMJPEG and provide an e-mail address will automatically 
  602. receive updates via e-mail. 
  603.  
  604. For e-mail registrations, you need to use a program called "uudecode" to decode 
  605. the uuencoded file that we e-mail to you.  For your information, a uuencoded 
  606. file is a binary file that is converted to text by a program called "uuencode". 
  607. If your mail system rejects large messages, we will split the uuencoded file 
  608. into smaller parts before mailing the parts to you, and you will need to edit 
  609. the messages with a text editor before you can decode them.  Compuserve, for 
  610. example, does not permit large e-mail messages.  Also, the uuencoded file is 
  611. rather large; it is approximately 300k for PMJPEG v.1.4.  Compuserve users may 
  612. find it less expensive to receive PMJPEG via U.S. Mail. 
  613.  
  614. Registrations with the incorrect fee, non-US currency, or drawn on a non-US 
  615. bank will be returned. 
  616.  
  617. To register, complete the order form and send a check in US funds drawn on a US 
  618. bank to: 
  619.  
  620.    Norman Yee 
  621.    58 Chandler St. 
  622.    Boston, MA 02116 
  623.  
  624. Registration of PMJPEG is based on "personal usage."  Corporate or 
  625. organizational users must register all copies used on an individual basis; a 
  626. specific person (name) must be explicitly assigned to each registrant who will 
  627. be provided with a personalized copy of PMJPEG. Registration grants a specific 
  628. person (not an organization or corporate entity) the right to use PMJPEG. 
  629.  
  630. Although we will try to mail your copy of PMJPEG 1-3 weeks after we receive 
  631. your registration, please allow up to 4-6 weeks for delivery. 
  632.  
  633.  
  634. ΓòÉΓòÉΓòÉ 10. Reporting Bugs ΓòÉΓòÉΓòÉ
  635.  
  636. If you find a bug in PMJPEG, we would appreciate it if you would inform us of 
  637. the bug through one of our e-mail accounts: 
  638.  
  639.   Norman Yee 
  640.   nyee@osiris.ee.tufts.edu 
  641.  
  642.   Ken Yee 
  643.   kenyee@ksr.com 
  644.  
  645. When you send us a bug report, include a description of the procedure for 
  646. reproducing the bug and a description of your system configuration(hardware and 
  647. software). 
  648.  
  649.  
  650. ΓòÉΓòÉΓòÉ 11. License Agreement (applicable to registered users) ΓòÉΓòÉΓòÉ
  651.  
  652. You are licensed to single-copy use of PMJPEG; this means that you can install 
  653. your registered version of PMJPEG simultaneously on one computer at work, one 
  654. computer at home, and one portable computer, if only one copy is in use by the 
  655. registered individual at a time.  You may make copies of the registered PMJPEG 
  656. disk as necessary for normal backup purposes; you agree not to make any copies 
  657. of the printed PMJPEG manual or the registered version of PMJPEG for others. 
  658.  
  659.  
  660. ΓòÉΓòÉΓòÉ 12. Disclaimer ΓòÉΓòÉΓòÉ
  661.  
  662. The authors of this program accept no responsibility for damages that are 
  663. caused by this program and make NO WARRANTY or representation, either express 
  664. or implied, with respect to this software.  This software is provided "AS IS," 
  665. and you, its user, assume the entire risk when you use it. 
  666.  
  667.  
  668. ΓòÉΓòÉΓòÉ 13. Acknowledgments ΓòÉΓòÉΓòÉ
  669.  
  670. PMJPEG is based in part on the work of the Independent JPEG Group. 
  671.  
  672. TIFF support in PMJPEG is based in part on Sam Leffler's TIFF library. 
  673.  
  674. Windows is a trademark of Microsoft Corporation. 
  675.  
  676. OS/2 is a trademark of International Business Machines Corporation. 
  677.  
  678. The Graphics Interchange Format(c) is the Copyright property of CompuServe 
  679. Incorporated.  GIF(sm) is a Service Mark property of CompuServe Incorporated. 
  680.  
  681. GIF2JPG and Image Alchemy are trademarks of Handmade Software, Inc. 
  682.  
  683. WinJPEG is copyright (C) 1992, 1993, Norman Yee and Ken Yee.  All rights 
  684. reserved. 
  685.  
  686. PMJPEG is copyright (C) 1993, Norman Yee and Ken Yee.  All rights reserved. 
  687.  
  688. o Copyright Notice for Sam Leffler's TIFF Library 
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 13.1. Copyright Notice for Sam Leffler's TIFF Library ΓòÉΓòÉΓòÉ
  692.  
  693. Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993 Sam Leffler 
  694.  
  695. Copyright (c) 1991, 1992, 1993 Silicon Graphics, Inc. 
  696.  
  697. Permission to use, copy, modify, distribute, and sell this software and  its 
  698. documentation for any purpose is hereby granted without fee, provided that (i) 
  699. the above copyright notices and this permission notice appear in all copies of 
  700. the software and related documentation, and (ii) the names of Sam Leffler and 
  701. Silicon Graphics may not be used in any advertising or publicity relating to 
  702. the software without the specific, prior written permission of Sam Leffler and 
  703. Silicon Graphics.