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.4 has the following features:
- display JPEG, TIFF, Targa, GIF, PCX, Windows BMP, or OS/2 BMP images
- export an image to JPEG, TIFF, Targa, GIF, PCX, Windows BMP, or OS/2 BMP
- capability of generating OS/2 desktop-background bitmaps that use
the system colors
- display an image in 16 color, 256 color, 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
- contrast enhancement
- gamma correction
- image rotation, vertical or horizontal flip, and image resizing
- image cropping
- batch file compression of GIF, TIFF, or Targa files to JPEG File
Interchange Format
- copy an image to the clipboard or paste an image from the clipboard
- slideshow: display selected files sequentially with a cycle option
- image buffering in a cyclic slideshow
- 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.42
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 2 720k 3 1/2" floppies, 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. MA 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.

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.3. Compuserve users may find it less
expensive to receive PMJPEG via U.S. Mail.

Registrations with the incorrect fee or with non-US currency will be
returned.

To register, complete the order form and send a check drawn from a US
bank to:

Norman Yee
58 Chandler St.
Boston, MA 02116

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
[email protected]

Ken Yee
[email protected]

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 Sam Leffler
Copyright (c) 1991, 1992 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, 1993, Norman Yee and Ken Yee. All rights
reserved.

PMJPEG is copyright (C) 1993, Norman Yee and Ken Yee. All rights
reserved.