Aplot
draws an anti-aliased isometric perspective plot of the square array of elevations that it
reads from
file.
The output is a picture file, written on standard output.
Option
-t
specifies the type of the data in the binary file. Possible
types
are
s short
i int
l long
f float
d double
c char
u unsigned char
The default is
-t f.
Option
-w
sets the
WINDOW=
attribute of the output image.
By default, the image is drawn in a 640×512 window.
Normally, the data is scaled to make the plot fill the window.
This default scaling can be overridden by option
-r,
in which case the data is scaled so that
range
is the magnitude of data values that would make a plot that just
fills the window vertically.
Option
-l
gives the name of a file describing how to shade the surface and how
shiny the surface is.
By default, a not-at-all shiny surface is lit from above by a single light source.
The
lightfile
contains lines of the following forms:
light x y z brightness
specifies light source of the given brightness shining in direction
(x,y,z
There can be up to 16 light sources.
The default light is in direction (2,3,9) and has brightness 1.
ambient brightness
specifies the brightness of then ambient (non-directional) light.
The default is 0.02.
diff reflectance
sets the amount of diffuse reflection from the surface.
The default is 0.98.
spec reflectance
sets the amount of specular reflection from the surface.
The default is 0.
bump height
sets the width of the specular reflection bump. Larger numbers
produce tighter (less diffuse) bumps. The default is 80.
Option
-a
suppresses writing an
alpha
channel into the output file.
By default, the output has
CHAN=ma.
SOURCE
/sys/src/fb/aplot.c
SEE ALSO
picfile(9.6),
filters(9.1)
BUGS
Input files are assumed to use native byte order and
floating point format, and so are not transportable,
except under option
-t u.