PLplot 5.9.6
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 122 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 295 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 74 of file plpage.c.

void c_pleop ( void  )

End current page.

Definition at line 105 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 226 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 249 of file plpage.c.

void plP_setsub ( void  )

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

Definition at line 195 of file plpage.c.

void plP_subpInit ( void  )

Set up plot parameters according to the number of subpages.

Definition at line 139 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 265 of file plpage.c.

 All Data Structures Files Functions