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(3plplot), input)
              Input relative device coordinate (0.0-1.0) for the x coordinate.

       ry (PLFLT(3plplot), input)
              Input relative device coordinate (0.0-1.0) for the y coordinate.

       wx (PLFLT_NC_SCALAR(3plplot), output)
              Returned  value  of the x world coordinate corresponding to the relative device coordinates rx and
              ry.

       wy (PLFLT_NC_SCALAR(3plplot), output)
              Returned value of the y world coordinate corresponding to the relative device coordinates  rx  and
              ry.

       window (PLINT_NC_SCALAR(3plplot), output)
              Returned  value  of  the  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
              incremented.   Thus,  for  a  simple page layout with non-overlapping viewports and one window per
              viewport, window corresponds to the viewport 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 fulfills 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 the returned value of the last defined window index is set to -1.

AUTHORS

       Many developers (who are  credited  at  http://plplot.sourceforge.net/credits.php)  have  contributed  to
       PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                                 November, 2017                            PLCALC_WORLD(3plplot)