INTRO(9) INTRO(9)
NAME
intro - introduction to raster image software
DESCRIPTION
Plan 9 provides a suite of commands and library routines to
create and manipulate files containing gray-scale and full-
color images. Section 9 of the manual is divided into
subsections numbered like the main manual sections: 9.1 for
commands, 9.2 for library routines, 9.6 for file formats.
Picture files are two-dimensional arrays of multi-byte
records with a textual header describing the dimensions of
the image, the algorithm used to encode the file, and
whatever other information programs may wish to preserve.
picfile(9.6) describes the file format; picopen(9.2)
describes a library of routines to read and write picture
files.
/bin/fb contains a collection of programs to manipulate pic-
ture files.
Drop displays a picture file in an 8½(1) window or on a raw
Plan 9 terminal. Examine similarly displays an image and
allows interactive examination of its pixel values. Picinfo
displays the header of a picture file on its standard out-
put. Pcp copies picture files, modifying header attributes
as requested and updating the encoded picture array corre-
spondingly. It can clip a subwindow out of a picture, per-
mute, delete and rename channels, change the encoding type
and even convert full-color images to monochrome and vice-
versa. Hed is a more brute-force version of pcp that can
apply an arbitrary sed(1) script to a picfile header. It
copies the image array verbatim and can thus convert pre-
cious images into garbage or vice-versa.
Dumppic, gif2pic, picopic and Face2pic convert files in var-
ious alien formats to picfile(9.6) format. Pic2ps converts
picfiles to encapsulated Postscript. Nohed removes the
header from a picture file. When applied to a TYPE=dump
picture this converts it into the ubiquitous `raw dump' for-
mat. Mugs is an interactive program to convert picfiles
into 48x48 icons of the sort used by seemail (see mail(1)).
Some commands create simple images out of whole cloth. Card
writes an image of constant color. Ramp creates an image
that is one color at one edge and changes linearly to
another color at the opposite edge.
Twb and its subroutine dpic convert troff(1) input into
anti-aliased images.
Page 1 Plan 9 (printed 11/1/25)
INTRO(9) INTRO(9)
Aplot reads a square array of data points and draws an
anti-aliased perspective plot of the surface it defines.
There are numerous commands that read one or more images and
write a modified image on standard output. See remap(9.1),
filters(9.1), floyd(9.1), he(9.1), lam(9.1), lerp(9.1),
logo(9.1), lum(9.1), quantize(9.1), resample(9.1)
transpose(9.1) and xpand(9.1) for descriptions.
Moto is an animator's command language. It converts concise
descriptions of simultaneous processes overlapping in time
into sequential command files suitable for producing frames
of an animation.
SEE ALSO
Sections add(2), balloc(2), cachechars(2), subfalloc(2),
bitblt(2), event(2), frame(2), print(2), bit(3), layer(2),
bitmap(6) and font(6) describe the standard Plan 9 interac-
tive bitmap graphics interface.
Page 2 Plan 9 (printed 11/1/25)