plcalc_world(3plplot) [debian man page]
PLCALC_WORLD(3plplot) PLplot API PLCALC_WORLD(3plplot) NAME
plcalc_world - Calculate world coordinates and corresponding window index from relative device coordinates SYNOPSIS
plcalc_world(rx, ry, wx, wy, window) DESCRIPTION
Calculate world coordinates, wx and wy, and corresponding window index from relative device coordinates, rx and ry. Redacted form: General: plcalc_world(rx, ry, wx, wy, window) Perl/PDL: Not available? This function is used in example 31. ARGUMENTS
rx (PLFLT, input) Input relative device coordinate (ranging from 0. to 1.) for the x coordinate. ry (PLFLT, input) Input relative device coordinate (ranging from 0. to 1.) for the y coordinate. wx (PLFLT *, output) Pointer to the returned world coordinate for x corresponding to the relative device coordinates rx and ry. wy (PLFLT *, output) Pointer to the returned world coordinate for y corresponding to the relative device coordinates rx and ry. window (PLINT *, output) Pointer to the returned last defined window index that corresponds to the input relative device coordinates (and the returned world coordinates). To give some background on the window index, for each page the initial window index is set to zero, and each time plwind(3plplot) is called within the page, world and device coordinates are stored for the window and the window index is incre- mented. Thus, for a simple page layout with non-overlapping viewports and one window per viewport, window corresponds to the view- port index (in the order which the viewport/windows were created) of the only viewport/window corresponding to rx and ry. However, for more complicated layouts with potentially overlapping viewports and possibly more than one window (set of world coordinates) per viewport, window and the corresponding output world coordinates corresponds to the last window created that fulfils the criterion that the relative device coordinates are inside it. Finally, in all cases where the input relative device coordinates are not inside any viewport/window, then window is set to -1. 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 PLCALC_WORLD(3plplot)
Check Out this Related Man Page
PLENV0(3plplot) PLplot API PLENV0(3plplot) NAME
plenv0 - Same as plenv(3plplot) but if in multiplot mode does not advance the subpage, instead clears it. SYNOPSIS
plenv0(xmin, xmax, ymin, ymax, just, axis) DESCRIPTION
Sets up plotter environment for simple graphs by calling pladv(3plplot) and setting up viewport and window to sensible default values. plenv0(3plplot) leaves enough room around most graphs for axis labels and a title. When these defaults are not suitable, use the individual routines plvpas(3plplot), plvpor(3plplot), or plvasp(3plplot) for setting up the viewport, plwind(3plplot) for defining the window, and plbox(3plplot) for drawing the box. Redacted form: plenv0(xmin, xmax, ymin, ymax, just, axis) This function is used in example 21. 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 plenv0(3plplot) using plsvpa(3plplot), plvasp(3plplot) or other. 0: the x and y axes are scaled independently to use as much of the screen as pos- sible. 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 coordinate axes at x=0 and y=0. 2: also draw a grid at major tick posi- tions in both coordinates. 3: also draw a grid at minor tick positions in both coordinates. 10: same as 0 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.) 11: same as 1 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.) 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 converted to logarithms separately.) 20: same as 0 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.) 21: same as 1 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.) 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 logarithmic x and y tick marks. (The x and y data have to be con- verted to logarithms separately.) 31: same as 1 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.) 32: same as 2 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.) 33: same as 3 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.) 40: same as 0 except date / time x labels. 41: same as 1 except date / time x labels. 42: same as 2 except date / time x labels. 43: same as 3 except date / time x labels. 50: same as 0 except date / time y labels. 51: same as 1 except date / time y labels. 52: same as 2 except date / time y labels. 53: same as 3 except date / time y labels. 60: same as 0 except date / time x and y labels. 61: same as 1 except date / time x and y labels. 62: same as 2 except date / time x and y labels. 63: same as 3 except date / time x and y labels. 70: same as 0 except custom x and y labels. 71: same as 1 except custom x and y labels. 72: same as 2 except custom x and y labels. 73: same as 3 except custom x and y labels. 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 PLENV0(3plplot)