\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Sunicontopnm User Manual" 0 "23 October 2010" "netpbm documentation"

.SH NAME
sunicontopnm - convert a Sun icon into a Netpbm image


.UN synopsis
.SH SYNOPSIS

\fBsunicontopnm\fP
[\fIiconfile\fP]


.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBsunicontopnm\fP reads a Sun icon as input and produces a PBM or PGM
image as output.
.PP
If the input is of the Depth=8 variety, the output is PGM.  Otherwise,
it is PBM.  Before Netpbm 10.53 (December 2010), the program would not work
on a Depth=8 icon.
.PP
If the input is color, the output is still PGM (the program can't do
any better because developers haven't figured out how).  If you know the
palette used by the Sun icon image, you can use \fBpamlookup\fP to
convert the PGM output to the proper color Netpbm image.


.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBsunicontopnm\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN sunicons
.SH ABOUT SUN ICONS
.PP
It seems that this icon format was used in Sunview and was usable in its
successor Openlook/Openwindows in Sun 4.1.1, which offered backward
compatibility for Sunview, including the icons.  Sunview's desktop was
monochrome.  OpenWindows had color icons.  Sun 4 came with OpenWindows.
OpenWindows appears to have been an X-based gui so presumably the icons were
mostly XPM files.
.PP
So in addition to \fBsunicontopnm\fP, you should try \fBxpmtoppm\fP and
\fBxbmtopbm\fP on icons from a Sun Workstation.


.UN seealso
.SH SEE ALSO
.BR "pbmtosunicon" (1)\c
\&,
.BR "winicontoppm" (1)\c
\&,
.BR "xpmtoppm" (1)\c
\&,
.BR "xbmtopbm" (1)\c
\&,
.BR "infotopam" (1)\c
\&,
.BR "pbm" (5)\c
\&
.BR "pgm" (5)\c
\&

.UN history
.SH HISTORY
.PP
Jef Poskanzer wrote the program under the name \fBicontopbm\fP in 1988.
.PP
In October 2010, Prophet Of The Way (afu@wta.att.ne.jp) converted it to use
the more recent "packed PBM" library functions, thus speeding it up
.PP
Netpbm 10.53 (December 2010) renamed the program to \fBsunicontopnm\fP.
This name reflects the fact that there are lots of kinds of icons in the world
besides the Sun variety, Windows ones being most popular.  It also takes
into account the new Depth=8 capability (see below).
.PP
Netpbm 10.53 (December 2010) added the ability to work with Depth=8
icon input and input with 32 bit "items."  Whereas the previous
program always produced PBM output, the new program produced PGM in the
Depth=8 case.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/sunicontopnm.html
.PP