[wxWidgets.git] / src / tiff / man / ppm2tiff.1

.\" $Id: ppm2tiff.1,v 1.5 2006-03-01 11:20:33 dron Exp $
.\"
.\" Copyright (c) 1991-1997 Sam Leffler
.\" Copyright (c) 1991-1997 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.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
.\" 
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
.\" OF THIS SOFTWARE.
.\"
.if n .po 0
.TH PPM2TIFF 1 "March 1, 2006" "libtiff"
.SH NAME
ppm2tiff \- create a
.SM TIFF
file from 
.SM PPM, PGM
and
.SM PBM
image files
.SH SYNOPSIS
.B ppm2tiff
[
.I options
] [
.I input.ppm
]
.I output.tif
.SH DESCRIPTION
.I ppm2tiff
converts a file in the 
.SM PPM, PGM
and
.SM PBM
image formats to
.SM TIFF.
By default, the
.SM TIFF
image is created with data samples packed (\c
.IR PlanarConfiguration =1),
compressed with the Packbits algorithm (\c
.IR Compression =32773),
and with each strip no more than 8 kilobytes. These characteristics can be
overridden, or explicitly specified with the options described below
.PP
If the
.SM PPM
file contains greyscale data, then the
.I PhotometricInterpretation
tag is set to 1 (min-is-black), otherwise it is set to 2 (RGB).
.PP
If no
.SM PPM
file is specified on the command line,
.I ppm2tiff
will read from the standard input.
.SH OPTIONS
.TP
.B \-c
Specify a compression scheme to use when writing image data:
.B none 
for no compression,
.B packbits
for PackBits compression (will be used by default),
.B lzw
for Lempel-Ziv & Welch compression,
.B jpeg
for baseline JPEG compression,
.B zip
for Deflate compression,
.B g3
for CCITT Group 3 (T.4) compression,
and
.B g4
for CCITT Group 4 (T.6) compression.
.TP
.B \-r
Write data with a specified number of rows per strip; by default the number of
rows/strip is selected so that each strip is approximately 8 kilobytes.
.TP
.B \-R
Mark the resultant image to have the specified X and Y resolution (in
dots/inch).
.SH "SEE ALSO"
.BR tiffinfo (1),
.BR tiffcp (1),
.BR tiffmedian (1),
.BR libtiff (3)
.PP
Libtiff library home page:
.BR http://www.remotesensing.org/libtiff/
Commit	Line	Data
80ed523f	1	.\" $Id: ppm2tiff.1,v 1.5 2006-03-01 11:20:33 dron Exp $
8414a40c VZ	2	.\"
	3	.\" Copyright (c) 1991-1997 Sam Leffler
	4	.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
	5	.\"
	6	.\" Permission to use, copy, modify, distribute, and sell this software and
	7	.\" its documentation for any purpose is hereby granted without fee, provided
	8	.\" that (i) the above copyright notices and this permission notice appear in
	9	.\" all copies of the software and related documentation, and (ii) the names of
	10	.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
	11	.\" publicity relating to the software without the specific, prior written
	12	.\" permission of Sam Leffler and Silicon Graphics.
	13	.\"
	14	.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
	15	.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
	16	.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
	17	.\"
	18	.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
	19	.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
	20	.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
	21	.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
	22	.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
	23	.\" OF THIS SOFTWARE.
	24	.\"
	25	.if n .po 0
	26	.TH PPM2TIFF 1 "March 1, 2006" "libtiff"
	27	.SH NAME
	28	ppm2tiff \- create a
	29	.SM TIFF
	30	file from
	31	.SM PPM, PGM
	32	and
	33	.SM PBM
	34	image files
	35	.SH SYNOPSIS
	36	.B ppm2tiff
	37	[
	38	.I options
	39	] [
	40	.I input.ppm
	41	]
	42	.I output.tif
	43	.SH DESCRIPTION
	44	.I ppm2tiff
	45	converts a file in the
	46	.SM PPM, PGM
	47	and
	48	.SM PBM
	49	image formats to
	50	.SM TIFF.
	51	By default, the
	52	.SM TIFF
	53	image is created with data samples packed (\c
	54	.IR PlanarConfiguration =1),
	55	compressed with the Packbits algorithm (\c
	56	.IR Compression =32773),
	57	and with each strip no more than 8 kilobytes. These characteristics can be
	58	overridden, or explicitly specified with the options described below
	59	.PP
	60	If the
	61	.SM PPM
	62	file contains greyscale data, then the
	63	.I PhotometricInterpretation
	64	tag is set to 1 (min-is-black), otherwise it is set to 2 (RGB).
	65	.PP
66	If no
67	.SM PPM
68	file is specified on the command line,
69	.I ppm2tiff
70	will read from the standard input.
71	.SH OPTIONS
72	.TP
73	.B \-c
74	Specify a compression scheme to use when writing image data:
75	.B none
76	for no compression,
77	.B packbits
78	for PackBits compression (will be used by default),
79	.B lzw
80	for Lempel-Ziv & Welch compression,
81	.B jpeg
82	for baseline JPEG compression,
83	.B zip
84	for Deflate compression,
85	.B g3
86	for CCITT Group 3 (T.4) compression,
87	and
88	.B g4
89	for CCITT Group 4 (T.6) compression.
90	.TP
91	.B \-r
92	Write data with a specified number of rows per strip; by default the number of
93	rows/strip is selected so that each strip is approximately 8 kilobytes.
94	.TP
95	.B \-R
96	Mark the resultant image to have the specified X and Y resolution (in
97	dots/inch).
98	.SH "SEE ALSO"
99	.BR tiffinfo (1),
100	.BR tiffcp (1),
101	.BR tiffmedian (1),
102	.BR libtiff (3)
103	.PP
104	Libtiff library home page:
105	.BR http://www.remotesensing.org/libtiff/