


PLCALC_WORLD(3)             PLplot API            PLCALC_WORLD(3)


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 not used in any examples.

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  corre-
              sponds  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(3) 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 corre-
              sponds to the viewport index  (in  the  order  which  the  view-
              port/windows  were  created)  of the only viewport/window corre-
              sponding 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  view-
              port/window, then window is set to -1.




                          November, 2007                        1





PLCALC_WORLD(3)             PLplot API            PLCALC_WORLD(3)


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.

















































                          November, 2007                        2


