PLADV(3)                          PLplot API                          PLADV(3)



NAME
       pladv - Advance the (sub-)page

SYNOPSIS
       pladv(sub)

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(3)(0) will always advance the page.  If sub>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(3) followed by plbop(3) to first advance the page.
       This routine is called automatically (with sub=0) by plenv(3), but if
       plenv(3) is not used, pladv(3) must be called after initializing PLplot
       but before defining the viewport.

       Redacted form: pladv(sub)

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

ARGUMENTS
       sub (PLINT, 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.


AUTHORS
       Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot.  This
       man page was automatically generated from the DocBook source of the
       PLplot documentation, maintained by Alan W. Irwin and Rafael
       Laboissiere.

SEE ALSO
       PLplot documentation at http://plplot.sourceforge.net/resources.



                                November, 2007                        PLADV(3)
