115 lines
2.8 KiB
Groff
115 lines
2.8 KiB
Groff
.TH DJPEG 1 "11 December 1991"
|
|
.SH NAME
|
|
djpeg \- decompress a JPEG file to an image file
|
|
.SH SYNOPSIS
|
|
.B djpeg
|
|
[
|
|
.B \-GPRTbgD2d
|
|
]
|
|
[
|
|
.BI \-q " N"
|
|
]
|
|
[
|
|
.I filename
|
|
]
|
|
.LP
|
|
.SH DESCRIPTION
|
|
.LP
|
|
.B djpeg
|
|
decompresses the named JPEG file, or the standard input if no file is named,
|
|
and produces an image file on the standard output. PPM, GIF, Targa, or RLE
|
|
output format can be selected. (RLE is supported only if the URT library is
|
|
available.)
|
|
.LP
|
|
The color quantization algorithm is currently shoddy. Because of this, the
|
|
GIF output mode is not recommended in the current release, except for
|
|
gray-scale output (obtained with
|
|
.BR \-g ).
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-G
|
|
Select GIF output format (implies
|
|
.BR \-q ,
|
|
with default of 256 colors).
|
|
Currently the color quantization uses a shoddy algorithm and external
|
|
quantization (e.g.
|
|
.IR ppmquant ,
|
|
.IR rlequant )
|
|
is recommended before conversion to GIF format.
|
|
.TP
|
|
.B \-P
|
|
Select PPM or PGM output format (this is the default). PGM is emitted if the
|
|
JPEG file is gray-scale or if
|
|
.B \-g
|
|
is specified.
|
|
.TP
|
|
.B \-R
|
|
Select RLE output format. Requires URT library.
|
|
.TP
|
|
.B \-T
|
|
Select Targa output format. Gray-scale format is emitted if the JPEG file is
|
|
gray-scale or if
|
|
.B \-g
|
|
is specified; otherwise, colormapped format is emitted if
|
|
.B \-q
|
|
is specified; otherwise, 24-bit full-color format is emitted.
|
|
.TP
|
|
.B \-b
|
|
Perform cross-block smoothing. This is quite memory-intensive and only seems
|
|
to improve the image at low quality settings (\fB\-Q\fR 10 to 20 or so).
|
|
At normal
|
|
.B \-Q
|
|
settings it may make the image worse.
|
|
.TP
|
|
.B \-g
|
|
Force gray-scale output even if input is color.
|
|
.TP
|
|
.BI \-q " N"
|
|
Quantize to N colors.
|
|
.TP
|
|
.B \-D
|
|
Do not use dithering in color quantization. By default, Floyd-Steinberg
|
|
dithering is applied when quantizing colors, but on some images dithering may
|
|
result in objectionable "graininess". If that happens, you can turn off
|
|
dithering with
|
|
.BR \-D .
|
|
.TP
|
|
.B \-2
|
|
Use two-pass color quantization (not yet supported).
|
|
.TP
|
|
.B \-d
|
|
Enable debug printout. More
|
|
.BR \-d 's
|
|
give more output. Also, version information is printed at startup.
|
|
.SH EXAMPLES
|
|
.LP
|
|
This example decompresses the JPEG file foo.jpg and saves the output
|
|
as a gray-scale image in foo.pgm:
|
|
.IP
|
|
.B djpeg \-g
|
|
.I foo.jpg
|
|
.B >
|
|
.I foo.pgm
|
|
.SH SEE ALSO
|
|
.BR cjpeg (1)
|
|
.br
|
|
.BR ppmquant (1)
|
|
[From the PBMplus distribution]
|
|
.br
|
|
.BR rlequant (1)
|
|
[From the Utah Raster Toolkit distribution]
|
|
.br
|
|
Wallace, Gregory K. "The JPEG Still Picture Compression Standard",
|
|
Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44.
|
|
.SH AUTHOR
|
|
Independent JPEG Group
|
|
.SH BUGS
|
|
.B djpeg
|
|
currently uses a shoddy color quantization algorithm. This leads to
|
|
poor GIF file output. Two-pass color quantization is not yet
|
|
supported.
|
|
.PP
|
|
Arithmetic coding is not supported for legal reasons.
|
|
.PP
|
|
Not as fast as we'd like.
|