unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (plan9)
Page:
Section:
Apropos / Subsearch:
optional field

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  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 direc-
              tion (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)