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

NAME

6       pladv - Advance the (sub-)page
7

SYNOPSIS

9       pladv(page)
10

DESCRIPTION

12       Advances  to  the  next  subpage if sub=0, performing a page advance if
13       there are no remaining subpages  on  the  current  page.   If  subpages
14       aren't  being used, pladv(3plplot)(0) will always advance the page.  If
15       page>0, PLplot switches to the specified subpage.  Note that  this  al‐
16       lows  you  to overwrite a plot on the specified subpage; if this is not
17       what you intended, use pleop(3plplot)  followed  by  plbop(3plplot)  to
18       first  advance  the  page.   This routine is called automatically (with
19       page=0)  by  plenv(3plplot),  but  if  plenv(3plplot)  is   not   used,
20       pladv(3plplot)  must  be  called  after  initializing PLplot but before
21       defining the viewport.
22
23       Redacted form: pladv(page)
24
25       This function is used in examples 1, 2, 4, 6-12, 14-18, 20, 21,  23-27,
26       29, and 31.
27

ARGUMENTS

29       page (PLINT(3plplot), input)
30              Specifies  the  subpage  number (starting from 1 in the top left
31              corner and increasing along the rows) to which to advance.   Set
32              to  zero  to advance to the next subpage (or to the next page if
33              subpages are not being used).
34
35

AUTHORS

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

SEE ALSO

41       PLplot documentation at http://plplot.org/documentation.php.
42
43
44
45                                 January, 2023                  PLADV(3plplot)