aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1
diff options
context:
space:
mode:
authorDavid Walter Seikel2013-01-13 18:54:10 +1000
committerDavid Walter Seikel2013-01-13 18:54:10 +1000
commit959831f4ef5a3e797f576c3de08cd65032c997ad (patch)
treee7351908be5995f0b325b2ebeaa02d5a34b82583 /libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1
parentAdd info about changes to Irrlicht. (diff)
downloadSledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.zip
SledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.tar.gz
SledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.tar.bz2
SledjHamr-959831f4ef5a3e797f576c3de08cd65032c997ad.tar.xz
Remove damned ancient DOS line endings from Irrlicht. Hopefully I did not go overboard.
Diffstat (limited to 'libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1')
-rw-r--r--libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1504
1 files changed, 252 insertions, 252 deletions
diff --git a/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1 b/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1
index 9f7038f..f3722d1 100644
--- a/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1
+++ b/libraries/irrlicht-1.8/source/Irrlicht/jpeglib/djpeg.1
@@ -1,252 +1,252 @@
1.TH DJPEG 1 "3 October 2009" 1.TH DJPEG 1 "3 October 2009"
2.SH NAME 2.SH NAME
3djpeg \- decompress a JPEG file to an image file 3djpeg \- decompress a JPEG file to an image file
4.SH SYNOPSIS 4.SH SYNOPSIS
5.B djpeg 5.B djpeg
6[ 6[
7.I options 7.I options
8] 8]
9[ 9[
10.I filename 10.I filename
11] 11]
12.LP 12.LP
13.SH DESCRIPTION 13.SH DESCRIPTION
14.LP 14.LP
15.B djpeg 15.B djpeg
16decompresses the named JPEG file, or the standard input if no file is named, 16decompresses the named JPEG file, or the standard input if no file is named,
17and produces an image file on the standard output. PBMPLUS (PPM/PGM), BMP, 17and produces an image file on the standard output. PBMPLUS (PPM/PGM), BMP,
18GIF, Targa, or RLE (Utah Raster Toolkit) output format can be selected. 18GIF, Targa, or RLE (Utah Raster Toolkit) output format can be selected.
19(RLE is supported only if the URT library is available.) 19(RLE is supported only if the URT library is available.)
20.SH OPTIONS 20.SH OPTIONS
21All switch names may be abbreviated; for example, 21All switch names may be abbreviated; for example,
22.B \-grayscale 22.B \-grayscale
23may be written 23may be written
24.B \-gray 24.B \-gray
25or 25or
26.BR \-gr . 26.BR \-gr .
27Most of the "basic" switches can be abbreviated to as little as one letter. 27Most of the "basic" switches can be abbreviated to as little as one letter.
28Upper and lower case are equivalent (thus 28Upper and lower case are equivalent (thus
29.B \-BMP 29.B \-BMP
30is the same as 30is the same as
31.BR \-bmp ). 31.BR \-bmp ).
32British spellings are also accepted (e.g., 32British spellings are also accepted (e.g.,
33.BR \-greyscale ), 33.BR \-greyscale ),
34though for brevity these are not mentioned below. 34though for brevity these are not mentioned below.
35.PP 35.PP
36The basic switches are: 36The basic switches are:
37.TP 37.TP
38.BI \-colors " N" 38.BI \-colors " N"
39Reduce image to at most N colors. This reduces the number of colors used in 39Reduce image to at most N colors. This reduces the number of colors used in
40the output image, so that it can be displayed on a colormapped display or 40the output image, so that it can be displayed on a colormapped display or
41stored in a colormapped file format. For example, if you have an 8-bit 41stored in a colormapped file format. For example, if you have an 8-bit
42display, you'd need to reduce to 256 or fewer colors. 42display, you'd need to reduce to 256 or fewer colors.
43.TP 43.TP
44.BI \-quantize " N" 44.BI \-quantize " N"
45Same as 45Same as
46.BR \-colors . 46.BR \-colors .
47.B \-colors 47.B \-colors
48is the recommended name, 48is the recommended name,
49.B \-quantize 49.B \-quantize
50is provided only for backwards compatibility. 50is provided only for backwards compatibility.
51.TP 51.TP
52.B \-fast 52.B \-fast
53Select recommended processing options for fast, low quality output. (The 53Select recommended processing options for fast, low quality output. (The
54default options are chosen for highest quality output.) Currently, this is 54default options are chosen for highest quality output.) Currently, this is
55equivalent to \fB\-dct fast \-nosmooth \-onepass \-dither ordered\fR. 55equivalent to \fB\-dct fast \-nosmooth \-onepass \-dither ordered\fR.
56.TP 56.TP
57.B \-grayscale 57.B \-grayscale
58Force gray-scale output even if JPEG file is color. Useful for viewing on 58Force gray-scale output even if JPEG file is color. Useful for viewing on
59monochrome displays; also, 59monochrome displays; also,
60.B djpeg 60.B djpeg
61runs noticeably faster in this mode. 61runs noticeably faster in this mode.
62.TP 62.TP
63.BI \-scale " M/N" 63.BI \-scale " M/N"
64Scale the output image by a factor M/N. Currently supported scale factors are 64Scale the output image by a factor M/N. Currently supported scale factors are
65M/N with all M from 1 to 16, where N is the source DCT size, which is 8 for 65M/N with all M from 1 to 16, where N is the source DCT size, which is 8 for
66baseline JPEG. If the /N part is omitted, then M specifies the DCT scaled 66baseline JPEG. If the /N part is omitted, then M specifies the DCT scaled
67size to be applied on the given input. For baseline JPEG this is equivalent 67size to be applied on the given input. For baseline JPEG this is equivalent
68to M/8 scaling, since the source DCT size for baseline JPEG is 8. 68to M/8 scaling, since the source DCT size for baseline JPEG is 8.
69Scaling is handy if the image is larger than your screen; also, 69Scaling is handy if the image is larger than your screen; also,
70.B djpeg 70.B djpeg
71runs much faster when scaling down the output. 71runs much faster when scaling down the output.
72.TP 72.TP
73.B \-bmp 73.B \-bmp
74Select BMP output format (Windows flavor). 8-bit colormapped format is 74Select BMP output format (Windows flavor). 8-bit colormapped format is
75emitted if 75emitted if
76.B \-colors 76.B \-colors
77or 77or
78.B \-grayscale 78.B \-grayscale
79is specified, or if the JPEG file is gray-scale; otherwise, 24-bit full-color 79is specified, or if the JPEG file is gray-scale; otherwise, 24-bit full-color
80format is emitted. 80format is emitted.
81.TP 81.TP
82.B \-gif 82.B \-gif
83Select GIF output format. Since GIF does not support more than 256 colors, 83Select GIF output format. Since GIF does not support more than 256 colors,
84.B \-colors 256 84.B \-colors 256
85is assumed (unless you specify a smaller number of colors). 85is assumed (unless you specify a smaller number of colors).
86.TP 86.TP
87.B \-os2 87.B \-os2
88Select BMP output format (OS/2 1.x flavor). 8-bit colormapped format is 88Select BMP output format (OS/2 1.x flavor). 8-bit colormapped format is
89emitted if 89emitted if
90.B \-colors 90.B \-colors
91or 91or
92.B \-grayscale 92.B \-grayscale
93is specified, or if the JPEG file is gray-scale; otherwise, 24-bit full-color 93is specified, or if the JPEG file is gray-scale; otherwise, 24-bit full-color
94format is emitted. 94format is emitted.
95.TP 95.TP
96.B \-pnm 96.B \-pnm
97Select PBMPLUS (PPM/PGM) output format (this is the default format). 97Select PBMPLUS (PPM/PGM) output format (this is the default format).
98PGM is emitted if the JPEG file is gray-scale or if 98PGM is emitted if the JPEG file is gray-scale or if
99.B \-grayscale 99.B \-grayscale
100is specified; otherwise PPM is emitted. 100is specified; otherwise PPM is emitted.
101.TP 101.TP
102.B \-rle 102.B \-rle
103Select RLE output format. (Requires URT library.) 103Select RLE output format. (Requires URT library.)
104.TP 104.TP
105.B \-targa 105.B \-targa
106Select Targa output format. Gray-scale format is emitted if the JPEG file is 106Select Targa output format. Gray-scale format is emitted if the JPEG file is
107gray-scale or if 107gray-scale or if
108.B \-grayscale 108.B \-grayscale
109is specified; otherwise, colormapped format is emitted if 109is specified; otherwise, colormapped format is emitted if
110.B \-colors 110.B \-colors
111is specified; otherwise, 24-bit full-color format is emitted. 111is specified; otherwise, 24-bit full-color format is emitted.
112.PP 112.PP
113Switches for advanced users: 113Switches for advanced users:
114.TP 114.TP
115.B \-dct int 115.B \-dct int
116Use integer DCT method (default). 116Use integer DCT method (default).
117.TP 117.TP
118.B \-dct fast 118.B \-dct fast
119Use fast integer DCT (less accurate). 119Use fast integer DCT (less accurate).
120.TP 120.TP
121.B \-dct float 121.B \-dct float
122Use floating-point DCT method. 122Use floating-point DCT method.
123The float method is very slightly more accurate than the int method, but is 123The float method is very slightly more accurate than the int method, but is
124much slower unless your machine has very fast floating-point hardware. Also 124much slower unless your machine has very fast floating-point hardware. Also
125note that results of the floating-point method may vary slightly across 125note that results of the floating-point method may vary slightly across
126machines, while the integer methods should give the same results everywhere. 126machines, while the integer methods should give the same results everywhere.
127The fast integer method is much less accurate than the other two. 127The fast integer method is much less accurate than the other two.
128.TP 128.TP
129.B \-dither fs 129.B \-dither fs
130Use Floyd-Steinberg dithering in color quantization. 130Use Floyd-Steinberg dithering in color quantization.
131.TP 131.TP
132.B \-dither ordered 132.B \-dither ordered
133Use ordered dithering in color quantization. 133Use ordered dithering in color quantization.
134.TP 134.TP
135.B \-dither none 135.B \-dither none
136Do not use dithering in color quantization. 136Do not use dithering in color quantization.
137By default, Floyd-Steinberg dithering is applied when quantizing colors; this 137By default, Floyd-Steinberg dithering is applied when quantizing colors; this
138is slow but usually produces the best results. Ordered dither is a compromise 138is slow but usually produces the best results. Ordered dither is a compromise
139between speed and quality; no dithering is fast but usually looks awful. Note 139between speed and quality; no dithering is fast but usually looks awful. Note
140that these switches have no effect unless color quantization is being done. 140that these switches have no effect unless color quantization is being done.
141Ordered dither is only available in 141Ordered dither is only available in
142.B \-onepass 142.B \-onepass
143mode. 143mode.
144.TP 144.TP
145.BI \-map " file" 145.BI \-map " file"
146Quantize to the colors used in the specified image file. This is useful for 146Quantize to the colors used in the specified image file. This is useful for
147producing multiple files with identical color maps, or for forcing a 147producing multiple files with identical color maps, or for forcing a
148predefined set of colors to be used. The 148predefined set of colors to be used. The
149.I file 149.I file
150must be a GIF or PPM file. This option overrides 150must be a GIF or PPM file. This option overrides
151.B \-colors 151.B \-colors
152and 152and
153.BR \-onepass . 153.BR \-onepass .
154.TP 154.TP
155.B \-nosmooth 155.B \-nosmooth
156Don't use high-quality upsampling. 156Don't use high-quality upsampling.
157.TP 157.TP
158.B \-onepass 158.B \-onepass
159Use one-pass instead of two-pass color quantization. The one-pass method is 159Use one-pass instead of two-pass color quantization. The one-pass method is
160faster and needs less memory, but it produces a lower-quality image. 160faster and needs less memory, but it produces a lower-quality image.
161.B \-onepass 161.B \-onepass
162is ignored unless you also say 162is ignored unless you also say
163.B \-colors 163.B \-colors
164.IR N . 164.IR N .
165Also, the one-pass method is always used for gray-scale output (the two-pass 165Also, the one-pass method is always used for gray-scale output (the two-pass
166method is no improvement then). 166method is no improvement then).
167.TP 167.TP
168.BI \-maxmemory " N" 168.BI \-maxmemory " N"
169Set limit for amount of memory to use in processing large images. Value is 169Set limit for amount of memory to use in processing large images. Value is
170in thousands of bytes, or millions of bytes if "M" is attached to the 170in thousands of bytes, or millions of bytes if "M" is attached to the
171number. For example, 171number. For example,
172.B \-max 4m 172.B \-max 4m
173selects 4000000 bytes. If more space is needed, temporary files will be used. 173selects 4000000 bytes. If more space is needed, temporary files will be used.
174.TP 174.TP
175.BI \-outfile " name" 175.BI \-outfile " name"
176Send output image to the named file, not to standard output. 176Send output image to the named file, not to standard output.
177.TP 177.TP
178.B \-verbose 178.B \-verbose
179Enable debug printout. More 179Enable debug printout. More
180.BR \-v 's 180.BR \-v 's
181give more output. Also, version information is printed at startup. 181give more output. Also, version information is printed at startup.
182.TP 182.TP
183.B \-debug 183.B \-debug
184Same as 184Same as
185.BR \-verbose . 185.BR \-verbose .
186.SH EXAMPLES 186.SH EXAMPLES
187.LP 187.LP
188This example decompresses the JPEG file foo.jpg, quantizes it to 188This example decompresses the JPEG file foo.jpg, quantizes it to
189256 colors, and saves the output in 8-bit BMP format in foo.bmp: 189256 colors, and saves the output in 8-bit BMP format in foo.bmp:
190.IP 190.IP
191.B djpeg \-colors 256 \-bmp 191.B djpeg \-colors 256 \-bmp
192.I foo.jpg 192.I foo.jpg
193.B > 193.B >
194.I foo.bmp 194.I foo.bmp
195.SH HINTS 195.SH HINTS
196To get a quick preview of an image, use the 196To get a quick preview of an image, use the
197.B \-grayscale 197.B \-grayscale
198and/or 198and/or
199.B \-scale 199.B \-scale
200switches. 200switches.
201.B \-grayscale \-scale 1/8 201.B \-grayscale \-scale 1/8
202is the fastest case. 202is the fastest case.
203.PP 203.PP
204Several options are available that trade off image quality to gain speed. 204Several options are available that trade off image quality to gain speed.
205.B \-fast 205.B \-fast
206turns on the recommended settings. 206turns on the recommended settings.
207.PP 207.PP
208.B \-dct fast 208.B \-dct fast
209and/or 209and/or
210.B \-nosmooth 210.B \-nosmooth
211gain speed at a small sacrifice in quality. 211gain speed at a small sacrifice in quality.
212When producing a color-quantized image, 212When producing a color-quantized image,
213.B \-onepass \-dither ordered 213.B \-onepass \-dither ordered
214is fast but much lower quality than the default behavior. 214is fast but much lower quality than the default behavior.
215.B \-dither none 215.B \-dither none
216may give acceptable results in two-pass mode, but is seldom tolerable in 216may give acceptable results in two-pass mode, but is seldom tolerable in
217one-pass mode. 217one-pass mode.
218.PP 218.PP
219If you are fortunate enough to have very fast floating point hardware, 219If you are fortunate enough to have very fast floating point hardware,
220\fB\-dct float\fR may be even faster than \fB\-dct fast\fR. But on most 220\fB\-dct float\fR may be even faster than \fB\-dct fast\fR. But on most
221machines \fB\-dct float\fR is slower than \fB\-dct int\fR; in this case it is 221machines \fB\-dct float\fR is slower than \fB\-dct int\fR; in this case it is
222not worth using, because its theoretical accuracy advantage is too small to be 222not worth using, because its theoretical accuracy advantage is too small to be
223significant in practice. 223significant in practice.
224.SH ENVIRONMENT 224.SH ENVIRONMENT
225.TP 225.TP
226.B JPEGMEM 226.B JPEGMEM
227If this environment variable is set, its value is the default memory limit. 227If this environment variable is set, its value is the default memory limit.
228The value is specified as described for the 228The value is specified as described for the
229.B \-maxmemory 229.B \-maxmemory
230switch. 230switch.
231.B JPEGMEM 231.B JPEGMEM
232overrides the default value specified when the program was compiled, and 232overrides the default value specified when the program was compiled, and
233itself is overridden by an explicit 233itself is overridden by an explicit
234.BR \-maxmemory . 234.BR \-maxmemory .
235.SH SEE ALSO 235.SH SEE ALSO
236.BR cjpeg (1), 236.BR cjpeg (1),
237.BR jpegtran (1), 237.BR jpegtran (1),
238.BR rdjpgcom (1), 238.BR rdjpgcom (1),
239.BR wrjpgcom (1) 239.BR wrjpgcom (1)
240.br 240.br
241.BR ppm (5), 241.BR ppm (5),
242.BR pgm (5) 242.BR pgm (5)
243.br 243.br
244Wallace, Gregory K. "The JPEG Still Picture Compression Standard", 244Wallace, Gregory K. "The JPEG Still Picture Compression Standard",
245Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44. 245Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44.
246.SH AUTHOR 246.SH AUTHOR
247Independent JPEG Group 247Independent JPEG Group
248.SH BUGS 248.SH BUGS
249To avoid the Unisys LZW patent, 249To avoid the Unisys LZW patent,
250.B djpeg 250.B djpeg
251produces uncompressed GIF files. These are larger than they should be, but 251produces uncompressed GIF files. These are larger than they should be, but
252are readable by standard GIF decoders. 252are readable by standard GIF decoders.