plmtex3(3plplot) [debian man page]
PLMTEX3(3plplot) PLplot API PLMTEX3(3plplot) NAME
plmtex3 - Write text relative to viewport boundaries in 3D plots. SYNOPSIS
plmtex3(side, disp, pos, just, text) DESCRIPTION
Writes text at a specified position relative to the viewport boundaries. Text may be written inside or outside the viewport, but is clipped at the subpage boundaries. The reference point of a string lies along a line passing through the string at half the height of a capital letter. The position of the reference point along this line is determined by just, and the position of the reference point rela- tive to the viewport is set by disp and pos. Redacted form: plmtex3(side, disp, pos, just, text) This function is used in example 28. ARGUMENTS
side (const char *, input) Specifies the side of the viewport along which the text is to be written. The string should contain one or more of the following characters: [xyz][ps][v]. Only one label is drawn at a time, i.e. xyp will only label the X axis, not both the X and Y axes. x: Label the X axis. y: Label the Y axis. z: Label the Z axis. p: Label the primary axis. For Z this is the leftmost Z axis. For X it is the axis that starts at y-min. For Y it is the axis that starts at x-min. s: Label the secondary axis. v: Draw the text per- pendicular to the axis. disp (PLFLT, input) Position of the reference point of string, measured outwards from the specified viewport edge in units of the current character height. Use negative disp to write within the viewport. pos (PLFLT, input) Position of the reference point of string along the specified edge, expressed as a fraction of the length of the edge. just (PLFLT, input) Specifies the position of the string relative to its reference point. If just=0., the reference point is at the left and if just=1., it is at the right of the string. Other values of just give intermediate justifications. text (const char *, input) The string to be written out. 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. August, 2012 PLMTEX3(3plplot)
Check Out this Related Man Page
PLAXES(3plplot) PLplot API PLAXES(3plplot) NAME
plaxes - Draw a box with axes, etc. with arbitrary origin SYNOPSIS
plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick, nysub) DESCRIPTION
Draws a box around the currently defined viewport with arbitrary world-coordinate origin specified by x0 and y0 and labels it with world coordinate values appropriate to the window. Thus plaxes(3plplot) should only be called after defining both viewport and window. The character strings xopt and yopt specify how the box should be drawn as described below. If ticks and/or subticks are to be drawn for a particular axis, the tick intervals and number of subintervals may be specified explicitly, or they may be defaulted by setting the appro- priate arguments to zero. Redacted form: General: plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick, nysub) Perl/PDL: plaxes(x0, y0, xtick, nxsub, ytick, nysub, xopt, yopt) This function is not used in any examples. ARGUMENTS
x0 (PLFLT, input) World X coordinate of origin. y0 (PLFLT, input) World Y coordinate of origin. xopt (const char *, input) Pointer to character string specifying options for horizontal axis. The string can include any combination of the following letters (upper or lower case) in any order: a: Draws axis, X-axis is horizontal line (y=0), and Y-axis is vertical line (x=0). b: Draws bottom (X) or left (Y) edge of frame. c: Draws top (X) or right (Y) edge of frame. d: Plot labels as date / time. Values are assumed to be seconds since the epoch (as used by gmtime). f: Always use fixed point numeric labels. g: Draws a grid at the major tick interval. h: Draws a grid at the minor tick interval. i: Inverts tick marks, so they are drawn outwards, rather than inwards. l: Labels axis logarithmically. This only affects the labels, not the data, and so it is necessary to compute the loga- rithms of data points before passing them to any of the drawing routines. m: Writes numeric labels at major tick intervals in the unconventional location (above box for X, right of box for Y). n: Writes numeric labels at major tick intervals in the conventional location (below box for X, left of box for Y). o: Use custom labeling function to generate axis label text. The custom labeling function can be defined with the plslabelfuncplslabelfunc; command. s: Enables subticks between major ticks, only valid if t is also specified. t: Draws major ticks. 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 vertical axis. The string can include any combination of the letters defined above for xopt, and in addition may contain: v: Write numeric labels for vertical axis parallel to the base of the graph, rather than parallel to the axis. 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. 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. August, 2012 PLAXES(3plplot)