.TH CVT2PIC 9.1
.SH NAME
cvt2pic, dumppic, ega2pic, face2pic, gif2pic, jpg2pic, nasa2pic, pcx2pic, picopic, sgi2pic, targa2pic, tiff2pic, utah2pic, xbm2pic \- convert other formats to picture files
.SH SYNOPSIS
.B fb/cvt2pic
[
.I file
]
.PP
.B fb/dumppic
.I input xsize ysize channels
.PP
.B fb/ega2pic
[
.I file
]
.PP
.B fb/face2pic
[
.I facefile
]
.PP
.B fb/gif2pic
[
.B -m
]
[
.B -s
.I image
] [
.I file
]
.PP
.B fb/jpg2pic
.I file
.PP
.B fb/nasa2pic
.I file
.PP
.B fb/pcx2pic
[
.B -r
]
[
.I file
]
.PP
.B fb/picopic
.I red green blue xsize ysize
.PP
.B fb/sgi2pic
.I file
.PP
.B fb/targa2pic
[
.I file
]
.PP
.B fb/tiff2pic
.I file
.PP
.B fb/utah2pic
.I file
.PP
.B fb/xbm2pic
[
.I file
]
.SH DESCRIPTION
.I Cvt2pic
examines the given
.I file
(default standard input),
and tries to convert it to a
.IR picfile (9.6).
It can recognize
TIFF,
.BR xbm ,
CompuServe GIF,
Usenix facesaver,
NASA,
Utah
.BR rle ,
SGI, JPEG,
.BR pcx ,
and
.IR picfile (9.6)
images.  The actual conversion is done by
calling out to one of the programs described below.
Although we have programs to decipher
EGA,
Targa, 
and raw dump images,
.I cvt2pic
cannot recognize them.
.PP
.I Dumppic
copies
.I input
to its standard output, adding a
.B TYPE=dump
picture file header.
.I Xsize
and
.I ysize
are the width and height of the picture.
.I Channels
is the value of the output's
.B CHAN=
attribute.
.I Face2pic
reads
.I facefile
(default standard input),
a file in the Usenix face-saver format, and converts it to
.IR picfile (9.6)
format, writing the result on standard output.
.PP
.I Picopic
creates a
.B TYPE=pico
image from the files
.I red, green
and
.I blue
which must be raw (headerless)
dumps in scan line order of size
.IR xsize × ysize .
.PP
.I Ega2pic
reads an EGA `enhanced color mode' image from
.I input
and converts it to
.IR picfile (9.6)
format, written on standard output.
.PP
.I Gif2pic
reads a CompuServe GIF format picture from
.I input
(default standard input) and converts it to
.IR picfile (9.6)
format, written on standard output.
By default, it converts its input into a 3-channel
.I rgb
image.  The
.B -m
flag causes it to output a single channel image with a color map.
GIF files may contain multiple images; the
.B -s
flag allows selection of an image other than the first.
.PP
.I Jpg2pic
reads a JPEG-coded file in the JFIF format from
.I input
(or standard input)
and converts it to
.IR picfile (9.6)
format, written on standard output.
It generates
.BR TYPE=dump .
.PP
.I Nasa2pic
reads a NASA satellite image and converts it to
.IR picfile (9.6)
format, written on standard output.
It can decipher only images with a single 8-bit channel.
NASA images typically have copious annotations in their
headers; these are mostly lost.
.PP
.I Sgi2pic
converts SGI-format images to picfiles.
.PP
.I Targa2pic
reads a Targa format file and converts it to
.IR picfile (9.6)
format, written on standard output.
It cannot convert compressed or color-mapped files.
.PP
.I Tiff2pic
converts TIFF images to picfiles.  It cannot handle images with
more than 8 bits per color component, nor images of more than 8
channels.  It uses a version of Sam Leffler's TIFF library that
purports to toe to TIFF 6.0.
.PP
.I Utah2pic
reads a Utah
.I rle
(run-length encoded) image and converts it to
.IR picfile (9.6)
format, written on standard output.
.PP
.I Pcx2pic
reads a Paintbrush PCX format picture from
.I input
(or standard input)
and converts it to
.IR picfile (9.6)
format, written on standard output.
.B TYPE=dump
is generated by default; the
.B -r
flag selects
.BR TYPE=runcode .
.PP
.I Xbm2pic
reads an X window-system bitmap file from
.I file
(or standard input)
and converts it to
.IR picfile (9.6)
format, written on standard output.
.SH "SEE ALSO
.IR picfile (9.6)
.br
.I Pic2gif
contains code that is Copyright © 1988, 1989 by Patrick J. Naughton.
.SH SOURCE
.B /sys/src/fb
.SH BUGS
The world is awash with raster image file formats, many of which spawn new versions
from time to time, possibly making these programs obsolete.  On
the other hand, we guarantee unconditionally that
.IR picfile (9.6)
will never change.