src/tiff/man/pal2rgb.1

   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/