


PLENV(3)                    PLplot API                   PLENV(3)


NAME
       plenv - Set up standard window and draw box

SYNOPSIS
       plenv(xmin, xmax, ymin, ymax, just, axis)

DESCRIPTION
       Sets  up  plotter environment for simple graphs by calling pladv(3) and
       setting up viewport and window to sensible  default  values.   plenv(3)
       leaves enough room around most graphs for axis labels and a title. When
       these defaults are not suitable, use the individual routines plvpas(3),
       plvpor(3),  or  plvasp(3)  for  setting  up the viewport, plwind(3) for
       defining the window, and plbox(3) for drawing the box.

       Redacted form: plenv(xmin, xmax, ymin, ymax, just, axis)

       This function is used in example 1,3,9,13,14,19-22.

ARGUMENTS
       xmin (PLFLT, input)
              Value of x at left-hand edge of window (in world coordinates).

       xmax (PLFLT, input)
              Value of x at right-hand edge of window (in world  coordinates).

       ymin (PLFLT, input)
              Value of y at bottom edge of window (in world coordinates).

       ymax (PLFLT, input)
              Value of y at top edge of window (in world coordinates).

       just (PLINT, input)
              Controls how the axes will be scaled: -1: the scales will not be
              set, the user must set up  the  scale  before  calling  plenv(3)
              using  plsvpa(3),  plvasp(3)  or other.  0: the x and y axes are
              scaled independently to use as much of the screen  as  possible.
              1:  the  scales of the x and y axes are made equal.  2: the axis
              of the x and y axes are made equal, and the  plot  box  will  be
              square.


       axis (PLINT, input)
              Controls drawing of the box around the plot: -2: draw no box, no
              tick marks, no numeric tick labels, no axes.  -1: draw box only.
              0: draw box, ticks, and numeric tick labels.  1: also draw coor-
              dinate axes at x=0 and y=0.  2: also draw a grid at  major  tick
              positions  in  both  coordinates.   3: also draw a grid at minor
              tick positions in both coordinates.  10: same as 0 except  loga-
              rithmic  x tick marks. (The x data have to be converted to loga-
              rithms separately.)  11: same as 1  except  logarithmic  x  tick
              marks.  (The  x  data  have  to be converted to logarithms sepa-
              rately.)  12: same as 2 except logarithmic x tick marks. (The  x
              data  have  to be converted to logarithms separately.)  13: same
              as 3 except logarithmic x tick marks. (The x  data  have  to  be



                          November, 2007                        1





PLENV(3)                    PLplot API                   PLENV(3)


              converted to logarithms separately.)  20: same as 0 except loga-
              rithmic y tick marks. (The y data have to be converted to  loga-
              rithms  separately.)   21:  same  as 1 except logarithmic y tick
              marks. (The y data have to  be  converted  to  logarithms  sepa-
              rately.)   22: same as 2 except logarithmic y tick marks. (The y
              data have to be converted to logarithms separately.)   23:  same
              as  3  except  logarithmic  y tick marks. (The y data have to be
              converted to logarithms separately.)  30: same as 0 except loga-
              rithmic  x  and  y tick marks. (The x and y data have to be con-
              verted to logarithms separately.)  31: same as  1  except  loga-
              rithmic  x  and  y tick marks. (The x and y data have to be con-
              verted to logarithms separately.)  32: same as  2  except  loga-
              rithmic  x  and  y tick marks. (The x and y data have to be con-
              verted to logarithms separately.)  33: same as  3  except  loga-
              rithmic  x  and  y tick marks. (The x and y data have to be con-
              verted to logarithms separately.)



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                        2


