


PLBOX3(3)                   PLplot API                  PLBOX3(3)


NAME
       plbox3 - Draw a box with axes, etc, in 3-d

SYNOPSIS
       plbox3(xopt,  xlabel,  xtick,  nxsub, yopt, ylabel, ytick, nysub, zopt,
       zlabel, ztick, nzsub)

DESCRIPTION
       Draws axes, numeric and text labels  for  a  three-dimensional  surface
       plot.   For  a  more complete description of three-dimensional plotting
       see the PLplot documentation.

       Redacted form:  General: plbox3(xopt, xlabel, xtick, nxsub, yopt,  yla-
       bel,  ytick, nysub, zopt, zlabel, ztick, nzsub) Perl/PDL: plbox3(xtick,
       nxsub, ytick, nysub, ztick, nzsub, xopt, xlabel,  yopt,  ylabel,  zopt,
       zlabel)


       This function is used in examples 8,11,18,21.

ARGUMENTS
       xopt (const char *, input)
              Pointer  to  character string specifying options for the x axis.
              The string can include any combination of the following  letters
              (upper  or  lower  case) in any order: b: Draws axis at base, at
              height z=zmin where zmin is defined by call to  plw3d(3).   This
              character  must  be  specified  in order to use any of the other
              options.  f: Always use fixed point numeric labels.  i:  Inverts
              tick  marks,  so  they are drawn downwards, rather than upwards.
              l: Labels axis logarithmically.  This only affects  the  labels,
              not  the  data, and so it is necessary to compute the logarithms
              of data points before passing them to any of  the  drawing  rou-
              tines.   n:  Writes  numeric labels at major tick intervals.  s:
              Enables subticks between major ticks, only valid if  t  is  also
              specified.   t: Draws major ticks.  u: If this is specified, the
              text label for the axis is written under the axis.


       xlabel (const char *, input)
              Pointer to character string specifying  text  label  for  the  x
              axis.  It is only drawn if u is in the xopt string.

       xtick (PLFLT, input)
              World  coordinate interval between major ticks on the x axis. If
              it is set to zero, PLplot  automatically  generates  a  suitable
              tick interval.

       nxsub (PLINT, input)
              Number  of  subintervals  between  major  x axis ticks for minor
              ticks.  If it is set to zero, PLplot automatically  generates  a
              suitable minor tick interval.

       yopt (const char *, input)
              Pointer  to  character string specifying options for the y axis.



                          November, 2007                        1





PLBOX3(3)                   PLplot API                  PLBOX3(3)


              The string is interpreted in the same way as xopt.

       ylabel (const char *, input)
              Pointer to character string specifying  text  label  for  the  y
              axis.  It is only drawn if u is in the yopt string.

       ytick (PLFLT, input)
              World  coordinate interval between major ticks on the y axis. If
              it is set to zero, PLplot  automatically  generates  a  suitable
              tick interval.

       nysub (PLINT, input)
              Number  of  subintervals  between  major  y axis ticks for minor
              ticks.  If it is set to zero, PLplot automatically  generates  a
              suitable minor tick interval.

       zopt (const char *, input)
              Pointer  to  character string specifying options for the z axis.
              The string can include any combination of the following  letters
              (upper  or lower case) in any order: b: Draws z axis to the left
              of the surface plot.  c: Draws z axis to the right of  the  sur-
              face plot.  d: Draws grid lines parallel to the x-y plane behind
              the figure.  These lines are not drawn until after plot3d(3)  or
              plmesh(3)  are  called  because  of  the  need  for  hidden line
              removal.  f: Always use fixed point numeric labels.  i:  Inverts
              tick  marks,  so they are drawn away from the center.  l: Labels
              axis logarithmically.  This only affects  the  labels,  not  the
              data,  and  so it is necessary to compute the logarithms of data
              points before passing them to any of the drawing  routines.   m:
              Writes  numeric labels at major tick intervals on the right-hand
              vertical axis.  n: Writes numeric labels at major tick intervals
              on  the  left-hand  vertical  axis.  s: Enables subticks between
              major ticks, only valid if t is also specified.  t: Draws  major
              ticks.   u:  If  this  is  specified,  the text label is written
              beside the left-hand axis.  v: If this is  specified,  the  text
              label is written beside the right-hand axis.


       zlabel (const char *, input)
              Pointer  to  character  string  specifying  text label for the z
              axis.  It is only drawn if u or v are in the zopt string.

       ztick (PLFLT, input)
              World coordinate interval between major ticks on the z axis.  If
              it  is  set  to  zero, PLplot automatically generates a suitable
              tick interval.

       nzsub (PLINT, input)
              Number of subintervals between major  z  axis  ticks  for  minor
              ticks.   If  it is set to zero, PLplot automatically generates a
              suitable minor tick interval.






                          November, 2007                        2





PLBOX3(3)                   PLplot API                  PLBOX3(3)


AUTHORS
       Geoffrey Furnish and Maurice LeBrun wrote and  maintain  PLplot.   This
       man  page  was  automatically  generated from the DocBook source of the
       PLplot  documentation,  maintained  by  Alan  W.   Irwin   and   Rafael
       Laboissiere.

SEE ALSO
       PLplot documentation at http://plplot.sourceforge.net/resources.

















































                          November, 2007                        3


