1PLSPAGE(3plplot)                  PLplot API                  PLSPAGE(3plplot)
2
3
4

NAME

6       plspage - Set page parameters
7

SYNOPSIS

9       plspage(xp, yp, xleng, yleng, xoff, yoff)
10

DESCRIPTION

12       Sets  the page configuration (optional).  If an individual parameter is
13       zero then that parameter value is not updated.  Not all parameters  are
14       recognized  by  all drivers and the interpretation is device-dependent.
15       The X-window driver uses the length and offset parameters to  determine
16       the  window  size  and  location.  The length and offset values are ex‐
17       pressed in units that are specific to  the  current  driver.   For  in‐
18       stance: screen drivers will usually interpret them as number of pixels,
19       whereas printer drivers will usually use mm.
20
21       This routine, if used, must be called before initializing  PLplot.   It
22       may be called at later times for interactive drivers to change only the
23       dpi for subsequent redraws which you can force  via  a  call  to  plre‐
24       plot(3plplot).   If  this function is not called then the page size de‐
25       faults to landscape A4 for drivers which use real world page sizes  and
26       744  pixels  wide  by  538  pixels high for raster drivers. The default
27       value for dx and dy is 90 pixels per inch for raster drivers.
28
29       Redacted form: plspage(xp, yp, xleng, yleng, xoff, yoff)
30
31       This function is used in examples 14 and 31.
32

ARGUMENTS

34       xp (PLFLT(3plplot), input)
35              Number of pixels per inch (DPI), x. Used only by raster drivers,
36              ignored by drivers which use "real world" units (e.g. mm).
37
38       yp (PLFLT(3plplot), input)
39              Number  of  pixels per inch (DPI), y.  Used only by raster driv‐
40              ers, ignored by drivers which use "real world" units (e.g. mm).
41
42       xleng (PLINT(3plplot), input)
43              Page length, x.
44
45       yleng (PLINT(3plplot), input)
46              Page length, y.
47
48       xoff (PLINT(3plplot), input)
49              Page offset, x.
50
51       yoff (PLINT(3plplot), input)
52              Page offset, y.
53
54

AUTHORS

56       Many developers (who  are  credited  at  http://plplot.org/credits.php)
57       have contributed to PLplot over its long history.
58

SEE ALSO

60       PLplot documentation at http://plplot.org/documentation.php.
61
62
63
64                                 January, 2023                PLSPAGE(3plplot)
Impressum