NAME

       pladv - Advance the (sub-)page

SYNOPSIS

       pladv(page)

DESCRIPTION

       Advances  to  the  next subpage if sub=0, performing a page advance if there are no remaining subpages on
       the current page.  If subpages aren't being used, pladv(3plplot)(0) will always  advance  the  page.   If
       page>0,  PLplot  switches to the specified subpage.  Note that this allows you to overwrite a plot on the
       specified subpage; if this is not what you intended, use pleop(3plplot)  followed  by  plbop(3plplot)  to
       first  advance  the  page.   This routine is called automatically (with page=0) by plenv(3plplot), but if
       plenv(3plplot) is not used, pladv(3plplot) must be called after initializing PLplot but  before  defining
       the viewport.

       Redacted form: pladv(page)

       This function is used in examples 1, 2, 4, 6-12, 14-18, 20, 21, 23-27, 29, and 31.

ARGUMENTS

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

AUTHORS

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

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                                   March, 2025                                    PLADV(3plplot)