plan9 man page for aplot

APLOT(9.1)																APLOT(9.1)

NAME
       aplot - isometric plots of data arrays

SYNOPSIS
       fb/aplot [ -a ] [ -llightfile ] [ -ttype ] [ -rrange ] [ -w x0 y0 x1 y1 ] file

DESCRIPTION
       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 640x512 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 sur-
       face 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.

																	APLOT(9.1)