1PLENV(3plplot)                    PLplot API                    PLENV(3plplot)
2
3
4

NAME

6       plenv - Set up standard window and draw box
7

SYNOPSIS

9       plenv(xmin, xmax, ymin, ymax, just, axis)
10

DESCRIPTION

12       Sets up plotter environment for simple graphs by calling pladv(3plplot)
13       and  setting  up  viewport  and  window  to  sensible  default  values.
14       plenv(3plplot)  leaves  a  standard  margin  (left-hand margin of eight
15       character heights, and a margin around the other three  sides  of  five
16       character  heights)  around  most  graphs  for axis labels and a title.
17       When these defaults are not suitable, use the individual routines  plv‐
18       pas(3plplot),  plvpor(3plplot),  or  plvasp(3plplot) for setting up the
19       viewport, plwind(3plplot) for defining the window,  and  plbox(3plplot)
20       for drawing the box.
21
22       Redacted form: plenv(xmin, xmax, ymin, ymax, just, axis)
23
24       This function is used in example 1,3,9,13,14,19-22,29.
25

ARGUMENTS

27       xmin (PLFLT(3plplot), input)
28              Value of x at left-hand edge of window (in world coordinates).
29
30       xmax (PLFLT(3plplot), input)
31              Value of x at right-hand edge of window (in world coordinates).
32
33       ymin (PLFLT(3plplot), input)
34              Value of y at bottom edge of window (in world coordinates).
35
36       ymax (PLFLT(3plplot), input)
37              Value of y at top edge of window (in world coordinates).
38
39       just (PLINT(3plplot), input)
40              Controls how the axes will be scaled: -1: the scales will not be
41              set,  the  user  must  set   up   the   scale   before   calling
42              plenv(3plplot)  using plsvpa(3plplot), plvasp(3plplot) or other.
43              0: the x and y axes are scaled independently to use as  much  of
44              the  screen  as possible.  1: the scales of the x and y axes are
45              made equal.  2: the axis of the x and y axes are made equal, and
46              the plot box will be square.
47
48
49       axis (PLINT(3plplot), input)
50              Controls drawing of the box around the plot: -2: draw no box, no
51              tick marks, no numeric tick labels, no axes.  -1: draw box only.
52              0: draw box, ticks, and numeric tick labels.  1: also draw coor‐
53              dinate axes at x=0 and y=0.  2: also draw a grid at  major  tick
54              positions  in  both  coordinates.   3: also draw a grid at minor
55              tick positions in both coordinates.  10: same as 0 except  loga‐
56              rithmic  x tick marks. (The x data have to be converted to loga‐
57              rithms separately.)  11: same as 1  except  logarithmic  x  tick
58              marks.  (The  x  data  have  to be converted to logarithms sepa‐
59              rately.)  12: same as 2 except logarithmic x tick marks. (The  x
60              data  have  to be converted to logarithms separately.)  13: same
61              as 3 except logarithmic x tick marks. (The x  data  have  to  be
62              converted to logarithms separately.)  20: same as 0 except loga‐
63              rithmic y tick marks. (The y data have to be converted to  loga‐
64              rithms  separately.)   21:  same  as 1 except logarithmic y tick
65              marks. (The y data have to  be  converted  to  logarithms  sepa‐
66              rately.)   22: same as 2 except logarithmic y tick marks. (The y
67              data have to be converted to logarithms separately.)   23:  same
68              as  3  except  logarithmic  y tick marks. (The y data have to be
69              converted to logarithms separately.)  30: same as 0 except loga‐
70              rithmic  x  and  y tick marks. (The x and y data have to be con‐
71              verted to logarithms separately.)  31: same as  1  except  loga‐
72              rithmic  x  and  y tick marks. (The x and y data have to be con‐
73              verted to logarithms separately.)  32: same as  2  except  loga‐
74              rithmic  x  and  y tick marks. (The x and y data have to be con‐
75              verted to logarithms separately.)  33: same as  3  except  loga‐
76              rithmic  x  and  y tick marks. (The x and y data have to be con‐
77              verted to logarithms separately.)  40: same as 0 except  date  /
78              time  x labels.  41: same as 1 except date / time x labels.  42:
79              same as 2 except date / time x labels.  43:  same  as  3  except
80              date  /  time  x labels.  50: same as 0 except date / time y la‐
81              bels.  51: same as 1 except date / time y labels.  52: same as 2
82              except date / time y labels.  53: same as 3 except date / time y
83              labels.  60: same as 0 except date / time x and y  labels.   61:
84              same  as 1 except date / time x and y labels.  62: same as 2 ex‐
85              cept date / time x and y labels.  63: same as 3  except  date  /
86              time  x  and  y labels.  70: same as 0 except custom x and y la‐
87              bels.  71: same as 1 except custom x and y labels.  72: same  as
88              2  except  custom x and y labels.  73: same as 3 except custom x
89              and y labels.
90
91
92

AUTHORS

94       Many developers (who  are  credited  at  http://plplot.org/credits.php)
95       have contributed to PLplot over its long history.
96

SEE ALSO

98       PLplot documentation at http://plplot.org/documentation.php.
99
100
101
102                                 January, 2023                  PLENV(3plplot)
Impressum