Penguin
Recent Changes
Blame: tifftopnm(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of tifftopnm(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 tifftopnm
2 !!!tifftopnm
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 AUTHOR
9 ----
10 !!NAME
11
12
13 tifftopnm - convert a TIFF file into a portable anymap
14 !!SYNOPSIS
15
16
17 __tifftopnm__
18 [[__--alphaout=__{''alpha-filename'',__-__}]
19 [[__--headerdump__] [[''tiff-filename'']
20 !!DESCRIPTION
21
22
23 Reads a TIFF file as input. Produces a portable anymap as
24 output. The type of the output file depends on the input
25 file - if it's black pbm''
26 file; if it's grayscale, generates a ''pgm'' file;
27 otherwise, a ''ppm'' file. The program tells you which
28 type it is writing.
29
30
31 This program cannot read every possible TIFF file -- there
32 are myriad variations of the TIFF format. However, it does
33 understand monochrome and gray scale, RGB, RGBA
34 (red/green/blue with alpha channel), CMYK
35 (Cyan-Magenta-Yellow-Black ink color separation), and color
36 palette TIFF files. An RGB file can have either single plane
37 (interleaved) color or multiple plane format. The program
38 reads 1-8 and 16 bit-per-sample input, the latter in either
39 bigendian or littlendian encoding. Tiff directory
40 information may also be either bigendian or
41 littendian.
42
43
44 One reason this program isn't as general as TIFF programs
45 often are is that it does not use the TIFFRGBAImageGet()
46 function of the TIFF library to read TIFF files. Rather, it
47 uses the more primitive TIFFReadScanLine() function and
48 decodes it itself.
49
50
51 There is no fundamental reason that this program could not
52 read other kinds of TIFF files; the existing limitations are
53 mainly because no one has asked for more.
54
55
56 The PNM output has the same maxval as the Tiff input, except
57 that if the Tiff input is colormapped (which implies a
58 maxval of 65535) the PNM output has a maxval of 255. Though
59 this may result in lost information, such input images
60 hardly ever actually have more color resolution than a
61 maxval of 255 provides and people often cannot deal with PNM
62 files that have maxval
63 have'' a maxval
64 ''
65
66
67 The ''tiff-filename'' argument names the regular file
68 that contains the Tiff image. If you specify
69 ''tfftopnm__ uses
70 Standard Input. In either case, the file must be seekable.
71 That means no pipe, but any regular file is
72 fine.
73 !!OPTIONS
74
75
76 __--alphaout=__''alpha-filename''
77
78
79 __tifftopnm__ creates a PGM (portable graymap) file
80 containing the alpha channel values in the input image. If
81 the input image doesn't contain an alpha channel, the
82 ''alpha-filename'' file contains all zero (transparent)
83 alpha values. If you don't specify __--alphaout__,
84 __tifftopnm__ does not generate an alpha file, and if the
85 input image has an alpha channel, __tifftopnm__ simply
86 discards it.
87
88
89 If you specify __-__ as the filename, __tifftopnm__
90 writes the alpha output to Standard Output and discards the
91 image.
92
93
94 See pnmcomp(1) for one way to use the alpha output
95 file.
96
97
98 __--headerdump__
99
100
101 Dump TIFF file information to stderr. This information may
102 be useful in debugging TIFF file conversion
103 problems.
104
105
106 All options can be abbreviated to their shortest unique
107 prefix.
108 !!SEE ALSO
109
110
111 pnmtotiff(1), pnmtotiffcmyk(1),
112 pnmcomp(1), pnm(5)
113 !!AUTHOR
114
115
116 Derived by Jef Poskanzer from tif2ras.c, which is Copyright
117 (c) 1990 by Sun Microsystems, Inc. Author: Patrick J.
118 Naughton (naughton@wind.sun.com).
119 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.