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

NAME

6       plcalc_world  -  Calculate  world  coordinates and corresponding window
7       index from relative device coordinates
8

SYNOPSIS

10       plcalc_world(rx, ry, wx, wy, window)
11

DESCRIPTION

13       Calculate world coordinates, wx and wy, and corresponding window  index
14       from relative device coordinates, rx and ry.
15
16       Redacted form:  General: plcalc_world(rx, ry, wx, wy, window) Perl/PDL:
17       Not available?
18
19
20       This function is used in example 31.
21

ARGUMENTS

23       rx (PLFLT, input)
24              Input relative device coordinate (ranging from 0. to 1.) for the
25              x coordinate.
26
27       ry (PLFLT, input)
28              Input relative device coordinate (ranging from 0. to 1.) for the
29              y coordinate.
30
31       wx (PLFLT *, output)
32              Pointer to the returned world coordinate for x corresponding  to
33              the relative device coordinates rx and ry.
34
35       wy (PLFLT *, output)
36              Pointer  to the returned world coordinate for y corresponding to
37              the relative device coordinates rx and ry.
38
39       window (PLINT *, output)
40              Pointer to the returned last defined window  index  that  corre‐
41              sponds  to  the  input  relative  device  coordinates  (and  the
42              returned world coordinates).  To give  some  background  on  the
43              window  index,  for each page the initial window index is set to
44              zero, and each time plwind(3plplot) is called within  the  page,
45              world  and  device coordinates are stored for the window and the
46              window index is incremented.  Thus, for  a  simple  page  layout
47              with non-overlapping viewports and one window per viewport, win‐
48              dow corresponds to the viewport index (in the  order  which  the
49              viewport/windows  were created) of the only viewport/window cor‐
50              responding to rx and ry.  However, for more complicated  layouts
51              with  potentially  overlapping  viewports and possibly more than
52              one window (set of world coordinates) per viewport,  window  and
53              the  corresponding  output  world coordinates corresponds to the
54              last window created that fulfils the criterion that the relative
55              device  coordinates  are inside it.  Finally, in all cases where
56              the input relative device coordinates are not inside  any  view‐
57              port/window, then window is set to -1.
58
59

AUTHORS

61       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
62       man page was automatically generated from the  DocBook  source  of  the
63       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
64       Laboissiere.
65

SEE ALSO

67       PLplot documentation at http://plplot.sourceforge.net/resources.
68
69
70
71                                  July, 2010             PLCALC_WORLD(3plplot)
Impressum