1PLBOX(3plplot) PLplot API PLBOX(3plplot)
2
6 plbox - Draw a box with axes, etc
7
9 plbox(xopt, xtick, nxsub, yopt, ytick, nysub)
10
12 Draws a box around the currently defined viewport, and labels it with
13 world coordinate values appropriate to the window. Thus plbox(3plplot)
14 should only be called after defining both viewport and window. The
15 ascii character strings xopt and yopt specify how the box should be
16 drawn as described below. If ticks and/or subticks are to be drawn for
17 a particular axis, the tick intervals and number of subintervals may be
18 specified explicitly, or they may be defaulted by setting the appropri‐
19 ate arguments to zero.
20 Redacted form: General: plbox(xopt, xtick, nxsub, yopt, ytick, nysub)
22 Perl/PDL: plbox(xtick, nxsub, ytick, nysub, xopt, yopt)
23 This function is used in examples 1, 2, 4, 6, 6-12, 14-18, 21, 23-26,
26 and 29.
27
29 xopt (PLCHAR_VECTOR(3plplot), input)
30 An ascii character string specifying options for the x axis.
31 The string can include any combination of the following letters
32 (upper or lower case) in any order: a: Draws axis, X-axis is
33 horizontal line (y=0), and Y-axis is vertical line (x=0). b:
34 Draws bottom (X) or left (Y) edge of frame. c: Draws top (X) or
35 right (Y) edge of frame. d: Plot labels as date / time. Values
36 are assumed to be seconds since the epoch (as used by gmtime).
37 f: Always use fixed point numeric labels. g: Draws a grid at
38 the major tick interval. h: Draws a grid at the minor tick
39 interval. i: Inverts tick marks, so they are drawn outwards,
40 rather than inwards. l: Labels axis logarithmically. This only
41 affects the labels, not the data, and so it is necessary to com‐
42 pute the logarithms of data points before passing them to any of
43 the drawing routines. m: Writes numeric labels at major tick
44 intervals in the unconventional location (above box for X, right
45 of box for Y). n: Writes numeric labels at major tick intervals
46 in the conventional location (below box for X, left of box for
47 Y). o: Use custom labelling function to generate axis label
48 text. The custom labelling function can be defined with the
49 plslabelfunc(3plplot) command. s: Enables subticks between
50 major ticks, only valid if t is also specified. t: Draws major
51 ticks. u: Exactly like "b" except don't draw edge line. w:
52 Exactly like "c" except don't draw edge line. x: Exactly like
53 "t" (including the side effect of the numerical labels for the
54 major ticks) except exclude drawing the major and minor tick
55 marks.
56 xtick (PLFLT(3plplot), input)
59 World coordinate interval between major ticks on the x axis. If
60 it is set to zero, PLplot automatically generates a suitable
61 tick interval.
62 nxsub (PLINT(3plplot), input)
64 Number of subintervals between major x axis ticks for minor
65 ticks. If it is set to zero, PLplot automatically generates a
66 suitable minor tick interval.
67 yopt (PLCHAR_VECTOR(3plplot), input)
69 An ascii character string specifying options for the y axis.
70 The string can include any combination of the letters defined
71 above for xopt, and in addition may contain: v: Write numeric
72 labels for the y axis parallel to the base of the graph, rather
73 than parallel to the axis.
74 ytick (PLFLT(3plplot), input)
77 World coordinate interval between major ticks on the y axis. If
78 it is set to zero, PLplot automatically generates a suitable
79 tick interval.
80 nysub (PLINT(3plplot), input)
82 Number of subintervals between major y axis ticks for minor
83 ticks. If it is set to zero, PLplot automatically generates a
84 suitable minor tick interval.
85
88 Many developers (who are credited at http://plplot.source‐
89 forge.net/credits.php) have contributed to PLplot over its long his‐
90 tory.
91
93 PLplot documentation at http://plplot.sourceforge.net/documenta‐
94 tion.php.
95 August, 2017 PLBOX(3plplot)