~ubuntu-branches/ubuntu/karmic/tiff/karmic-security

« back to all changes in this revision

Viewing changes to man/pal2rgb.1

  • Committer: Bazaar Package Importer
  • Author(s): Fabio M. Di Nitto
  • Date: 2004-10-14 07:57:59 UTC
  • Revision ID: james.westby@ubuntu.com-20041014075759-a77e7zuaetya8cp0
Tags: upstream-3.6.1
ImportĀ upstreamĀ versionĀ 3.6.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\"     $Header: /cvsroot/osrs/libtiff/man/pal2rgb.1,v 1.1.1.1 1999/07/27 21:50:27 mike 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 "October 15, 1995"
 
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 behaviour 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
.IR tiffinfo (1),
 
106
.IR tiffcp (1),
 
107
.IR tiffmedian (1),
 
108
.IR libtiff (3)