Debian Codegraph @

upstream/debian-unstable/man1/sunicontopnm.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 "Sunicontopnm User Manual" 1 "23 October 2010" "netpbm documentation"
7
8 .SH NAME
9 sunicontopnm - convert a Sun icon into a Netpbm image
10
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBsunicontopnm\fP
16 [\fIiconfile\fP]
17
18
19 .UN description
20 .SH DESCRIPTION
21 .PP
22 This program is part of
23 .BR "Netpbm" (1)\c
24 \&.
25 .PP
26 \fBsunicontopnm\fP reads a Sun icon as input and produces a PBM or PGM
27 image as output.
28 .PP
29 If the input is of the Depth=8 variety, the output is PGM. Otherwise,
30 it is PBM. Before Netpbm 10.53 (December 2010), the program would not work
31 on a Depth=8 icon.
32 .PP
33 If the input is color, the output is still PGM (the program can't do
34 any better because developers haven't figured out how). If you know the
35 palette used by the Sun icon image, you can use \fBpamlookup\fP to
36 convert the PGM output to the proper color Netpbm image.
37
38
39 .UN options
40 .SH OPTIONS
41 .PP
42 There are no command line options defined specifically
43 for \fBsunicontopnm\fP, but it recognizes the options common to all
44 programs based on libnetpbm (See
45 .UR index.html#commonoptions
46 Common Options
47 .UE
48 \&.)
49
50 .UN sunicons
51 .SH ABOUT SUN ICONS
52 .PP
53 It seems that this icon format was used in Sunview and was usable in its
54 successor Openlook/Openwindows in Sun 4.1.1, which offered backward
55 compatibility for Sunview, including the icons. Sunview's desktop was
56 monochrome. OpenWindows had color icons. Sun 4 came with OpenWindows.
57 OpenWindows appears to have been an X-based gui so presumably the icons were
58 mostly XPM files.
59 .PP
60 So in addition to \fBsunicontopnm\fP, you should try \fBxpmtoppm\fP and
61 \fBxbmtopbm\fP on icons from a Sun Workstation.
62
63
64 .UN seealso
65 .SH SEE ALSO
66 .BR "pbmtosunicon" (1)\c
67 \&,
68 .BR "winicontoppm" (1)\c
69 \&,
70 .BR "xpmtoppm" (1)\c
71 \&,
72 .BR "xbmtopbm" (1)\c
73 \&,
74 .BR "infotopam" (1)\c
75 \&,
76 .BR "pbm" (1)\c
77 \&
78 .BR "pgm" (1)\c
79 \&
80
81 .UN history
82 .SH HISTORY
83 .PP
84 Jef Poskanzer wrote the program under the name \fBicontopbm\fP in 1988.
85 .PP
86 In October 2010, Prophet Of The Way ([email protected]) converted it to use
87 the more recent "packed PBM" library functions, thus speeding it up
88 .PP
89 Netpbm 10.53 (December 2010) renamed the program to \fBsunicontopnm\fP.
90 This name reflects the fact that there are lots of kinds of icons in the world
91 besides the Sun variety, Windows ones being most popular. It also takes
92 into account the new Depth=8 capability (see below).
93 .PP
94 Netpbm 10.53 (December 2010) added the ability to work with Depth=8
95 icon input and input with 32 bit "items." Whereas the previous
96 program always produced PBM output, the new program produced PGM in the
97 Depth=8 case.
98 .SH DOCUMENT SOURCE
99 This manual page was generated by the Netpbm tool 'makeman' from HTML
100 source. The master documentation is at
101 .IP
102 .B http://netpbm.sourceforge.net/doc/sunicontopnm.html
103 .PP