INTRODUCTION
PMJPEG is a shareware image viewer with image processing and conversion
capabilities for OS/2 2.x. PMJPEG is a port of WinJPEG to OS/2 2.x. It is
a native 32-bit PM application.
PMJPEG v.1.63 has the following features:
- display JPEG, TIFF, GIF, Targa, PCX, Windows BMP, OS/2 BMP, or PPM images
- export an image to JPEG, TIFF, GIF, Targa, PCX, Windows BMP, OS/2 BMP,
or PPM format
- capability of generating OS/2 desktop-background bitmaps that use
the system colors
- display an image in monochrome, 16 color, 256 color, hicolor, or
truecolor display modes
- display an image in full screen mode
- print an image with scaling, best proportional fit on the page, or
fit for full page
- red/green/blue or hue/saturation/brightness adjustment
- color to grayscale conversion or image negative conversion
- contrast enhancement
- gamma correction
- image rotation, vertical or horizontal flip, image resizing, and
image cropping
- batch file compression of GIF, TIFF, Targa, or PPM files to JPEG File Interchange Format
- copy an image to the clipboard or paste an image from the clipboard
- slideshow: display selected files in forward, reverse, or random
order with a cycle option
- image buffering in a cyclic slideshow
- capture a window, the client area of a window, or a portion of or
the entire desktop
- support for file name extension association and starting a slideshow
from the command line
CONTENTS OF ARCHIVE
The following files are contained in this archive:
order.frm - PMJPEG order form
pmjpeg.hlp - PMJPEG online help
pmjpeg.exe - PMJPEG v.1.63
readme.1st - this file
whats.new - changes from previous versions
KNOWN PROBLEMS
There are two bugs in the 256 color ET4000 driver that comes with the
OS/2 2.1 beta or OS/2 2.0 + Service Pack: 1) the driver does not stretch
the bitmap correctly so the Stretch to Fit Window option does not work
properly, and 2) the image under the dialog box or under the drop-down
menu is not re-drawn with the right colors. Use the Auto-Refresh option
if you have the second problem.
If you are using the 256 color ET4000 driver, for certain images such as
24-bit images displayed with Maximum Color Depth set to 256 colors, the
text that shows the cropping dimensions is garbled by a filled box.
This appears to be a bug in OS/2's palette manager or the driver.
If you are using a 256 color driver, when you exit PMJPEG, the system
colors do not immediately return to normal. The system colors are
gradually restored by OS/2. You can force the colors to change back by
opening and/or closing a window, such as the window list that pops up
when you hit CTL-ESC.
DISTRIBUTION CONDITIONS
You are free to distribute this shareware version of PMJPEG as long as the
following conditions are met:
1) The distributed archive must contain ONLY the files listed above.
2) The contents of this archive are NOT MODIFIED in any way.
3) This version is not to be sold. However, a reasonable disk copying fee
is permitted.
4) This version is not to be bundled with a commercially sold package
without permission from the authors.
HOW TO REGISTER
If you use PMJPEG for more than 14 days, you are expected to register
PMJPEG. When you register, you will receive the latest version of
PMJPEG, a user manual, and a collection of JPEG images (we will put as
many as we can fit on 1 1.44M 3 1/2" floppy or on 4 360k 5 1/4"
floppies). Also, the registered version does not have the
reminder-to-register screen at the start.
The registration fee is only $20. Massachusetts residents, add 5% sales
tax to the registration fee. US residents, add $4 for shipping and
handling; non-US residents, add $8 for shipping and handling. If you
want PMJPEG e-mailed to your account instead of having it physically
mailed to you, there is no extra shipping charge. If you are paying
with a Visa or MasterCard, add 10% to this subtotal. The 10% is the
processing fee that we get charged for credit card transactions.
Updates are free but the shipping charge described above applies to
updates. Users who register PMJPEG and provide an e-mail address will
automatically receive updates via e-mail.
For e-mail registrations, you need to use a program called "uudecode" to
decode the uuencoded file that we e-mail to you. For your information,
a uuencoded file is a binary file that is converted to text by a program
called "uuencode". If your mail system rejects large messages, we will
split the uuencoded file into smaller parts before mailing the parts to
you, and you will need to edit the messages with a text editor before
you can decode them. Compuserve, for example, does not permit large
e-mail messages. Also, the uuencoded file is rather large; it is
approximately 300k for PMJPEG v.1.6. Compuserve users may find it less
expensive to receive PMJPEG via U.S. Mail.
Registrations with the incorrect fee, non-US currency, or drawn on a
non-US bank will be returned.
To register, complete the order and send payment to:
Norman Yee
58 Chandler St.
Boston, MA 02116
U.S.A.
Registration of PMJPEG is based on "personal usage." Corporate or
organizational users must register all copies used on an individual
basis; a specific person (name) must be explicitly assigned to each
registrant who will be provided with a personalized copy of PMJPEG.
Registration grants a specific person (not an organization or corporate
entity) the right to use PMJPEG.
Although we will try to mail your copy of PMJPEG 1-3 weeks after we
receive your registration, please allow up to 4-6 weeks for delivery.
REPORTING BUGS
If you find a bug in PMJPEG, we would appreciate it if you would inform
us of the bug through one of our e-mail accounts:
Norman Yee
nyee@osiris.ee.tufts.edu
Ken Yee
kenyee@ksr.com
When you send us a bug report, include a description of the procedure
for reproducing the bug and a description of your system
configuration(hardware and software).
DISCLAIMER
The authors of this program accept no responsibility for damages that
are caused by this program and make NO WARRANTY or representation,
either express or implied, with respect to this software. This software
is provided "AS IS," and you, its user, assume the entire risk when you
use it.
ACKNOWLEDGMENTS
PMJPEG is based in part on the work of the Independent JPEG Group.
TIFF support in WinJPEG is based in part on Sam Leffler's TIFF library.
Windows is a trademark of Microsoft Corporation.
OS/2 is a trademark of International Business Machines Corporation.
The Graphics Interchange Format(c) is the Copyright property of
CompuServe Incorporated. GIF(sm) is a Service Mark property of
CompuServe Incorporated.
COPYRIGHT NOTICE FOR SAM LEFFLER's TIFF LIBRARY
Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994 Sam Leffler
Copyright (c) 1991, 1992, 1993, 1994 Silicon Graphics, Inc.
Permission to use, copy, modify, distribute, and sell this software and
its documentation for any purpose is hereby granted without fee,
provided that (i) the above copyright notices and this permission notice
appear in all copies of the software and related documentation, and (ii)
the names of Sam Leffler and Silicon Graphics may not be used in any
advertising or publicity relating to the software without the specific,
prior written permission of Sam Leffler and Silicon Graphics.
WinJPEG is Copyright (C) 1992-1994, Norman Yee and Ken Yee. All rights
reserved.
PMJPEG is Copyright (C) 1993, 1994, Norman Yee and Ken Yee. All rights
reserved.
*** v. 1.63 Changes ***
- Bug fix:
o PMJPEG run from the OS/2 command line would not correctly load a
file which wasn't specified with a full path.
*** v. 1.62 Changes ***
- Bug fix:
o The cbSize field of OS/2 bitmaps created by PMJPEG was not correct.
*** v. 1.61 Changes ***
- Reading GIF files is slightly faster.
- Bug fixes:
o If you were saving from the OS/2 common dialog and a directory
wasn't highlighted, PMJPEG did not ask you if you want to overwrite
an existing file.
o When you deleted a file that is in the recently used file list, it
wasn't removed. Thanks to M.Hulskamp for pointing out these bugs.
o The PMJPEG file dialogs didn't let you use a filename that is
longer than 32 characters. Thanks to M.Zimmerman for pointing
out the bug.
o When you selected a recently used directory and file format
from the menu, the directory would not be correctly set in the
PMJPEG open file dialog.
o If an edited image wasn't saved and you selected Slideshow,
you would not be prompted to save the image.
o A random cycled slideshow showed the same image several times
before showing a different image.
*** v. 1.60 Changes ***
- Added the ability to set the priority of all the threads besides the
main one.
- Added an option of using the OS/2 standard file dialogs or the PMJPEG
dialogs.
- Added support for saving 1-bit and 4-bit TIFF files. TIFF's can be
optionally compressed with Packbits.
- Added support for saving 1-bit and 4-bit PCX files.
- Added support for saving 1-bit and 4-bit(RLE or uncompressed) bitmaps.
- Added support for saving grayscale JPEG, TIFF, Targa, and PPM files.
- Added capability of buffering most recently used file names and directories.
- Improved output image quality when a 24-bit image is saved to a GIF file.
- Improved the memory manager.
*** v. 1.50 Changes ***
- Added screen capture functions. You can capture any window, the
client area of a window, the entire desktop, or a portion of the
desktop.
- Added capability of displaying a slideshow in reverse or random order.
- Added support for loading/saving/compressing PPM files.
- Added ability of starting a command-line slideshow with a wildcard
in the filename. For example, typing
pmjpeg c:\pics\*.jpg c:\pics\sample?.gif
from the OS/2 command line will display all .jpg files and all
sample?.gif files in c:\pics.
- Added Negative feature.
- Added "Window" options. Moved "Move Window after Load" option to
Window options dialog.
- Added "Keep Aspect Ratio if Stretched" option.
- Added "Suppress Warnings" option.
- Added keyboard accelerators for Delete, Copy, Paste, and scrolling an
image.
- Bug fix: Corrupted JPEG's would crash PMJPEG.
- Bug fix: Trying to close PMJPEG while PMJPEG was loading/saving didn't
work.
*** v. 1.43 Changes ***
- Added support for displaying images in monochrome and hicolor display
modes.
- Loading PCX files is faster.
- Cropping of a stretched image is now possible.
- Fixed the copy/paste functions so that they support palettes.
- Fixed a bug in reading v.2.8 PCX files without a palette.
- Fixed a bug in reading PCX files. Thanks to K.Griepenkerl and O.Lefevre
for pointing out the bugs and providing sample files.
- Fixed a bug in reading bitmaps with an incorrect bitmap size field.
Thanks to O.Zander for pointing out the bug.
- Fixed a bug in saving images after a 1- or 4-bit bitmap is pasted
into PMJPEG. Thanks to T. Hellerhoff for pointing out the bug.
- Fixed a bug in displaying 24-bit TIFFs on a display driver that
supports <15 bits.
*** v. 1.42 Changes ***
- Added the fullscreen display option and fullscreen slideshows.
- Reduced the amount of memory needed for saving RLE8 and RLE24 bitmaps.
- Bad files in a slideshow are now eliminated from a cyclic slideshow and
the next image is loaded immediately.
- Bug fix: If you didn't have a printer installed, PMJPEG would beep
and exit immediately after you run it.
- Bug fix: If you loaded a non-JPEG 24-bit image with Maximum Color
Depth set to 256 or 16 colors, editing or saving the image would crash
PMJPEG.
- Bug fix: Sometimes, when you edit the HSV of an 8-bit image, the
palette would not change immediately.
*** v. 1.41 Changes ***
- PMJPEG warns you about changes in the image and lets you save the
changes before you exit or load another image.
- Bug fix: Grayscale Targa's loads ok this time.
*** v. 1.40 Changes ***
- Added support for displaying images in 16 color mode. Replaced the
8-bit Bitmap option with Maximum Color Depth option. When viewing
images, set Maximum Color Depth to the number of colors supported by
your OS/2 display driver. When converting images from one format to
another, set it to 16.7 Million colors.
- Added support for 4 color TIFF images and NeXT TIFF compressed images.
- Added image printing capability.
- Added gamma correction feature.
- Added Stretch to Fit Window option.
- 24-bit images quantized to 256 colors look much better(less grainy).
- Map To System Colors is much faster.
- Slider scales are expanded and the slider values are displayed.
- Bug fixes:
o PMJPEG did not read TIFF FAX3 files unless 8-bit Bitmap is on.
Thanks to R. Falkner for pointing it out.
o Bi-level TIFF images were displayed with black and gray
colors instead of black and white. Thanks to R. Pasco for pointing
out the bug.
o Run-length encoded RGB Targas were not quantized to 256 colors if
you had the 8-bit Bitmap option on.
o Grayscale Targa's would not load.
*** v. 1.31 Changes ***
- Bug fix: If the progress is displayed in the title bar, the progress
dialog would appear when you restore the window after minimizing it.
Thanks to M. Brown for pointing the bug out.
- Bug fix: When you click with the left mouse button on the PMJPEG
window during a slideshow, it would incorrectly advance to the next
image in the slideshow.
- Bug fix: If the window was minimized to an icon, the icon would be
resized to the image size after an image is loaded.
- Fixed a bug in reading RLE4 bitmaps.
*** v. 1.30 Changes ***
- Added Map to System Colors feature. This feature is useful for making
256-color bitmaps that can be displayed as an OS/2 desktop background
picture with the system colors. Thanks to S. Lacy for his help.
- Added Crop feature.
- Added Paste feature.
- Progress can be displayed in either a dialog box or the title bar.
- Added capability for buffering selected image file formats during a
cyclic slideshow. Thanks to S. Hiles for his suggestions.
- HSV Adjustment is much faster.
- Saving all types of BMP's is much faster.
- The window position is now saved when you save the options. Thanks to
A. Dhir for the suggestion.
- Bug fix: PMJPEG would load/save OS/2 2.0 bitmaps incorrectly.
- Bug fix: If you saved to an 8-bit PCX file, PMJPEG would hang until
you closed the progress dialog.
- Bug fix: After a slideshow with only one image, PMJPEG would wait
until the delay elapsed before re-activating menu items.
- Bug fix: Cancelling an image save prevents subsequent save's and load's.
*** v. 1.20 Changes ***
- Added Resize feature.
- Added Grayscale feature.
- Added Copy to clipboard feature.
- Added Auto-Refresh option.
- Loading PCX files is slightly faster.
- Loading TIFF files is slightly faster.
- Fixed a bug in reading 1-bit PCX files. Thanks to B. Ferrell
for pointing out this bug.
- Fixed the following bug in the open dialog: ".*" extension would be
incorrectly added to a selected filename if the "All Files" File Type
is chosen
*** v. 1.10 Changes ***
- Added PCX support.
- Progress dialog is now modeless.
- Added "Display Old Image during Load" option which lets you view the
currently displayed image while loading a different image.
- Added "Move Window after Load" option.
- Fixed bug in loading OS/2 1.x bitmaps. Thanks to Y. Yeargan for
pointing out the bug.
- Fixed bug in adjusting contrast, RGB, or HSV in 24-bit images
*** v. 1.00 Changes ***
- Added all planned v.1.0 features.
- Much faster version.
- Replaced open dialog.
- Slideshow can be started with file list from command line.
- Fixed image display bug that occurs when the window height is greater
than the image's height.