PLADV(3)

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(3)(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(3) followed by plbop(3) to first advance the page. This routine is called automatically (with page=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(page)

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

ARGUMENTS

page (PLINT(3), 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.