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
              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(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
              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 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.



                                November, 2007                 PLCALC_WORLD(3)
