1PLSPAGE(3plplot) PLplot API PLSPAGE(3plplot)
2
3
4
6 plspage - Set page parameters
7
9 plspage(xp, yp, xleng, yleng, xoff, yoff)
10
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
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
56 Many developers (who are credited at http://plplot.org/credits.php)
57 have contributed to PLplot over its long history.
58
60 PLplot documentation at http://plplot.org/documentation.php.
61
62
63
64 July, 2022 PLSPAGE(3plplot)