home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / graphics / pmjpg095.zip / PMJPEG.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-02-28  |  12KB  |  293 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.0.95 has the following features: 
  8.  
  9. Γûá display JPEG, GIF, Targa, Windows BMP, or OS/2 BMP images
  10. Γûá display of JPEG images with 1-pass/2-pass quantization and Floyd-Steinberg dithering
  11. Γûá color balance: red, green, and blue adjustment
  12. Γûá hue, saturation, and brightness adjustment
  13. Γûá image rotation, vertical or horizontal flip
  14. Γûá batch file compression of GIF or TARGA files to JPEG File Interchange Format (JFIF)
  15.  
  16. In order to see images displayed with the right colors, you must use a version 
  17. of OS/2 and a 256 color driver that support palette manager. Both OS/2 2.0 with 
  18. the Service Pack and OS/2 2.1 beta support palette manager. 
  19.  
  20. If you are using the 256 color ET4000 driver that comes with OS/2 2.1 beta, 
  21. you'll notice that the image under the dialog box or under the drop-down menu 
  22. is not re-drawn correctly.  This is a bug in the ET4000 driver. 
  23.  
  24. When you exit, the system colors may not return to normal.  This appears to be 
  25. a bug with the palette manager of the December 1992 OS/2 2.1 beta. However, the 
  26. palette does appear to correct itself after you open and/or close a window, 
  27. such as the window list. 
  28.  
  29. The planned features for v.1.0 are: 
  30.  
  31. Γûá display JPEG, TIFF, Targa, GIF, Windows BMP, or OS/2 BMP images
  32. Γûá export an image to JPEG, TIFF, Targa, GIF, or OS/2 BMP
  33. Γûá display of 24-bit images with 1-pass or 2-pass(for JPEG only) quantization and Floyd-Steinberg dithering
  34. Γûá color balance: red, green, and blue adjustment
  35. Γûá hue, saturation, and brightness adjustment
  36. Γûá contrast enhancement
  37. Γûá image rotation, vertical or horizontal flip
  38. Γûá batch file compression of GIF, TIFF, or TARGA files to JPEG File Interchange Format (JFIF)
  39. Γûá slideshow: display selected files sequentially with a cycle option
  40.  
  41. Registered users will receive a copy of v.1.0 when it is available (expected in 
  42. early April). 
  43.  
  44.  
  45. ΓòÉΓòÉΓòÉ 2. JPEG ΓòÉΓòÉΓòÉ
  46.  
  47. Joint Photographic Experts Group (JPEG)  refers to a still-picture compression 
  48. standard that specifies several modes of operation.  The mode used by the 
  49. Independent JPEG Group's(IJPEG) software, which is incorporated into PMJPEG, is 
  50. sequential buildup;  in this mode,  each component of an image is encoded in a 
  51. left-to-right and top-to-bottom scan.  Sequential mode is lossy, which means 
  52. that when you compress an image, you will lose information.  That is, when you 
  53. decode the compressed image, the decoded image will not exactly match the 
  54. original.  One reason that sequential mode JPEG is lossy is that the algorithm 
  55. compresses an image by removing visually insignificant information, colors that 
  56. the human eye cannot detect. 
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ 3. Image File Formats ΓòÉΓòÉΓòÉ
  60.  
  61. o JPEG File Formats 
  62. o Graphics Interchange Format (GIF) 
  63. o Targa 
  64. o BMP 
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 3.1. JPEG File Formats ΓòÉΓòÉΓòÉ
  68.  
  69. The JPEG committee has not specified a standard file format, and consequently, 
  70. many applications of the JPEG algorithm use their own proprietary format. 
  71. PMJPEG uses the JPEG File Interchange Format(JFIF) which transports only pixel 
  72. information.  JFIF is supported by the IJPEG Group's software and other 
  73. programs based on their code. 
  74.  
  75. Handmade Software's GIF2JPG and Image Alchemy by default use a proprietary JPEG 
  76. format that is not compatible with the JFIF standard.  This proprietary format 
  77. is not supported by PMJPEG.  When you use GIF2JPG, remember to use the "-j" 
  78. option to produce a JPEG file that is compatible with the JFIF standard and 
  79. viewable with PMJPEG. 
  80.  
  81. However, the GIF2JPG's "-j" option doesn't always produce a file in JFIF.  If 
  82. you have to use a DOS converter,  we recommend that you use the IJPEG Group's 
  83. cjpeg program.  Otherwise, you should use PMJPEG's Batch Compression feature, 
  84. which performs the same task as cjpeg except that only GIF and TARGA images are 
  85. supported. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 3.2. Graphics Interchange Format (GIF) ΓòÉΓòÉΓòÉ
  89.  
  90. PMJPEG can view interlaced/non-interlaced GIF87a and GIF89a files.  If a GIF89a 
  91. file contains more than one image, it will display the first image in the file. 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 3.3. Targa ΓòÉΓòÉΓòÉ
  95.  
  96. PMJPEG can view uncompressed TARGA files stored with 8, 15, 16, 24, or 32 bits 
  97. per pixel. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 3.4. BMP ΓòÉΓòÉΓòÉ
  101.  
  102. PMJPEG can view OS/2 BMP or Windows BMP files. 
  103.  
  104.  
  105. ΓòÉΓòÉΓòÉ 4. Menu Commands ΓòÉΓòÉΓòÉ
  106.  
  107. The menus are ordered by the following main topics: 
  108.  
  109. o File Menu 
  110. o Edit Menu 
  111. o Options 
  112.  
  113.  
  114. ΓòÉΓòÉΓòÉ 4.1. File Menu ΓòÉΓòÉΓòÉ
  115.  
  116. The File menu includes commands that enable you to open and save files, to 
  117. batch convert files to JPEG, and to display multiple images in a selected 
  118. order. 
  119.  
  120. o Open 
  121. o Save All Options 
  122. o Delete 
  123. o Batch Compression 
  124. o Exit 
  125.  
  126.  
  127. ΓòÉΓòÉΓòÉ 4.1.1. File Open ΓòÉΓòÉΓòÉ
  128.  
  129. Select the name of a file to display. 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 4.1.2. Save All Options ΓòÉΓòÉΓòÉ
  133.  
  134. This will save all the PMJPEG options to a file named "pmjpeg.sav" in the same 
  135. directory as the PMJPEG executable.  When PMJPEG is initially loaded, the 
  136. options will be loaded if "pmjpeg.sav" exists. 
  137.  
  138.  
  139. ΓòÉΓòÉΓòÉ 4.1.3. Delete ΓòÉΓòÉΓòÉ
  140.  
  141. This menu command lets you delete the file containing the currently displayed 
  142. image.  PMJPEG will prompt you for confirmation before deleting the file. 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 4.1.4. Batch Compression ΓòÉΓòÉΓòÉ
  146.  
  147. Select GIF and TARGA files to compress to JPEG format with the options 
  148. specified in the JPEG Options dialog.  The list box on the left displays the 
  149. drives and the directories in the current path, the one in the middle displays 
  150. the files in the current path, and the one on the right displays a list of 
  151. files to be converted.  To add file(s) to the latter box, select the file(s) 
  152. you want to convert and press the Add button. 
  153.  
  154. The output file(s) will have the same name as the input file(s) except that 
  155. they will have a ".jpg" extension.  Also, the output file(s) will be placed in 
  156. the same directory path in which the input file(s) were located. 
  157.  
  158. See also JPEG Options. 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 4.1.5. Exit ΓòÉΓòÉΓòÉ
  162.  
  163. Exit from PMJPEG. 
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 4.2. Edit Menu ΓòÉΓòÉΓòÉ
  167.  
  168. The Edit menu includes commands that enable you to change the color components 
  169. of an image, and to manipulate the image. 
  170.  
  171. o HSV Adjustment 
  172. o Color Balance 
  173. o Rotate 
  174. o Flip Horizontal 
  175. o Flip Vertical 
  176.  
  177.  
  178. ΓòÉΓòÉΓòÉ 4.2.1. HSV Adjustment ΓòÉΓòÉΓòÉ
  179.  
  180. Use the scroll bars to adjust the amount of hue, saturation, and 
  181. value/brightness in an image.  A value of 0 on the scroll bar means that there 
  182. is no change in the corresponding color component. When the value is increased 
  183. or decreased, the color component is increased or decreased, respectively. 
  184. Warning: the HSV calculations are very slow in 24-bit mode. 
  185.  
  186.  
  187. ΓòÉΓòÉΓòÉ 4.2.2. Color Balance ΓòÉΓòÉΓòÉ
  188.  
  189. Use the scroll bars to adjust the amount of red, green, and blue in an image. 
  190. A value of 0 on the scroll bar means that there is no change in the 
  191. corresponding color component.  When the value is increased or decreased, the 
  192. color component is increased or decreased, respectively. 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 4.2.3. Rotate ΓòÉΓòÉΓòÉ
  196.  
  197. Rotate the image clockwise by 90 degrees. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 4.2.4. Flip Horizontal ΓòÉΓòÉΓòÉ
  201.  
  202. Flip the image around the vertical axis. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 4.2.5. Flip Vertical ΓòÉΓòÉΓòÉ
  206.  
  207. Flip the image around the horizontal axis. 
  208.  
  209.  
  210. ΓòÉΓòÉΓòÉ 4.3. Options Menu ΓòÉΓòÉΓòÉ
  211.  
  212. The Options menu includes commands that let you determine how other commands 
  213. operate. The settings for the options can be saved with the Save All Options 
  214. command. 
  215.  
  216. o JPEG Options 
  217.  
  218.  
  219. ΓòÉΓòÉΓòÉ 4.3.1. JPEG Options ΓòÉΓòÉΓòÉ
  220.  
  221. 2-pass(Heckbert) quantization produces better looking output than 1-pass 
  222. quantization and it is slower.  Also, 2-pass quantization uses more memory so 
  223. it may be even slower because PMJPEG will swap to hard disk when it runs out of 
  224. virtual memory.  The output of 1-pass generally looks more grainy. 
  225.  
  226. Dithering uses available colors in a palette to simulate additional colors. 
  227. The dithering method that PMJPEG uses is called Floyd-Steinberg Dithering. 
  228. Dithering is useful when quantizing to 256 colors or less but it is not needed 
  229. for a true-color (24-bit) display.  You may want to turn off dithering since it 
  230. sometimes causes a grainy output image. 
  231.  
  232. The Quality Factor, an integer between 0 and 100 inclusive, determines the 
  233. tradeoff between the output file size and the output image quality.  If you 
  234. choose a high quality factor, the image quality will be high but the file size 
  235. will be large.  A lower quality setting will yield a smaller file at a cost of 
  236. lower fidelity.  Since the JPEG algorithm is lossy, a quality factor of 100 
  237. will not give you a losslessly compressed image. 
  238.  
  239. The Smoothing Factor, also an integer between 0 and 100 inclusive, determines 
  240. the degree of smoothing to apply to an image before compressing that image with 
  241. JPEG.  The higher you set the factor, the higher the degree of smoothing that 
  242. is applied.  A smoothing factor of 0 means that no smoothing is performed. 
  243. Smoothing removes noise introduced when an image is dithered, and, in turn, 
  244. smoothing produces a smaller JPEG file.  It should be used for only dithered 
  245. images, like photographic GIF pictures.  Generally, a factor between 10 and 50 
  246. removes the dithering noise from an image. 
  247.  
  248. Entropy Optimization produces a smaller JPEG file but it takes more time to 
  249. encode the image. 
  250.  
  251. If PMJPEG runs out of virtual memory while it is decoding/encoding JPEG files, 
  252. it will use temporary files that are created in the specified path. 
  253.  
  254.  
  255. ΓòÉΓòÉΓòÉ 5. Reporting Bugs ΓòÉΓòÉΓòÉ
  256.  
  257. If you find a bug in PMJPEG, we would appreciate it if you would inform us of 
  258. the bug through one of our e-mail accounts: 
  259.  
  260.   Norman Yee 
  261.   nyee@osiris.ee.tufts.edu 
  262.  
  263.   Ken Yee 
  264.   kenyee@ksr.com 
  265.  
  266. When you send us a bug report, include a description of the procedure for 
  267. reproducing the bug and a description of your system configuration(hardware and 
  268. software). 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 6. Disclaimer ΓòÉΓòÉΓòÉ
  272.  
  273. The authors of this program accept no responsibility for damages that are 
  274. caused by this program and make NO WARRANTY or representation, either express 
  275. or implied, with respect to this software.  This software is provided "AS IS," 
  276. and you, its user, assume the entire risk when you use it. 
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ 7. Acknowledgments ΓòÉΓòÉΓòÉ
  280.  
  281. PMJPEG is based in part on the work of the Independent JPEG Group. 
  282.  
  283. Windows is a trademark of Microsoft Corporation. 
  284.  
  285. OS/2 is a trademark of International Business Machines Corporation. 
  286.  
  287. The Graphics Interchange Format(c) is the Copyright property of CompuServe 
  288. Incorporated.  GIF(sm) is a Service Mark property of CompuServe Incorporated. 
  289.  
  290. WinJPEG is copyright (C) 1992, 1993, Norman Yee and Ken Yee.  All rights 
  291. reserved. 
  292.  
  293. PMJPEG is copyright (C) 1993, Norman Yee and Ken Yee.  All rights reserved.