plpage.c File Reference

#include "plplotP.h"

Go to the source code of this file.

Functions
void	c_pladv (PLINT page)
void	c_plclear (void)
void	c_pleop (void)
void	c_plbop (void)
void	plP_subpInit (void)
void	plP_setsub (void)
void	c_plgspa (PLFLT *xmin, PLFLT *xmax, PLFLT *ymin, PLFLT *ymax)
int	plGetCursor (PLGraphicsIn *plg)
int	plTranslateCursor (PLGraphicsIn *plg)
void	c_plcalc_world (PLFLT rx, PLFLT ry, PLFLT *wx, PLFLT *wy, PLINT *window)

---

Detailed Description

Page/subpage handling routines.

Definition in file plpage.c.

---

Function Documentation

void c_pladv

(

PLINT

page

)

Advance to subpage "page", or to the next one if "page" = 0.

Parameters:

page

: subpage identifier or 0

Definition at line 37 of file plpage.c.

void c_plbop

(

void

)

Start new page. Should only be used with pleop().

Definition at line 115 of file plpage.c.

void c_plcalc_world	(	PLFLT	rx,
		PLFLT	ry,
		PLFLT *	wx,
		PLFLT *	wy,
		PLINT *	window
	)

Calculate world coordinates wx, and wy from relative device coordinates, rx and ry. Also, return the window index for which the world coordinates are valid. window is set to -1 and wx and wy to 0. if rx and ry do not correspond to valid world coordinates for any currently existing window.

Author:

Paul Casteels, modified by Alan W. Irwin.

Parameters:

	rx	: relative x device coordinates
	ry	: relative y device coordinates
	wx	: Pointer to x world coordinate (after call)
	wy	: Pointer to y world coordinate (after call)
	window	: Pointer index of window for which the world coordinates are valid

Definition at line 284 of file plpage.c.

void c_plclear

(

void

)

Clear current subpage. Subpages can be set with pladv before calling plclear. Not all drivers support this.

Definition at line 70 of file plpage.c.

void c_pleop

(

void

)

End current page.

Definition at line 99 of file plpage.c.

void c_plgspa	(	PLFLT *	xmin,
		PLFLT *	xmax,
		PLFLT *	ymin,
		PLFLT *	ymax
	)

Get subpage boundaries in absolute coordinates (mm from bottom left-hand corner of page).

Parameters:

	xmin	: pointer to PLFLT containing minimal x boundary after call
	xmax	: pointer to PLFLT containing maximal x boundary after call
	ymin	: pointer to PLFLT containing minimal y boundary after call
	ymax	: pointer to PLFLT containing maximal y boundary after call

Definition at line 217 of file plpage.c.

int plGetCursor

(

PLGraphicsIn *

plg

)

Wait for graphics input event and translate to world coordinates.

Author:

Paul Casteels.

Parameters:

plg

: pointer to PLGraphicsIn

Returns:

0 if no translation to world coordinates is possible.

See also:

PLGraphicsIn

Definition at line 239 of file plpage.c.

void plP_setsub

(

void

)

Set up the subpage boundaries according to the current subpage selected.

Definition at line 186 of file plpage.c.

void plP_subpInit

(

void

)

Set up plot parameters according to the number of subpages.

Definition at line 131 of file plpage.c.

int plTranslateCursor

(

PLGraphicsIn *

plg

)

Translates cursor position from relative device coordinates to world coordinates.

Author:

Paul Casteels, modified by Alan W. Irwin

Parameters:

plg

: pointer to PLGraphicsIn

Returns:

0 if no translation to world coordinates is possible.

Definition at line 255 of file plpage.c.