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(3plplot), input)
24              Input relative device coordinate (0.0-1.0) for the x coordinate.
25
26       ry (PLFLT(3plplot), input)
27              Input relative device coordinate (0.0-1.0) for the y coordinate.
28
29       wx (PLFLT_NC_SCALAR(3plplot), output)
30              Returned value of the x world coordinate  corresponding  to  the
31              relative device coordinates rx and ry.
32
33       wy (PLFLT_NC_SCALAR(3plplot), output)
34              Returned  value  of  the y world coordinate corresponding to the
35              relative device coordinates rx and ry.
36
37       window (PLINT_NC_SCALAR(3plplot), output)
38              Returned value of the last defined window index that corresponds
39              to the input relative device coordinates (and the returned world
40              coordinates).  To give some background on the window index,  for
41              each page the initial window index is set to zero, and each time
42              plwind(3plplot) is called within  the  page,  world  and  device
43              coordinates  are  stored  for the window and the window index is
44              incremented.  Thus, for a simple page layout  with  non-overlap‐
45              ping  viewports  and one window per viewport, window corresponds
46              to the viewport index (in the order which  the  viewport/windows
47              were  created)  of  the only viewport/window corresponding to rx
48              and ry.  However, for more complicated layouts with  potentially
49              overlapping  viewports and possibly more than one window (set of
50              world coordinates) per viewport, window  and  the  corresponding
51              output  world coordinates corresponds to the last window created
52              that fulfills the criterion that the relative device coordinates
53              are  inside  it.  Finally, in all cases where the input relative
54              device coordinates are not inside any viewport/window, then  the
55              returned value of the last defined window index is set to -1.
56
57

AUTHORS

59       Many    developers   (who   are   credited   at   http://plplot.source‐
60       forge.net/credits.php) have contributed to PLplot over  its  long  his‐
61       tory.
62

SEE ALSO

64       PLplot    documentation   at   http://plplot.sourceforge.net/documenta‐
65       tion.php.
66
67
68
69                                 August, 2017            PLCALC_WORLD(3plplot)
Impressum