plcalc_world(3plplot) [debian man page]

PLCALC_WORLD(3plplot)						    PLplot API						     PLCALC_WORLD(3plplot)

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, 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(3plplot)  is  called  within  the page, world and device coordinates are stored for the window and the window index is incre-
	      mented.  Thus, for a simple page layout with non-overlapping viewports and one window per viewport, window corresponds to the  view-
	      port  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.

								   August, 2012 					     PLCALC_WORLD(3plplot)

PLMAP(3plplot)							    PLplot API							    PLMAP(3plplot)

NAME

       plmap - Plot continental outline in world coordinates.

SYNOPSIS

       plmap(mapform, type, minlong, maxlong, minlat, maxlat)

DESCRIPTION

       Plots continental outlines in world coordinates. examples/c/x19c demonstrates how to use this  function to create different projections.

       Redacted form:  General: plmap(mapform, type, minlong, maxlong, minlat, maxlat) F95, Java, Perl/PDL, Python: Not implemented?

       This function is used in example 19.

ARGUMENTS

       mapform (void (*) (PLINT, PLFLT *, PLFLT *), input)
	      A  user  supplied function to transform the coordinate  longitudes and latitudes to a plot coordinate system.   By using this trans-
	      form, we can change from a longitude,  latitude coordinate to a polar stereographic project, for	example.   Initially,  x[0]..[n-1]
	      are  the longitudes and y[0]..y[n-1]  are the corresponding latitudes.  After the call to mapform(), x[]	and y[] should be replaced
	      by the corresponding plot coordinates.   If no transform is desired, mapform can be replaced by NULL.

       type (char *, input)
	      type is a character string. The value of this parameter determines the type of background. The possible values are: "globe" --  con-
	      tinental	outlines  "usa" -- USA and state boundaries "cglobe" -- continental outlines and countries "usaglobe" -- USA, state bound-
	      aries and continental outlines

       minlong (PLFLT, input)
	      The value of the longitude on the left side of the plot.	The value of minlong must be less than	the  value  of	maxlong,  and  the
	      quantity maxlong-minlong must be less than or equal to 360.

       maxlong (PLFLT, input)
	      The value of the longitude on the right side of the plot.

       minlat (PLFLT, input)
	      The  minimum  latitude  to be plotted on the background.	 One can always use -90.0 as the boundary outside the plot window  will be
	      automatically eliminated.  However, the program will be  faster if one can reduce the size of the background plotted.

       maxlat (PLFLT, input)
	      The maximum latitudes to be plotted on the background.   One can always use 90.0 as the boundary outside the plot  window   will	be
	      automatically eliminated.

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.

								   August, 2012 						    PLMAP(3plplot)