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

.\" $Id: pal2rgb.1,v 1.3 2005/11/02 11:07:19 dron Exp $
.\"
.\" Copyright (c) 1990-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 PAL2RGB 1 "September 20, 2005" "libtiff"
.SH NAME
pal2rgb \- convert a palette color
.SM TIFF
image to a full color image
.SH SYNOPSIS
.B pal2rgb
[
.I options
]
.I input.tif
.I output.tif
.SH DESCRIPTION
.I Pal2rgb
converts a palette color
.SM TIFF
image to a full color image by
applying the colormap of the palette image to each sample
to generate a full color
.SM RGB
image.
.SH OPTIONS
Options that affect the interpretation of input data are:
.TP
.B \-C
This option overrides the default behavior of
.I pal2rgb
in determining whether or not
colormap entries contain 16-bit or 8-bit values.
By default the colormap is inspected and
if no colormap entry greater than 255 is found,
the colormap is assumed to have only 8-bit values; otherwise
16-bit values (as required by the
.SM TIFF
specification) are assumed.
The
.B \-C
option can be used to explicitly specify the number of
bits for colormap entries:
.B "\-C 8"
for 8-bit values, 
.B "\-C 16"
for 16-bit values.
.PP
Options that affect the output file format are:
.TP
.B \-p
Explicitly select the planar configuration used in organizing
data samples in the output image:
.B "\-p contig"
for samples packed contiguously, and
.B "\-p separate"
for samples stored separately.
By default samples are packed.
.TP
.B \-c
Use the specific compression algorithm to encoded image data
in the output file:
.B "\-c packbits"
for Macintosh Packbits,
.B "\-c lzw"
for Lempel-Ziv & Welch,
.B "\-c zip"
for Deflate,
.B "\-c none"
for no compression.
If no compression-related option is specified, the input
file's compression algorithm is used.
.TP
.B \-r
Explicitly specify the number of rows in each strip of the
output file.
If the
.B \-r
option is not specified, a number is selected such that each
output strip has approximately 8 kilobytes of data in it.
.SH BUGS
Only 8-bit images are handled.
.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
8414a40c VZ	1	.\" $Id: pal2rgb.1,v 1.3 2005/11/02 11:07:19 dron Exp $
	2	.\"
	3	.\" Copyright (c) 1990-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 PAL2RGB 1 "September 20, 2005" "libtiff"
	27	.SH NAME
	28	pal2rgb \- convert a palette color
	29	.SM TIFF
	30	image to a full color image
	31	.SH SYNOPSIS
	32	.B pal2rgb
	33	[
	34	.I options
	35	]
	36	.I input.tif
	37	.I output.tif
	38	.SH DESCRIPTION
	39	.I Pal2rgb
	40	converts a palette color
	41	.SM TIFF
	42	image to a full color image by
	43	applying the colormap of the palette image to each sample
	44	to generate a full color
	45	.SM RGB
	46	image.
	47	.SH OPTIONS
	48	Options that affect the interpretation of input data are:
	49	.TP
	50	.B \-C
	51	This option overrides the default behavior of
	52	.I pal2rgb
	53	in determining whether or not
	54	colormap entries contain 16-bit or 8-bit values.
	55	By default the colormap is inspected and
	56	if no colormap entry greater than 255 is found,
	57	the colormap is assumed to have only 8-bit values; otherwise
	58	16-bit values (as required by the
	59	.SM TIFF
	60	specification) are assumed.
	61	The
	62	.B \-C
	63	option can be used to explicitly specify the number of
	64	bits for colormap entries:
65	.B "\-C 8"
66	for 8-bit values,
67	.B "\-C 16"
68	for 16-bit values.
69	.PP
70	Options that affect the output file format are:
71	.TP
72	.B \-p
73	Explicitly select the planar configuration used in organizing
74	data samples in the output image:
75	.B "\-p contig"
76	for samples packed contiguously, and
77	.B "\-p separate"
78	for samples stored separately.
79	By default samples are packed.
80	.TP
81	.B \-c
82	Use the specific compression algorithm to encoded image data
83	in the output file:
84	.B "\-c packbits"
85	for Macintosh Packbits,
86	.B "\-c lzw"
87	for Lempel-Ziv & Welch,
88	.B "\-c zip"
89	for Deflate,
90	.B "\-c none"
91	for no compression.
92	If no compression-related option is specified, the input
93	file's compression algorithm is used.
94	.TP
95	.B \-r
96	Explicitly specify the number of rows in each strip of the
97	output file.
98	If the
99	.B \-r
100	option is not specified, a number is selected such that each
101	output strip has approximately 8 kilobytes of data in it.
102	.SH BUGS
103	Only 8-bit images are handled.
104	.SH "SEE ALSO"
105	.BR tiffinfo (1),
106	.BR tiffcp (1),
107	.BR tiffmedian (1),
108	.BR libtiff (3)
109	.PP
110	Libtiff library home page:
111	.BR http://www.remotesensing.org/libtiff/