Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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)

Check Out this Related Man Page

PLPTEX(3plplot) 						    PLplot API							   PLPTEX(3plplot)

NAME

       plptex - Write text inside the viewport

SYNOPSIS

       plptex(x, y, dx, dy, just, text)

DESCRIPTION

       Writes  text at a specified position and inclination within the viewport.  Text is clipped at the viewport boundaries.  The reference point
       of a string lies along a line passing through the string at half the height of a capital letter.  The position of the reference point along
       this  line  is  determined  by just, the reference point is placed at world coordinates (x, y) within the viewport.  The inclination of the
       string is specified in terms of differences of world coordinates making it easy to write text parallel to a line in a graph.

       Redacted form: plptex(x, y, dx, dy, just, text)

       This function is used in example 2-4,10,12-14,20,23,24,26.

ARGUMENTS

       x (PLFLT, input)
	      x coordinate of reference point of string.

       y (PLFLT, input)
	      y coordinate of reference point of string.

       dx (PLFLT, input)
	      Together with dy, this specifies the inclination of the string.  The baseline of the string is parallel to a line joining (x, y)	to
	      (x+dx, y+dy).

       dy (PLFLT, input)
	      Together with dx, this specifies the inclination of the string.

       just (PLFLT, input)
	      Specifies  the  position	of  the  string  relative  to  its reference point.  If just=0., the reference point is at the left and if
	      just=1., it is at the right of the string.  Other values of just give intermediate justifications.

       text (const char *, input)
	      The string to be written out.

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 						   PLPTEX(3plplot)
Man Page