pamtouil - Man Page
convert a PNM or PNM/transparency image into a Motif UIL icon file
Examples (TL;DR)
- Convert a PNM or PAM file into a Motif UIL icon file:
pamtouil path/to/input.pnm|pam > path/to/output.uil
- Specify a prefix string to be printed in the output UIL file:
pamtouil -name uilname path/to/input.pnm|pam > path/to/output.uil
Synopsis
pamtouil [-name=uilname] [pamfile]
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 =.
Description
This program is part of Netpbm(1).
pamtouil 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, pamtouil renders pixels that are more than half transparent as transparent in the output.
In the UIL's colormap, pamtouil uses the color names from the RGB database -- the same one ppmmake(1) uses. Where a color in the input does not exactly match one of the colors named in the RGB database, pamtouil uses the closest color named in the RGB database.
Options
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options ), pamtouil recognizes the following command line option:
- -name
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 -name is not
specified and no ppmfile is specified (i.e. piped input), the
prefix string will default to the string "noname".
See Also
pamstack(1) pam(1) ppm(1)
History
Before May 2002, pamtouil was called ppmtouil and had no way to specify transparency.
Author
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
Document Source
This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master documentation is at