1PLBOX3(3plplot) PLplot API PLBOX3(3plplot)
2
6 plbox3 - Draw a box with axes, etc, in 3-d
7
9 plbox3(xopt, xlabel, xtick, nxsub, yopt, ylabel, ytick, nysub, zopt,
10 zlabel, ztick, nzsub)
11
13 Draws axes, numeric and text labels for a three-dimensional surface
14 plot. For a more complete description of three-dimensional plotting
15 see the PLplot documentation.
16 Redacted form: General: plbox3(xopt, xlabel, xtick, nxsub, yopt, yla‐
18 bel, ytick, nysub, zopt, zlabel, ztick, nzsub) Perl/PDL: plbox3(xtick,
19 nxsub, ytick, nysub, ztick, nzsub, xopt, xlabel, yopt, ylabel, zopt,
20 zlabel)
21 This function is used in examples 8,11,18,21.
24
26 xopt (const char *, input)
27 Pointer to character string specifying options for the x axis.
28 The string can include any combination of the following letters
29 (upper or lower case) in any order: b: Draws axis at base, at
30 height z=zmin where zmin is defined by call to plw3d(3plplot).
31 This character must be specified in order to use any of the
32 other options. f: Always use fixed point numeric labels. i:
33 Inverts tick marks, so they are drawn downwards, rather than
34 upwards. l: Labels axis logarithmically. This only affects the
35 labels, not the data, and so it is necessary to compute the log‐
36 arithms of data points before passing them to any of the drawing
37 routines. n: Writes numeric labels at major tick intervals. s:
38 Enables subticks between major ticks, only valid if t is also
39 specified. t: Draws major ticks. u: If this is specified, the
40 text label for the axis is written under the axis.
41 xlabel (const char *, input)
44 Pointer to character string specifying text label for the x
45 axis. It is only drawn if u is in the xopt string.
46 xtick (PLFLT, input)
48 World coordinate interval between major ticks on the x axis. If
49 it is set to zero, PLplot automatically generates a suitable
50 tick interval.
51 nxsub (PLINT, input)
53 Number of subintervals between major x axis ticks for minor
54 ticks. If it is set to zero, PLplot automatically generates a
55 suitable minor tick interval.
56 yopt (const char *, input)
58 Pointer to character string specifying options for the y axis.
59 The string is interpreted in the same way as xopt.
60 ylabel (const char *, input)
62 Pointer to character string specifying text label for the y
63 axis. It is only drawn if u is in the yopt string.
64 ytick (PLFLT, input)
66 World coordinate interval between major ticks on the y axis. If
67 it is set to zero, PLplot automatically generates a suitable
68 tick interval.
69 nysub (PLINT, input)
71 Number of subintervals between major y axis ticks for minor
72 ticks. If it is set to zero, PLplot automatically generates a
73 suitable minor tick interval.
74 zopt (const char *, input)
76 Pointer to character string specifying options for the z axis.
77 The string can include any combination of the following letters
78 (upper or lower case) in any order: b: Draws z axis to the left
79 of the surface plot. c: Draws z axis to the right of the sur‐
80 face plot. d: Draws grid lines parallel to the x-y plane behind
81 the figure. These lines are not drawn until after
82 plot3d(3plplot) or plmesh(3plplot) are called because of the
83 need for hidden line removal. f: Always use fixed point numeric
84 labels. i: Inverts tick marks, so they are drawn away from the
85 center. l: Labels axis logarithmically. This only affects the
86 labels, not the data, and so it is necessary to compute the log‐
87 arithms of data points before passing them to any of the drawing
88 routines. m: Writes numeric labels at major tick intervals on
89 the right-hand vertical axis. n: Writes numeric labels at major
90 tick intervals on the left-hand vertical axis. s: Enables
91 subticks between major ticks, only valid if t is also specified.
92 t: Draws major ticks. u: If this is specified, the text label
93 is written beside the left-hand axis. v: If this is specified,
94 the text label is written beside the right-hand axis.
95 zlabel (const char *, input)
98 Pointer to character string specifying text label for the z
99 axis. It is only drawn if u or v are in the zopt string.
100 ztick (PLFLT, input)
102 World coordinate interval between major ticks on the z axis. If
103 it is set to zero, PLplot automatically generates a suitable
104 tick interval.
105 nzsub (PLINT, input)
107 Number of subintervals between major z axis ticks for minor
108 ticks. If it is set to zero, PLplot automatically generates a
109 suitable minor tick interval.
110
113 Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This
114 man page was automatically generated from the DocBook source of the
115 PLplot documentation, maintained by Alan W. Irwin and Rafael
116 Laboissiere.
117
119 PLplot documentation at http://plplot.sourceforge.net/resources.
120 March, 2007 PLBOX3(3plplot)