summary refs log tree commit diff
path: root/pamtouil.html
blob: f94b773949c311a26651ae726bc45a2d59a6a66c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pamtouil User Manual</title></head>
<body>
<h1>pamtouil</h1>
Updated: 05 May 2002
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>

pamtouil - convert a PNM or PNM/transparency image into a Motif UIL icon file

<h2 id="synopsis">SYNOPSIS</h2>

<b>pamtouil</b> [<b>-name=</b><i>uilname</i>] [<i>pamfile</i>]

<p>You may abbreviate any option to its shortest unique prefix.
You may use two hyphens instead of one to delimit an option.  You may
separate an option from its value with whitespace instead of <b>=</b>.

<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>pamtouil</b> reads a PNM or PAM image as input and produces a Motif UIL
icon file as output.  If the input is PAM, it may be either a regular
grayscale or color image or grayscale+transparency or color+transparency.
Where the transparency channel is present, <b>pamtouil</b> renders pixels that
are more than half transparent as transparent in the output.

<p>In the UIL's colormap, <b>pamtouil</b> uses the color names from
the RGB database -- the same one <b><a href="ppmmake.html">ppmmake</a></b>
uses.  Where a color in the input does not exactly match one of the colors
named in the RGB database, <b>pamtouil</b> uses the closest color named
in the RGB database.

<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>pamtouil</b> recognizes the following
command line option:

<dl compact>

<dt><b>-name</b>

<dd>
     Allows you to specify the prefix string which is printed in the
     resulting UIL output.  If not specified, will default to the filename
     (without extension) of the ppmfile argument.  If <b>-name</b> is not
     specified and no ppmfile is specified (i.e. piped input), the
     prefix string will default to the string "noname".

</dl>

<h2 id="seealso">SEE ALSO</h2>

<a href="pamstack.html">pamstack</a>
<a href="pam.html">pam</a>
<a href="ppm.html">ppm</a>

<h2 id="history">HISTORY</h2>

<p>Before May 2002, <b>pamtouil</b> was called <b>ppmtouil</b> and had no
way to specify transparency.

<h2 id="author">AUTHOR</h2>

Converted by Bryan Henderson from ppmtouil.c, which was converted by
Jef Poskanzer from ppmtoxpm.c, which is Copyright (C) 1990 by Mark
W. Snitily

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#history">HISTORY</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>