| 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 |