Penguin
Recent Changes
Annotated edit history of ppmtoxpm(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 ppmtoxpm
2 !!!ppmtoxpm
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 LIMITATIONS
8 SEE ALSO
9 AUTHOR
10 ----
11 !!NAME
12
13
14 ppmtoxpm - convert a PPM iamge into an X11 pixmap
15 !!SYNOPSIS
16
17
18 __ppmtoxpm__ [[__-name=__''xpmname'']
19 [[__-rgb=__''rgb-textfile'']
20 [[__-alphamask=__''pgmfile'']
21 [[''ppmfile'']
22
23
24 Minimum unique abbrevations are acceptable.
25 !!DESCRIPTION
26
27
28 Reads a portable pixmap as input. Produces X11 pixmap
29 (version 3) as output which can be loaded directly by the
30 XPM library.
31
32
33 For example, to convert the file
34
35
36 xbmtopbm dot | ppmtoxpm -name dot
37
38
39 or, with a rgb text file (in the local
40 directory)
41
42
43 xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt
44 !!OPTIONS
45
46
47 __-name=__''xpmname''
48
49
50 The __-name__ option allows you to specify the prefix
51 string which is printed in the resulting XPM output. If not
52 specified, will default to the filename (without extension)
53 of the
54 __-name__ or ''ppmfile'', (i.e. your input is from
55 Standad Input), the prefix string defaults to the string
56 __noname__.
57
58
59 __rgb=__''rgb-textfile''
60
61
62 The __-rgb__ option allows you to specify an X11 rgb text
63 file for the lookup of color name mnemonics. This rgb text
64 file is typically the /usr/lib/X11/rgb.txt of the MIT X11
65 distribution, but any file using the same format may be
66 used. When specified and a RGB value from the ppm input
67 matches a RGB value from the
68 __-rgb or if the RGB values
69 don't__ match, then __ppmtoxpm produces the color
70 specifications in the #RGB, #RRGGBB,__ #RRRGGGBBB, or
71 #RRRRGGGGBBBB hexadecimal format.
72
73
74 __-alphamask=__''pgmfile''
75
76
77 This option names a PGM file to use as an alpha
78 (transparency) mask. The file must contain an image the same
79 dimensions as the input image. __ppmtoxpm__ marks as
80 transparent any pixel whose position in the alpha mask image
81 is at most half white.
82
83
84 If you don't specify __-alphamask__, __ppmtoxpm__
85 makes all pixels in the output opaque.
86
87
88 __ppmcolormask__ is one way to generate an alpha mask
89 file. You might also generate it by extracting transparency
90 information from an XPM file with the __-alphaout__
91 option to __xpmtoppm__. There are similar options on
92 other Netpbm converters that convert from formats that
93 include transparency information too.
94 !!LIMITATIONS
95
96
97 An option to match the closest (rather than exact) color
98 name mnemonic from the rgb text would be a desirable
99 enhancement.
100
101
102 Truncation of the least significant bits of a RGB value may
103 result in nonexact matches when performing color name
104 mnemonic lookups.
105 !!SEE ALSO
106
107
108 ppmcolormask(1), xpmtoppm(1),
109 ppm(5)
110 XPM Manual by Arnaud Le Hors
111 lehors@mirsa.inria.fr
112 !!AUTHOR
113
114
115 Copyright (C) 1990 by Mark W. Snitily.
116
117
118 Permission to use, copy, modify, and distribute this
119 software and its documentation for any purpose and without
120 fee is hereby granted, provided that the above copyright
121 notice appear in all copies and that both that copyright
122 notice and this permission notice appear in supporting
123 documentation. This software is provided
124
125
126 This tool was developed for Schlumberger Technologies, ATE
127 Division, and with their permission is being made available
128 to the public with the above copyright notice and permission
129 notice.
130
131
132 Upgraded to XPM2 by Paul Breslaw, Mecasoft SA, Zurich,
133 Switzerland (paul@mecazh.uu.ch) Thu Nov 8 16:01:17
134 1990
135
136
137 Upgraded to XPM version 3 by Arnaud Le Hors
138 (lehors@mirsa.inria.fr) Tue Apr 9 1991
139 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.