Debian Codegraph @

upstream/debian-unstable/man1/pamtouil.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pamtouil User Manual" 1 "05 May 2002" "netpbm documentation"
7
8 .SH NAME
9
10 pamtouil - convert a PNM or PNM/transparency image into a Motif UIL icon file
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpamtouil\fP [\fB-name=\fP\fIuilname\fP] [\fIpamfile\fP]
16 .PP
17 You may abbreviate any option to its shortest unique prefix.
18 You may use two hyphens instead of one to delimit an option. You may
19 separate an option from its value with whitespace instead of \fB=\fP.
20
21 .UN description
22 .SH DESCRIPTION
23 .PP
24 This program is part of
25 .BR "Netpbm" (1)\c
26 \&.
27 .PP
28 \fBpamtouil\fP reads a PNM or PAM image as input and produces a Motif UIL
29 icon file as output. If the input is PAM, it may be either a regular
30 grayscale or color image or grayscale+transparency or color+transparency.
31 Where the transparency channel is present, \fBpamtouil\fP renders pixels that
32 are more than half transparent as transparent in the output.
33 .PP
34 In the UIL's colormap, \fBpamtouil\fP uses the color names from
35 the RGB database -- the same one
36 .BR "ppmmake" (1)\c
37 \&
38 uses. Where a color in the input does not exactly match one of the colors
39 named in the RGB database, \fBpamtouil\fP uses the closest color named
40 in the RGB database.
41
42 .UN options
43 .SH OPTIONS
44 .PP
45 In addition to the options common to all programs based on libnetpbm
46 (most notably \fB-quiet\fP, see
47 .UR index.html#commonoptions
48 Common Options
49 .UE
50 \&), \fBpamtouil\fP recognizes the following
51 command line option:
52
53
54
55 .TP
56 \fB-name\fP
57 Allows you to specify the prefix string which is printed in the
58 resulting UIL output. If not specified, will default to the filename
59 (without extension) of the ppmfile argument. If \fB-name\fP is not
60 specified and no ppmfile is specified (i.e. piped input), the
61 prefix string will default to the string "noname".
62
63
64
65 .UN seealso
66 .SH SEE ALSO
67 .BR "pamstack" (1)\c
68 \&
69 .BR "pam" (1)\c
70 \&
71 .BR "ppm" (1)\c
72 \&
73
74 .UN history
75 .SH HISTORY
76 .PP
77 Before May 2002, \fBpamtouil\fP was called \fBppmtouil\fP and had no
78 way to specify transparency.
79
80 .UN author
81 .SH AUTHOR
82
83 Converted by Bryan Henderson from ppmtouil.c, which was converted by
84 Jef Poskanzer from ppmtoxpm.c, which is Copyright (C) 1990 by Mark
85 W. Snitily
86 .SH DOCUMENT SOURCE
87 This manual page was generated by the Netpbm tool 'makeman' from HTML
88 source. The master documentation is at
89 .IP
90 .B http://netpbm.sourceforge.net/doc/pamtouil.html
91 .PP